NDK笔记---Android.mk文件

借鉴并整理:http://blog.sina.com.cn/s/blog_602f8770010148ce.html

android-ndk-r10d/build/core/*.mk文件

结合自己的Android.mk文件记录
- Android.mk简介：
Android.mk文件用来告知NDK Build系统关于Source的信息。 Android.mk是GNU Makefile的一部分，且将被Build System解析一次或多次。所以，请尽量少的在Android.mk中声明变量，也不要假定任何东西不会在解析过程中定义。

Android.mk文件语法允许我们将Source打包成一个”modules”. modules可以是：
静态库
动态库。

只有动态库可以被 install/copy到应用程序包(APK). 静态库则可以被链接入动态库。
可以在一个Android.mk中定义一个或多个modules. 也可以将同一份source 加进多个modules.

Build System帮我们处理了很多细节而不需要我们再关心。例如：你不需要在Android.mk中列出头文件和外部依赖文件。NDK Build System自动帮我们提供这些信息。这也意味着，当用户升级NDK后，你将可以受益于新的toolchain/platform而不必再去修改Android.mk.

每一个NDK程序都是必备的Android.mk程序

• Build System构建系统,是基于GNU Makefile的是由多种GNU Makefile片段构成,这些片段在ndk安装程序的build/core中
  标注*号的是在一个mk文件中必须定义的

    LOCAL_PATH := $(call my-dir) *
    include $(CLEAR_VARS)       *

    LOCAL_MODULE_TAGS := optional  *

    LOCAL_STATIC_JAVA_LIBRARIES := gson jcifs 

    LOCAL_SRC_FILES := $(call all-java-files-under, src)
    #LOCAL_SRC_FILES := $(call all-subdir-java-files)  

    #LOCAL_SDK_VERSION := current
    LOCAL_CERTIFICATE := platform

    LOCAL_PACKAGE_NAME := IServerService  *

    include $(BUILD_PACKAGE)

    include $(CLEAR_VARS)

    LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES  := gson:libs/gson-2.7.jar jcifs:libs/jcifs-1.3.18.jar 

    include $(BUILD_MULTI_PREBUILT)

    # Use the folloing include to make our test apk.
    include $(call all-makefiles-under,$(LOCAL_PATH))

• 关键词如下

  1. LOCAL_PATH := $(call my-dir)
     每个Android.mk文件必须以定义LOCAL_PATH为开始。它用于在开发tree中查找源文件。宏my-dir则由Build System提供。返回包含Android.mk的目录路径。

  2. include $(CLEAR_VARS) //build/core/clear-vars.mk
     CLEAR_VARS 变量由Build System提供。并指向一个指定的GNU Makefile，由它负责清理很多LOCAL_xxx.
     例如：LOCAL_MODULE, LOCAL_SRC_FILES, LOCAL_STATIC_LIBRARIES等等。但不清理LOCAL_PATH. 这个清理动作是必须的，因为所有的编译控制文件由同一个GNU Make解析和执行，其变量是全局的。所以清理后才能避免相互影响。

  3. LOCAL_MODULE_TAGS := optional/user/eng/tests 四个选项
     user 该模块只在user版本下才编译
     eng 该模块只在eng版本下编译
     tests 该模块只在tests版本下编译
     optional 在所有版本下都会编译

     LOCAL_MODULE := hello-jni
     LOCAL_MODULE模块必须定义，以表示Android.mk中的每一个生成输出模块的名字。名字必须唯一且不包含空格。Build System会自动添加适当的前缀和后缀。例如，foo，要产生动态库，则生成libfoo.so.
     但请注意：如果模块名被定为：libfoo.则生成libfoo.so. 不再加前缀。

     LOCAL_MODULE_FILENAME 重新定义当前模块名字

  4. LOCAL_STATIC_JAVA_LIBRARIES := gson jcifs javax.servlet.jsp_2 javax.servlet_3
     LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES := gson:libs/gson-2.7.jar jcifs:libs/jcifs-1.3.18.jar

  5. LOCAL_SRC_FILES := hello-jni.c
     通过空格分开添加多个源文件名;
     LOCAL_PATH的相对路径
     LOCAL_SRC_FILES包含将要打包如模块的C/C++ 源码。不必列出头文件，build System 会自动帮我们找出依赖文件。
     缺省的C++源码的扩展名为.cpp. 也可以修改，通过LOCAL_CPP_EXTENSION。

  6. LOCAL_CPP_EXTENSION
     C++源文件的默扩展名.cpp.为c++程序指定一个或者多个扩展名

  7. LOCAL_CERTIFICATE := platform
     LOCAL_CERTIFICATE 后面是签名文件的文件名，说明IServerService.apk是一个需要platform key签名的APK

  8. LOCAL_PACKAGE_NAME := IServerService // == LOCAL_MODULE
     package的名字，这个名字在脚本中将标识app或package

  9. include $(BUILD_PACKAGE) //用来编译package/app下的apk文件 ,,与10一个性质

  10. include $(BUILD_SHARED_LIBRARY)

      引入模块构建共享库.
      BUILD_SHARED_LIBRARY：是Build System提供的一个变量，指向一个GNU Makefile Script。它负责收集自从上次调用 include $(CLEAR_VARS) 后的所有LOCAL_XXX信息。并决定编译成为什么类型的模块。

      BUILD_STATIC_LIBRARY：编译为静态库。//build-static-library.mk
      BUILD_SHARED_LIBRARY ：编译为动态库//build-shared-library.mk
      BUILD_EXECUTABLE：编译为独立可执行程序//build-executable.mk

  11. include $(all-subdir-makefiles)
      包含当前目录下的所有子目录下的mk文件
      调用以上命令可以将所有的Android.mk文件包含在当前项目构建过程中;

  12. LOCAL_SRC_FILES := $(call all-subdir-c-files)

  13. include $(call all-makefiles-under,$(LOCAL_PATH))
      //build LOCAL_PATH 加载当前目录下的所有makefile文件

  14. LOCAL_SRC_FILES := $(call all-java-files-under, src) //all-java-files-under宏的定义是在build/core/definitions.mk中
      //src表示目录
      包含java源码,表示在src目录下的java源码,当然默认包含LOCAL_PATH下的所有java文件.

  15. LOCAL_SRC_FILES := $(call all-subdir-java-files)
      java子目录中的所有java文件

• 多个共享库可以在同一个Android.mk中被定义
  如下格式

  LOCAL_PATH := $(call my-dir)

  //模块一

  include $(CLEAR_VARS)

  LOCAL_MODULE := modulel
  LOCAL_SRC_FILES := moduel.c
  include $(BUILD_SHARED_LIBRARY)

  //模块二

  include $(CLEAR_VARS)

  LOCAL_MODULE := modulel2
  LOCAL_SRC_FILES := moduel2.c
  include $(BUILD_SHARED_LIBRARY)

  处理完成Android.mk文件后会生成两个共享文件: libmodulel.so和libmodulel2.so

  • 构建静态库
    Android NDK支持静态库,但不直接使用静态库,需要其共享库调用,如第三方源代码编成静态库被调用.
    如下格式:
    LOCAL_PATH := $(call my-dir)

  //模块一 静态库 可以是单独一个模块亦可以是第三方库源码

  include $(CLEAR_VARS)

  LOCAL_MODULE := modulel3
  LOCAL_SRC_FILES := moduel3.c
  include $(BUILD_STATIC_LIBRARY)

  //模块二

  include $(CLEAR_VARS)

  LOCAL_MODULE := modulel4
  LOCAL_SRC_FILES := moduel4.c

  LOCAL_STATIC_LIBRARIES := modulel3 //使用静态库

  include $(BUILD_SHARED_LIBRARY)

  //模块三 使用模块一的静态库

  include $(CLEAR_VARS)

  LOCAL_MODULE := modulel5
  LOCAL_SRC_FILES := moduel5.c

  LOCAL_SHARED_LIBRARIES := modulel4 //使用共享库

  include $(BUILD_SHARED_LIBRARY)