使用Android Studio和CMake进行NDK开发 - 模块划分与管理

1. 概述

---

如果工程代码比较小，所有的C/C++代码放在一个CMake模块里问题不大。但是随着功能的增加，可能会拆分模块来管理，例如一个加密模块、一个音频处理模块。或者为了便于管理引入第三方的静态库，而进行模块拆分。

一种可行简单的办法就是直接分散到每个一个Gradle Module当中，这种方案不讨论，我们仅讨论全部C/C++模块放到一个Gradle Module，最终入下图所示：

AndroidStudio本地模块

目录规划

---

在写代码之前，我们需要规划我们的目录，这样才能做到有条不紊。按照AS自身做法，我们依然把所有的C/C++代码放到cpp目录当中，例子中，会有三个模块：sqlite3（第三方源码）、openssl(第三方预编译的静态库)、testlib（自己的模块），目录结构如下：

目录结构

CMakeLists.txt的组织

根CMakeLists.txt

---

有多个模块，那么需要多个CMakeLists.txt来进行组织，首先是模块根目录下（注意是模块根目录）CMakeLists.txt，该文件主要是设定一些基础参数，并且引入子模块。

文件路径： d:\work\AndroidMultiCMakeModule\app\CMakeLists.txt

内容：

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

cmake_minimum_required(VERSION 3.4.1)

# 添加include目录，在C/C++中的include指令能找到对应的头文件
# 该命令类似java的classpath，不用的地方的是，它指示的是头文件，仅包含类/函数等声明
include_directories(src/main/cpp)
include_directories(src/main/cpp/sqlite3)
include_directories(src/main/cpp/openssl/include)

# 添加导入的库目标,方便后续添加依赖
add_library(openssl_crypto STATIC IMPORTED)
# 指示该库文件的路径
set_target_properties(openssl_crypto
                      PROPERTIES
                      IMPORTED_LOCATION ${CMAKE_SOURCE_DIR}/src/main/cpp/openssl/${ANDROID_ABI}/libcrypto.a)

add_library(openssl_ssl STATIC IMPORTED)
set_target_properties(openssl_ssl
                    PROPERTIES
                    IMPORTED_LOCATION ${CMAKE_SOURCE_DIR}/src/main/cpp/openssl/${ANDROID_ABI}/libssl.a)


# 添子项目的目录
add_subdirectory(src/main/cpp/sqlite3)
add_subdirectory(src/main/cpp/testlib)

比较关键的就是add_subdirectory，该指令会寻找指定目录下的CMakeLists.txt

子项目的CMakeLists.txt

---

子项目的CMakeLists.txt相对来就比较简单，就是添加源码，设定其他编译参数一类的。

• sqlite3子模块

project(sqlite)

# 添加静态库
add_library(sqlite_static STATIC sqlite3.c)

• testlib子模块

project(testlib)

# 添加动态库
add_library(testlib SHARED testlib.cpp)

# 为该动态库添加要链接的库
target_link_libraries(testlib sqlite_static openssl_crypto openssl_ssl)

sync之后，我们会看到AS的工程窗口显示出C/C++模块如下图：

image.png

直接列出了全部引用的CMakeLists.txt和C/C++模块。

我们的TestLib引用了sqlite和openssl两个模块，写代码实测一下：

testlib.cpp

#include 

#include 
#include 

extern "C"
JNIEXPORT jstring
JNICALL
Java_com_example_AndroidMultiCmakeModule_TestLib_sqlite3Version(
        JNIEnv *env,
        jobject /* this */) {


    return env->NewStringUTF(SQLITE_VERSION);
}

extern "C"
JNIEXPORT jstring
JNICALL
Java_com_example_AndroidMultiCmakeModule_TestLib_openSSLVersion(
        JNIEnv *env,
        jobject /* this */) {

    char tmp[256] = {0};
    sprintf(tmp, "openssl: %d", OpenSSL_version_num());

    return env->NewStringUTF(tmp);
}

TestLib.java代码：

class TestLib {

    public static native String sqlite3Version();
    public static native String openSSLVersion();

    static {
        System.loadLibrary("testlib");
    }
}

MainActivity.kt代码：

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        // Example of a call to a native method
        sample_text.text = "sqlite: " + TestLib.sqlite3Version() + " openssl: " + TestLib.openSSLVersion()
    }
}

最终运行结果：

image.png

这说明，我们的testlib模块，正常调用了其他两个native模块。