Android NDK 入门与实践之 CMake

作者: 迷途小码农h | 来源:发表于2019-03-13 19:58 被阅读7次

CMake

Android Studio 用于构建原生库的默认工具是 CMake,由于很多现有项目都使用构建工具包编译其原生代码,Android Studio 还支持 ndk-build,如果您在创建新的原生库,则应使用 CMake。

如果您的原生源文件还没有 CMake 构建脚本,则您需要自行创建一个并包含适当的 CMake 命令。CMake 构建脚本是一个纯文本文件,您必须将其命名为 CMakeLists.txt。本部分介绍了您应包含到构建脚本中的一些基本命令,用于在创建原生库时指示 CMake 应使用哪些源文件。

注:如果您的项目使用 ndk-build,则不需要创建 CMake 构建脚本。提供一个指向您的 Android.mk 文件的路径,将 Gradle 关联到您的原生库。

要创建一个可以用作 CMake 构建脚本的纯文本文件,请按以下步骤操作:

安装 CMake;

Tools > Android > SDK Manager,点击 SDK Tools 标签,选中 CMake,点击 Apply 安装;

新建 CMakeLists.txt

CMakeLists.txt 主要用于声明 CMake 使用版本、so 库名称、C 或 CPP 文件路径等信息。

1、从 IDE 的左侧打开 Project 窗格并从下拉菜单中选择 Project 视图;

2、右键点击 您的模块 的根目录并选择 New > File;

3、输入“CMakeLists.txt”作为文件名并点击 OK;

CMakeLists.txt 示例:

设置构建本地库所需的最小版本

cmake_minimum_required(VERSION 3.4.1)

编译出一个动态库 HelloCPP,源文件只有 src/main/cpp/HelloCPP.cpp

add_library( # 设置库的名称,即 SO 文件的名称
NDKSample

         # STATIC:静态库,是目标文件的归档文件,在链接其它目标的时候使用。
         # SHARED:动态库,会被动态链接,在运行时被加载。
         # MODULE:模块库,是不会被链接到其它目标中的插件,但是可能会在运行时使用dlopen-系列的函数动态链接。
         SHARED

         # 要编译的源代码文件
         src/main/cpp/HelloCPP.cpp )

指定的是头文件的目录

include_directories(src/main/cpp/include/)

添加 NDK API,Android NDK 提供了一套实用的原生 API 和库,通过将 NDK 库包含到项目的 CMakeLists.txt 脚本文件中。

find_library( # 定位 Android 特定的日志支持库并将其路径存储在 log-lib 中
log-lib

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

为了确保您的原生库可以在 log 库中调用函数,您需要使用 CMake 构建脚本中的 target_link_libraries() 命令关联库。

target_link_libraries( # Specifies the target library.
NDKSample

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

C 或 C++ 代码

main 下面增加了 cpp 目录,即放置 C 或 C++ 代码的地方;

HelloCPP.cpp

include <jni.h>

include <string>

extern "C"

JNIEXPORT jstring JNICALL
Java_com_wuxiaolong_cmake_HelloLibrary_sayHello(JNIEnv *env, jobject) {
//从 C++ 传字符串到 Java
std::string hello = "Hello from C++ by cmake";
return env->NewStringUTF(hello.c_str());
}
app/build.gradle

android {

defaultConfig {
    //……
    externalNativeBuild {
        cmake {
            //设置 C++ flag,可选配置,-frtti 表示项目支持RTTI;-fexceptions 表示当前项目支持C++异常处理
            cppFlags "-frtti -fexceptions"
            //arguments 语法:-D + 变量,更多变量:https://developer.android.com/ndk/guides/cmake.html
            arguments "-DANDROID_ARM_NEON=TRUE"

        }

    }
    // 指定 ABI
    ndk {
        // Specifies the ABI configurations of your native
        // libraries Gradle should build and package with your APK.
        abiFilters 'armeabi', 'armeabi-v7a'
    }


}
externalNativeBuild {
    cmake {
        //指明 CMakeList.txt 路径
        path "CMakeLists.txt"
    }
}

}
HelloLibrary

public class HelloLibrary {
static {
//加载动态库,这里对应 CMakeLists.txt 里的 add_library NDKSample
System.loadLibrary("NDKSample");
}

//使用 native 关键字指示以原生代码形式实现的方法
public native String sayHello();

}
调用

TextView text = findViewById(R.id.text);
text.setText(new HelloLibrary().sayHello());
如果在 New Project 时,勾选 Include C++ support,会自动生成上面这些,有个示例。CMake 如果深究还有很多东西要学习,先酱紫吧。

参考

向您的项目添加 C 和 C++ 代码

CMake

CMAKE手册

相关文章

网友评论

    本文标题:Android NDK 入门与实践之 CMake

    本文链接:https://www.haomeiwen.com/subject/xufxmqtx.html