macOS下纯CMake编译Android原生代码遇ld: --sysroot选项错误

问题原因分析 #

你遇到的ld: unknown option: --sysroot错误，本质是手动指定CMAKE_LINKER干扰了Android NDK toolchain的正常工作流程：

• Android NDK的clang工具链并非直接调用ld二进制，而是通过clang作为前端驱动，自动传递--sysroot等必要参数给底层的链接器。
• 当你手动设置CMAKE_LINKER为NDK的ld时，CMake会绕过clang直接调用该ld，但此时编译过程中生成的--sysroot参数是给clang用的，直接传给ld就会导致不支持的错误。更糟的是，如果系统的ld（/usr/bin/ld）优先级更高，会直接覆盖你指定的NDK链接器，因为CMake可能没有正确识别你指定的路径。

具体解决步骤 #

1. 移除手动指定的CMAKE_LINKER参数

Android的android.toolchain.cmake会自动配置好适合目标平台的链接器，不需要手动指定。修改你的CMake命令，删除-DCMAKE_LINKER=...这一行。

修改后的完整CMake命令：

/Users/myname/Library/Android/sdk/cmake/3.6.4111459/bin/cmake \
-DCMAKE_TOOLCHAIN_FILE=/Users/myname/Library/Android/ndk/android-ndk-r20b/build/cmake/android.toolchain.cmake \
-DANDROID_STL=c++_static \
-DANDROID_TOOLCHAIN=clang \
-DANDROID_ABI=arm64-v8a \
-DANDROID_NDK=/Users/myname/Library/Android/ndk/android-ndk-r20b \
-DANDROID_PLATFORM=android-23 \
-DCMAKE_BUILD_TYPE=Release \
-DCMAKE_MAKE_PROGRAM=/Users/myname/Library/Android/sdk/cmake/3.6.4111459/bin/ninja \
-G"Ninja" \
..

2. 替换生成器（可选但推荐）

你原来用的-G"Android Gradle - Ninja"是专门给Gradle集成用的生成器，纯CMake编译场景下直接用-G"Ninja"即可，避免Gradle相关的额外配置干扰。

3. 确保NDK工具链优先于系统工具

如果修改命令后仍然出现类似错误，说明系统的工具（比如ld、clang）优先级高于NDK的工具。可以临时修改PATH环境变量，把NDK工具链的bin目录放到最前面：

# 先设置PATH，让NDK的工具优先被找到
export PATH=/Users/myname/Library/Android/ndk/android-ndk-r20b/toolchains/llvm/prebuilt/darwin-x86_64/bin:$PATH

# 再执行修改后的CMake命令
/Users/myname/Library/Android/sdk/cmake/3.6.4111459/bin/cmake \
-DCMAKE_TOOLCHAIN_FILE=/Users/myname/Library/Android/ndk/android-ndk-r20b/build/cmake/android.toolchain.cmake \
-DANDROID_STL=c++_static \
-DANDROID_TOOLCHAIN=clang \
-DANDROID_ABI=arm64-v8a \
-DANDROID_NDK=/Users/myname/Library/Android/ndk/android-ndk-r20b \
-DANDROID_PLATFORM=android-23 \
-DCMAKE_BUILD_TYPE=Release \
-DCMAKE_MAKE_PROGRAM=/Users/myname/Library/Android/sdk/cmake/3.6.4111459/bin/ninja \
-G"Ninja" \
..

4. 排查CMake链接器调用日志（用于定位问题）

如果还是无法解决，可以开启CMake的调试日志，查看实际调用的链接器路径：

# 增加--debug-output参数查看详细日志
/Users/myname/Library/Android/sdk/cmake/3.6.4111459/bin/cmake \
--debug-output \
# 其他参数同上
..

在日志中搜索linker或ld，确认CMake是否真的使用了NDK的链接器（路径应该包含android-ndk-r20b/toolchains/llvm/prebuilt/darwin-x86_64/bin/）。

内容的提问来源于stack exchange，提问作者shizhen