[cocos2dx]Android.mk学习

概述Android.mk是Android提供的一种makefile文件，用来指定诸如编译生成so库名、引用的头文件目录、需要编译的.c/.cpp文件和.a静态库文件等。要掌握jni，就必须熟练掌握Android.mk的语法规范。  由于该文件会被NDK的编译工具解析多次，因此应该尽量减少源码中声明变量，因为这些变量可能会被多次定义从而影响到后面的解析。这个文件的语法允许把源代码组织成模块，每个模块属于

AndroID.mk是AndroID提供的一种makefile文件，用来指定诸如编译生成so库名、引用的头文件目录、需要编译的.c/.cpp文件和.a静态库文件等。要掌握jni，就必须熟练掌握AndroID.mk的语法规范。

由于该文件会被NDK的编译工具解析多次，因此应该尽量减少源码中声明变量，因为这些变量可能会被多次定义从而影响到后面的解析。这个文件的语法允许把源代码组织成模块，每个模块属于下列类型之一：

APK程序：一般的AndroID程序，编译打包生成apk文件。 JAVA库：java类库，编译打包生成jar包文件。 C\C++应用程序：可执行的C/C++应用程序。 C\C++静态库：编译生产C/C++静态库，并打包成.a文件。 C\C++共享库：编译生成共享库（动态库），并打包成.so文件，有且只有共享库才能被安装/复制到APK包中。 一个androID子项目中会存在一个或多个AndroID.mk文件
单一的AndroID.mk文件：直接参考NDK的sample目录下的hello-jni项目，在这个项目中只有一个AndroID.mk文件 多个AndroID.mk文件：如果需要编译的模块比较多，我们可能会将对应的模块放置在相应的目录中，这样，我们可以在每个目录中定义对应的AndroID.mk文件（类似于上面的写法），最后，在根目录放置一个AndroID.mk文件，内容如下：include $(call all-subdir-makefiles)只需要这一行就可以了，它的作用就是包含所有子目录中的AndroID.mk文件 多个模块共用一个AndroID.mk ：这个文件允许你将源文件组织成模块，这个模块中含有：静态库(.a文件) 和动态库(.so文件)只有共享库才能被安装/复制到您的应用软件（APK）包中include $(BUILD_STATIC_liBRARY)编译出的是静态库 ;include $(BUILD_SHARED_liBRARY)编译出的是动态库 这里参考了网上一个通用的例子，编译简单的“Hello World”，来说明一下AndroID.mk编写。例如下面的文件：

sources/test/hello.csources/test/AndroID.mk

其中“hello.c”是一个JNI共享库，实现返回“hello world”字符串的原生方法。因此，AndroID.mk文件内容如下：

LOCAL_PATH := $(call my-dir)  include $(CLEAR_VARS)  LOCAL_MODulE := hello  LOCAL_SRC_fileS := hello.c  include $(BUILD_SHARED_liBRARY) 

解释一下这几行代码：
LOCAL_PATH := $(call my-dir) ： 一个AndroID.mk文件首先必须定义好LOCAL_PATH变量，用于在开发树中查找源文件。在这个例子中，宏函数my-dir由编译系统提供，用于返回当前路径（即包含AndroID.mk文件的目录）。
include $(CLEAR_VARS)：CLEAR_VARS由编译系统提供，指定让GNU MAKEfile清除了LOCAL_PATH变量外的许多LOCAL_***变量（例如：LOCAL_MODulE、LOCAL_SRC_fileS等）。这是非常有必要的，因为所有的编译文件都在同一个GUN MKAE执行环境中，所有的变量都是全局变量，不清除容易引起解析错误。
LOCAL_MODulE := hello：LOCAL_MODulE变量必须定义，用来标识在AndroID.mk文件描述的每一个模块。而且名称必须是唯一的，并且不能包含空格。编译系统会自动产生合适的前缀和后缀，比如一个被命名为hello的共享库模块，将会生成libhello.so文件。如果把库命名为libhello，编译系统将不会添加任何lib前缀，也会生成libhello.so文件。
LOCAL_SRC_fileS := hello.c：LOCAL_SRC_fileS变量必须包含将要编译打包进模块中的源代码文件。
include $(BUILD_SHARED_liBRARY)：BUILD_SHARED_liBRARY是编译系统提供的变量，指向一个GNU Makefile脚本（应该就是build/core目录下的shared_library.mk）,负责收集自从上次调用include $(CLEAR_VARS)以来，定义在LOCAL_***变量中的所有信息，并且决定编译什么，如何正确地去做，并根据其规则生成动态库。
自定义变量
以下是在 AndroID.mk中依赖或定义的变量列表，可以定义其他变量为自己使用，但是NDK编译系统保留下列变量名：
-以 LOCAL_开头的名字（例如 LOCAL_MODulE） -以 PRIVATE_,NDK_ 或 APP_开头的名字（内部使用） -小写名字（内部使用，例如‘my-dir’） -如果为了方便在 AndroID.mk 中定义自己的变量，建议使用 MY_前缀 NDK r5 开始支持预编译共享库。预编译共享库就是从其他地方获得源码编译出的共享库，而不是AndroID系统自带的。
声明共享库模块 把共享库声明为一个独立模块。假如 libfoo.so 与 AndroID.mk 位于同一目录。则 AndroID.mk 应该这样写：

LOCAL_PATH := $(call my-dir)    include $(CLEAR_VARS)  LOCAL_MODulE := foo-prebuilt     # 模块名  LOCAL_SRC_fileS := libfoo.so     # 模块的文件路径（相对于 LOCAL_PATH）    include $(PREBUILT_SHARED_liBRARY) # 注意这里不是 BUILD_SHARED_liBRARY  

这个共享库将被拷贝到 $PROJECT/obj/local 和 $PROJECT/libs/<abi> （strip过的）
在其他模块中引用这个共享库 在 AndroID.mk 中，将这个共享库的模块名加入 LOCAL_STATIC_liBRARIES （静态库）或 LOCAL_SHARED_liBRARIES （动态库）。例如,使用 libfoo.so 的方法:

include $(CLEAR_VARS)  LOCAL_MODulE := foo-user  LOCAL_SRC_fileS := foo-user.c  LOCAL_SHARED_liBRARY := foo-prebuilt  include $(BUILD_SHARED_liBRARY)  

为共享库导出头文件 这个共享库一般有相应的头文件，比如 libfoo.so 就有 foo.h。一个简单方法（在AndroID.mk中写）

include $(CLEAR_VARS)  LOCAL_MODulE := foo-prebuilt  LOCAL_SRC_fileS := libfoo.so  LOCAL_EXPORT_C_INCLUDES := $(LOCAL_PATH)/include  include $(PREBUILT_SHARED_liBRARY)   

这样，使用该共享库的模块就会在它的 LOCAL_C_INCLUDES 变量加入该头文件搜索路径。

#宏函数my-dir返回编译系统提供的当前路径，即AndroID.mk的目录#如（HelloWorld/proj.androID/jni/XX）LOCAL_PATH := $(call my-dir)#初始化模块  重置除LOCAL_PATH变量以外的所有变量 include $(CLEAR_VARS)#导入库目录$(call import-add-path,$(LOCAL_PATH)/../../cocos2d)$(call import-add-path,$(LOCAL_PATH)/../../cocos2d/external)$(call import-add-path,$(LOCAL_PATH)/../../cocos2d/cocos)#模块名，唯一。LOCAL_MODulE := cocos2dcpp_shared#模块文件名，唯一（可选）LOCAL_MODulE_filename := libcocos2dcpp
#把.cpp .c .cc等实现文件的路径赋值给LOCAL_SRC_fileS我用的是C++版  所以后缀是.cpp 我们新建文件时，需要在这里添加路径。LOCAL_SRC_fileS := hellocpp/main.cpp \	../../Classes/AppDelegate.cpp \	../../Classes/HelloWorldScene.cpp#配置头文件的搜索范围LOCAL_C_INCLUDES := $(LOCAL_PATH)/../../Classes#获取静态库LOCAL_WHolE_STATIC_liBRARIES := cocos2dx_static#追加静态库LOCAL_WHolE_STATIC_liBRARIES += cocosdenshion_static# LOCAL_WHolE_STATIC_liBRARIES += Box2d_static# LOCAL_WHolE_STATIC_liBRARIES += cocosbuilder_static# LOCAL_WHolE_STATIC_liBRARIES += spine_static# LOCAL_WHolE_STATIC_liBRARIES += cocostudio_static# LOCAL_WHolE_STATIC_liBRARIES += cocos_network_static# LOCAL_WHolE_STATIC_liBRARIES += cocos_extension_static#根据编译器提供的变量BUILD_SHARED_liBRARY生成动态库include $(BUILD_SHARED_liBRARY)#导入模块，以下是常用的几个模块$(call import-module,.)$(call import-audio/androID)# $(call import-module,Box2D)以下是cocos2dx-3.2新建项目时生成的AndroID.mk文件，基本语法：
 
 
“#” 注释“：=”  赋值“+=”  追加“$”   引用某变量的值
 如果文件少 直接在LOCAL_SRC_fileS这个变量里添加文件的路径就好了，若有几十个文件，一个个添加还不累死，而且难维护，难扩展，易出错，。。。  
LOCAL_PATH := $(call my-dir)include $(CLEAR_VARS)$(call import-add-path,$(LOCAL_PATH)/../../cocos2d/cocos)LOCAL_MODulE := cocos2dcpp_sharedLOCAL_MODulE_filename := libcocos2dcpp#wIDcard为扩展通配符#遍历目录和子目录define walk $(wildcard $(1)) $(foreach e,$(wildcard $(1)/*),$(call walk,$(e)))endef#遍历路径Classes下得目录和子目录文件，并存入ALLfileS变量中ALLfileS = $(call walk,$(LOCAL_PATH)/../../Classes)#从ALLfileS目录中提取文件，并存入file_List中#.cc是linux/Unix下为C++源文件的默认扩展名,与.cpp一个意思#.c 因为我要用到sqlite3.c  file_List := hellocpp/main.cppfile_List += $(filter %.cpp,$(ALLfileS))file_List += $(filter %.c,$(ALLfileS))file_List += $(filter %.cc,$(ALLfileS))#搜索Classes下的子目录文件file_INCLUDES += $(shell find $(LOCAL_PATH)/../../Classes -type d)#根据搜索到的文件名 编译资源文件LOCAL_SRC_fileS := $(file_List:$(LOCAL_PATH)/%=%)#提供搜索文件的路径LOCAL_C_INCLUDES := $(LOCAL_PATH)/../../Classes \	$(file_INCLUDES) \#静态库LOCAL_WHolE_STATIC_liBRARIES := cocos2dx_staticLOCAL_WHolE_STATIC_liBRARIES += cocosdenshion_static#LOCAL_WHolE_STATIC_liBRARIES += Box2d_static#LOCAL_WHolE_STATIC_liBRARIES += cocosbuilder_static#LOCAL_WHolE_STATIC_liBRARIES += spine_staticLOCAL_WHolE_STATIC_liBRARIES += cocostudio_staticLOCAL_WHolE_STATIC_liBRARIES += cocos_network_staticLOCAL_WHolE_STATIC_liBRARIES += cocos_extension_static#编译动态库#导入静态库对应的模块$(call import-#$(call import-module,editor-support/spine)$(call import-editor-support/cocostudio)$(call import-network)$(call import-extensions)
          总结       
以上是内存溢出为你收集整理的[cocos2dx]Android.mk学习全部内容，希望文章能够帮你解决[cocos2dx]Android.mk学习所遇到的程序开发问题。
如果觉得内存溢出网站内容还不错，欢迎将内存溢出网站推荐给程序员好友。
					
										


					

						
欢迎分享，转载请注明来源：内存溢出
原文地址: https://outofmemory.cn/web/1083778.html