- 用CMake向已有AS項目添加C/C++代碼
mac上安裝軟件真的很簡單, 一路下一步就能夠安裝好android studio. 這裏有一篇舊文-Mac下安裝配置Android Studio 2.x和3.x並配置使用adb可供參考. 而寫這篇的目的, 主要是我發現以前的ndk開發方式已通過時了, 須要更新一下新的流程.android
CMake的方式是官方默認的ndk構建方式, 先從默認栗子開始看吧.c++
- 新建一個項目, 勾選C++ support:
- 你會發現初始的Activity就只能是基礎或者空的類型了, 其餘的都沒了.
- 這裏默認C++標準便可:
- C++ Standard: 選擇哪種C++標準, 默認選擇Toolchain Default選項, 其會使用默認的CMake配置
- Exceptions Support: 是否啓用對C++異常處理的支持, 若是選中, AS會將-fexceptions標誌添加到模塊級build.grade文件的cppFlags中
- Runtime Type Information Support: 是否支持RTTI, 若是選中, AS會將-frtti標誌添加到模塊級build.gradle文件的cppFlags中
- 來看看項目都多了什麼, 先切換到Android標籤下, 多了cpp目錄(ps: 注意, 這裏就算切換到Project標籤, 依舊是cpp哈), 一些頭文件, 和native-lib.cpp, 不用說, 這個cpp裏面確定是jni代碼了, 我貼出來:
#include <jni.h>
#include <string>
extern "C" JNIEXPORT jstring JNICALL
Java_com_so_testcmake_MainActivity_stringFromJNI(
JNIEnv *env,
jobject /* this */) {
std::string hello = "Hello from C++";
return env->NewStringUTF(hello.c_str());
}
複製代碼
- 而後切換到Project標籤, 這個CMakeLists.txt就特別惹眼了, 我把裏面大段註釋都去掉, 而後貼出代碼. .externalNativeBuild文件夾: 用於存放cmake編譯好的文件, 包括支持的各類硬件等信息. 其實看到前面的**.**也知道是系統管理的了.
cmake_minimum_required(VERSION 3.4.1)
add_library( # Sets the name of the library.
native-lib
# Sets the library as a shared library.
SHARED
# Provides a relative path to your source file(s).
src/main/cpp/native-lib.cpp)
find_library( # Sets the name of the path variable.
log-lib
# Specifies the name of the NDK library that
# you want CMake to locate.
log)
target_link_libraries( # Specifies the target library.
native-lib
# Links the target library to the log library
# included in the NDK.
${log-lib})
複製代碼
很明顯, 關鍵在於add_library這一段bash
- 第一個參數生成函數庫的名稱, 即libnative-lib.so或libnative-lib.a(lib和.so/.a默認缺省)
- 第二個參數生成庫類型: 動態庫爲SHARED, 靜態庫爲STATIC
- 第三個參數依賴的c/cpp文件(相對路徑)
- 最後回到Activity類來看看, 操做仍是同樣的, 加載庫, 聲明native函數.
public class MainActivity extends AppCompatActivity {
// 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);
// Example of a call to a native method
TextView tv = (TextView) findViewById(R.id.sample_text);
tv.setText(stringFromJNI());
}
/**
* A native method that is implemented by the 'native-lib' native library,
* which is packaged with this application.
*/
public native String stringFromJNI();
}
複製代碼
- 再來到build.gradle文件, 發現多出來了兩個標籤段, 也就是說, 若是咱們本身要建CMake環境, 是要加這兩段的.
- 新建一個空項目, 不含C++ support, 剛纔的項目不要關, 以後會大段複製黏貼:
- 新建JNI目錄, 發如今Android標籤下是cpp, 到了Project標籤下又是jni, 我一直很想知道谷歌是怎麼實現這一點的.
- 建立一個Java類, 將以前項目的代碼複製過來, 以下:
public class MyJNI {
// Used to load the 'native-lib' library on application startup.
static {
System.loadLibrary("native-lib");
}
/**
* A native method that is implemented by the 'native-lib' native library,
* which is packaged with this application.
*/
public native String stringFromJNI();
}
複製代碼
- 而後在jni目錄下建立cpp文件, 複製以前項目的代碼, 注意包名的變更:
#include <jni.h>
#include <string>
extern "C" JNIEXPORT jstring JNICALL
Java_com_so_addcmake_MyJNI_stringFromJNI(
JNIEnv *env,
jobject /* this */) {
std::string hello = "Hello from C++";
return env->NewStringUTF(hello.c_str());
}
複製代碼
- 而後將以前項目的CMakeLists.txt複製到這個項目的app目錄下, 修改相對路徑, 即將cpp變成jni, 而後文件名也能夠更改, 可是注意對應.
- 接下來在build.gradle中加入代碼, 以後同步:
ndk {
abiFilters 'x86', 'x86_64', 'armeabi-v7a', 'arm64-v8a'
}
複製代碼
externalNativeBuild {
cmake {
path "CMakeLists.txt"
}
}
複製代碼
固然, 你能夠手動操做進行關聯, 右擊app目錄, 點擊Link C++ Project with Gradle, 選擇以前的CMakeLists.txt文件.app
- 最後回到Activity, 設置組件顯示從cpp函數返回的字符串, 編譯運行:
TextView tvTest = (TextView) findViewById(R.id.tv_test);
tvTest.setText(new MyJNI().stringFromJNI());
複製代碼
- 最後來自效果圖:
- 這是個有些過期的方式, 可是依舊是能夠用的, 一樣, 新建空項目. 而後和以前同樣, 建一個cpp/jni目錄.
- 複用以前的JNI類, 也就是加載了C++庫和聲明瞭本地函數的Java類.
- 建立Android.mk, Application.mk, helloNDK.cpp文件, 代碼依次貼出:
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := HelloNDK
LOCAL_SRC_FILES := helloNDK.cpp
include $(BUILD_SHARED_LIBRARY)
複製代碼
APP_MODULES := HelloNDK
APP_ABI := all
複製代碼
//
// Created by 楊驍 on 2019/2/2.
//
#include <jni.h>
#include <stdio.h>
#ifdef __cplusplus
extern "C" {
#endif
/**
* 函數名規則: Java_包名_類名_方法名
* @param env 表示一個指向JNI環境的指針, 能夠經過它來方位JNI提供的接口方法
* @param thiz 表示Java對象中的this
* @return
*/
jstring Java_com_so_addndk_HelloNDK_get(JNIEnv *env, jobject thiz) {
printf("invoke get in c++\n");
return env->NewStringUTF("Hello from JNI in helloJni.so !");
}
void Java_com_so_addndk_HelloNDK_set(JNIEnv *env, jobject thiz, jstring string) {
printf("invoke set from C++\n");
char* str = (char*)env->GetStringUTFChars(string,NULL);
printf("%s\n", str);
env->ReleaseStringUTFChars(string, str);
}
#ifdef __cplusplus
}
#endif
複製代碼
- 而後打開終端, 進入到jni目錄, 使用ndk-build指令生成.so文件, 接着把生成的.so文件拷貝到app目錄下的libs目錄:
- 最後在Activity中調用就大功告成了:
要說操做上這兩種的複雜度感受差很少, 可是我依舊推薦CMake方案, 至少這種是短期不會過期的方案.ide