目标

用CMake方法实现在java中调用本地C/C++文件中的方法，并生成相应so库导出。

实现步骤梳理

1. 在需要调用本地方法的java文件中加载so库，并声明本地函数。
2. 新建与java同级的cpp文件夹，在其中新建c/c++文件，实现本地方法。
3. 新建CMakeList.txt文件，在其中作相应so库名称、C文件路径等相关配置。
4. 在build.gradle中配置CMakeList.txt文件路径、ABI类别等。
5. 编译运行，在app/build/intermediates/cmake/debug/obj路径下即可找到生成的so库。

具体实现

1.在需要调用本地方法的java文件中加载so库，并声明本地函数。

package com.example.taoying.testndkapp;

import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.TextView;

public class MainActivity extends AppCompatActivity {

    // Used to load the 'native-lib' library on application startup.
    static {
        System.loadLibrary("native-lib");//加载so库，待加载的so库的名称为libnative-lib.so。
    }

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // Example of a call to a native method
        TextView tv = findViewById(R.id.sample_text);
        tv.setText(stringFromJNIwithp("11"));
    }

    /**
     * A native method that is implemented by the 'native-lib' native library,
     * which is packaged with this application.
     */
    public native String stringFromJNI();//本地方法用native修饰


    public native String stringFromJNIwithp(String a);
}

注意两点：

• System.loadLibrary("native-lib");加载so库，so库的名称为libnative-lib.so。
• 本地函数用native修饰。

2.新建与java同级的cpp文件夹，在其中新建c/c++文件，实现本地方法。

本地新建cpp文件夹和相应文件.png

native-lib.cpp

#include <jni.h>
#include <string>

extern "C" JNIEXPORT jstring JNICALL
Java_com_example_taoying_testndkapp_MainActivity_stringFromJNI(
        JNIEnv* env,
        jobject /* this */) {
    std::string hello = "Hello from C++";
    return env->NewStringUTF(hello.c_str());
}


extern "C" JNIEXPORT jstring JNICALL Java_com_example_taoying_testndkapp_MainActivity_stringFromJNIwithp
        (JNIEnv * env, jobject /* this */, jstring jstring1){
    std::string hello = "stringFromJNIwithp";
    return env->NewStringUTF(hello.c_str());
}

• 本地函数名的格式需要遵循如下规则：Java_包名类名方法名，否则该方法将无法被找到。
• JNIEnv* 表示一个指向JNI环境的指针，可以通过他来访问JNI提供的接口方法。
• jobject表示Java对象中的this（如果该方法是非静态方法）或者Class对象（如果该方法是static方法）。
• JNIEXPORT和JNICALL是JNI中定义的宏，可以在jni.h这个头文件中找到。JNIEXPORT确保函数在符号表中可见， JNICALL确保函数使用正确的调用约定。

3.新建CMakeList.txt文件，在其中作相应so库名称、C文件路径等相关配置。

CMakeLists.txt

# For more information about using CMake with Android Studio, read the
# documentation: https://d.android.com/studio/projects/add-native-code.html

# Sets the minimum version of CMake required to build the native library.

cmake_minimum_required(VERSION 3.4.1)

# Creates and names a library, sets it as either STATIC
# or SHARED, and provides the relative paths to its source code.
# You can define multiple libraries, and CMake builds them for you.
# Gradle automatically packages shared libraries with your APK.
//add_library表示生成静态链接库libnative-lib.so
//native-lib 即为生成库的名称
//SHARED 表示生成动态库libnative-lib.so， STATIC表示生成静态库libnative-lib.a。
//native-lib.cpp 表示c/c++源文件的路径。
//${CMAKE_SOURCE_DIR}：表示CMakeLists.txt的当前文件夹路径。
add_library( # Sets the name of the library.
             native-lib

             # Sets the library as a shared library.
             SHARED

             # Provides a relative path to your source file(s).
             native-lib.cpp )

# Searches for a specified prebuilt library and stores the path as a
# variable. Because CMake includes system libraries in the search path by
# default, you only need to specify the name of the public NDK library
# you want to add. CMake verifies that the library exists before
# completing its build.

find_library( # Sets the name of the path variable.
              log-lib

              # Specifies the name of the NDK library that
              # you want CMake to locate.
              log )

# Specifies libraries CMake should link to your target library. You
# can link multiple libraries, such as libraries you define in this
# build script, prebuilt third-party libraries, or system libraries.
//需要加载的so库,需要加载多个时用空格" "连接
target_link_libraries( # Specifies the target library.
                       native-lib

                       # Links the target library to the log library
                       # included in the NDK.
                       ${log-lib} )

这里有更多关于CMakeList.txt的编写规则的介绍。

4.在build.gradle中配置CMakeList.txt文件路径、ABI类别等。

apply plugin: 'com.android.application'

android {
    compileSdkVersion 28
    defaultConfig {
        applicationId "com.example.taoying.testndkapp"
        minSdkVersion 15
        targetSdkVersion 28
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
        externalNativeBuild {
            cmake {
                //代表编译C++代码时用的编译选项
                //如cppFlags "-frtti -fexceptions" 配置支持RTTI和C++异常处理（这个非必须 也可以不配）
                cppFlags ""
            }
        }
        ndk {
            //配置ABI类别，注意这里配置的Cpu类型在编译后会生成相应的so动态库，不配置默认生成所有
            //生成的so库在C:\Users\taoying\Desktop\TestNdkApp\app\build\intermediates\cmake\debug\obj\arm64-v8a\libnative-lib.so路径下
            abiFilters "arm64-v8a"
        }
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
    externalNativeBuild {
        // 指定CMake编译配置文件路径
        cmake {
            path "src/main/cpp/CMakeLists.txt"
            version "3.10.2"
        }
    }

    //可选配置
    /*sourceSets.main {
        //默认so库放在src/main/jniLibs目录下，此时可以制定新的存放so库的目录
        jniLibs.srcDirs = ['libs']
    }*/
}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'com.android.support:appcompat-v7:28.0.0'
    implementation 'com.android.support.constraint:constraint-layout:1.1.3'
    testImplementation 'junit:junit:4.12'
    androidTestImplementation 'com.android.support.test:runner:1.0.2'
    androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'
}

5. 编译运行，在app/build/intermediates/cmake/debug/obj路径下即可找到生成的so库。

so库路径.png

更多JNI&NDK系列文章，参见：
JNI&NDK开发最佳实践（一）：开篇
JNI&NDK开发最佳实践（二）:CMake实现调用已有C/C++文件中的本地方法
JNI&NDK开发最佳实践（三）：CMake实现调用已有so库中的本地方法
JNI&NDK开发最佳实践（四）:JNI数据类型及与Java数据类型的映射关系
JNI&NDK开发最佳实践（五）:本地方法的静态注册与动态注册
JNI&NDK开发最佳实践（六）：JNI实现本地方法时的数据类型转换
JNI&NDK开发最佳实践（七）：JNI之本地方法与java互调
JNI&NDK开发最佳实践（八）：JNI局部引用、全局引用和弱全局引用
JNI&NDK开发最佳实践（九）：调试篇