如何在Android Studio CMake项目中链接第三方静态库并实现JNI调用

嘿，作为CMake新手遇到这种链接问题太正常了，我来帮你一步步搞定这两个问题——先讲通用的静态库链接方法，再针对你的arm64-v8a静态库+JNI场景给出具体修正方案！

一、通用步骤：将第三方静态库链接到CMake项目 #

如果你以后再遇到类似的静态库链接需求，记住这几个核心步骤：

• 放置静态库：建议按CPU架构分类存放，比如把mylib.a放到cpp/arm64-v8a/目录下（方便CMake针对不同架构匹配库），当然你也可以直接放在cpp根目录，但分架构更规范。
• 声明预构建静态库：用add_library的IMPORTED关键字告诉CMake这是已经编译好的库，不是需要编译的源码文件。
• 指定静态库的实际路径：通过set_target_properties设置IMPORTED_LOCATION，明确告诉CMake这个预构建库的位置。
• 链接到你的目标共享库：在target_link_libraries里把静态库和你的JNI共享库关联起来。

二、针对你的场景的具体解决方案 #

1. 修正你的CMakeLists.txt #

你之前的CMakeLists.txt最大的问题是把预构建的mylib.a当成了普通源码库来处理，没有用IMPORTED关键字。下面是修正后的完整代码，我加了详细注释：

# 设置CMake最低版本要求
cmake_minimum_required(VERSION 3.4.1)

# 1. 声明你的JNI共享库（native-lib）
add_library(
    native-lib
    SHARED
    native-lib.cpp  # 你的JNI包装器源码
)

# 2. 声明预构建的静态库mylib（IMPORTED关键字是关键！）
add_library(
    mylib
    STATIC
    IMPORTED  # 告诉CMake这是已经编译好的导入库
)

# 3. 设置mylib的实际路径，这里对应arm64-v8a架构的库
set_target_properties(
    mylib
    PROPERTIES IMPORTED_LOCATION
    ${CMAKE_SOURCE_DIR}/arm64-v8a/mylib.a  # 注意路径：如果你的库在cpp根目录，就改成${CMAKE_SOURCE_DIR}/mylib.a
)

# 找到NDK自带的log库（用于日志输出）
find_library(
    log-lib
    log
)

# 4. 把native-lib和mylib、log库链接起来
target_link_libraries(
    native-lib
    mylib  # 直接引用我们声明的mylib
    ${log-lib}
)

注意：如果你的mylib.a直接放在cpp目录下，把${CMAKE_SOURCE_DIR}/arm64-v8a/mylib.a改成${CMAKE_SOURCE_DIR}/mylib.a就行；如果要支持多架构，建议用CMAKE_ANDROID_ARCH_ABI变量来动态匹配路径，比如${CMAKE_SOURCE_DIR}/${CMAKE_ANDROID_ARCH_ABI}/mylib.a。

2. JNI包装器的实现（native-lib.cpp） #

假设你的mylib.a里有一个主函数int mylib_main(const char* input)，下面是JNI包装器的示例代码，它会调用这个函数并把结果传递给Java层：

#include <jni.h>
#include <string>
// 引入mylib的头文件（你需要有对应的头文件mylib.h，放到cpp目录下）
#include "mylib.h"

extern "C" JNIEXPORT jstring JNICALL
Java_com_your_package_name_MainActivity_getResultFromMylib(
        JNIEnv* env,
        jobject /* this */, jstring input_str) {
    // 把Java字符串转成C字符串
    const char* input = env->GetStringUTFChars(input_str, nullptr);
    
    // 调用mylib的主函数
    int result = mylib_main(input);
    
    // 释放Java字符串的C指针
    env->ReleaseStringUTFChars(input_str, input);
    
    // 把结果转成Java字符串返回
    std::string output = "mylib返回结果：" + std::to_string(result);
    return env->NewStringUTF(output.c_str());
}

注意：一定要把mylib的头文件（比如mylib.h）放到cpp目录下，否则编译器找不到函数声明会报错。

3. 编译验证 #

修改完CMakeLists.txt和native-lib.cpp后，点击Android Studio的"Sync Project with Gradle Files"，然后尝试编译。如果还有错误，检查这几点：

• 静态库的路径是否正确，是否和CMake里的IMPORTED_LOCATION一致；
• 静态库的架构（arm64-v8a）是否和你当前编译的ABI匹配（在Build Variants里查看）；
• 是否包含了静态库对应的头文件。

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