NDK--CMakeLists配置第三方so库

当我们创建一个NDK工程时，会自动创建一个CMakeLists.txt的文件，在AS中c++的编译器是使用LLVM，规则为cmake，今天来学习下cmake的基本套路

首先，我创建了两个NDK工程，第一个工程为lib，为第二个工程提供so库

我们修改cpp文件，新增一个求和方法

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

int sum(int a, int b) {
    return a + b;
}

由于我们这个工程要提供so库，所以在CMakeLists中改下编译出来的so库名称：test-lib

编译下，找到生成的so库文件夹，复制到第二个工程

如果想要指定平台可以在gradle中配置：

在defaultConfig目录里面
ndk {
abiFilters "armeabi","x86"
}

复制到libs下

AS中默认存放so库的目录需要在src/main中创建一个jniLibs的文件夹，也可以通过gradle配置，指定目录

在app.gralde中的android目录下
sourceSets.main {
jniLibs.srcDirs = ['libs']
jni.srcDirs = []
}

这边使用的是libs目录作为so库的存放目录，接下来我们来配置第二个工程的CMakeLists

1.首先，为了以后方便使用，我们为so库的路径设置一个别名

#设置so库路径
set(my_lib_path ${CMAKE_SOURCE_DIR}/../../../libs)

${CMAKE_SOURCE_DIR}为CMakeLists文件的当前路径，以后我们就可以直接使用my_lib_path了

2.第二步，我们配置导入的so库

#将第三方库作为动态库引用
add_library(test-lib
        SHARED
        IMPORTED)

这边我们只需要修改库的名称(test-lib)就可以了，其他的复制粘贴

3.第三步，配置第三方库的路径，这边就要用到我们开始定义的my_lib_path别名了

#指定第三方库的绝对路径
set_target_properties(test-lib
        PROPERTIES IMPORTED_LOCATION
        ${my_lib_path}/${ANDROID_ABI}/libtest-lib.so)

同样的，我们只需要关注上一步定义好的名称和连接的so库的绝对路径，另外，关于${ANDROID_ABI}的说明：系统会自动根据apk安装时的平台，自动将相应平台下的so库导入

4.最后在target_link_libraries中添加第三方库名称

target_link_libraries( # Specifies the target library.
        native-lib
        test-lib
        
        # Links the target library to the log library
        # included in the NDK.
        ${log-lib})

完整CMakeLists：

cmake_minimum_required(VERSION 3.4.1)

#设置so库路径
set(my_lib_path ${CMAKE_SOURCE_DIR}/libs)

#将第三方库作为动态库引用
add_library(test-lib
        SHARED
        IMPORTED)

#指定第三方库的绝对路径
set_target_properties(test-lib
        PROPERTIES IMPORTED_LOCATION
        ${my_lib_path}/${ANDROID_ABI}/libtest-lib.so)

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)

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)

target_link_libraries( # Specifies the target library.
        native-lib
        test-lib
        
        # Links the target library to the log library
        # included in the NDK.
        ${log-lib})

接下来，我们开始使用导入的库中的方法：求和方法

1.首先，创建一个.h文件，声明导入方库的方法：

//
// Created by aruba on 2020/4/13.
//
#ifndef NDKAPPLICATION_TEST_LIB_H
#define NDKAPPLICATION_TEST_LIB_H

//申明外部 函数 外部属性
extern int sum(int a, int b);

#endif //NDKAPPLICATION_TEST_LIB_H

2.在需要使用的cpp中引入头文件，并调用

#include <jni.h>
#include <string>
#include <android/log.h>
#include <assert.h>
#include "test-lib.h"

#define TAG "C++"
#define LOGI(...) __android_log_print(ANDROID_LOG_INFO, TAG, __VA_ARGS__)
#define NELEM(x) ((int) (sizeof(x) / sizeof((x)[0])))

extern "C"
JNIEXPORT jstring JNICALL native_stringFromJNI(JNIEnv *env, jclass type) {

    return env->NewStringUTF("C++");
}

JNIEXPORT jint JNICALL native_sum(JNIEnv *env, jclass type, jint a, jint b) {

    return sum(a, b);
}

static const JNINativeMethod gMethods[] = {
        {
                "stringFromJNI", "()Ljava/lang/String;", (void *) native_stringFromJNI
        },
        {
                "sum", "(II)I", (void *) native_sum
        }
};

static int registerNatives(JNIEnv *env) {
    LOGI("registerNatives begin");
    jclass clazz;
    //找到java的类
    clazz = env->FindClass("com/aruba/ndkapplication/JniUtils");

    if (clazz == NULL) {
        LOGI("clazz is null");
        return JNI_FALSE;
    }

    if (env->RegisterNatives(clazz, gMethods, NELEM(gMethods)) < 0) {
        LOGI("RegisterNatives error");
        return JNI_FALSE;
    }

    return JNI_TRUE;
}

JNIEXPORT jint JNI_OnLoad(JavaVM *vm, void *reserved) {
    LOGI("jni_OnLoad begin");

    JNIEnv *env = NULL;

    if (vm->GetEnv((void **) &env, JNI_VERSION_1_4) != JNI_OK) {
        LOGI("ERROR: GetEnv failed\n");
        return -1;
    }

    assert(env != NULL);

    registerNatives(env);

    return JNI_VERSION_1_4;
}

在java中调用

package com.aruba.ndkapplication;

public class JniUtils {
    static {
        System.loadLibrary("native-lib");
    }
    
    public static native String stringFromJNI();

    public static native int sum(int a, int b);
}

public class MainActivity extends AppCompatActivity {

    @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(JniUtils.sum(10, 20) + "");
    }

}

Demo地址：https://gitee.com/aruba/NDKApplication.git