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')
   }