需求背景

别部门做C语言开发的同学开发了一个库，需要给我们Android端去调用。
我们拿到源码，首先需要做的是通过CMake去把C源码编译链接成动态库。

当然静态库也行，看项目需求吧。不过大部分都是编译动态库，不理解动态库和静态库概念的同学可以翻看我的Linux专栏，里面有详细的介绍。

然后就是通过编写JNI代码去调用这个.so库。

我们作为Android开发工程师，要把输出的.so目标文件和调用这个.so文件的Java代码封装给别的不懂JNI的Android开发同学。

基于上述场景和需求。
我们输出的产物需要有：一个.so库（跟进不同cpu架构一共有4种不同的目标文件）+ 一个.jar文件。

本文介绍的是如何生成对应的.jar文件。关于JNI和CMake的知识可以查看我专栏的其他博文。

目录结构

首先，这个模块是个library，结构如下：

由于JNI代码，Java的native方法映射到JNI中C++代码的方法是通过包名+方法名映射的，包名不一样会导致无法调用.so库的代码。

Java层的native方法：

JNI层的C++方法：

所以我们需要做的是把Java层用于调用JNI层的代码打包起来，作为jar包提供给外部。

gradle结构

plugins {
    id 'com.android.library'
}

android {
    namespace 'com.xxx.nativelib'
    compileSdk 33

    defaultConfig {
        minSdk 24
        targetSdk 33

        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
        consumerProguardFiles "consumer-rules.pro"
        externalNativeBuild {
            cmake {
                cppFlags ""
            }
        }
    }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'),
                    'proguard-rules.pro'
        }
    }
    externalNativeBuild {
        cmake {
            path "src/main/cpp/CMakeLists.txt"
            version "3.22.1"
        }
    }
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }

    lintOptions {
        abortOnError false
    }
}

//定义一个makeJar任务
task makeJar(type: Copy) {
    //删除存在的
    delete 'build/libs/KsnetSecurity.jar'

    //from这个语法是将aar_main_jar目录下的release目录下的classes.jar文件拷贝到build/libs/目录下
    //设置拷贝的文件,build/intermediates/aar_main_jar/release/目录下的classes.jar
    from('build/intermediates/aar_main_jar/release/')

    //into表示 classes.jar打进jar包后的文件目录
    // build/libs/表示classes.jar打进jar包后的文件目录
    //将classes.jar放入build/libs/目录下
    into('build/libs/')

    //include表示的是我们只关心classes.jar这个文件
    include('classes.jar')
    //重命名
    rename ('classes.jar', 'xxxxx.jar')
}

//作用是在执行makeJar任务之前，先执行build任务
makeJar.dependsOn(build)

dependencies {
    testImplementation 'junit:junit:4.13.2'
    androidTestImplementation 'androidx.test.ext:junit:1.1.5'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'
}

makeJar的语法解析

//定义一个makeJar任务
task makeJar(type: Copy) {
    //删除存在的
    delete 'build/libs/KsnetSecurity.jar'

    //from这个语法是将aar_main_jar目录下的release目录下的classes.jar文件拷贝到build/libs/目录下
    //设置拷贝的文件,build/intermediates/aar_main_jar/release/目录下的classes.jar
    from('build/intermediates/aar_main_jar/release/')

    //into表示 classes.jar打进jar包后的文件目录
    // build/libs/表示classes.jar打进jar包后的文件目录
    //将classes.jar放入build/libs/目录下
    into('build/libs/')

    //include表示的是我们只关心classes.jar这个文件
    include('classes.jar')
    //重命名
    rename ('classes.jar', 'xxxxx.jar')
}

//作用是在执行makeJar任务之前，先执行build任务
makeJar.dependsOn(build)

这里的makeJar代码用于定义一个名为makeJar的任务。

1. 任务依赖关系：

   makeJar.dependsOn(build)
   

   此语句表示在执行makeJar任务之前，需要先执行build任务。dependsOn是Gradle中用于定义任务之间依赖关系的方法，确保在执行makeJar之前，build任务已经成功执行。

2. 定义makeJar任务：

   task makeJar(type: Copy) {
   

   这部分定义了一个名为makeJar的任务，它的类型是Copy，这意味着它是一个拷贝任务，用于复制文件。

3. 删除已存在的文件：

   delete 'build/libs/KsnetSecurity.jar'
   

   此语句表示在执行makeJar任务之前，删除已存在的build/libs/xxxxx.jar文件。

4. 设置拷贝源和目标：

   from('build/intermediates/aar_main_jar/release/')
   into('build/libs/')
   

   这两行语句设置了拷贝的源目录和目标目录。from表示从指定目录拷贝文件，into表示将文件拷贝到指定目录。

5. 指定拷贝文件及重命名：

   include('classes.jar')
   rename ('classes.jar', 'xxxxx.jar')
   

   include指定了需要拷贝的文件（此处是classes.jar），而rename则指定了拷贝到目标目录后的重命名规则，将classes.jar重命名为xxxxx.jar。
   这个脚本的主要目的是在执行makeJar任务之前，先执行build任务，并在执行makeJar任务时，进行文件拷贝和重命名，生成最终的JAR文件。

执行makeJar 任务

点击左上方的三角形按钮，既可以开始构建和运行任务。

拿到jar包

在build文件夹下的libs目录可以找到生成的jar包：