android studio之外使用NDK编译生成android指定架构的动态库

通过CMake配置生成Android所需的指定架构.so文件，并将其正确集成到Android项目中，需结合NDK工具链和Gradle构建流程的协同作用。以下是关键要点及操作建议：

1. CMake配置生成指定架构.so的核心条件

工具链文件必须显式声明

您提供的配置片段中缺少了CMAKE_TOOLCHAIN_FILE的设置，这是NDK交叉编译的核心参数。正确的配置应通过-DCMAKE_TOOLCHAIN_FILE指定NDK的工具链文件路径：
cmake 复制代码
```
set(CMAKE_TOOLCHAIN_FILE "${CMAKE_ANDROID_NDK}/build/cmake/android.toolchain.cmake")
```
否则CMake无法识别Android平台的交叉编译规则 $citation:9$ 。
ABI与API级别的绑定

您的配置使用CMAKE_ANDROID_ARCH_ABI设置架构，但需同时指定ANDROID_PLATFORM（如-DANDROID_NATIVE_API_LEVEL=21）以确保生成的.so兼容目标Android版本。NDK的API级别决定了系统库的可用性，例如arm64-v8a至少需要API 21以上 $citation:5$ $citation:9$ 。
输出路径需符合Gradle规范

您设置CMAKE_LIBRARY_OUTPUT_DIRECTORY为out/jniLibs，但Android Studio的externalNativeBuild默认将.so生成至build/intermediates/cxx目录。若需自定义路径，需在build.gradle中通过android.externalNativeBuild.cmake同步配置：
gradle 复制代码
```
externalNativeBuild {
    cmake {
        path "CMakeLists.txt"
        arguments "-DCMAKE_LIBRARY_OUTPUT_DIRECTORY=$projectDir/src/main/jniLibs"
    }
}
```
否则手动移动文件可能破坏Gradle的自动化流程 $citation:1$ $citation:3$ 。

2. 是否需要手动移动.so文件到`jniLibs`目录？

标准流程无需手动操作

如果通过Android Studio的externalNativeBuild配置CMake（如在build.gradle中声明path "CMakeLists.txt"），Gradle会自动将生成的.so文件按ABI分类放入app/build/intermediates/cmake/目录，并最终打包到APK的lib/ABI/路径下，无需手动移动 $citation:1$ $citation:3$ 。
特殊情况需手动干预

仅在以下场景需要手动操作：
1. 独立构建.so ：若使用命令行调用CMake（如cmake -B build -S . -DANDROID_ABI=arm64-v8a），需手动将生成的.so复制到app/src/main/jniLibs/ABI/目录 $citation:5$ $citation:9$ 。
2. 多模块依赖 ：若主项目依赖预编译的第三方.so库，需在CMakeLists.txt中通过IMPORTED_LOCATION指定其路径，而非手动移动 $citation:2$ 。

3. 完整配置示例与注意事项

标准CMakeLists.txt配置

cmake 复制代码

# 设置最小CMake版本与项目名称
cmake_minimum_required(VERSION 3.22)
project(NativeLib)

# 指定NDK工具链文件（关键！）
set(CMAKE_TOOLCHAIN_FILE "/home/mi/Android/Sdk/ndk/27.0.12077973/build/cmake/android.toolchain.cmake")

# 定义目标架构（可通过命令行传递，而非硬编码）
set(ANDROID_ABI "arm64-v8a")  # 可替换为 armeabi-v7a/x86/x86_64
set(ANDROID_PLATFORM "android-21")

# 启用C++特性与STL支持
set(CMAKE_ANDROID_STL_TYPE c++_shared)
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED YES)

# 添加QuickJS源码并生成静态库
add_library(quickjs STATIC ${QUICKJS_SRC})
target_include_directories(quickjs PUBLIC ${PROJECT_SOURCE_DIR}/include)

# 生成主共享库并链接依赖
add_library(native-lib SHARED src/native.cpp)
target_link_libraries(native-lib quickjs log m z)

Gradle配置（自动绑定ABI与输出目录）

gradle 复制代码

android {
    ...
    externalNativeBuild {
        cmake {
            path "CMakeLists.txt"
            arguments "-DFORCE_CONFIG_VERSION=\"2024-07-01\"", "-DANDROID_ABI=arm64-v8a"
        }
    }
    defaultConfig {
        ...
        ndk {
            abiFilters "arm64-v8a"  # Gradle仅构建指定ABI
        }
    }
}

关键注意事项

避免硬编码架构 ：ANDROID_ABI应通过abiFilters或命令行参数动态传递，而非在CMakeLists.txt中固定 $citation:1$ $citation:7$ 。
符号导出控制 ：若QuickJS代码中有导出函数（如JNIEXPORT），需确保POSITION_INDEPENDENT_CODE开启：
cmake 复制代码
```
set_target_properties(quickjs PROPERTIES POSITION_INDEPENDENT_CODE ON)
```
否则可能导致运行时符号解析失败 $citation:4$ 。

清理缓存与强制重建 ：

bash 复制代码

# 清理Android项目中的CMake缓存
rm -rf app/.cxx/Debug/2jf37e1c/arm64-v8a
# 强制Gradle重新生成.so
./gradlew cleanBuildCache && ./gradlew assembleDebug

旧缓存可能残留导致链接错误 $citation:3$ $citation:8$ 。

4. 常见误区与解决方案

误区1：直接使用系统CMake

Android NDK的CMake版本（如3.22）可能与系统全局CMake（如3.25）存在兼容性问题。应优先使用Android Studio内置的CMake：