MacOS编译pocl链接libOpenCL.dylib出现未定义符号报错

nm输出中小写t标记的是本地文本段符号，这类符号不会被加入动态库导出符号表，外部程序链接时无法识别，这就是报undefined symbols的直接原因。
MacOS下clang编译动态库时默认所有符号为hidden私有状态，不会对外导出。你关闭ENABLE_ICD选项后，旧版本pocl的构建脚本不会自动给OpenCL公共API添加可见性标记，叠加Homebrew版LLVM14和pocl的适配bug，就会出现所有OpenCL API符号都被标记为本地符号的问题。

• 清理旧构建缓存，避免历史文件干扰

rm -rf build && mkdir build && cd build

• 执行cmake配置时追加符号可见性和rpath相关参数，强制公共符号导出，同时避免运行时库找不到的问题

cmake .. \
  -DENABLE_TESTS=OFF \
  -DENABLE_EXAMPLES=OFF \
  -DENABLE_ICD=OFF \
  -DCMAKE_C_FLAGS="-fvisibility=default" \
  -DCMAKE_CXX_FLAGS="-fvisibility=default" \
  -DCMAKE_INSTALL_RPATH="@loader_path/../lib/CL" \
  -DCMAKE_BUILD_WITH_INSTALL_RPATH=ON

• 并行编译，线程数和CPU核心数对齐

make -j$(sysctl -n hw.ncpu)

• 编译完成后验证符号导出状态，输出结果中_clBuildProgram前为大写T即表示符号正常导出，可被外部程序链接

nm lib/CL/libOpenCL.dylib | grep clBuildProgram

• 若按上述步骤操作后仍存在链接错误，可直接开启ICD支持：将cmake参数中-DENABLE_ICD=OFF改为-DENABLE_ICD=ON，ICD模式下pocl会自动处理符号导出逻辑，编译安装后将生成的icd配置文件放到/etc/OpenCL/vendors/目录即可正常使用
• 编译时出现的-pie参数unused警告是Homebrew版LLVM和MacOS系统链接器的兼容提示，不影响功能，可直接忽略

内容的提问来源于stack exchange，提问作者Vince W.