AS使用ndkbuild建立cpp工程记录

AS使用nakbuild建立cpp工程记录

因为须要使用c++和.so库，因此必需要使用ndk方式，记录下过程。

现状是，咱们获得第三方的.so和一些头文件类，须要使用这些类和函数来完成咱们的功能，好比说机器学习算法运算库，但如何使用这些在.so内的函数呢？须要把.so和头文件加载到项目中，这就须要使用Android.mk和Application.mk文件来编译了，==须要注意的是这仅限于使用ndk-build命令编译的项目==，由于如今AS2.2后默认使用了cmake来编译native项目。

官网对Android.mk文件介绍这个文件的编写以后会讲到。

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

应该统一放在app/src/main/jni路径下，包括须要的jni接口文件，也应该放在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（会默认在名字前加上lib字段）
• LOCAL_SRC_FILES: 指定文件在哪，好比目前例子上就是native-lib.cpp。
• include $(BUILD_SHARED_LIBRARY)：帮助系统将全部内容链接到一块儿

其余内容能够参考Google官方文档；我这里说下须要注意的点。

须要注意的问题

1. 若是是第三方库和jni接口文件都在jni目录下（这也是开头提到的推荐目录），此时就能够只写一个Android.mk文件，这个文件包括了添加第三方.so库和.hpp头文件，和编译本身的jni cpp函数库。否则就须要写两个Android.mk文件，一个用于加载第三方.so到项目中，另外一个用于编译生成本身写的jni接口cpp库（即libnative-lib.so）。

2. 两个Android.mk文件的区别：

   • 添加.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文件比较统一，通常你们的都差很少，能够直接拿来用，不须要修改什么地方，须要注意的点可能有以下几点：

   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库函数找不到问题。

Gradle文件的调整

因为如今AS建立native项目默认都使用cmake了，Gradle也是按照cmake配置的，若是要使用ndk-build也须要修改一下Gradle。

1. 把原来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"
               }
           }

2. 在android{}下添加以下，指定makefile文件路径，这是必须的：

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

3. 须要指定编译的版本，因为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"
               }
           }
       }

4. 若是出现More than one file was found with OS independent path问题，须要去除以下指定，能够看个人这篇文章AS中ndk-build方式cpp问题集锦

   // 注释掉以下代码
       sourceSets.main {
   //        jniLibs.srcDir('src/main/libs')
   }