AS使用nakbuild创建cpp工程记录

由于需要使用c++和.so库,所以必须要使用ndk方式,记录下过程。

现状是,我们得到第三方的.so和一些头文件类,需要使用这些类和函数来完成我们的功能,比如说机器学习算法运算库,但如何使用这些在.so内的函数呢?需要把.so和头文件加载到项目中,这就需要使用Android.mkApplication.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')
    }

本文固定链接: http://www.js-code.com/cpp/cpp_60856.html