Android——AS中集成cpp代码(CMake)

一、作用

第三方用 C++ 写好了一些功能，我们要在 Java 代码中调用它们。

二、概念

Android NDK开发扫盲及最新CMake的编译使用

（1）CMake 基本语法规则
Android NDK 开发：CMake 使用

（2）JNI 写法
强推-Android NDK开发：JNI实战篇

• JNI 调用 Java 对象的属性、方法

• Java 方法传参给 JNI 函数

（3）C语言基础
C语言基础及指针①基础语法

<>表示引入的是系统头文件，" "表示引入的是第三方头文件。

（4）JNI 的两种注册方式
Android NDK开发：JNI基础篇-静态注册
Android NDK开发：JNI实战篇-动态注册

（5）JNI 回调
Android JNI 篇 - JNI回调的三种方法（精华篇）

三、集成过程

0.第三方提供源代码

c_test.h和c_test.cpp

第三方提供给我们一个方法，返回一个字符串。

我们要把它集成进 AS 工程

1. 目录结构

最终的目录结构

（1）新建cpp文件夹
第三方提供的.cpp文件直接放在该目录下

（2）include文件夹
第三方给的.h格式的头文件都放在该目录下

（3）CMakeLists.txt
位于module根目录下，先新建个空文件放在这里占位，具体怎么写后面再说

2. Java 中编写native方法

（1）写native方法
新建一个类专门用于和 native 进行交互

public class SDKUtil {

    static {
        System.loadLibrary("ndkdemo-lib");
    }

    // 单例
    private static volatile SDKUtil instance;
    private SDKUtil(){

    }

    public static SDKUtil getInstance() {
        if (instance == null) {
            synchronized (SDKUtil.class) {
                if (instance == null) {
                    instance = new SDKUtil();
                }
            }
        }
        return instance;
    }
    
    // native 方法
    public static native String stringFromCpp();
}

（2）javac编译该类
将目录切换到sdk

（3）javah导出 JNI 头文件
将目录切换到java

3. 编写JNI方法

在cpp文件夹下新建一个cpp文件，命名随意，但为了好维护，我们把它和想要生成的so库的名称起得一致。

#include 
#include "cpp_test.h"
extern "C" JNIEXPORT jstring JNICALL
Java_com_example_myapplication_sdk_SDKUtil_stringFromCpp(
        JNIEnv *env,
        jclass type)
{
    const char * cppStr = cppFunction();
    return env->NewStringUTF(cppStr);
}

要加上extern "C"

4. CMakeList.txt

CMake将C++文件编译为so库，这些so库后续会被gradle打入apk包中

（1）填写CMake文件

cmake_minimum_required(VERSION 3.4.1)

add_definitions(-D ANDROID_PLATFORM)

#设置生成的so动态库最后输出的路径
set(CMAKE_LIBRARY_OUTPUT_DIRECTORY ${PROJECT_SOURCE_DIR}/libs/${ANDROID_ABI})

#.h文件目录
include_directories(
        ${CMAKE_SOURCE_DIR}/src/main/cpp/include #h文件目录
)

#add_library(libaudio_device STATIC IMPORTED)

#link_directories(${CMAKE_SOURCE_DIR}/src/main/cpp/include/lib)

add_library( # Sets the name of the library.
        ndkdemo-lib                     #c/cpp代码将要编译成为so库的名称，java代码加载库文件要用这个名称
        SHARED                          #动态库

        #自己的JNI实现
        src/main/cpp/ndkdemo-lib.cpp

        #引入的第三方实现相关
        src/main/cpp/cpp_test.cpp # cpp代码文件路径，如有多个需依次填写

        )

find_library( #调用系统库
        log-lib                   #打印用
        log )

target_link_libraries( # Specifies the target library.
        ndkdemo-lib
        OpenSLES
        ${log-lib} )

• add_definitions

CMake 预编译宏定义

• add_library

定义好要生成的so库的名称

（2）将工程切换到Android视图，进行如下操作

之后build.gradle会发生相应变化。

注意两个externalNativeBuild {}的配置

4. 开始调用

在MainActivity中调用，返回结果显示在界面上

public class MainActivity extends AppCompatActivity {

    private TextView mTv;

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

        mTv = findViewById(R.id.tv);

        mTv.setText(SDKUtil.getInstance().stringFromCpp());
    }
}

生成so

四、重点说明

1. 将第三方提供的静态库集成到项目

【NDK】Android Studio2.2+使用CMake依赖多个第三方库

（1）将静态库放在jniLibs下

将静态库放在jniLibs下

（2）CMake添加依赖的静态库

参考文献

Android Stuido：在现有工程中添加C/C++代码

关于在Android中使用CMake你所需要了解的一切（二）
关于在Android中使用CMake你所需要了解的一切（一）

关于在现有项目的集成NDK环境(Cmake方式)