android学习-ndk-build(androidstudio编译cocos2d-x库的cpp为so文件的解释)

本文不作为ndk初学使用,只是对cpp等c++文件编译成so文件的过程中,参数含义,及ndk配置的解释。使用的技术比较旧。

androidStudio使用gradle调用ndk-build工具编译c++代码,
使用ndk-build来进行编译,而不是使用最新版本的cmake工具

在gradle配置的参数最后都是调用ndk-build命令去执行Android.mk和Application.mk文件

Android.mk文件指定需要编译的c或c++文件

Application.mk文件用来描述应用程序需要的模块,需要生成的.so文件

commandLine "$ndkDir/ndk-build.cmd", "NDK_PROJECT_PATH=$projectDir.absolutePath\\build", 
      "APP_BUILD_SCRIPT=$projectDir.absolutePath\\src\\main\\jni\\Android.mk",
       "NDK_APPLICATION_MK=$projectDir.absolutePath\\src\\main\\jni\\Application.mk"

build.gradle配置参数

也就是在执行jni/Android.mk文件进行编译时需要用到的环境变量

build.gradle

defaultConfig {
。。。
externalNativeBuild {
ndkBuild {
targets 'cocos2djs'
arguments 'NDK_TOOLCHAIN_VERSION=4.9'
arguments 'APP_PLATFORM=android-19'
arguments 'NDK_MODULE_PATH=cocos2d-x;cocos2d-x/cocos;cocos2d-x/external'
arguments '-j' + Runtime.runtime.availableProcessors()
abiFilters.addAll(['armeabi-v7a'])
}
}
} externalNativeBuild {
ndkBuild {
if (!project.hasProperty("PROP_NDK_MODE") || PROP_NDK_MODE.compareTo('none') != 0) {
// skip the NDK Build step if PROP_NDK_MODE is none
path "jni/Android.mk"
}
}
}

使用targets指定我们编译的模块,其实就是指定只执行哪个Android.mk文件,这个是跟path 指定的路径jni/Android.mk相匹配的

jni/Android.mk文件中已经定义的模块名

LOCAL_MODULE := cocos2djs_shared
LOCAL_MODULE_FILENAME := libcocos2djs

最后输出的so文件是libcocos2djs.so   也可以不加lib前缀,ndk会自动添加前缀。这个模块名就是cocos2djs,也就是上面我们指定的targets:cocos2djs

如果修改了这个targets 'zwhcocos2djs',则会报错。Valid values are:这句后面的都是查找到的所有模块名

> Unexpected native build target zwhcocos2djs. Valid values are: extension, creator, audioengine, cpufeatures, cocos2dandroid, spine, vorbisidec, network, cocos2djs, dragonbones, jscocos2d, ui, cocos2dxinternal,

使用arguments来定义ndk的运行时用到的环境变量值

arguments 'NDK_TOOLCHAIN_VERSION=4.9'

NDK_TOOLCHAIN_VERSION=4.9 配置ndk使用的gcc编译工具版本
APP_PLATFORM=android-19 设置android平台版本
NDK_MODULE_PATH=cocos2d-x;cocos2d-x/cocos;cocos2d-x/external
arguments '-j' + Runtime.runtime.availableProcessors()
这个-j参数后面是得到处理器的数量。指定使用多少个处理器进行ndk的编译
abiFilters.addAll(['armeabi', 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64', 'mips', 'mips64'])
用来设置ndk需要编译的cpu架构,一般来说只需要armeabi-v7a,arm64-v8a,x86这三个cpu架构
path "jni/Android.mk"
设置要运行的mk文件路径

NDK_MODULE_PATH是用来设置模块的路径,在windows系统上使用分号;在非windows系统上使用冒号:分隔不同的ndk模块路径

会在Android.mk中调用执行其他模块的android.mk文件时使用

$(call import-module, scripting/js-bindings/proj.android)

执行上面代码时,会查找上面的模块路径,如果存在这个$modulePath/scripting/js-bindings/proj.android/Android.mk文件,则会执行这个文件。

所有模块路径下都找不到文件时,则会报错Are you sure your NDK_MODULE_PATH variable is properly defined。

jni/ Android.mk代码

如果需要查看Android.mk语法可以查看下这个https://www.cnblogs.com/gne-hwz/p/9996641.html

LOCAL_PATH := $(call my-dir)

include $(CLEAR_VARS)

LOCAL_MODULE := cocos2djs_shared
LOCAL_MODULE_FILENAME := libcocos2djs ifeq ($(USE_ARM_MODE),1)
LOCAL_ARM_MODE := arm
endif LOCAL_SRC_FILES := hellojavascript/main.cpp \
../../../Classes/AppDelegate.cpp \
../../../Classes/jsb_module_register.cpp \ LOCAL_C_INCLUDES := $(LOCAL_PATH)/../../../Classes ifeq ($(USE_ANY_SDK),1)
LOCAL_SRC_FILES += ../../../Classes/anysdk/SDKManager.cpp \
../../../Classes/anysdk/jsb_anysdk_basic_conversions.cpp \
../../../Classes/anysdk/manualanysdkbindings.cpp \
../../../Classes/anysdk/jsb_anysdk_protocols_auto.cpp LOCAL_C_INCLUDES += $(LOCAL_PATH)/../../../Classes/anysdk LOCAL_WHOLE_STATIC_LIBRARIES := PluginProtocolStatic
endif LOCAL_STATIC_LIBRARIES := cocos2d_js_static LOCAL_EXPORT_CFLAGS := -DCOCOS2D_DEBUG=2 -DCOCOS2D_JAVASCRIPT include $(BUILD_SHARED_LIBRARY) $(call import-module, scripting/js-bindings/proj.android)

上面代码的意思是使用LOCAL_SRC_FILES指定的cpp文件 作为编译模块的源文件,也就是说ndk会编译这些cpp文件,然后聚合到一个模块中。

最后一行是查找在gradle中定义NDK_MODULE_PATH路径中查找相对路径为scripting/js-bindings/proj.android/Android.mk文件,并执行这个Android.mk文件

然后这个proj.android下的文件mk文件会继续调用cocos文件夹下的mk文件,调用,调用,调用!。最后c++或c代码就编译完成了。

Application.mk目的是描述在你的应用程序中所需要的模块,这是一个可选文件,规定怎么编译so文件

比如,设置编译的模式debug或者release

  使用这个变量设置编译模式APP_OPTIM := release  默认是release模式

--------------- 越长大越无知

上一篇:Android Studio NDK编程-环境搭建及Hello!


下一篇:android最新版 极光推送