Android.mk编译脚本 & AndroidManifest.xml编写及注释

更新时间: 2019.04.17

AndroidManifest.xml:

android:sharedUserId="android.uid.systemui"    //SystemUI属于系统apk
coreApp="true"    //SystemUI属于核心apk
android:persistent="true"    //SystemUI不会被KILL，即被KILL后会自动重启

Android.mk

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

# CLEAR_VARS 变量由Build System提供。并指向一个指定的GNU Makefile，负责清理多余的LOCAL_xxx.  
# 这个清理动作是必须的，因为所有的编译控制文件由同一个GNU Make解析和执行，其变量是全局的  
# 所以清理后才能避免相互影响 比如LOCAL_MODULE, LOCAL_SRC_FILES, LOCAL_STATIC_LIBRARIES  
include $(CLEAR_VARS)  

# 定义引用的jar包：名字自定义，后面会针对名字进行路径说明  
LOCAL_STATIC_JAVA_LIBRARIES := supportinternal supportannotions  

# 定义引用的aar包：名字自定义，后面会针对名字进行路径说明  
# aar包内如果有jar包，需要导出引用比如V4包有jar包  
LOCAL_STATIC_JAVA_AAR_LIBRARIES := support4  

# 定义src文件路径  
LOCAL_SRC_FILES := $(call all-subdir-Java-files) $(call all-java-files-under, src) $(call all-renderscript-files-under, src)  

# 定义res文件路径  
LOCAL_RESOURCE_DIR := $(LOCAL_PATH)/res  

# 编译后名称  
LOCAL_PACKAGE_NAME := SysemUI
# 预置到 /system/pri-app/;不添加此属性，编译后的路径为/system/app/SystemUI
# 在同样具有系统权限情况下，/system/pri-app下的apk权限比/system/app下大
LOCAL_PRIVILEGED_MODULE := true
# 编译生成目标的安装路径
# 在build/core/envsetup.mk中定义;TARGET_ROOT_OUT：表示根文件系统;TARGET_OUT：表示system文件系统;TARGET_OUT_DATA：表示data文件系统。
# 预置的apk用户可以卸载,恢复出厂设置不可恢复
LOCAL_MODULE_PATH := $(TARGET_OUT_DATA_APPS)    
# 预置的apk用户可以卸载,恢复出厂设置可恢复
LOCAL_MODULE_PATH := $(TARGET_OUT)/vendor/operator/app    

# 定义生成的apk使用的key  
# 指定平台签名,生成Settings.apk文件之后,系统会使用如下两个文件对Settings.apk进行签名,这个系统设置就拥有系统权限了
# (源码根目录)MSM8939_AndroidL/build/target/product/security/platform.pk8
# (源码根目录)MSM8939_AndroidL/build/target/product/security/platform.x509.pem
# Settings光使用Platform签名还不行,需要在AndroidManifest.xml文件package="xxx"后指定共享用户ID,并将添加属性: coreApp="true",才会变成内核应用
# 任何一个Android应用,如果使用前面的配置,并在Android源代码中使用mm/mmm命令进行编译,其权限就会和Settings完全一样
# 每一个版本(包括同一版本不同分支)Android源代码所带的Platform签名都不一样,使用不同的签名会导致apk程序认证不通过,尽管system/app下已存在对应apk
# 设置coreApp="true"和android:sharedUserId="android.uid.system"的apk将用于系统级的权限(不需要root权限),Android采用了Linux的ACL权限管理方式 
LOCAL_CERTIFICATE := platform
# 指定混淆标识文件
LOCAL_PROGUARD_FLAG_FILES := proguard.flags
# 定义jar包 aar包的路径 :后面跟的是相对Android.mk文件的相对路径  
LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES := supportinternal:lib/support-annotations-22.2.1-sources.jar \  
                                        supportannmtions:lib/internal_impl-22.2.1.jar \  
                                        support4:lib/support-v4-22.2.1.aar \  

include $(CLEAR_VARS)   

# 因为aar包的存在，这个主要是用于合并AndroidManifest.xml 和res资源文件   
LOCAL_AAPT_FLAG := \   
                   --auto-add-overlay \   
                   --extra-package android.support.v4 \   
                   --extra-package com.openthos.launcher.openthoslauncher   

# 指明合并后的AndroidManifest.xml的路径 （一般不用指定）   
LOCAL_MANIFEST_FILE := $(LOCAL_PATH)/AndroidManifest.xml   

# 因引入jar包或aar包，须加上这句   
include $(BUILD_MULTI_PREBUILT)   

include $(call all-makefiles-under,$(LOCAL_PATH))  

Android.mk Sample:

# 编译一个简单的apk
# 定义当前模块的相对路径
LOCAL_PATH := $(call my-dir)
# 清空当前环境变量
include $(CLEAR_VARS)
# 编译生成的目标名称
LOCAL_PACKAGE_NAME := LocalPackage
# 编译该模块需要的资源($(call all-subdir-java-files)当前目录下所有的.java文件)
LOCAL_SRC_FILES := $(call all-subdir-java-files)
# 编译生成目标文件格式
include $(BUILD_PACKAGE)

• 1. 预置apk

1.在目录下添加: /vendor/qcom/proprietary/MiniBrowser/Android.mk & MiniBrowser.apk
Android.mk:
 LOCAL_PATH := $(call my-dir)
 include $(CLEAR_VARS)
 #Module name should match apk name to be installed
 LOCAL_MODULE := MiniBrowser
 LOCAL_MODULE_TAGS := optionalco
 LOCAL_SRC_FILES := $(LOCAL_MODULE).apk
 LOCAL_MODULE_CLASS := APPS
 LOCAL_MODULE_SUFFIX := $(COMMON_ANDROID_PACKAGE_SUFFIX)
 LOCAL_CERTIFICATE := PRESIGNED
 include $(BUILD_PREBUILT)
2.配置加入系统编译:
 /vendor/qcom/proprietary/common/config/device-vendor.mk
WANDOUJIA += wandoujia
PRODUCT_PACKAGES += $(WANDOUJIA )
或者在/build/target/product/core.mk添加:
PRODUCT_PACKAGES += \
    MiniBrowser\

添加或移除编译系统源码(在/build/target/product/core.mk中移除配置)

• 2.预置apk(apk带有so库)

 LOCAL_PATH := $(call my-dir)
 include $(CLEAR_VARS)
 # Module name should match apk name to be installed
 LOCAL_MODULE := baiduinput
 LOCAL_MODULE_TAGS := optional
 LOCAL_SRC_FILES := $(LOCAL_MODULE).apk
 LOCAL_MODULE_CLASS := APPS
 LOCAL_MODULE_SUFFIX := $(COMMON_ANDROID_PACKAGE_SUFFIX)
 LOCAL_CERTIFICATE := PRESIGNED
 LOCAL_MULTILIB:=32
 LOCAL_PREBUILT_JNI_LIBS:= \
  @lib/armeabi/libbdEASRAndroid.so  \
  @lib/armeabi/libbdEASRAndroid.v1.8.8.so  \
  @lib/armeabi/libprocmox_v1_4.so
 include $(BUILD_PREBUILT)

 #LOCAL_PRIVILEGED_MODULE := true
 #LOCAL_OVERRIDES_PACKAGES := Home

• 3.编译一个带有so库的源码

LOCAL_PATH:= $(call my-dir)

include $(CLEAR_VARS)
LOCAL_MODULE := libgangyun_face_jni
LOCAL_MODULE_TAGS := optional
LOCAL_MODULE_CLASS := SHARED_LIBRARIES
LOCAL_SRC_FILES_arm := libs/armeabi/libgangyun_face_jni.so
LOCAL_MODULE_SUFFIX := .so
LOCAL_MULTILIB := 32
include $(BUILD_PREBUILT)

include $(CLEAR_VARS)

LOCAL_MODULE_TAGS := optional
LOCAL_CERTIFICATE := platform

LOCAL_STATIC_JAVA_LIBRARIES := android-support-v13
LOCAL_STATIC_JAVA_LIBRARIES += android-ex-camera2-portability
LOCAL_STATIC_JAVA_LIBRARIES += xmp_toolkit
LOCAL_STATIC_JAVA_LIBRARIES += glide
LOCAL_STATIC_JAVA_LIBRARIES += guava
LOCAL_STATIC_JAVA_LIBRARIES += jsr305


LOCAL_STATIC_JAVA_LIBRARIES +=libaritygangyunsdk
LOCAL_STATIC_JAVA_LIBRARIES += isoviewer


LOCAL_SRC_FILES := $(call all-java-files-under, src)
LOCAL_SRC_FILES += $(call all-java-files-under, src_pd)
LOCAL_SRC_FILES += $(call all-java-files-under, src_pd_gcam)

LOCAL_RESOURCE_DIR += \
	$(LOCAL_PATH)/res \
	$(LOCAL_PATH)/res_p


include $(LOCAL_PATH)/version.mk
LOCAL_AAPT_FLAGS := \
        --auto-add-overlay \
        --version-name "$(version_name_package)" \
        --version-code $(version_code_package) \

LOCAL_PACKAGE_NAME := Camera2
#ifneq ($(TARGET_BUILD_VARIANT),eng)
#LOCAL_OVERRIDES_PACKAGES := SnapdragonCamera
#endif
LOCAL_SDK_VERSION := current

LOCAL_PROGUARD_ENABLED := disabled

LOCAL_PROGUARD_FLAG_FILES := proguard.flags

LOCAL_JNI_SHARED_LIBRARIES := libjni_tinyplanet libjni_jpegutil

LOCAL_JNI_SHARED_LIBRARIES += libgangyun_face_jni 
LOCAL_MULTILIB := 32

include $(BUILD_PACKAGE)
include $(CLEAR_VARS)
LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES := libaritygangyunsdk:libs/gangyun-sdk-1.1.2-20160328.jar \
                                        isoviewer:libs/isoviewer-1.0-RC-27.jar
include $(BUILD_MULTI_PREBUILT)

include $(call all-makefiles-under, $(LOCAL_PATH))

• 3.添加预编译jar包(局部添加和全局添加)

3.1.1 在路径下添加文件(全局添加):
    prebuilts/misc/common/ansen_libs/umeng-analytics-v6.0.1.jar; fc909.jar;Android.mk
3.1.2 编写 Android.mk :
    LOCAL_PATH:= $(call my-dir)
    include $(CLEAR_VARS)
    LOCAL_MODULE := fc909
    LOCAL_MODULE_TAGS := optional
    LOCAL_SRC_FILES := fc909.jar
    LOCAL_MODULE_CLASS := JAVA_LIBRARIES
    LOCAL_MODULE_SUFFIX := $(COMMON_JAVA_PACKAGE_SUFFIX)
    include $(BUILD_PREBUILT)
    
    include $(CLEAR_VARS)
    LOCAL_MODULE := umeng-analytics-v6.0.1
    LOCAL_MODULE_TAGS := optional
    LOCAL_SRC_FILES := umeng-analytics-v6.0.1.jar
    #LOCAL_IS_HOST_MODULE := true
    LOCAL_MODULE_CLASS := JAVA_LIBRARIES
    LOCAL_MODULE_SUFFIX := $(COMMON_JAVA_PACKAGE_SUFFIX)
    include $(BUILD_PREBUILT)
3.1.3 加入系统编译,在device/qcom/common/base.mk添加:
    PRODUCT_PACKAGES += $(CRDA)
    PRODUCT_PACKAGES += $(WLAN)
    PRODUCT_PACKAGES += \
        quciifplib \
        fc909 \
        umeng-analytics-v6.0.1 \
        fingerprint    
    
    # Live Wallpapers
    PRODUCT_PACKAGES += \
            LiveWallpapers \
3.1.4 使用已经添加的jar   
    packages/apps/Settings/Android.mk:
    LOCAL_STATIC_JAVA_LIBRARIES := android-support-v4 \
                    android-support-v13 fc909 quciifplib \
                    umeng-analytics-v6.0.1
----------------------------------------------------------

3.2 在对应工程/libs下添加adapter-rxjava-2.1.0.jar; converter-gson-2.1.0.jar(局部添加)
    Android.mk:
    LOCAL_STATIC_JAVA_LIBRARIES := android-support-v4 \
                    android-support-v13 \
                    android-support-v7-appcompat \
                    adapter-rxjava \
                    gson 

    include $(CLEAR_VARS)
    LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES := adapter-rxjava:libs/adapter-rxjava-2.1.0.jar \
                        gson:libs/gson-2.7.jar 
    #冒号前面为jar别名，后面为jar文件的实际路径  
    include $(BUILD_MULTI_PREBUILT)

• 4.编译添加AAR包

LOCAL_STATIC_JAVA_AAR_LIBRARIES := filepicker

LOCAL_AAPT_FLAGS := --auto-add-overlay
LOCAL_AAPT_FLAGS += --extra-packages com.tomorrow_p.simple

include $(CLEAR_VARS)
LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES := filepicker:libs/filepicker-2.4.2.aar
include $(BUILD_MULTI_PREBUILT)

• 5.java文件编译出静态和动态jar包(局部和全局)

静态jar包: 静态jar包是使用.class文件打包而成的JAR文件,可以在任何java虚拟机运行;静态jar包会被打包进使用的apk或者plugin插件中,使用静态jar的缺点:每次修改完静态jar涉及的类后,apk或plugin插件也要重新编译打包,并且如果系统多处都使用此静态jar包,容易产生jar包内容的重复,jar包内容过大时占用空间变大.

在源代码src同级目录下添加Android.mk

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

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

LOCAL_MODULE := AAFramework

include $(BUILD_STATIC_JAVA_LIBRARY)

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
# Build all java files in the java subdirectory
LOCAL_SRC_FILES := $(call all-subdir-java-files)
# 生成的java库的jar文件名
LOCAL_JAVA_LIBRARIES := android.test.runner
# The name of the jar file to create
LOCAL_MODULE := sample
#
include $(BUILD_STATIC_JAVA_LIBRARY)
#include $(BUILD_JAVA_LIBRARY)
#编译生成动态库
#include $(BUILD_SHARED_LIBRARY)

动态jar包(系统共享): 在静态jar包基础上使用.dex打包而成的jar文件,.dex是Android系统使用的文件格式

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

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

LOCAL_MODULE := AAFramework

ALL_DEFAULT_INSTALLED_MODULES += $(LOCAL_MODULE)
LOCAL_PROGUARD_ENABLED := disabled
LOCAL_DEX_PREOPT := false

include $(BUILD_JAVA_LIBRARY)

做法和静态jar包做法，只有一处不同，就是最后一句的声明的生成的是动态库；
使用的时候有两种方法：
1、使用的时候在去动态加载；
  首先，在apk的AndroidMainfest.xml文件中添加对动态库的声明；
  如：  
   
        
   其次，在system/ect/permissions下添加android.net.xml配置文件，在配置文件中去声明jar包的路径
 
 
    

标签表示除了framework中的动态库以外，系统将为应用自动加载的动态库；
最后，只要在相应的system/framework目录下存在SkyFramework.jar即可
2、像系统自动加载framework.jar包一样，开机时候默认加载
  做法：Android5.0上是在build/target/product的core_minimal.mk中添加到
  PRODUCT_BOOT_JARS := \
AAFramework
开机的时候会默认加载此动态jar包

• 6.编译一个依赖静态和动态.jar文件的APK

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
# 引入名为static-library的静态jar包
LOCAL_STATIC_JAVA_LIBRARIES := static-library
# 引入名为static-library的动态jar包
#LOCAL_STATIC_LIBRARIES := share-library
# Build all java files in the java subdirectory
LOCAL_SRC_FILES := $(call all-subdir-java-files)
# Name of the APK to build
LOCAL_PACKAGE_NAME := LocalPackage
# Tell it to build an APK
include $(BUILD_PACKAGE)

• 7.使用ifeq判断语句

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
# 判断条件
USED_SHARE :=TRUE
ifeq ($(USED_SHARE ),true)
# 引入名为static-library的静态jar包
LOCAL_STATIC_JAVA_LIBRARIES := static-library
else
# 引入名为static-library的动态jar包
LOCAL_STATIC_LIBRARIES := share-library
endif
LOCAL_SRC_FILES := $(call all-subdir-java-files)
LOCAL_PACKAGE_NAME := LocalPackage
include $(BUILD_PACKAGE)

-8.编译一个需要platform key签名的APK

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
# Build all java files in the java subdirectory
LOCAL_SRC_FILES := $(call all-subdir-java-files)
# Name of the APK to build
LOCAL_PACKAGE_NAME := LocalPackage
LOCAL_CERTIFICATE := platform
# Tell it to build an APK
include $(BUILD_PACKAGE)
注：LOCAL_CERTIFICATE 后面应该是签名文件的文件名

• 9.编译一个需要特殊vendor key签名的APK

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
# Build all java files in the java subdirectory
LOCAL_SRC_FILES := $(call all-subdir-java-files)
# Name of the APK to build
LOCAL_PACKAGE_NAME := LocalPackage
LOCAL_CERTIFICATE := vendor/example/certs/app
# Tell it to build an APK
include $(BUILD_PACKAGE)

• 10.装载一个普通的第三方APK

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
# Module name should match apk name to be installed.
LOCAL_MODULE := LocalModuleName
LOCAL_SRC_FILES := $(LOCAL_MODULE).apk
LOCAL_MODULE_CLASS := APPS
LOCAL_MODULE_SUFFIX := $(COMMON_ANDROID_PACKAGE_SUFFIX)
LOCAL_CERTIFICATE := platform
include $(BUILD_PREBUILT) 

• 11.support包的添加

LOCAL_PATH := $(call my-dir)

# ---------------------------------------
# Build OmaDrmEngineDemo application
#
# Output: OmaDrmEngineDemo.apk
# ----------------------------------------
include $(CLEAR_VARS)

LOCAL_MODULE_TAGS := optional

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

LOCAL_PACKAGE_NAME := OmaDrmEngineDemo

LOCAL_STATIC_JAVA_LIBRARIES := \
        android-support-v4 \
        android-support-v7-appcompat \
        android-support-v7-recyclerview \
        android-support-v7-gridlayout \
        android-support-design
LOCAL_RESOURCE_DIR = \
        $(LOCAL_PATH)/res \
        frameworks/support/v7/appcompat/res \
        frameworks/support/v7/recyclerview/res \
        frameworks/support/v7/gridlayout/res \
        frameworks/support/design/res
#$(LOCAL_PATH)/../../../../prebuilts/sdk/current/support/v7/appcompat/res
LOCAL_AAPT_FLAGS := \
        --auto-add-overlay \
        --extra-packages android.support.v7.appcompat \
        --extra-packages android.support.v7.recyclerview \
        --extra-packages android.support.v7.gridlayout \
        --extra-packages android.support.design

LOCAL_PROGUARD_ENABLED := disabled

LOCAL_DEX_PREOPT := false

LOCAL_MODULE_TAGS := eng development

include $(BUILD_PACKAGE)

• 12.引用系统的库 liblog

LOCAL_SHARED_LIBRARIED += liblog
# 编译会从/out/targer/product/fiber-a31st/obj/lib/liblog.so找对应的库

• 12.引用第三方的库文件

# 库的路径:/lib/,库的名称:libxx
LOCAL_LDFLAGS += -L/lib/-libxx

• 13.引用第三方头文件

# 头文件绝对路径:/inc/
LOCAL_C_INCLUDES :=$(LOCAL_PATH)/inc/

• 14.apk预置到system/framework

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
# Module name should match apk name to be installed.
LOCAL_MODULE := ZeusisCommonUILibrary
LOCAL_SRC_FILES := $(LOCAL_MODULE).apk
LOCAL_MODULE_CLASS := APPS
LOCAL_MODULE_SUFFIX := $(COMMON_ANDROID_PACKAGE_SUFFIX)
LOCAL_CERTIFICATE := platform

LOCAL_MODULE_PATH := $(PRODUCT_OUT)/system/framework/
LOCAL_DEX_PREOPT := false
LOCAL_EXPORT_PACKAGE_RESOURCES := true
LOCAL_MODULE_TAGS := optional
include $(BUILD_PREBUILT)