android studio CMake初体验
一、简介
NDK:Android NDK 是一套允许您使用原生代码语言(例如 C 和 C++)实现部分应用的工具集。在开发某些类型应用时,这有助于您重复使用以这些语言编写的代码库。
JNI:Java 原生接口,JNI 是 Java 和 C++ 组件用以互相沟通的接口
原生共享库:NDK 从原生源代码构建这些库或 .so 文件。
原生静态库:NDK 也可构建静态库或 .a 文件,您可以关联到其他库。
ABI:ABI 可以非常精确地定义应用的机器代码在运行时如何与系统交互。 NDK 根据这些定义构建 .so 文件。 不同的 ABI 对应不同的架构:NDK 包含对 ARMEABI(默认)、MIPS 和 x86 的 ABI 支持。
CMake:一款外部构建工具,可与 Gradle 搭配使用来构建原生库。如果您只计划使用 ndk-build,则不需要此组件。
LLDB:一种调试程序,Android Studio 使用它来调试原生代码。
https://developer.android.com/ndk/index.html
https://developer.android.com/ndk/guides/concepts.html
https://developer.android.com/studio/projects/add-native-code.html
二、下载NDK或构建工具
- 在打开的项目中,从菜单栏选择 Tools > SDK Manager。
- 点击 SDK Tools 标签。
-
选中 LLDB、CMake 和 NDK 旁的复选框,如图所示。
- 点击 Apply,然后在弹出式对话框中点击 OK。
- 安装完成后,点击 Finish,然后点击 OK。
三、创建项目
- New->New Project->Create Android Project ,选中 Include C++ Support 复选框。
- 点击 Next->Next->Next->Next
- 在向导的 Customize C++ Support 部分,您可以使用下列选项自定义项目:
- C++ Standard:使用下拉列表选择您希望使用哪种 C++ 标准。选择 Toolchain Default 会使用默认的 CMake 设置。
- Exceptions Support:如果您希望启用对 C++ 异常处理的支持,请选中此复选框。如果启用此复选框,Android Studio 会将
-fexceptions标志添加到模块级build.gradle文件的cppFlags中,Gradle 会将其传递到 CMake。 - Runtime Type Information Support:如果您希望支持 RTTI,请选中此复选框。如果启用此复选框,Android Studio 会将
-frtti标志添加到模块级build.gradle文件的cppFlags中,Gradle 会将其传递到 CMake。
四、项目结构
在 Android Studio 完成新项目的创建后,从 IDE 左侧打开 Project 窗格并选择 Android 视图。如图所示,Android Studio 将添加 cpp 、.externalNativeBuild组和文件CMakeLists.txt:
- 在 cpp 组中,您可以找到属于项目的所有原生源文件、标头和预构建库。对于新项目,Android Studio 会创建一个示例 C++ 源文件
native-lib.cpp,并将其置于应用模块的src/main/cpp/目录中。本示例代码提供了一个简单的 C++ 函数stringFromJNI(),此函数可以返回字符串“Hello from C++”。 - 在CMakeLists.txt和externalNativeBuild组中,您可以找到 CMake 或 ndk-build 的构建脚本。与
build.gradle文件指示 Gradle 如何构建应用一样,CMake 和 ndk-build 需要一个构建脚本来了解如何构建您的原生库。对于新项目,Android Studio 会创建一个 CMake 构建脚本CMakeLists.txt,并将其置于模块的根目录中。
五、简单示例
我们以求2个数的和为例。
- 在native-lib.cpp中编写函数
int add(int x,int y) { return x+y; }
- 在MainActivity中编写
// Used to load the 'native-lib' library on application startup. static { System.loadLibrary("native-lib"); } @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); } /** * A native method that is implemented by the 'native-lib' native library, * which is packaged with this application. */ public native String stringFromJNI(); public native int add(int x,int y);
- 打开Terminal(控制台)
View->Tool Windows->Terminal。
- 跳转到目录:cd app/src/main/java
- 生成JNI头文件
在控制台输入javah -d . -jni com.zzy.ndkdemo.MainActivity命令
刷新目录后,会多出一个头文件com_zzy_ndkdemo_MainActivity.h文件,将该文件拷贝到CPP目录下
- 在nativa-lib.cpp中实现头文件中的函数
extern "C" JNIEXPORT jint JNICALL Java_com_zzy_ndkdemo_MainActivity_add(JNIEnv *env, jobject instance, jint x, jint y) { return add(x, y); }
注意需要加上extern "C"
- 在MainActivity.java中加上调用,编译运行。
int sum = add(10,20); TextView tv = (TextView) findViewById(R.id.sample_text); tv.setText("sum:"+sum);