Android 编译命令
一、编译命令
编译Android源码的第一步
# 在源码根目录执行
source build/envsetup.sh
其中source命令就是用于运行shell脚本命令,功能等价于”.”,因此该命令也等价于. build/envsetup.sh
。在文件envsetup.sh声明了当前会话终端可用的命令,这里需要注意的是当前会话终端,也就意味着每次新打开一个终端都必须再一次执行这些指令。
source envsetup.sh #初始化编译环境,包括后面的lunch和make指令
lunch #指定此次编译的目标设备以及编译类型,可以直接跟数字(没有指定的话,会出现选项)
make -j12 #开始编译,默认为编译整个系统,其中-j12代表的是编译的job数量为12。
所有的编译命令都在envsetup.sh文件能找到相对应的function,比如上述的命令lunch,make,在文件一定能找到
function lunch(){
...
}
function make(){
...
}
source envsetup.sh
,需要cd到envsetup.sh文件所在路径执行,路径可能在build/envsetup.sh
,或者integrate/envsetup.sh
,再或者不排除有些厂商会封装自己的.sh脚本,但核心思路是一致的。
1.1 代码编译
编译指令 #解释
m #在源码树的根目录执行编译
mm #编译当前路径下所有模块,但不包含依赖
mmm [module_path] #编译指定路径下所有模块,但不包含依赖
mma #编译当前路径下所有模块,且包含依赖
mmma [module_path] #编译指定路径下所有模块,且包含依赖
make [module_name] #无参数,则表示编译整个Android代码
下面列举部分模块的编译指令:
模块 make命令 mmm命令
init make init mmm system/core/init
zygote make app_process mmm frameworks/base/cmds/app_process
system_server make services mmm frameworks/base/services
java framework make framework mmm frameworks/base
framework资源 make framework-res mmm frameworks/base/core/res
jni framework make libandroid_runtime mmm frameworks/base/core/jni
binder make libbinder mmm frameworks/native/libs/binder
上述mmm命令同样适用于mm/mma/mmma,编译系统采用的是增量编译,只会编译发生变化的目标文件。当需要重新编译所有的相关模块,则需要编译命令后增加参数-B,比如
make -B [module_name],
或者 mm -B [module_path]。
对于m、mm、mmm、mma、mmma这些命令的实现都是通过make方式来完成的。
mmm/mm编译的效率很高,而make/mma/mmma编译较缓慢;
make/mma/mmma编译时会把所有的依赖模块一同编译,但mmm/mm不会;
- 首次编译时采用make/mma/mmma编译;
- 当依赖模块已经编译过的情况,则使用mmm/mm编译。
1.2 代码搜索
搜索指令 | 解释 |
---|---|
cgrep |
所有C/C++文件执行搜索操作 |
jgrep |
所有Java文件执行搜索操作 |
ggrep |
所有Gradle文件执行搜索操作 |
mangrep [keyword] |
所有AndroidManifest.xml文件执行搜索操作 |
mgrep [keyword] |
所有Android.mk文件执行搜索操作 |
sepgrep [keyword] |
所有sepolicy文件执行搜索操作 |
resgrep [keyword] |
所有本地res/*.xml文件执行搜索操作 |
sgrep [keyword] |
所有资源文件执行搜索操作 |
#上述指令用法最终实现方式都是基于grep指令,各个指令用法格式:
xgrep [keyword]
#搜索所有AndroidManifest.xml文件中的launcher关键字所在文件的具体位置,指令
mangrep launcher
#搜索所有Java代码中包含zygote所在文件
jgrep zygote
#搜索所有system_app的selinux权限信息
sepgrep system_app
1.3 导航指令
导航指令 解释
croot 切换至Android根目录
cproj 切换至工程的根目录
godir [filename] 跳转到包含某个文件的目录
Tips: 当每次修改完某个文件后需要编译时,执行cproj后会跳转到当前模块的根目录,也就是Android.mk文件所在目录,然后再执行mm指令,即可编译目标模块;当进入源码层级很深后,需要返回到根目录,使用croot一条指令完成;另外cd - 指令可用于快速切换至上次目录。
1.4 信息查询
查询指令 解释
hmm 查询所有的指令help信息
findmakefile 查询当前目录所在工程的Android.mk文件路径
print_lunch_menu 查询lunch可选的product
printconfig 查询各项编译变量值
gettop 查询Android源码的根目录
gettargetarch 获取TARGET_ARCH值
2.5 其他指令
上述只是列举比较常用的指令,还有其他指令,而且不同的build编译系统,支持的指令可能会存在一些差异,当忘记这些编译指令,可以通过执行hmm,查询指令的帮助信息。
最后再列举两个比较常用的指令:
make clean:执行清理操作,等价于 rm -rf out/
make update-api:更新API,在framework API改动后需执行该指令,Api记录在目录frameworks/base/api;
二、编译系统
Android 编译系统是Android源码的一部分,用于编译Android系统,Android SDK以及相关文档。该编译系统是由Make文件、Shell以及Python脚本共同组成,其中最为重要的便是Make文件。
2.1 Makefile分类
整个Build系统的Make文件分为三大类:
系统核心的Make文件:定义了Build系统的框架,文件全部位于路径
/build/core
,其他Make文件都是基于该框架编写的;针对产品的Make文件:定义了具体某个型号手机的Make文件,文件路径位于/device,该目录下往往又以公司名和产品名划分两个子级目录,比如
/device/qcom/msm8916
;针对模块的Make文件:整个系统分为各个独立的模块,每个模块都一个专门的Make文件,名称统一为"Android.mk",该文件定义了当前模块的编译方式。Build系统会扫描整个源码树中名为
Android.mk
的文件,并执行相应模块的编译工作。
2.2 编译产物
经过make编译后的产物,都位于/out目录,该目录下主要关注下面几个目录:
/out/host:#Android开发工具的产物,包含SDK各种工具,比如adb,dex2oat,aapt等。
/out/target/common:#通用的一些编译产物,包含Java应用代码和Java库;
/out/target/product/[product_name]:#针对特定设备的编译产物以及平台相关C/C++代码和二进制文件;
在/out/target/product/[product_name]目录下,有几个重量级的镜像文件:
system.img:#挂载为根分区,主要包含Android OS的系统文件;
ramdisk.img:#主要包含init.rc文件和配置文件等;
userdata.img:#被挂载在/data,主要包含用户以及应用程序相关的数据;
当然还有boot.img,reocovery.img等镜像文件,这里就不介绍了。