AS使用ndkbuild創建cpp工程記錄
AS使用ndkbuild創建cpp工程記錄
由於需要使用c++和.so庫,所以必須要使用ndk方式,記錄下過程。
現狀是,我們得到第三方的.so
和一些頭文件
類,需要使用這些類和函數來完成我們的功能,比如說機器學習算法運算庫,但如何使用這些在.so內的函數呢?需要把.so和頭文件加載到項目中,這就需要使用Android.mk
和Application.mk
文件來編譯了,==需要註意的是這僅限於使用ndk-build命令編譯的項目==,因為現在AS2.2後默認使用了cmake
來編譯native項目。
官網對Android.mk文件介紹這個文件的編寫之後會講到。
.so文件和頭文件放在哪?
應該統一放在app/src/main/jni
Android.mk和Application.mk文件
- LOCAL_PATH:表示文件在當前項目中的位置
my-dir
是一個函數,由構建系統提供的。 - CLEAR_VARS:也是由構建系統提供的變量,指向特殊 GNU Makefile,可為您清除許多 LOCAL_XXX 變量,例如 LOCAL_MODULE、LOCAL_SRC_FILES 和 LOCAL_STATIC_LIBRARIES,==但是不會清除LOCAL_PATH變量==
- LOCAL_MODULE:存儲你需要編譯模塊的名字,比如
native-lib
,最後打出的.so庫名字便是libnative-lib.so
- LOCAL_SRC_FILES: 指定文件在哪,比如目前例子上就是
native-lib.cpp
。 - include $(BUILD_SHARED_LIBRARY):幫助系統將所有內容連接到一起
其他內容可以參考Google官方文檔;我這裏說下需要註意的點。
需要註意的問題
如果是第三方庫和jni接口文件都在
jni
目錄下(這也是開頭提到的推薦目錄),此時就可以只寫一個Android.mk
文件,這個文件包括了添加第三方.so庫和.hpp頭文件,和編譯自己的jni cpp函數庫。不然就需要寫兩個Android.mk
文件,一個用於加載第三方.so到項目中,另一個用於編譯生成自己寫的jni接口cpp庫(即libnative-lib.so
兩個Android.mk文件的區別:
- 添加.so庫的Android.mk需要指定
mkinclude $(CLEAR_VARS)LOCAL_MODULE := nnLOCAL_SRC_FILES := $(LOCAL_PATH)/armeabi-v7a/lib/libnn.soLOCAL_EXPORT_C_INCLUDES := $(LOCAL_PATH)/armeabi-v7a/include# 需要指定是預編譯的庫,加如下標識include $(PREBUILT_SHARED_LIBRARY)
- 編譯自己的jni接口cpp文件
mkLOCAL_PATH := $(call my-dir)include $(CLEAR_VARS)LOCAL_MODULE := native-libLOCAL_SRC_FILES := native-lib.cppLOCAL_LDLIBS := -llog -landroidLOCAL_CFLAGS += -std=c++11# 此處即上述所編譯好的第三方庫,這裏引用一下LOCAL_SHARED_LIBRARIES := nninclude $(BUILD_SHARED_LIBRARY)
- 添加.so庫的Android.mk需要指定
兩個文件如果寫在一個Android.mk文件中,順序應該是先寫自己jni接口庫mk,再寫第三方.so的預編譯庫mk。
Application.mk文件比較統一,一般大家的都差不多,可以直接拿來用,不需要修改什麽地方,需要註意的點可能有如下幾點:
mkAPP_PLATFORM := android-15APP_ABI := armeabi-v7aNDK_TOOLCHAIN_VERSION=4.9APP_PIE := falseAPP_STL := gnustl_staticAPP_CFLAGS := -O3 -Wall -pipe \ -ffast-math \ -fstrict-aliasing -Werror=strict-aliasing \ -Wno-psabi -Wa,--noexecstack \ -DANDROID -DNDEBUG \ -std=c++11
APP_PLATFORM
版本需要和在AndroidManifest.xml
中的對應,比如說我這裏指定是15,則需要在xml
中也指定至少15版本:xml<uses-sdkandroid:minSdkVersion="15"android:targetSdkVersion="26" />
- 盡量使用
APP_STL := gnustl_static
該版本的c++支持最好,不會有標準庫找不到問題 - 如果還需要有支持
c++11
,則需要指定APP_CFLAGS := -std=c++11
,該句話在Android.mk
中最好也加上,可以保證不會有c++11
庫函數找不到問題。
Gradle文件的調整
由於現在AS創建native項目默認都使用cmake了,Gradle也是按照cmake配置的,如果要使用ndk-build也需要修改一下Gradle。
把原來
cmake
的地方換成ndkBuild
,對是ndkBuild
,這個和執行的命令不一樣,是一個配置函數。externalNativeBuild {
ndkBuild {
// Sets optional flags for the C compiler.
cFlags "-D_EXAMPLE_C_FLAG1", "-D_EXAMPLE_C_FLAG2"// Sets a flag to enable format macro constants for the C++ compiler.
cppFlags "-D__STDC_FORMAT_MACROS"
}
}在
android{}
下添加如下,指定makefile文件路徑,這是必須的:externalNativeBuild {
ndkBuild {
path "src/main/jni/Android.mk"
}
}需要指定編譯的版本,由於Android真機通常只需要
armeabi-v7a
,所以只編譯該版本即可,不需要編譯arm64
版本,可以在android{}下的buildTypes{}下指定編譯版本使用abiFilter
函數:buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile(‘proguard-android.txt‘), ‘proguard-rules.pro‘
ndk {
abiFilter "armeabi-v7a"
}
}debug {
minifyEnabled false
ndk {
abiFilter "armeabi-v7a"
}
}
}如果出現
More than one file was found with OS independent path
問題,需要去除如下指定,可以看我的這篇文章AS中ndk-build方式cpp問題集錦gradle// 註釋掉如下代碼 sourceSets.main {// jniLibs.srcDir(‘src/main/libs‘)}
AS使用ndkbuild創建cpp工程記錄