2018年的第一篇文章,主要講解了JNI晶密、NDK的一些概念以及在AS 3.0環(huán)境下如何使用CMake構(gòu)建工具來進(jìn)行NDK開發(fā)。
1.了解一些概念
-
JNI(Java Native Interface):
Java原生接口,是Java和其他原生代碼語言(例如 C 和 C++)通信的橋梁邑时。
-
NDK(Native Development Kit):
原生開發(fā)工具集,是一套允許您使用原生代碼語言(例如 C 和 C++)實現(xiàn)程序功能的工具集特姐。
-
ABI(Application Binary Interface):
應(yīng)用程序二進(jìn)制接口晶丘,不同的CPU支持不同的指令集,CPU與指令集的每種組合都有其自己的應(yīng)用二進(jìn)制接口(或ABI)唐含,ABI可以非常精確地定義應(yīng)用的機器代碼在運行時如何與系統(tǒng)交互浅浮。
支持的ABI:armeabi、armeabi-v7a觉壶、arm64-v8a脑题、x86、x86_64铜靶、mips叔遂、mips64
-
CMake:
Android推薦使用的NDK構(gòu)建工具,從AS 2.2版本之后開始支持(包含2.2版本)争剿。
2.環(huán)境搭建
安裝NDK開發(fā)所需的工具
在SDK Tools中安裝以下組件:
Cmake:NDK構(gòu)建工具
LLDB:NDK調(diào)試工具
NDK:NDK開發(fā)工具集
創(chuàng)建NDK項目
在創(chuàng)建項目時已艰,勾選【Include C++ support】選項,然后一路下一步蚕苇,到達(dá)【Customize C++ Support】設(shè)置頁:
可以看到三個選項:
C++ Standard:C++標(biāo)準(zhǔn)哩掺,選擇【Toolchain Default】會使用默認(rèn)的CMake配置。
Exceptions Support:支持C++異常處理涩笤,標(biāo)志為 -fexceptions嚼吞。
Runtime Type Information Support:支持運行時類型識別,標(biāo)志為
-frtti蹬碧,程序能夠使用基類的指針或引用來檢查這些指針或引用所指的對象的實際派生類型舱禽。
在這里我們使用默認(rèn)C++標(biāo)準(zhǔn),不勾選下面的兩個選項恩沽,點擊【Finish】按鈕進(jìn)入下一個環(huán)節(jié)誊稚。
3.NDK項目
看下項目目錄:
上圖中用紅框標(biāo)識了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的命令參數(shù),例如在創(chuàng)建項目時里伯,如果勾選了【Exceptions Support】和【Runtime Type Information Support】選項城瞎,是這樣配置的:
externalNativeBuild {
cmake {
cppFlags "-fexceptions -frtti"
}
}
更多命令參數(shù)可以查看Android NDK CMake文檔
-
defaultConfig外面的:
主要定義了CMake的構(gòu)建腳本CMakeLists.txt的路徑。
CMake的構(gòu)建腳本CMakeLists.txt
CMakeLists.txt是CMake的構(gòu)建腳本疾瓮,作用相當(dāng)于ndk-build中的Android.mk脖镀,看下CMakeLists.txt:
# 設(shè)置Cmake最小版本
cmake_minimum_required(VERSION 3.4.1)
# 編譯library
add_library( # 設(shè)置library名稱
native-lib
# 設(shè)置library模式
# SHARED模式會編譯so文件,STATIC模式不會編譯
SHARED
# 設(shè)置原生代碼路徑
src/main/cpp/native-lib.cpp )
# 定位library
find_library( # library名稱
log-lib
# 將library路徑存儲為一個變量爷贫,可以在其他地方用這個變量引用NDK庫
# 在這里設(shè)置變量名稱
log )
# 關(guān)聯(lián)library
target_link_libraries( # 關(guān)聯(lián)的library
native-lib
# 關(guān)聯(lián)native-lib和log-lib
${log-lib} )
這是一個基本的CMake構(gòu)建腳本认然,更多腳本配置請參考CMAKE手冊,看不懂漫萄!沒關(guān)系卷员,這里有中文版的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());
}
看下如何調(diào)用:
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();
}
調(diào)用方式很簡單岩瘦,代碼中已經(jīng)寫了注釋未巫,看下效果:
生成so文件
在CMakeLists.txt中將library的編譯模式設(shè)置為SHARED模式,點擊AS的編譯按鈕启昧,在app > build > intermediates > cmake > debug > obj目錄下會生成不同CPU架構(gòu)對應(yīng)的so文件:
生成的so文件也可以在其他項目中使用叙凡,在項目的app > src > main目錄下創(chuàng)建jniLibs文件夾,將生成的so文件(帶著CPU架構(gòu)目錄)拷貝到j(luò)niLibs文件夾中密末,按照上文中的調(diào)用方式即可正常使用握爷。
在app的build.gradle文中配置abiFilters,可以輸出指定ABI的so文件:
defaultConfig {
...
ndk {
abiFilters "armeabi", "armeabi-v7a", "arm64-v8a", "x86", "x86_64", "mips", "mips64"
}
}
4.寫在最后
后續(xù)還會更新更多NDK開發(fā)系列文章严里,敬請期待新啼!