本文将带你了解Android应用开发之Android 系统---Android.mk入门，希望本文对大家学Android有所帮助

Android.mk入门
这篇Blog主要记录向系统源码添加模块时使用的Makefile，和NDK编程使用的makefile有一些差异。
Android的mk文件是有很强的套路的，下面我在我的/packsges/app/文件夹下建立一个名字叫做MakefileDemo的工程，里面的目录结构如图所示：
libs存放了我使用的jar包这里目前只有一个dom4j-1.6.1.jar，src是存放源代码的目录，res是资源目录。
现在我们要编译这个apk（假设我们已经编译过一次系统源码）最主要的是Android,mk这个文件，这个文件告诉mmm（也可以是make，m，mm）命令如何去编译这个APK，下面就来一步一步写一下这个mk文件。
第一步
加入这段代码
?12LOCAL_PATH := $(call my-dir)include $(CLEAR_VARS)
LOCAL_PATH := $(call my-dir)，这句代码LOCAL_PATH是变量名，$(call my-dir)的意思是调用my-dir这个函数，这个函数的返回值是Android.mk这个文件所在的位置，对我这个项目来说该函数的返回值就是/packsges/app/MakefileDemo/。LOCAL_PATH这个变量是一定要定义的，它告诉编译系统当前模块的位置。
include $(CLEAR_VARS)这句代码的作用是清楚除了LOCAL_PATH变量之外的LOCAL_XXX变量，为什么要清楚这些变量呢？因为在编译MakefileDemo模块之前可能编译过别的模块，例如之前编译=过Launcher3这个模块人后这个模块升值了一个LOCAL_MODULE紧接着编译我们的MakefileDemo模块但是我们模块的mk文件不需要LOCAL_MODULE并且没有include $(CLEAR_VARS)清楚上个模块设置的变量，那么这个时候Launcher3的LOCAL_MODULE变量就会被Build系统误认为是我们的MakefileDemo的，这样就会产生不可预知的错误。
两句代码是mk文件的标配，基本上所有的mk文件都需要这两句代码。

注：LOCAL_PATH :=(callmydir)这句代码必须放在include(callmydir)这句代码必须放在include(CLEAR_VARS)这句代码前面，否则call my-dir不能返回正确的结果，具体原因请参照这篇博客
第二步
?123LOCAL_PATH := $(call my-dir)include $(CLEAR_VARS)LOCAL_SRC_FILES :=$(call all-subdir-java-files)
这里加入了LOCAL_SRC_FILES :=$(call all-subdir-java-files)这句代码，LOCAL_SRC_FILES变量代表需要编译的文件，这里调用了all-subdir-java-files函数，这个函数的返回值是LOCAL_PATH子目录的所有java文件，一般这样写已经满足大部分需求了，也可以直接写文件路径，多个文件使用空格+\+换行隔开，例如：
?123LOCAL_SRC_FILES := $(LOCAL_PATH)/src/com/example/yuanjize/Main.java \ $(LOCAL_PATH)/src/com/example/yuanjize/Demo.java \ $(LOCAL_PATH)/src/com/example/yuanjize/Demo2.java
第三步
由于我们要使用framework.jar和dom4j-1.6.1.jar的一些API，所以我们要引入这两个jar包，接下来代码就变成了这样：
?12345LOCAL_PATH := $(call my-dir)include $(CLEAR_VARS)LOCAL_SRC_FILES :=$(call all-subdir-java-files)LOCAL_JAVA_LIBRARIES := framework LOCAL_STATIC_JAVA_LIBRARIES := dom4j-1.6
这里就有一个问题了，为什么这两种jar包配置的方式不一样呢？答案就是：framework.jar存在于系统中，打包apk的时候不会打包进去而是apk在运行的时候从/system/frameword/frameword.jar加载

 这里需要说明一下静态库和动态库。
我们在写Android程序的时候经常用的一些类例如Activity，Handler，Service都是来自android.jar这个jar包（位置在SDK目录下的/platforms/android-XX/android.jar）但是如果反编译apk可以发现我们并不能看到这些类的源码，为什么呢？因为这些类都是存在在android系统中的，apk在运行的时候会自动从系统存放jar包的目录中去加载这些类。这些jar包就是动态库。
那么静态库是什么样子的呢？我们的dom4j-1.6.1.jar就是静态库，因为我们的系统中没有这个jar包，apk打包的时候会把这个jar包打包，反编译一下可以从dex文件中看见它。
所以引用这两个jar包要使用不同的变量，LOCAL_JAVA_LIBRARIES用于引用动态jar，LOCAL_STATIC_JAVA_LIBRARIES引用静态jar。（这里设置的是库的别名，但是我们一般就是把jar的名写进去，例如dom4j-1.6，build脚本会到别名对应的目录下去找到jar包，Build脚本后面会说）
第四步
?123456LOCAL_PATH := $(call my-dir)include $(CLEAR_VARS)LOCAL_SRC_FILES :=$(call all-subdir-java-files)LOCAL_JAVA_LIBRARIES := framework LOCAL_STATIC_JAVA_LIBRARIES := dom4j-1.6LOCAL_PACKAGE_NAME := MakefileDemo
这句代码LOCAL_PACKAGE_NAME := MakefileDemo指定了apk名为MakefileDemo这个名字在系统中必须是独一无二的，系统中各个模块的LOCAL_PACKAGE_NAME不能是相同的。如果是相同的呢？假如我的LOCAL_PACKAGE_NAME设置成Music那么编译这个apk之后生成的apk会覆盖out/target/product/XXXX定制版本/system/app/Music/Music.apk，也就是覆盖了手机里面原本的Music。
第五步
?1234567LOCAL_PATH := $(call my-dir)include $(CLEAR_VARS)LOCAL_SRC_FILES :=$(call all-subdir-java-files)LOCAL_JAVA_LIBRARIES := framework LOCAL_STATIC_JAVA_LIBRARIES := dom4j-1.6LOCAL_PACKAGE_NAME := MakefileDemoLOCAL_MODULE_TAGS := optional
LOCAL_MODULE_TAGS变量指明了编译的标签，当我们编译源码的时候需要调用lunch函数，lunch函数会打印出来源码包含的定制版本，可以分成user，userdebug，eng三种，选择不同的定制版本会编译不同的模块，一个模块是否在编译源码（也有可能使用make eng这种命令，这个命令编译包含LOCAL_MODULE_TAGS指定为eng的模块）的时候编译就是由这个标签决定，具体的编译策略这里不细说，以后研究Build系统时再深入讨论。
LOCAL_MODULE_TAGS的取值有user eng optional debug(网上还查到有一个test选项不过不太了解)，optional选项表明在所有版本都会被编译，user在user版本被编译，debug在userdebug版本被编译，eng就不说了和前几个一样，就是套路……,一般情况下为了方便我们编译自己apk的话为了方便都会选择optional。
第六步
我们写完了代码要发布的时候做的最后一件事—签名。
?12345678LOCAL_PATH := $(call my-dir)include $(CLEAR_VARS)LOCAL_SRC_FILES :=$(call all-subdir-java-files)LOCAL_JAVA_LIBRARIES := framework LOCAL_STATIC_JAVA_LIBRARIES := dom4j-1.6LOCAL_PACKAGE_NAME := MakefileDemoLOCAL_MODULE_TAGS := optionalLOCAL_CERTIFICATE := platform
LOCAL_CERTIFICATE指定使用了模块使用的签名文件，这里是使用system级别的签名文件。
通常我们如果指定android:sharedUserId="android.uid.system"来获取system级别的权限的话，签名文件就一定要用platform。
LOCAL_CERTIFICATE可以的取值有testkey media platform shared，使用情况和platform一样，看你想获取什么级别的权限。比如我想获取media级别的那么就在清单文件加入android:sharedUserId="android.uid.media然后让LOCAL_CERTIFICATE取值media。其实所有的签名文件都在build/target/product/security目录下面，这个目录包含一些XXX.x509.pem（公钥文件）,文件和XXX.pk8（私钥文件）文件（公钥私钥是成对出现的），例如share.pk8和share.x509.pem就是当LOCAL_CERTIFICATE := share时使用的签名文件。LOCAL_CERTIFICATE也可以指定自己生生的签名文件，如果想了解可以看下这篇博客。
第七步
指定编译脚本或者也可以看成想要编译成什么类型的文件
?123456789LOCAL_PATH := $(call my-dir)include $(CLEAR_VARS)LOCAL_SRC_FILES :=$(call all-subdir-java-files)LOCAL_JAVA_LIBRARIES := framework LOCAL_STATIC_JAVA_LIBRARIES := dom4j-1.6LOCAL_PACKAGE_NAME := MakefileDemoLOCAL_MODULE_TAGS := optionalLOCAL_CERTIFICATE := platforminclude $(BUILD_PACKAGE)
最后一步include $(BUILD_PACKAGE)指定了编译的脚本，我们想编译成apk所以我们指定的是BUILD_PACKAGE脚本。
然后我们现在编译这个模块mmm -B packages/app/MakefileDemo/
然后就出现了下面这个错误

 make:*No rule to make target out/target/common/obj/JAVA_LIBRARIES/dom4j-1.6.1_intermediates/classes.jack’, needed by out/target/common/obj/APPS/MakefileDemo_intermediates/with-local/classes.dex’. Stop.

出现这个错误的原因是：MakefileDemo这个apk依赖dom4j-1.6.1.jar然后make程序就去out/target/common/obj/JAVA_LIBRARIES/这个文件夹下寻找dom4j-1.6.1_intermediates/classes.jack文件，如果存在那么拿到这个jar继续buildMakefileDemo，如果没有找到那么就会查看我们的makefile有没有语句可以生成out/target/common/obj/JAVA_LIBRARIES/dom4j-1.6.1_intermediates/classes.jack'这个target。
所以这里就需要修改makefile来解决这个问题。
修改如下：
?12345678910111213LOCAL_PATH := $(call my-dir)include $(CLEAR_VARS)LOCAL_SRC_FILES :=$(call all-subdir-java-files)LOCAL_JAVA_LIBRARIES := framework LOCAL_STATIC_JAVA_LIBRARIES := dom4j-1.6LOCAL_PACKAGE_NAME := MakefileDemoLOCAL_MODULE_TAGS := optionalLOCAL_CERTIFICATE := platforminclude $(BUILD_PACKAGE) include $(CLEAR_VARS)  LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES := dom4j-1.6.1:libs/dom4j-1.6.1.jarinclude $(BUILD_MULTI_PREBUILT)

LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES变量指定了需要进行预编译的库，指定的语法是静态库别名：静态库所在文件夹例如dom4j-1.6.1:libs/dom4j-1.6.1.jar
再次build一次看下log，成功了：
?123456Install: out/target/product/XXX/system/app/MakefileDemo/MakefileDemo.apktarget Prebuilt: dom4j-1.6.1 (out/target/common/obj/JAVA_LIBRARIES/dom4j-1.6.1_intermediates/classes.jar)target Prebuilt: dom4j-1.6.1 (out/target/common/obj/JAVA_LIBRARIES/dom4j-1.6.1_intermediates/javalib.jar)target Prebuilt: dom4j-1.6.1 (out/target/product/XXXX/obj/JAVA_LIBRARIES/dom4j-1.6.1_intermediates/javalib.jar)make: Leaving directory `/home/yuanjize/android'#### make completed successfully (6 seconds) ####
打开上面生成的jar包可以发现都是dom4j-1.6.1的代码，BUILD_MULTI_PREBUILT只是改了个名字，至于classes.jack文件是Android 6.0最新的编译工具，感兴趣可以搜索一下。
到了这里已经可以完美的编译这个apk了。
总结一下这个mk文件的结构。
Start设置LOCAL_PATH清除除了LOCAL_PATH以外的所有LOCAL_PATH变量指定MODULE_TAGS指定要编译的源码目录指定模块或者apk名称是否编译成apk？指定签名指定build脚本是否引入外部静态库？使用BUILD_MULTI_PREBUILT脚本来处理静态库？Endyesnoyesno
最后介绍几个BUILD_XXXX脚本
我们这里使用的BUILD脚本是BUILD_PACKAGE作用是把这个模块编译成一个apk，下面的表格介绍了一些build脚本和对应的功能。


 
 
  脚本
 
  公能
 


 
 BUILD_PACKAGE
 编译成apk
 
 
 BUILD_JAVA_LIBRARY
 编译成动态JAVA库
 
 
 BUILD_STATIC_JAVA_LIBRARY
 编译成静态JAVA库
 
 
 BUILD_MULTI_PREBUILT
 定义了如何处理一个或多个已编译文件（拷贝操作）
 
 
 BUILD_PREBUILT
 定义了如何处理一个已编译文件（拷贝操作，只能copy一个）
 
 
 BUILD_STATIC_LIBRARY
 编译c/c++静态库
 
 
 BUILD_SHARED_LIBRARY
 编译c/c++共享库（.so文件）
 
 
 BUILD_EXECUTABLE
 编译成可执行程序
 


使用Build脚本生成的模块都在：
?12out/target/common/obj/out/target/product/定制版本/obj/
这两个目录下。
生成的apk在
out/target/product/定制版本/system/app/app名称/这个目录。
Build脚本的名字都是把宏的BUILD_前缀去掉，例如BUILD_EXECUTABLE的教本文件名字就是EXECUTABLE.mk,所有的脚本都在build/core目录下。    

本文由职坐标整理并发布，希望对同学们有所帮助。了解更多详情请关注职坐标移动开发之Android频道！