[cocos2dx]Android.mk学习

前端之家收集整理的这篇文章主要介绍了[cocos2dx]Android.mk学习前端之家小编觉得挺不错的,现在分享给大家,也给大家做个参考。

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编写。例如下面的文件
  1. sources/test/hello.c
  2. sources/test/Android.mk
其中“hello.c”是一个JNI共享库,实现返回“hello world”字符串的原生方法。因此,Android.mk文件内容如下:
  1. LOCAL_PATH := $(call my-dir)
  2. include $(CLEAR_VARS)
  3. LOCAL_MODULE := hello
  4. LOCAL_SRC_FILES := hello.c
  5. 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 := helloLOCAL_MODULE变量必须定义,用来标识在Android.mk文件描述的每一个模块。而且名称必须是唯一的,并且不能包含空格。编译系统会自动产生合适的前缀和后缀,比如一个被命名为hello的共享库模块,将会生成libhello.so文件。如果把库命名为libhello,编译系统将不会添加任何lib前缀,也会生成libhello.so文件
LOCAL_SRC_FILES := hello.cLOCAL_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 应该这样写:
  1. LOCAL_PATH := $(call my-dir)
  2. include $(CLEAR_VARS)
  3. LOCAL_MODULE := foo-prebuilt # 模块名
  4. LOCAL_SRC_FILES := libfoo.so # 模块的文件路径(相对于 LOCAL_PATH)
  5. include $(PREBUILT_SHARED_LIBRARY) # 注意这里不是 BUILD_SHARED_LIBRARY
这个共享库将被拷贝到 $PROJECT/obj/local 和 $PROJECT/libs/<abi> (strip过的)

在其他模块中引用这个共享库

在 Android.mk 中,将这个共享库的模块名加入 LOCAL_STATIC_LIBRARIES (静态库)或 LOCAL_SHARED_LIBRARIES (动态库)。例如,使用 libfoo.so 的方法:
  1. include $(CLEAR_VARS)
  2. LOCAL_MODULE := foo-user
  3. LOCAL_SRC_FILES := foo-user.c
  4. LOCAL_SHARED_LIBRARY := foo-prebuilt
  5. include $(BUILD_SHARED_LIBRARY)

为共享库导出头文件

这个共享库一般有相应的头文件,比如 libfoo.so 就有 foo.h。一个简单方法(在Android.mk中写)
  1. include $(CLEAR_VARS)
  2. LOCAL_MODULE := foo-prebuilt
  3. LOCAL_SRC_FILES := libfoo.so
  4. LOCAL_EXPORT_C_INCLUDES := $(LOCAL_PATH)/include
  5. include $(PREBUILT_SHARED_LIBRARY)

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

  1. #宏函数my-dir返回编译系统提供的当前路径,即Android.mk的目录
  2. #如(HelloWorld/proj.android/jni/XX)
  3. LOCAL_PATH := $(call my-dir)
  4.  
  5.  
  6. #初始化模块 重置除LOCAL_PATH变量以外的所有变量
  7. include $(CLEAR_VARS)
  8.  
  9.  
  10. #导入库目录
  11. $(call import-add-path,$(LOCAL_PATH)/../../cocos2d)
  12. $(call import-add-path,$(LOCAL_PATH)/../../cocos2d/external)
  13. $(call import-add-path,$(LOCAL_PATH)/../../cocos2d/cocos)
  14.  
  15.  
  16. #模块名,唯一。
  17. LOCAL_MODULE := cocos2dcpp_shared
  18. #模块文件名,唯一(可选)
  19. LOCAL_MODULE_FILENAME := libcocos2dcpp

  20. #把.cpp .c .cc等实现文件的路径赋值给LOCAL_SRC_FILES
  21. 我用的是C++版 所以后缀是.cpp 我们新建文件时,需要在这里添加路径。
  22. LOCAL_SRC_FILES := hellocpp/main.cpp \
  23. ../../Classes/AppDelegate.cpp \
  24. ../../Classes/HelloWorldScene.cpp
  25. #配置头文件搜索范围
  26. LOCAL_C_INCLUDES := $(LOCAL_PATH)/../../Classes
  27. #获取静态库
  28. LOCAL_WHOLE_STATIC_LIBRARIES := cocos2dx_static
  29. #追加静态库
  30. LOCAL_WHOLE_STATIC_LIBRARIES += cocosdenshion_static
  31.  
  32.  
  33. # LOCAL_WHOLE_STATIC_LIBRARIES += Box2d_static
  34. # LOCAL_WHOLE_STATIC_LIBRARIES += cocosbuilder_static
  35. # LOCAL_WHOLE_STATIC_LIBRARIES += spine_static
  36. # LOCAL_WHOLE_STATIC_LIBRARIES += cocostudio_static
  37. # LOCAL_WHOLE_STATIC_LIBRARIES += cocos_network_static
  38. # LOCAL_WHOLE_STATIC_LIBRARIES += cocos_extension_static
  39.  
  40.  
  41. #根据编译器提供的变量BUILD_SHARED_LIBRARY生成动态库
  42. include $(BUILD_SHARED_LIBRARY)
  43.  
  44.  
  45. #导入模块,以下是常用的几个模块
  46.  
  47.  
  48. $(call import-module,.)
  49. $(call import-audio/android)
  50.  
  51.  
  52. # $(call import-module,Box2D)
  53. dio)
  54. 以下是cocos2dx-3.2新建项目时生成Android.mk文件基本语法:

  55. “#” 注释
  56. “:=”  赋值
  57. “+=”  追加
  58. $   引用某变量的值
  59. 如果文件 直接在LOCAL_SRC_FILES这个变量里添加文件的路径就好了,若有几十个文件,一个个添加还不累死,而且难维护,难扩展,易出错,。。。
  60. LOCAL_PATH := $(call my-dir)
  61. include $(CLEAR_VARS)
  62. $(call import-add-path,$(LOCAL_PATH)/../../cocos2d/cocos)
  63. LOCAL_MODULE := cocos2dcpp_shared
  64. LOCAL_MODULE_FILENAME := libcocos2dcpp
  65. #widcard为扩展通配
  66. #遍历目录和子目录
  67. define walk
  68.  $(wildcard $(1)) $(foreach e,$(wildcard $(1)/*),$(call walk,$(e)))
  69. endef
  70. #遍历路径Classes下得目录和子目录文件,并存入ALLFILES变量中
  71. ALLFILES = $(call walk,$(LOCAL_PATH)/../../Classes)
  72. #从ALLFILES目录中提取文件,并存入FILE_LIST中
  73. #.cc是Linux/Unix下为C++源文件的默认扩展名,与.cpp一个意思
  74. #.c 因为我要用到sqlite3.c  
  75. FILE_LIST := hellocpp/main.cpp
  76. FILE_LIST += $(filter %.cpp,$(ALLFILES))
  77. FILE_LIST += $(filter %.c,$(ALLFILES))
  78. FILE_LIST += $(filter %.cc,$(ALLFILES))
  79. #搜索Classes下的子目录文件
  80. FILE_INCLUDES += $(shell find $(LOCAL_PATH)/../../Classes -type d)
  81. #根据搜索到的文件名 编译资源文件
  82. LOCAL_SRC_FILES := $(FILE_LIST:$(LOCAL_PATH)/%=%)
  83. #提供搜索文件的路径
  84. LOCAL_C_INCLUDES := $(LOCAL_PATH)/../../Classes \
  85. 	$(FILE_INCLUDES) \
  86. #静态库
  87. LOCAL_WHOLE_STATIC_LIBRARIES := cocos2dx_static
  88. LOCAL_WHOLE_STATIC_LIBRARIES += cocosdenshion_static
  89. #LOCAL_WHOLE_STATIC_LIBRARIES += Box2d_static
  90. #LOCAL_WHOLE_STATIC_LIBRARIES += cocosbuilder_static
  91. #LOCAL_WHOLE_STATIC_LIBRARIES += spine_static
  92. LOCAL_WHOLE_STATIC_LIBRARIES += cocostudio_static
  93. LOCAL_WHOLE_STATIC_LIBRARIES += cocos_network_static
  94. LOCAL_WHOLE_STATIC_LIBRARIES += cocos_extension_static
  95. #编译动态库
  96. #导入静态库对应的模块
  97. $(call import-#$(call import-module,editor-support/spine)
  98. $(call import-editor-support/cocostudio)
  99. $(call import-network)
  100. $(call import-extensions)

猜你在找的Cocos2d-x相关文章