AS使用ndkbuild創(chuàng)建cpp工程記錄

由于需要使用c++和.so庫，所以必須要使用ndk方式，記錄下過程。

現(xiàn)狀是，我們得到第三方的.so和一些頭文件類，需要使用這些類和函數(shù)來完成我們的功能，比如說機器學習算法運算庫，但如何使用這些在.so內(nèi)的函數(shù)呢？需要把.so和頭文件加載到項目中，這就需要使用Android.mk和Application.mk文件來編譯了，==需要注意的是這僅限于使用ndk-build命令編譯的項目==，因為現(xiàn)在AS2.2后默認使用了cmake來編譯native項目。

官網(wǎng)對Android.mk文件介紹這個文件的編寫之后會講到。

.so文件和頭文件放在哪？

應該統(tǒng)一放在app/src/main/jni路徑下，包括需要的jni接口文件，也應該放在jni目錄下，保持統(tǒng)一。

Android.mk和Application.mk文件

• LOCAL_PATH:表示文件在當前項目中的位置my-dir是一個函數(shù)，由構(gòu)建系統(tǒng)提供的。
• CLEAR_VARS:也是由構(gòu)建系統(tǒng)提供的變量，指向特殊 GNU Makefile，可為您清除許多 LOCAL_XXX 變量，例如 LOCAL_MODULE、LOCAL_SRC_FILES 和 LOCAL_STATIC_LIBRARIES，==但是不會清除LOCAL_PATH變量==
• LOCAL_MODULE:存儲你需要編譯模塊的名字，比如native-lib，最后打出的.so庫名字便是libnative-lib.so（會默認在名字前加上lib字段）
• LOCAL_SRC_FILES: 指定文件在哪，比如目前例子上就是native-lib.cpp。
• include $(BUILD_SHARED_LIBRARY)：幫助系統(tǒng)將所有內(nèi)容連接到一起

其他內(nèi)容可以參考Google官方文檔；我這里說下需要注意的點。

需要注意的問題

1. 如果是第三方庫和jni接口文件都在jni目錄下（這也是開頭提到的推薦目錄），此時就可以只寫一個Android.mk文件，這個文件包括了添加第三方.so庫和.hpp頭文件，和編譯自己的jni cpp函數(shù)庫。不然就需要寫兩個Android.mk文件，一個用于加載第三方.so到項目中，另一個用于編譯生成自己寫的jni接口cpp庫（即libnative-lib.so）。

2. 兩個Android.mk文件的區(qū)別：

   • 添加.so庫的Android.mk需要指定

     include $(CLEAR_VARS)
     LOCAL_MODULE := nn
     LOCAL_SRC_FILES := $(LOCAL_PATH)/armeabi-v7a/lib/libnn.so
     LOCAL_EXPORT_C_INCLUDES := $(LOCAL_PATH)/armeabi-v7a/include
     # 需要指定是預編譯的庫，加如下標識
     include $(PREBUILT_SHARED_LIBRARY)
     

   • 編譯自己的jni接口cpp文件

     LOCAL_PATH := $(call my-dir)
     include $(CLEAR_VARS)
     LOCAL_MODULE := native-lib
     LOCAL_SRC_FILES := native-lib.cpp
     LOCAL_LDLIBS := -llog -landroid
     LOCAL_CFLAGS += -std=c++11
     # 此處即上述所編譯好的第三方庫，這里引用一下
     LOCAL_SHARED_LIBRARIES := nn
     include $(BUILD_SHARED_LIBRARY)
     

3. 兩個文件如果寫在一個Android.mk文件中，順序應該是先寫自己jni接口庫mk，再寫第三方.so的預編譯庫mk。

4. Application.mk文件比較統(tǒng)一，一般大家的都差不多，可以直接拿來用，不需要修改什么地方，需要注意的點可能有如下幾點：

   APP_PLATFORM := android-15
   APP_ABI := armeabi-v7a
   NDK_TOOLCHAIN_VERSION=4.9
   APP_PIE := false
   APP_STL := gnustl_static
   APP_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版本：

     <uses-sdk
     android:minSdkVersion="15"
     android:targetSdkVersion="26" />
     

   • 盡量使用APP_STL := gnustl_static該版本的c++支持最好，不會有標準庫找不到問題
   • 如果還需要有支持c++11，則需要指定APP_CFLAGS := -std=c++11，該句話在Android.mk中最好也加上，可以保證不會有c++11庫函數(shù)找不到問題。

Gradle文件的調(diào)整

由于現(xiàn)在AS創(chuàng)建native項目默認都使用cmake了，Gradle也是按照cmake配置的，如果要使用ndk-build也需要修改一下Gradle。

1. 把原來cmake的地方換成ndkBuild，對是ndkBuild，這個和執(zhí)行的命令不一樣，是一個配置函數(shù)。

           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"
               }
           }
   

2. 在android{}下添加如下，指定makefile文件路徑，這是必須的：

       externalNativeBuild {
           ndkBuild {
               path "src/main/jni/Android.mk"
           }
       }
   

3. 需要指定編譯的版本，由于Android真機通常只需要armeabi-v7a，所以只編譯該版本即可，不需要編譯arm64版本，可以在android{}下的buildTypes{}下指定編譯版本使用abiFilter函數(shù)：

       buildTypes {
           release {
               minifyEnabled false
               proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
               ndk {
                   abiFilter "armeabi-v7a"
               }
           }
   
           debug {
               minifyEnabled false
               ndk {
                   abiFilter "armeabi-v7a"
               }
           }
       }
   

4. 如果出現(xiàn)More than one file was found with OS independent path問題，需要去除如下指定，可以看我的這篇文章AS中ndk-build方式cpp問題集錦

   // 注釋掉如下代碼
       sourceSets.main {
   //        jniLibs.srcDir('src/main/libs')
   }