Android NDK开发(一) 使用CMake构建工具进行NDK开发
2018-01-18 09:07
821 查看
2018年的第一篇文章,主要讲解了JNI、NDK的一些概念以及在AS 3.0环境下如何使用CMake构建工具来进行NDK开发。
Java原生接口,是Java和其他原生代码语言(例如 C 和 C++)通信的桥梁。
NDK(Native Development Kit):
原生开发工具集,是一套允许您使用原生代码语言(例如 C 和 C++)实现程序功能的工具集。
ABI(Application Binary Interface):
应用程序二进制接口,不同的CPU支持不同的指令集,CPU与指令集的每种组合都有其自己的应用二进制接口(或ABI),ABI可以非常精确地定义应用的机器代码在运行时如何与系统交互。
ABI官方文档
支持的ABI:armeabi、armeabi-v7a、arm64-v8a、x86、x86_64、mips、mips64
CMake:
Android推荐使用的NDK构建工具,从AS 2.2版本之后开始支持(包含2.2版本)。
在SDK Tools中安装以下组件:
Cmake:NDK构建工具
LLDB:NDK调试工具
NDK:NDK开发工具集
创建NDK项目
在创建项目时,勾选【Include C++ support】选项,然后一路下一步,到达【Customize C++ Support】设置页:
可以看到三个选项:
C++ Standard:C++标准,选择【Toolchain Default】会使用默认的CMake配置。
Exceptions Support:支持C++异常处理,标志为 -fexceptions。
Runtime Type Information Support:支持运行时类型识别,标志为
-frtti,程序能够使用基类的指针或引用来检查这些指针或引用所指的对象的实际派生类型。
在这里我们使用默认C++标准,不勾选下面的两个选项,点击【Finish】按钮进入下一个环节。
上图中用红框标识了NDK项目与普通项目的不同之处,下面分别来看看:
首先来看下build.gradle配置:
可以看到build.gradle配置中多了两个externalNativeBuild配置项:
defaultConfig里面的:
主要配置了Cmake的命令参数,例如在创建项目时,如果勾选了【Exceptions Support】和【Runtime Type Information Support】选项,是这样配置的:
更多命令参数可以查看Android NDK CMake文档
defaultConfig外面的:
主要定义了CMake的构建脚本CMakeLists.txt的路径。
CMake的构建脚本CMakeLists.txt
CMakeLists.txt是CMake的构建脚本,作用相当于ndk-build中的Android.mk,看下CMakeLists.txt:
这是一个基本的CMake构建脚本,更多脚本配置请参考CMAKE手册,看不懂!没关系,这里有中文版的CMAKE手册-中文版。
原生代码native-lib.cpp
Android提供了一个简单的JNI交互Demo,返回一个字符串给Java层,方法名是通过 Java_包名_类名_方法名 的方式命名的:
看下如何调用:
调用方式很简单,代码中已经写了注释,看下效果:
生成so文件
在CMakeLists.txt中将library的编译模式设置为SHARED模式,点击AS的编译按钮,在app > build > intermediates > cmake > debug > obj目录下会生成不同CPU架构对应的so文件:
生成的so文件也可以在其他项目中使用,在项目的app > src > main目录下创建jniLibs文件夹,将生成的so文件(带着CPU架构目录)拷贝到jniLibs文件夹中,按照上文中的调用方式即可正常使用。
在app的build.gradle文中配置abiFilters,可以输出指定ABI的so文件:
后续还会更新更多NDK开发系列文章,敬请期待!
1.了解一些概念
JNI(Java Native Interface):Java原生接口,是Java和其他原生代码语言(例如 C 和 C++)通信的桥梁。
NDK(Native Development Kit):
原生开发工具集,是一套允许您使用原生代码语言(例如 C 和 C++)实现程序功能的工具集。
ABI(Application Binary Interface):
应用程序二进制接口,不同的CPU支持不同的指令集,CPU与指令集的每种组合都有其自己的应用二进制接口(或ABI),ABI可以非常精确地定义应用的机器代码在运行时如何与系统交互。
ABI官方文档
支持的ABI:armeabi、armeabi-v7a、arm64-v8a、x86、x86_64、mips、mips64
CMake:
Android推荐使用的NDK构建工具,从AS 2.2版本之后开始支持(包含2.2版本)。
2.环境搭建
安装NDK开发所需的工具在SDK Tools中安装以下组件:
Cmake:NDK构建工具
LLDB:NDK调试工具
NDK:NDK开发工具集
创建NDK项目
在创建项目时,勾选【Include C++ support】选项,然后一路下一步,到达【Customize C++ Support】设置页:
可以看到三个选项:
C++ Standard:C++标准,选择【Toolchain Default】会使用默认的CMake配置。
Exceptions Support:支持C++异常处理,标志为 -fexceptions。
Runtime Type Information Support:支持运行时类型识别,标志为
-frtti,程序能够使用基类的指针或引用来检查这些指针或引用所指的对象的实际派生类型。
在这里我们使用默认C++标准,不勾选下面的两个选项,点击【Finish】按钮进入下一个环节。
3.NDK项目
看下项目目录:上图中用红框标识了NDK项目与普通项目的不同之处,下面分别来看看:
首先来看下build.gradle配置:
apply plugin: 'com.android.application' android { compileSdkVersion 26 defaultConfig { applicationId "com.yl.ndkdemo" minSdkVersion 15 targetSdkVersion 26 versionCode 1 versionName "1.0" testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner" externalNativeBuild { cmake { cppFlags "" } } } buildTypes { release { minifyEnabled false proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' } } externalNativeBuild { cmake { path "CMakeLists.txt" } } } dependencies { // 引用一些库 }
可以看到build.gradle配置中多了两个externalNativeBuild配置项:
defaultConfig里面的:
主要配置了Cmake的命令参数,例如在创建项目时,如果勾选了【Exceptions Support】和【Runtime Type Information Support】选项,是这样配置的:
externalNativeBuild { cmake { cppFlags "-fexceptions -frtti" } }
更多命令参数可以查看Android NDK CMake文档
defaultConfig外面的:
主要定义了CMake的构建脚本CMakeLists.txt的路径。
CMake的构建脚本CMakeLists.txt
CMakeLists.txt是CMake的构建脚本,作用相当于ndk-build中的Android.mk,看下CMakeLists.txt:
# 设置Cmake最小版本 cmake_minimum_required(VERSION 3.4.1) # 编译library add_library( # 设置library名称 native-lib # 设置library模式 # SHARED模式会编译so文件,STATIC模式不会编译 SHARED # 设置原生代码路径 src/main/cpp/native-lib.cpp ) # 定位library find_library( # library名称 log-lib # 将library路径存储为一个变量,可以在其他地方用这个变量引用NDK库 # 在这里设置变量名称 log ) # 关联library target_link_libraries( # 关联的library native-lib # 关联native-lib和log-lib ${log-lib} )
这是一个基本的CMake构建脚本,更多脚本配置请参考CMAKE手册,看不懂!没关系,这里有中文版的CMAKE手册-中文版。
原生代码native-lib.cpp
Android提供了一个简单的JNI交互Demo,返回一个字符串给Java层,方法名是通过 Java_包名_类名_方法名 的方式命名的:
#include <jni.h> #include <string> extern "C" JNIEXPORT jstring JNICALL Java_com_yl_ndkdemo_MainActivity_stringFromJNI( JNIEnv *env, jobject /* this */) { std::string hello = "Hello from C++"; return env->NewStringUTF(hello.c_str()); }
看下如何调用:
public class MainActivity extends AppCompatActivity { // 加载native-lib,不加lib前缀 static { System.loadLibrary("native-lib"); } @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); // 将获取的字符串显示在TextView上 TextView tv = (TextView) findViewById(R.id.sample_text); tv.setText(stringFromJNI()); } /** * native-lib中的原生方法 */ public native String stringFromJNI(); }
调用方式很简单,代码中已经写了注释,看下效果:
生成so文件
在CMakeLists.txt中将library的编译模式设置为SHARED模式,点击AS的编译按钮,在app > build > intermediates > cmake > debug > obj目录下会生成不同CPU架构对应的so文件:
生成的so文件也可以在其他项目中使用,在项目的app > src > main目录下创建jniLibs文件夹,将生成的so文件(带着CPU架构目录)拷贝到jniLibs文件夹中,按照上文中的调用方式即可正常使用。
在app的build.gradle文中配置abiFilters,可以输出指定ABI的so文件:
defaultConfig { ... ndk { abiFilters "armeabi", "armeabi-v7a", "arm64-v8a", "x86", "x86_64", "mips", "mips64" } }
4.写在最后
NDK官方使用文档后续还会更新更多NDK开发系列文章,敬请期待!
相关文章推荐
- Android NDK开发(二) 使用ndk-build构建工具进行NDK开发
- Android NDK开发之旅(2):一篇文章搞定Android Studio中使用CMake进行NDK/JNI开发
- Android NDK开发之旅(2):Android Studio中使用CMake进行NDK/JNI开发(初级)
- Android NDK开发 Android Studio使用新的Gradle构建工具配置NDK环境(一)
- AS2.2使用CMake方式进行JNI/NDK开发
- 使用CMake来进行Android NDK开发
- AS2.2使用CMake方式进行JNI/NDK开发
- AS2.2使用CMake方式进行JNI/NDK开发
- AS2.2使用CMake方式进行JNI/NDK开发
- Android开发——Android Studio使用新的Gradle构建工具配置NDK环境
- AS2.2使用CMake方式进行JNI/NDK开发
- 使用CMake来进行Android NDK开发
- Android逆向基础笔记—Android NDK开发3之使用ndk-build工具手动编译
- 使用CMake来进行Android NDK开发
- AS2.2使用CMake方式进行JNI/NDK开发
- Windows平台下使用Android NDK进行开发
- ANDROID NDK实践开发系列(02)-- 在ndk跨版本使用surface显示输出
- 无需cygwin,使用NDK进行开发
- 用VC++进行MapX二次开发::之三------使用MapX工具
- 无需cygwin,使用NDK进行开发