Android 通过JNI调用三方so 高效教程

引言

在Android开发中，JNI（Java Native Interface）技术允许Java代码与本地代码（如C/C++）进行交互，这是一种强大的功能，尤其在需要使用第三方本地库（.so文件）时。虽然网络上关于如何引入第三方.so文件和头文件的资料较多，但信息往往零散且缺乏清晰度。本文旨在提供一份详尽的指南，帮助开发者更加顺畅地进行JNI开发。

准备工作

在开始之前，确保你的开发环境已经准备就绪：

NDK配置 ：Android Studio中的NDK是进行JNI开发不可或缺的。需要注意的是，使用较新的NDK版本时，可能会发现toolchains目录缺少某些内容，这是因为Google已经废弃了部分工具链。如果你的项目较旧，可能需要下载并添加这些缺失的工具链。
CMake和CPP环境 ：进行JNI开发通常意味着你已经有了这些工具。这里简要说明一下目录结构：可以在main目录下创建一个cpp文件夹用于存放CPP文件，而CMake脚本则放在app目录下。

在build.gradle中配置JNI

在defaultConfig闭包内，添加对外部本地构建的配置，例如生成armeabi-v7a格式的库。如果需要支持其他架构，可以在此处添加。
arduino 复制代码
```
gradleCopy code
externalNativeBuild {
    cmake {
        cppFlags ""
        abiFilters 'armeabi-v7a'
    }
}
```

在android闭包内配置CMake的路径和版本。

lua 复制代码

gradleCopy code
externalNativeBuild {
    cmake {
        path "CMakeLists.txt"
        version "3.10.2"
    }
}

设置源集以包含共享库。

css 复制代码

gradleCopy code
sourceSets {
    main {
        jniLibs.srcDirs = ['src/main/jniLibs']
    }
}

文件放置

so文件 ：在main目录下建立一个jniLibs文件夹，在其下创建对应的架构文件夹（例如armeabi-v7a），并将第三方.so文件放入相应的文件夹。
头文件 ：在cpp目录下创建一个include文件夹，用于存放第三方头文件。

编写CMake脚本

CMake是一个跨平台的自动化构建系统，它使用CMakeLists.txt文件来描述构建过程。对于JNI开发而言，正确配置CMake是关键步骤之一，以下是对CMake脚本配置的详细解析。

基础设置

scss 复制代码

cmake_minimum_required(VERSION 3.4.1)

此行指定了构建本地库所需的最低CMake版本，确保了构建过程的兼容性。

添加本地库

vbnet 复制代码

add_library(
    native-lib
    SHARED
    src/main/cpp/native-lib.cpp
)

add_library命令用于定义一个新的库（native-lib），并指定它是一个共享库（SHARED），源文件位于src/main/cpp/native-lib.cpp。
对于每一个第三方库，你需要使用add_library并设置IMPORTED标志，表明这个库是预先存在的，而非由当前的CMake脚本编译生成。

引入第三方共享库

bash 复制代码

add_library(test SHARED IMPORTED)
set_target_properties(gmpfprojectorfocusmanager_hidl PROPERTIES IMPORTED_LOCATION ${CMAKE_SOURCE_DIR}/src/main/jniLibs/${ANDROID_ABI}/libtest.so)

第一行声明了一个名为test的共享库，并标记为IMPORTED，即它是外部导入的。
set_target_properties用于设置这个库的属性。这里，IMPORTED_LOCATION属性指明了库文件的实际位置，${CMAKE_SOURCE_DIR}是CMakeLists.txt文件所在的目录，${ANDROID_ABI}自动对应于构建的目标架构。

添加第三方头文件

bash 复制代码

target_include_directories(native-lib PRIVATE ${CMAKE_SOURCE_DIR}/src/main/cpp/include)

该命令将第三方库的头文件目录添加到native-lib的编译时搜索路径中。PRIVATE指定了这些头文件仅在编译native-lib时使用，不会影响其他目标。

链接库

bash 复制代码

target_link_libraries(
    native-lib
    test
    ${log-lib}
)

target_link_libraries命令用于指定native-lib需要链接哪些库。这里，除了之前声明的第三方库外，还有log-lib，一个常用的日志库，通常包含在NDK中。

实践提示

当引入多个第三方库时，对于每个库重复上述add_library和set_target_properties的步骤。
确保CMakeLists.txt文件中的路径和库名与实际匹配，特别是架构目录（如armeabi-v7a）和库文件名。
使用target_include_directories为你的代码提供正确的头文件路径，这对解决编译时的未找到声明或定义的错误至关重要。

结语

通过以上步骤，我们提供了一份详细而清晰的指南，旨在帮助Android开发者顺利引入和使用第三方本地库。记住，实践是学习的关键，不要害怕深入代码和配置中去寻找解决问题的方法。