Android平台带JNI封装的闭源C++引擎库最优打包结构问询

阿华AIGC实验室

2026-5-21

核心方案：打包为Android Archive (AAR) 库模块

作为经常分发Android闭源库的开发者，我可以明确告诉你：AAR是这个场景下的标准最优解，能把所有组件（JNI封装层Java代码、多架构的libengine.so和libfft.so）打包成一个单一文件，让开发者集成的工作量降到最低——他们甚至不需要手动处理任何.so文件，只需要依赖你的AAR就能调用封装好的Java API。

具体实现步骤

1. 创建Android Library模块

先在你的项目里新建一个Android Library模块（不要选Application），这个模块是你封装所有内容的容器：

把你的JNI封装层Java代码（比如com/yourcompany/engine/EngineWrapper.java）放到模块的src/main/java/目录下，确保代码里正确加载依赖的so（注意加载顺序，因为libengine.so依赖libfft.so，所以先加载后者）：

public class EngineWrapper {
    static {
        System.loadLibrary("fft");
        System.loadLibrary("engine");
        // 如果你的封装层还有单独的wrapper.so，也在这里加载：System.loadLibrary("wrapper");
    }

    // 对外暴露的API方法，比如：
    public native float[] performFFT(float[] input);
}

把所有架构的.so文件按规范放到模块的src/main/jniLibs/目录下（Library模块完全支持这个目录，你之前的误解可能是路径没放对），目录结构如下：

your-library-module/
└── src/
    └── main/
        ├── jniLibs/
        │   ├── armeabi-v7a/
        │   │   ├── libengine.so
        │   │   └── libfft.so
        │   ├── arm64-v8a/
        │   │   ├── libengine.so
        │   │   └── libfft.so
        │   ├── x86/
        │   │   ├── libengine.so
        │   │   └── libfft.so
        │   └── x86_64/
        │       ├── libengine.so
        │       └── libfft.so
        └── java/
            └── com/
                └── yourcompany/
                    └── engine/
                        └── EngineWrapper.java

2. 配置模块的构建脚本

在Library模块的build.gradle（或build.gradle.kts）里做简单配置，确保打包正确：

确认插件是com.android.library：

plugins {
    id 'com.android.library'
}

指定要打包的ABI架构（和你准备的so对应）：

android {
    compileSdk 34

    defaultConfig {
        minSdk 21 // 根据你的兼容需求调整
        targetSdk 34

        ndk {
            abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
        }
    }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

3. 构建并分发AAR

点击Android Studio顶部的Build -> Make Module 'your-library-module'，构建完成后，在模块的build/outputs/aar/目录下找到your-library-module-release.aar（一定要用release版本分发，避免调试信息）。
开发者的集成方式：
- 本地导入：让开发者把AAR复制到他们项目的libs/目录，然后在app模块的build.gradle里添加依赖：
```
dependencies {
    implementation files('libs/your-library-module-release.aar')
}
```
- Maven仓库分发（更适合后续更新）：把AAR发布到私有Maven仓库，开发者只需要添加仓库地址和一行依赖：
```
repositories {
    maven { url 'https://your-private-maven-repo.com' }
}

dependencies {
    implementation 'com.yourcompany:engine-library:1.0.0'
}
```

为什么这个方案最简洁？

完全封装底层细节：开发者看不到libengine.so和libfft.so，只需要调用你提供的Java API，不会出现漏加so、加载顺序错误的问题。
自动适配多架构：Android Studio会自动根据开发者的打包配置（比如App Bundle或APK拆分），为目标设备提取对应架构的so，无需开发者手动处理。
单一文件分发：不管有多少个so，最终只需要交付一个AAR文件，传输和集成都极其方便。