AS使用ndkbuild创建cpp工程记录

Posted 2020-11-01 zhcnick

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路径下，包括需要的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需要指定
     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)

3. 两个文件如果写在一个Android.mk文件中，顺序应该是先写自己jni接口库mk，再写第三方.so的预编译库mk。

4. 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。

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问题集锦
   gradle// 注释掉如下代码 sourceSets.main {// jniLibs.srcDir(‘src/main/libs‘)}