1. 为什么需要为Android NDK定制LLVM工具链如果你在Android上折腾过C项目尤其是那些需要高性能计算或者依赖特定C标准库特性的项目你大概率遇到过这样的困境从官方渠道获取的NDK工具链其自带的Clang编译器版本可能不是你想要的或者你需要的某些LLVM组件比如特定的静态分析工具、libc的某个补丁版本并没有包含在内。这时候一个通用的、预编译好的工具链就显得有些“力不从心”了。我自己就踩过这个坑。当时我需要为一个Android设备上的图像处理库启用最新的C20协程特性并且要链接一个高度定制化的libcabi。官方的NDK r25b自带的Clang版本虽然能用但在链接阶段总是遇到一些奇怪的ABI兼容性问题。折腾了好几天最后发现问题的根源在于官方工具链的libc库和我的某些静态库编译时使用的标准库版本有细微的不匹配。解决问题的根本方法就是自己从源码开始编译一套完全匹配我项目需求的LLVM工具链。这听起来很硬核但实际做下来你会发现它带来的好处是实实在在的。首先版本完全自主可控。你可以自由选择LLVM/Clang的任何一个发布版本甚至是某个特定的提交点确保与你的代码库完美契合。其次组件可以按需裁剪。你不需要编译整个庞大的LLVM生态可以只选择clang、libcxx、libcxxabi、compiler-rt等核心组件大大节省编译时间和磁盘空间。最后目标架构和平台特性可以深度定制。你可以针对特定的Android API级别、CPU架构如armeabi-v7a, arm64-v8a, x86_64进行优化甚至开启一些实验性的编译选项。简单来说自己编译LLVM工具链就像是为你的Android C项目量身定制一套“专属开发工具”。它摆脱了“有什么用什么”的限制进入了“需要什么就造什么”的自由境界。接下来我就带你走一遍从源码到可执行文件的完整流程手把手教你打造自己的“瑞士军刀”。2. 编译前的环境与源码准备工欲善其事必先利其器。编译LLVM这种大型项目一个干净、稳定的基础环境至关重要。我强烈推荐使用Ubuntu 20.04 LTS或22.04 LTS作为编译主机它们在软件包版本和社区支持上都非常成熟。我自己就是在Ubuntu 20.04.2上完成的整个过程非常顺畅。2.1 搭建基础编译环境首先我们需要安装一系列必要的开发工具和库。打开终端执行以下命令来安装基础编译器和工具sudo apt update sudo apt install -y build-essential cmake ninja-build python3 git这里解释一下这几个包的作用build-essential: 包含了GCC、G、make等最基础的编译工具链。虽然我们最终要编译Clang但编译LLVM本身的第一步可能还是需要GCC来引导。cmake: LLVM项目使用CMake作为构建系统生成器这是我们的核心工具。ninja-build: 这是一个比make更快的构建工具LLVM官方推荐使用它来加速编译过程。python3: LLVM的构建脚本和一些工具需要Python环境。接下来我们需要为Android交叉编译准备一些额外的库。由于我们要针对ARM架构的Android设备需要安装对应的标准库和链接器支持sudo apt install -y gcc-aarch64-linux-gnu g-aarch64-linux-gnu libstdc-10-dev-arm64-cross安装gcc-aarch64-linux-gnu是为了获取ARM64架构的系统头文件和链接器aarch64-linux-gnu-ld这在后续配置交叉编译工具链时可能会被CMake探测到作为备选。虽然我们主要使用Clang但准备好这些依赖可以避免一些潜在的配置错误。2.2 获取LLVM源码并管理版本LLVM的源码托管在GitHub上项目结构是一个包含了LLVM核心库和众多子项目如Clang、libc等的超级仓库。我们使用git clone命令来获取源码git clone --recursive https://github.com/llvm/llvm-project.git cd llvm-project--recursive参数至关重要它会自动克隆所有必要的子模块Submodules比如Clang、libc、libcxxabi、compiler-rt等。没有这个参数你得到的将是一个不完整的源码树无法编译出完整的工具链。进入llvm-project目录后我们需要切换到想要编译的特定版本。盲目使用main分支的最新代码可能会遇到不稳定的问题。我选择的是LLVM 15.0.7这是一个长期支持LTS版本相对稳定。你可以通过以下命令切换git checkout llvmorg-15.0.7 git submodule update --init --recursive第一行命令将整个仓库切换到15.0.7的发布标签。第二行命令确保所有子模块也同步更新到这个标签对应的状态。这一步可能需要一些时间因为要下载子模块的内容。2.3 获取并配置Android NDK我们需要Android NDK来提供Android系统的头文件、库以及构建所需的CMake工具链文件。你可以从Android开发者官网下载或者如果你已经安装了Android SDK可以通过sdkmanager来安装。这里我使用的是NDK r24版本号24.0.8215888。下载解压后假设你将其放在了/home/yourname/Android/Sdk/ndk/24.0.8215888/。接下来我们需要将其路径导出到环境变量方便后续的CMake命令引用export ANDROID_NDK/home/yourname/Android/Sdk/ndk/24.0.8215888/为了方便你可以把这条export命令添加到你的~/.bashrc或~/.zshrc文件中这样每次打开终端都会自动设置好。NDK目录里最关键的文件是$ANDROID_NDK/build/cmake/android.toolchain.cmake。这个CMake工具链文件会“魔法般”地帮我们配置好所有的交叉编译参数比如目标系统、CPU架构、编译器路径、sysroot系统根目录包含头文件和库等。我们稍后在CMake配置阶段就会用到它。3. 针对Android平台的源码适配与修改直接从GitHub拉取的LLVM源码其默认配置是针对宿主机的比如x86_64架构的Linux。当我们将其用于交叉编译到Android特别是ARM架构时源码中的一些构建规则可能会产生冲突。这不是Bug而是一些模块在非原生编译环境下不被支持。我们需要手动进行一些小手术让构建系统知道在编译Android版本时跳过它们。3.1 定位并修改有问题的CMake脚本根据我的经验问题通常出在几个与“Pass插件”相关的示例或测试模块上。这些模块在构建为动态插件时在Android的交叉编译环境下链接会失败。我们需要修改它们的CMakeLists.txt文件用条件判断将其排除在Android构建之外。第一个需要修改的文件是llvm/lib/Transforms/CMakeLists.txt这个目录下有一个LLVMHello模块是一个示例Pass插件。我们用文本编辑器打开它找到关于LLVMHello的add_llvm_library部分。原始内容大概是这样的add_llvm_library( LLVMHello MODULE BUILDTREE_ONLY Hello.cpp DEPENDS intrinsics_gen PLUGIN_TOOL opt )我们需要将其包裹在一个条件判断中使其仅在非Android平台构建if(NOT ANDROID) add_llvm_library( LLVMHello MODULE BUILDTREE_ONLY Hello.cpp DEPENDS intrinsics_gen PLUGIN_TOOL opt ) endif()第二个需要修改的文件是llvm/tools/bugpoint-passes/CMakeLists.txtbugpoint是LLVM的一个调试工具它也需要一些Pass插件。同样地我们找到BugpointPasses的构建规则进行修改。原始内容add_llvm_library( BugpointPasses MODULE BUILDTREE_ONLY TestPasses.cpp DEPENDS intrinsics_gen bugpoint )修改为if(NOT ANDROID) add_llvm_library( BugpointPasses MODULE BUILDTREE_ONLY TestPasses.cpp DEPENDS intrinsics_gen bugpoint ) endif()第三个需要修改的文件是llvm/examples/Bye/CMakeLists.txt这是另一个示例Pass。这个文件的情况稍微复杂一点因为它还包含了安装install指令。我们需要确保在Android环境下整个模块的构建和安装都被跳过。找到相关部分通常看起来像这样add_llvm_pass_plugin(Bye Bye.cpp DEPENDS intrinsics_gen BUILDTREE_ONLY ) install(TARGETS ${name} RUNTIME DESTINATION ${LLVM_EXAMPLES_INSTALL_DIR} ) set_target_properties(${name} PROPERTIES FOLDER Examples)我们需要将这一段整体用条件判断包裹起来。注意这里通常判断的是WIN32我们加上ANDROIDif (NOT WIN32 AND NOT ANDROID) add_llvm_pass_plugin(Bye Bye.cpp DEPENDS intrinsics_gen BUILDTREE_ONLY ) install(TARGETS ${name} RUNTIME DESTINATION ${LLVM_EXAMPLES_INSTALL_DIR} ) set_target_properties(${name} PROPERTIES FOLDER Examples) endif()完成这三处修改后就可以避免在编译Android版本时遇到令人头疼的“未定义引用”或链接器错误。这些修改的本质是告诉构建系统“嘿我们现在是在给Android手机编译工具链那些依赖宿主机器特定功能的插件就先别管了。”4. 编写构建脚本与CMake配置详解一切准备就绪现在进入核心环节——配置和编译。我习惯把所有的配置命令写在一个Shell脚本里这样清晰、可重复也方便记录参数。我们在llvm-project的同级目录创建一个名为build_android.sh的文件。4.1 构建脚本的骨架首先我们定义一些路径变量让脚本更清晰#!/bin/bash # 定义路径 LLVM_SOURCE_DIR$(pwd)/llvm-project BUILD_DIR$(pwd)/build_android_llvm INSTALL_DIR$(pwd)/android_llvm_install # 清理并创建构建和安装目录 rm -rf $BUILD_DIR $INSTALL_DIR mkdir -p $BUILD_DIR mkdir -p $INSTALL_DIRLLVM_SOURCE_DIR: 指向我们下载的LLVM源码根目录。BUILD_DIR: 这是一个临时目录用于存放CMake生成的中间文件和编译过程中的.o文件。将其与源码分离是一个好习惯称为out-of-source build保持源码树干净。INSTALL_DIR: 这是最终编译产物的安装目录编译好的clang、clang、库文件、头文件都会复制到这里。4.2 CMake配置参数逐行解析接下来是最关键的cmake命令。它很长但每一部分都有其作用cd $BUILD_DIR cmake -G Ninja \ -S $LLVM_SOURCE_DIR/llvm \ -B $BUILD_DIR \ -DCMAKE_BUILD_TYPERelease \ -DLLVM_ENABLE_PROJECTSclang;libcxx;libcxxabi;compiler-rt \ -DLLVM_INSTALL_UTILSON \ -DLLVM_TARGETS_TO_BUILDAArch64 \ -DLLVM_DEFAULT_TARGET_TRIPLEaarch64-linux-android \ -DCMAKE_TOOLCHAIN_FILE$ANDROID_NDK/build/cmake/android.toolchain.cmake \ -DANDROID_ABIarm64-v8a \ -DANDROID_PLATFORMandroid-24 \ -DANDROID_STLc_shared \ -DCMAKE_INSTALL_PREFIX$INSTALL_DIR \ -DLLVM_INCLUDE_TESTSOFF \ -DLLVM_BUILD_TESTSOFF \ -DLLVM_INCLUDE_BENCHMARKSOFF \ -DLLVM_ENABLE_ASSERTIONSOFF我们来逐一拆解这些参数-G Ninja: 指定生成Ninja构建文件。Ninja比Make更快。-S $LLVM_SOURCE_DIR/llvm: 指定源码路径。注意这里是llvm-project/llvm是LLVM核心的目录而不是整个llvm-project。-B $BUILD_DIR: 指定构建目录。-DCMAKE_BUILD_TYPERelease: 编译发布版本开启优化去掉调试信息。如果想调试工具链本身可以设为Debug但编译时间会巨长产物体积也大。-DLLVM_ENABLE_PROJECTSclang;libcxx;libcxxabi;compiler-rt:这是核心配置。指定要一起编译的子项目。clang是C/C/ObjC编译器前端libcxx和libcxxabi是LLVM的C标准库及其ABI库compiler-rt是编译器运行时库包含libclang_rt.builtins.a等对于Android交叉编译至关重要。你可以按需增减比如加上lldLLVM的链接器。-DLLVM_INSTALL_UTILSON: 安装LLVM的一些实用工具如llvm-config,FileCheck等。-DLLVM_TARGETS_TO_BUILDAArch64: 指定只编译AArch64即ARM64后端的代码。这能显著减少编译时间和产物大小。如果你还需要支持32位ARM可以加上ARM。-DLLVM_DEFAULT_TARGET_TRIPLEaarch64-linux-android: 设置默认的目标平台三元组。这会影响编译器驱动clang默认生成的代码目标。-DCMAKE_TOOLCHAIN_FILE$ANDROID_NDK/...:最关键的一行。引入Android NDK提供的CMake工具链文件它自动设置了交叉编译器、sysroot、平台标志等无数个变量。-DANDROID_ABIarm64-v8a: 指定应用二进制接口为64位ARM。-DANDROID_PLATFORMandroid-24: 指定目标Android API级别。这里选择24Android 7.0。选择更高的API级别可以使用更新的系统功能但需要你的设备支持。-DANDROID_STLc_shared: 指定使用LLVM的libc作为C标准库并以动态库.so形式链接。你也可以用c_static静态链接。-DCMAKE_INSTALL_PREFIX$INSTALL_DIR: 指定安装路径。-DLLVM_INCLUDE_TESTSOFF等: 关闭测试和基准测试这些对我们使用工具链没有帮助关闭它们能极大加快编译速度。-DLLVM_ENABLE_ASSERTIONSOFF: 关闭LLVM内部的断言检查进一步提升性能。4.3 执行编译与安装配置完成后就可以开始编译了。使用Ninja进行并行编译-j后面的数字根据你CPU的核心数来定通常为核心数1或2ninja -C $BUILD_DIR install -j$(nproc)这个命令会在$BUILD_DIR目录下执行编译-C参数并将最终产物安装到-DCMAKE_INSTALL_PREFIX指定的$INSTALL_DIR目录。-j$(nproc)会自动检测你机器的CPU核心数并启动相应数量的并行编译任务。这个过程会非常漫长取决于你的机器性能可能需要1到数个小时。你可以去喝杯咖啡或者处理其他事情。编译完成后$INSTALL_DIR目录下就会出现我们梦寐以求的、为Android ARM64定制的LLVM工具链。5. 在Android设备上验证与使用工具链编译好了但它到底能不能在Android设备上工作我们需要进行一次实战检验。最直接的方法就是用它编译一个简单的C程序然后推到设备上运行。5.1 准备测试代码与初步编译首先我们创建一个最简单的C测试程序test_hello.cpp#include iostream #include vector int main() { std::vectorint vec {1, 2, 3, 4, 5}; std::cout Hello from custom LLVM Clang on Android! std::endl; for (auto i : vec) { std::cout i ; } std::cout std::endl; return 0; }然后使用我们刚刚编译好的clang进行交叉编译。注意我们需要指定正确的--sysroot和-target但幸运的是由于我们使用了Android NDK的toolchain文件我们安装的clang已经内置了这些配置。我们可以先尝试最简单的命令cd $INSTALL_DIR ./bin/clang ../test_hello.cpp -o test_hello -pie-piePosition Independent Executable是Android系统运行可执行文件所要求的。如果一切配置正确这个命令应该能生成一个名为test_hello的ARM64可执行文件。用file命令检查一下file test_hello输出应该显示为test_hello: ELF 64-bit LSB shared object, ARM aarch64, version 1 (SYSV), dynamically linked, ...这确认了它是一个ARM64架构的二进制文件。5.2 解决头文件与库依赖问题然而在实际操作中你很可能在第一步就遇到错误fatal error: iostream file not found。这是因为编译器找不到C标准库的头文件。我们编译的libcxx虽然生成了库文件.a或.so但其头文件可能没有正确地被安装到编译器默认的搜索路径中或者我们需要显式地指定sysroot。解决方案是手动指定包含include路径和库路径。我们需要找到两个关键的目录我们编译安装的libcxx头文件路径通常在$INSTALL_DIR/include/c/v1。Android NDK的sysroot中的系统头文件路径在$ANDROID_NDK/toolchains/llvm/prebuilt/linux-x86_64/sysroot/usr/include。注意linux-x86_64部分可能因你的宿主机系统而异。因此更完整的编译命令应该是这样的./bin/clang ../test_hello.cpp -o test_hello \ -I$INSTALL_DIR/include/c/v1 \ -I$ANDROID_NDK/toolchains/llvm/prebuilt/linux-x86_64/sysroot/usr/include \ -I$ANDROID_NDK/toolchains/llvm/prebuilt/linux-x86_64/sysroot/usr/include/aarch64-linux-android \ -L$INSTALL_DIR/lib \ -L$ANDROID_NDK/toolchains/llvm/prebuilt/linux-x86_64/sysroot/usr/lib/aarch64-linux-android/24 \ -target aarch64-linux-android24 \ -stdliblibc \ -pie这个命令做了以下几件事-I: 添加头文件搜索路径覆盖了我们自己的libc头文件和Android系统头文件。-L: 添加库文件搜索路径指向我们编译的libc库和Android NDK中对应API级别24的系统库。-target: 明确指定目标平台。-stdliblibc: 强制使用LLVM的libc标准库。-pie: 生成位置无关的可执行文件。5.3 推送到设备并运行编译成功后使用adb将可执行文件推送到已连接的Android设备确保已开启USB调试adb push test_hello /data/local/tmp/ adb shell chmod x /data/local/tmp/test_hello adb shell /data/local/tmp/test_hello如果一切顺利你将在终端看到输出Hello from custom LLVM Clang on Android!以及1 2 3 4 5。恭喜你这意味着你亲手打造的LLVM工具链已经完全可以在Android设备上编译和运行C程序了5.4 可能遇到的“拦路虎”与解决思路在实际验证中你可能会遇到链接器错误比如找不到libc_shared.so。这是因为程序动态链接了libc库但设备上没有。解决方法有两种静态链接在编译时加上-static-libstdc对于libc更准确的可能是-stdliblibc -static或者修改CMake配置使用-DANDROID_STLc_static重新编译工具链。这样会把标准库代码打包进可执行文件体积会变大但部署简单。推送共享库到设备将$INSTALL_DIR/lib/libc_shared.so也推送到设备上并设置LD_LIBRARY_PATH环境变量或者将其放到系统库路径下。在adb shell中执行adb push $INSTALL_DIR/lib/libc_shared.so /data/local/tmp/ adb shell cd /data/local/tmp LD_LIBRARY_PATH. ./test_hello另一个常见问题是缺少libclang_rt.builtins-aarch64-android.a等编译器运行时库。这通常是因为compiler-rt项目没有正确编译或安装。请回头检查你的CMake配置中是否包含了compiler-rt并确保编译过程没有报错。这些运行时库对于处理某些底层操作如64位除法、内存操作等是必需的。整个流程走下来虽然步骤不少但每一步都有其明确的目的。自己编译工具链最大的收获除了得到一套完全符合预期的工具更是对整个Android C编译生态的理解加深了一层。以后再遇到奇怪的链接错误或ABI问题你就能更从容地从工具链层面去分析和解决了。这套自己打造的“神兵利器”将成为你在Android原生开发领域深入探索的坚实后盾。