Android.mk常用说明整理

• LOCAL_PATH := $(call my-dir)

  必须定义。当前路径，即本Android.mk文件所处目录。每个Android.mk文件必须先定义 LOCAL_PATH 变量，此变量表示源文件在开发树中的位置。$(call my-dir)为编译系统Build System提供的宏函数，返回的就是当前目录路径。避免频繁定义，LOCAL_PATH不会被$(CLEAR_VARS)清理，所以一个文件中，只需要定义一次即可。

• include $(CLEAR_VARS)

  必须定义。清空所有LOCAL_xxx变量，但不清理LOCAL_PATH变量。CLEAR_VARS为编译系统Build System提供的宏函数，$(CLEAR_VARS)指向的是一个特殊的GNU Makefile（clear_vars.mk），负责清理LOCAL_xxx变量，如：LOCAL_MODULE, LOCAL_SRC_FILES, LOCAL_STATIC_LIBRARIES等等。 这个清理动作是必须的，因为所有的编译控制文件由同一个GNU Make解析和执行，其变量(LOCAL_xxx)是全局的。所以清理后才能避免相互影响。

• LOCAL_PACKAGE_NAME := HelloWorld 或 LOCAL_MODULE:= HelloWorld

• 必须定义，模块名称，名称必须是唯一的且不包含空格，除应用(apk)可以另外使用LOCAL_PACKAGE_NAME外，其余的模块都以LOCAL_MODULE指定名称（如module包HelloWorldLib）

• LOCAL_SRC_FILES := $(call all-java-files-under, src/java)

  LOCAL_SRC_FILES := \
  			$(call all-java-files-under, src/java) \
  			src/java/com/android/helloworld/aidl/hello-0.aidl \
  			hello-1.c \
  			hello-2.so 
  

  必须定义，变量 LOCAL_SRC_FILES 为Build Modules提供的app所有源码Source文件列表，不需要列出依赖文件。$(call all-java-files-under, src/java)宏函数，可以得到指定目录src/java下的所有java源码，宏all-java-files-under定义在build/core/definitions.mk中。其他如aidl、c/c++、so等文件需手动添加。

• LOCAL_PROGUARD_ENABLED := disabled

  不使用代码混淆的工具进行代码混淆。

  可选定义，默认LOCAL_PROGUARD_ENABLED := full，即代码全部混淆。如果是user或userdebug。取值full, disabled, custom

• LOCAL_MANIFEST_FILE := AndroidManifest.xml

  指定AndroidManifest.xml路径为当前目录下。表示 Manifest 的路径，可以区分配置。

  # Choose the appropriate AndroidManifest.xml
  ifeq ($(strip $(MTK_EXCHANGE_SUPPORT)),yes)
      LOCAL_MANIFEST_FILE := AndroidManifest.xml
  else
      LOCAL_MANIFEST_FILE := src/AndroidManifest.xml
  endif
  

• LOCAL_STATIC_ANDROID_LIBRARIES := android-support-v4

  LOCAL_STATIC_ANDROID_LIBRARIES := \    
      android-support-transition \
      android-support-v13 \
      android-support-v7-appcompat \
      android-support-v4
  

  指定依赖的android类库。

• LOCAL_STATIC_JAVA_LIBRARIES := static-library

  LOCAL_STATIC_JAVA_LIBRARIES := \
  						gson_appname \						
  						hellolib_appname \						
  						hellolibaar_appname \
  						android-support-v4
  

  指定依赖的静态java类库，最终会打包到apk里面（添加的静态库编译会以拷贝的方式加到需要他的应用中）。

  LOCAL_STATIC_JAVA_LIBRARIES 后面为依赖的静态库别名，可以随便取名，对应后面LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES。此处也可以指定android类库。

• LOCAL_STATIC_JAVA_AAR_LIBRARIES := aar-library

  LOCAL_STATIC_JAVA_AAR_LIBRARIES := \
  						111aar_appname \
  						222aar_appname 
  

  指定依赖的aar包。冒号后为aar别名，可以配置在此变量，也可以配置在LOCAL_STATIC_JAVA_LIBRARIES中，方式相同。

• LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES := xxx:xxx.jar

  LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES := \
  						gson_appname:/libs/gson-2.2.4.jar \
                          hellolib_appname:/libs/hellolib.jar \
                          hellolibaar_appname:/libs/hellolibaar.aar \
  						111aar_appname:/libs/111aar.aar \
  						222aar_appname:/libs/222aar.aar 
  

  表示依赖的静态库具体路径，也可以是aar包。其中冒号前面为包别名，与LOCAL_STATIC_JAVA_LIBRARIES的值对应。冒号后面为包的实际路径。如果如上编写的，那么你可以使用AAR包中的java代码和so库了（如果有so库的话），

• LOCAL_AAPT_FLAGS := --auto-add-overlay

  LOCAL_AAPT_FLAGS := \
  	--auto-add-overlay \
  	--extra-packages com.xxxx.111aar
  

  设置aapt(Android Asset Packaging Tool)的参数：

  –auto-add-overlay : 配置应用程序打包标志，设置为自动添加并覆盖

  –extra-packages : com.xxxx.111aar

  如果需要使用的aar包中的R文件资源，那么需要在LOCAL_AAPT_FLAGS 变量后面添加AAR包中的包名，这AAR打包过程中，会有一个清单文件打包进去，只需要拷贝清单文件中package的包名并赋值给LOCAL_AAPT_FLAGS 即可。

• LOCAL_USE_AAPT2 := true

  使用appt2，aapt2是在aapt上做了优化。因为appt2在编译打包的时候，会有一些错误bug?，所以可以关闭appt2，这样就是默认使用appt了。

• LOCAL_JAVA_LIBRARIES

  ###例如：当前APK的Android.mk文件中出现该属性：
  LOCAL_JAVA_LIBRARIES += mediatek-framework telephony-common mediatek-telephony-base
  ###表示在编译当前APK的时候，导入framework-base中的一下部分jar，具体看源码该使用类所在的位置。
  

  指定依赖的共享java类库，只是编译的时候引用。

• include $(BUILD_STATIC_JAVA_LIBRARY)

  将当前模块编译成一个静态的 Java 库

• include $(BUILD_PACKAGE)

  编译生成apk，指向的是package.mk

• include$(BUILD_MULTI_PREBUILT)

  ​ 编译构建，Android提供了Prebuilt编译方法，两个文件prebuilt.mk和multi_prebuilt.mk，对应的方法宏是BUILD_PREBUILT和 BUILD_MULTI_PREBUILT。

  ​ prebuilt.mk就是prebuilt的具体实现，它是针对独立一个文件的操作，multi_prebuilt.mk 可以针对多个文件的，它对多个文件进行判断，然后调用prebuilt对独立一个文件进行处理。

  ​ 在 Android Build 系统中，编译是以模块（而不是文件）作为单位的，每个模块都有一个唯一的名称，一个模块的依赖对象只能是另外一个模块，而不能是其他类型的对象。对于已经编译好的二进制库，如果要用来被当作是依赖对象，那么应当将这些已经编译好的库作为单独的模块。对于这些已经编译好的库使用 BUILD_PREBUILT 或 BUILD_MULTI_PREBUILT。

  ​ 例如：当编译某个 Java 库需要依赖一些 Jar 包时，并不能直接指定 Jar 包的路径作为依赖，而必须首先将这些 Jar 包定义为一个模块，然后在编译 Java 库的时候通过模块的名称来依赖这些 Jar 包。

• include $(call all-makefiles-under,$(callall−makefiles−under,(LOCAL_PATH))

  如果子目录也有文件需要编译build，那么使用这句即可包含子目录所有的Android.mk文件

• LOCAL_DX_FLAGS := --multi-dex

  编译该模块，启用mulit dex，防止java方法Dex 64K限制问题

• LOCAL_JACK_FLAGS += --multi-dex native

  Jack 的目的是让 Android 支持更多的 Java 8 特性。

• LOCAL_RESOURCE_DIR := $(LOCAL_PATH)/app/src/main/res

  表示 Res 的路径

• LOCAL_MODULE_SUFFIX

  不用定义，module的后缀，=.apk。

• LOCAL_MODULE_TAGS := optional

  该模块在所有版本下都编译。

  可选定义，默认optional，可选项如下：

  user: 指该模块只在user版本下才编译

  eng: 指该模块只在eng版本下才编译

  tests: 指该模块只在tests版本下才编译

  optional:指该模块在所有版本下都编译

  PS：LOCAL_MODULE_TAGS 变量跟TARGET_BUILD_VARIANT 变量息息相关。 android系统编译时如果不指定TARGET_BUILD_VARIANT 变量的值，默认 TARGET_BUILD_VARIANT=eng ，这一项指定 编译android时形成的版本风格，一般发布时使用这个值,当然还有user,debuguser等风格值

  PS：如果两次make之间选了不同的编译模式，则需要运行一下make installclean，确保本次make不会用到上次install的文件，也可以运行make clean，不过耗时较长。

• LOCAL_CERTIFICATE := PRESIGNED

  PRESIGNED代表已经签过名了，无需系统再签名。

  可选定义，用于指定签名时使用的KEY，默认为testkey。可选项还有：

  //该APK完成一些系统的核心功能。系统签名，可访问系统中的文件/文件夹

  ​ LOCAL_CERTIFICATE := platform

  //该APK需要和home/contacts进程共享数据。

  ​ LOCAL_CERTIFICATE := shared

  //该APK是media/download系统中的一环

  ​ LOCAL_CERTIFICATE := media

  //普通APK，默认情况下使用

  ​ LOCAL_CERTIFICATE := **testkey

  需要在AndroidManifest.xml文件中添加对应如下内容：

  ​ android:sharedUserId=“android.uid.system”

  ​ android:sharedUserId=“android.uid.shared”

  ​ android:sharedUserId=“android.media”

  其各个KEY文件在Android源码的build/target/product/security/目录下：

  ​ 1、media.pk8与media.x509.pem；

  ​ 2、platform.pk8与platform.x509.pem；

  ​ 3、shared.pk8与shared.x509.pem；

  ​ 4、testkey.pk8与testkey.x509.pem；

  其中，“.pk8”文件为私钥，“.x509.pem”文件为公钥，这需要去了解非对称加密方式

• LOCAL_PRIVILEGED_MODULE := true

  模块装入system/priv-app目录下，系统核心app，不可卸载。

  可选定义，默认为false，放入system/app里面。

• LOCAL_PRIVATE_PLATFORM_APIS := true

  对于使用了系统@hide api的，需设为true

参考：

http://blog.chinaunix.net/uid-26215986-id-3602509.html

https://www.cnblogs.com/simbachen/p/4009552.html

https://blog.csdn.net/stn_lcd/article/details/53035344

https://blog.csdn.net/wzh048503/article/details/79026581

https://www.cnblogs.com/pengmn/p/9213831.html

https://www.cnblogs.com/gamesky/p/11369156.html