android.mk知识

网上抄写的，做个记录

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

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

include $(BUILD_SHARED_LIBRARY) 
BUILD_SHARED_LIBRARY：是Build System提供的一个变量，指向一个GNU Makefile Script。
它负责收集自从上次调用 include $(CLEAR_VARS)  后的所有LOCAL_XXX信息。并决定编译为什么。

BUILD_STATIC_LIBRARY    ：编译为静态库。 
BUILD_SHARED_LIBRARY ：编译为动态库 
BUILD_EXECUTABLE           ：编译为Native C可执行程序  

BUILD_PREBUILT                 ：该模块已经预先编译

LOCAL_MODULE_TAGS ：= user eng tests optional

可选定义，表示在什么版本情况下编译该版本，默认 optional。

• user: 指该模块只在 user 版本下才编译
• eng: 指该模块只在 eng 版本下才编译
• tests: 指该模块只在 tests 版本下才编译
• optional:指该模块在所有版本下都编译

LOCAL_CERTIFICATE

在什么情况下签名。

• testkey：普通 APK，默认情况下使用。
• platform：该 APK 完成一些系统的核心功能。经过对系统中存在的文件夹的访问测试， 这种方式编译出来的 APK 所在进程的 UID 为 system，可以参见 Settings。
• shared：该 APK 需要和 home/contacts 进程共享数据，可以参见 Launcher。
• media：该 APK 是 media/download 系统中的一环，可以参见 Gallery。

LOCAL_MODULE_CLASS

指定模块的类型，可不用定义。

# 编译 apk 文件
LOCAL_MODULE_CLASS := APPS

# 编译 jar 包
LOCAL_MODULE_CLASS := JAVA_LIBRAYIES

# 定义动态库文件
LOCAL_MODULE_CLASS := SHARED_LIBRAYIES

# 编译可执行文件
LOCAL_MODULE_CLASS := EXECUTABLES

include $(BUILD_PACKAGE)

表示生成一个 apk，它可以是多种类型

• BUILD_PACKAGE（既可以编apk，也可以编资源包文件，但是需要指定LOCAL_EXPORT_PACKAGE_RESOURCES:=true)
• BUILD_JAVA_LIBRARY（java共享库）
• BUILD_STATIC_JAVA_LIBRARY（java静态库）
• BUILD_EXECUTABLE（执行文件）
• BUILD_SHARED_LIBRARY（native共享库）
• BUILD_STATIC_LIBRARY（native静态库）

 LOCAL_MODULE_PATH := $(TARGET_OUT)/vendor/operator/app表示编译后apk放在/system/vendor/operator/app目录下面，用户可以卸载，否则不加这句，会放在/system/app/下面,用户不可以卸载。

LOCAL_MODULE_FILENAME: 
可选。用来override LOCAL_MODULE. 即允许用户重新定义最终生成的目标文件名。    

LOCAL_MODULE := foo-version-1  LOCAL_MODULE_FILENAME := libfoo

• lunch: lunch <product_name>-<build_variant> (选择要编译的目标产品和版本)
• tapas: tapas [<App1> <App2> ...] [arm|x86|mips|armv5] [eng|userdebug|user]
• croot: Changes directory to the top of the tree.(切换到源码的顶层目录)
• m: Makes from the top of the tree.(从顶层目录build整个系统)
• mm: Builds all of the modules in the current directory, but not their dependencies.(构建当前目录下所有的模块，但不包括它们的依赖)
• mmm: Builds all of the modules in the supplied directories, but not their dependencies.(构建指定目录下所有的模块，但不包括它们的依赖)
• mma: Builds all of the modules in the current directory, and their dependencies.(构建当前目录下所有的模块以及它们所依赖的模块)
• mmma: Builds all of the modules in the supplied directories, and their dependencies.(构建指定目录下所有的模块以及它们所依赖的模块)
• provision: Flash device with all required partitions. Options will be passed on to fastboot.(将设备所有需要的分区刷入，选项将传递给fastboot)
• cgrep: Greps on all local C/C++ files.(在C，C++文件中搜索指定关键字)
• ggrep: Greps on all local Gradle files.(在gradle文件中搜索指定关键字)
• jgrep: Greps on all local Java files.(在java文件中搜索指定关键字)
• resgrep: Greps on all local res/*.xml files.(在资源xml文件中搜索指定关键字)
• mangrep: Greps on all local AndroidManifest.xml files.(在AndroidManifest.xml文件中搜索指定关键字)
• mgrep: Greps on all local Makefiles files.(在Makefiles和android.mk文件中搜索指定关键字)
• sepgrep: Greps on all local sepolicy files.(在sepolicy文件中搜索指定关键字)
• sgrep: Greps on all local source files.(在所有本地文件中搜索指定关键字)
• godir: Go to the directory containing a file.(切换到包含某个文件的目录下)