Android JNI与CMake集成第三方so库实战指南

1. 环境准备与基础配置

在开始集成第三方so库之前，我们需要确保开发环境已经正确配置。Android Studio是主要的开发工具，NDK（Native Development Kit）和CMake则是必不可少的组件。NDK允许我们在Android应用中使用C和C++代码，而CMake则是一个跨平台的构建工具，用于管理编译过程。

首先，打开Android Studio，确保已经安装了NDK和CMake。你可以在SDK Manager中的"SDK Tools"选项卡中检查并安装它们。选择最新的稳定版本，但要注意，某些旧项目可能需要特定版本的NDK，这时你可以从官网下载并手动配置。

接下来，在项目的build.gradle文件中配置NDK和CMake。在android块中，添加以下代码来指定CMake的版本和路径：

android {
    ...
    externalNativeBuild {
        cmake {
            path "CMakeLists.txt"
            version "3.22.1"
        }
    }
}

这里的version应该与你安装的CMake版本一致。建议使用较新的版本，因为它们通常包含更好的性能和更多的功能。

在defaultConfig中，我们还需要指定生成的so库的目标ABI（Application Binary Interface）。常见的ABI包括armeabi-v7a、arm64-v8a、x86和x86_64。你可以根据需求选择支持的架构：

defaultConfig {
    ...
    externalNativeBuild {
        cmake {
            cppFlags ""
            abiFilters 'armeabi-v7a', 'arm64-v8a'
        }
    }
}

只选择你需要的ABI可以减少APK的大小。例如，如果你的应用主要针对现代设备，可以只包含arm64-v8a。

最后，设置jniLibs的源目录，这样Gradle在打包时会将so库包含进去。在sourceSets中配置：

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

这样，我们就完成了基础的环境配置。接下来，我们将重点放在项目结构和文件放置上。

2. 项目结构与文件放置

正确的项目结构对于集成第三方so库至关重要。一个清晰的结构不仅能简化配置过程，还能避免许多常见的路径错误。在Android项目中，Native代码和资源文件应该放在特定的目录下，以便构建系统能够自动识别和处理。

首先，在src/main目录下创建cpp文件夹，用于存放C/C++源文件和头文件。这是Android Studio默认的Native代码目录，CMake会自动从这里查找源文件。如果你有多个模块或复杂的代码结构，可以在这里创建子目录来组织代码。

对于第三方so库，我们需要在src/main下创建jniLibs文件夹。在这个文件夹中，为每个支持的ABI创建子文件夹，例如armeabi-v7a、arm64-v8a等。将对应的so文件放入相应的文件夹中。例如，如果你有一个名为libtest.so的库，它应该放在src/main/jniLibs/armeabi-v7a/libtest.so。

第三方头文件应该放在cpp目录下的include文件夹中。你可以根据库的名称或功能进一步组织头文件。例如，如果库名为test，可以创建src/main/cpp/include/test目录，并将所有头文件放在这里。这样，在CMake配置中，我们可以清晰地指定头文件的路径。

以下是一个示例项目结构：

src/
└── main/
    ├── cpp/
    │   ├── include/
    │   │   └── test/
    │   │       └── test.h
    │   └── native-lib.cpp