欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  移动技术

详谈Android编译命令

程序员文章站 2024-02-26 15:44:16
工欲善其事,必先利其器,对于想要深入学习android源码,必须先掌握android编译命令. 一、引言 关于android build系统,这个话题很早就打算...

工欲善其事,必先利其器,对于想要深入学习android源码,必须先掌握android编译命令.

一、引言

关于android build系统,这个话题很早就打算整理下,迟迟没有下笔,决定跟大家分享下。先看下面几条指令,相信编译过android源码的人都再熟悉不过的。

source /opt/android1204_17.conf 
source setenv.sh
lunch
make -j12

记得最初刚接触android时,同事告诉我用上面的指令就可以编译android源码,指令虽短但过几天就记不全或者忘记顺序,每次编译时还需要看看自己的云笔记,冰冷的指令总是难以让我记忆。后来我决定认真研究下这个指令的含义。知其然还需知其所以然,这样能更深层次的理解并记忆,才能与自身的知识体系建立强连接,或许还能有意外收获,果然如此,接下来跟大家分享一下在研究上述几条指令含义的过程中,深入了解到的android build(编译)系统。

二、编译命令

准备好编译环境后,编译android源码的第一步是 source build/envsetup.sh,其中source命令就是用于运行shell脚本命令,功能等价于".",因此该命令也等价于. build/envsetup.sh。在文件envsetup.sh声明了当前会话终端可用的命令,这里需要注意的是当前会话终端,也就意味着每次新打开一个终端都必须再一次执行这些指令。起初并不理解为什么新开的终端不能直接执行make指令,到这里总算明白了。

接下来,解释一下本文开头的引用的命令:

source /opt/android1204_17.conf  //初始化jdk环境变量(这个不是必需的,因厂商而异)
source setenv.sh  //初始化编译环境,包括后面的lunch和make指令
lunch  //指定此次编译的目标设备以及编译类型
make  -j12 //开始编译,默认为编译整个系统,其中-j12代表的是编译的job数量为12。
所有的编译命令都在envsetup.sh文件能找到相对应的function,比如上述的命令lunch,make,在文件一定能找到

function lunch(){
  ...
}

function make(){
  ...
}

具体实现这里就不展开说明,下面精炼地总结了一下各个指令用法和功效。

2.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]。

tips:

对于m、mm、mmm、mma、mmma这些命令的实现都是通过make方式来完成的。
mmm/mm编译的效率很高,而make/mma/mmma编译较缓慢;
make/mma/mmma编译时会把所有的依赖模块一同编译,但mmm/mm不会;

建议:首次编译时采用make/mma/mmma编译;当依赖模块已经编译过的情况,则使用mmm/mm编译。

2.2 代码搜索

搜索指令 解释
cgrep 所有c/c++文件执行搜索操作
jgrep 所有java文件执行搜索操作
ggrep 所有gradle文件执行搜索操作
mangrep [keyword] 所有androidmanifest.xml文件执行搜索操作
sepgrep [keyword] 所有sepolicy文件执行搜索操作
resgrep [keyword] 所有本地res/*.xml文件执行搜索操作
sgrep [keyword] 所有资源文件执行搜索操作

上述指令用法最终实现方式都是基于grep指令,各个指令用法格式:

xgrep [keyword]  //x代表的是上表的搜索指令
例如,搜索所有androidmanifest.xml文件中的launcher关键字所在文件的具体位置,指令

mangrep launcher
再如,搜索所有system_app的selinux权限信息

sepgrep system_app
tips: android源码非常庞大,直接采用grep来搜索代码,不仅方法笨拙、浪费时间,而且搜索出很多无意义的混淆结果。根据具体需求,来选择合适的代码搜索指令,能节省代码搜索时间,提高搜索结果的精准度,方便定位目标代码。

2.3 导航指令

导航指令 解释
croot 切换至android根目录
cproj 切换至工程的根目录
godir [filename] 跳转到包含某个文件的目录
tips: 当每次修改完某个文件后需要编译时,执行cproj后会跳转到当前模块的根目录,也就是android.mk文件所在目录,然后再执行mm指令,即可编译目标模块;当进入源码层级很深后,需要返回到根目录,使用croot一条指令完成;另外cd - 指令可用于快速切换至上次目录。

2.4信息查询

查询指令 解释
hmm 查询所有的指令help信息
findmakefile 查询当前目录所在工程的android.mk文件路径
print_lunch_menu 查询lunch可选的product
printconfig 查询各项编译变量值
gettop 查询android源码的根目录
gettargetarch 获取target_arch值
tips: 当忘了前面的所有指令时,可以执行一个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文件。关于编译系统可参考 理解 android build 系统。

3.1 makefile分类

整个build系统的make文件分为三大类:

系统核心的make文件:定义了build系统的框架,文件全部位于路径/build/core,其他make文件都是基于该框架编写的;
针对产品的make文件:定义了具体某个型号手机的make文件,文件路径位于/device,该目录下往往又以公司名和产品名划分两个子级目录,比如/device/qcom/msm8916;
针对模块的make文件:整个系统分为各个独立的模块,每个模块都一个专门的make文件,名称统一为"android.mk",该文件定义了当前模块的编译方式。build系统会扫描整个源码树中名为"android.mk"的问题,并执行相应模块的编译工作。

3.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等镜像文件,这里就不介绍了。

3.3 android.mk解析

在源码树中每一个模块的所有文件通常都相应有一个自己的文件夹,在该模块的根目录下有一个名称为“android.mk”
的文件。编译系统正是以模块为单位进行编译,每个模块都有唯一的模块名,一个模块可以有依赖多个其他模块,模块间的依赖关系就是通过模块名来引用的。也就是说当模块需要依赖一个jar包或者apk时,必须先将jar包或apk定义为一个模块,然后再依赖相应的模块。

对于android.mk文件,通常都是以下面两行

local_path := $(call my-dir) //设置当编译路径为当前文件夹所在路径
include $(clear_vars) //清空编译环境的变量(由其他模块设置过的变量)

为方便模块编译,编译系统设置了很多的编译环境变量,如下:

local_src_files:当前模块包含的所有源码文件;
local_module:当前模块的名称(具有唯一性);
local_package_name:当前apk应用的名称(具有唯一性);
local_c_includes:c/c++所需的头文件路径;
local_static_libraries:当前模块在静态链接时需要的库名;
local_shared_libraries:当前模块在运行时依赖的动态库名;
local_static_java_libraries:当前模块依赖的java静态库;
local_java_libraries:当前模块依赖的java共享库;
local_certificate:签署当前应用的证书名称,比如flatform。
local_module_tags:当前模块所包含的标签,可以包含多标签,可能值为debgu,eng,user,development或optional(默认值)

针对这些环境变量,编译系统还定义了一些便捷函数,如下:

$(call my-dir):获取当前文件夹路径;
$(call all-java-files-under, <src>):获取指定目录下的所有java文件;
$(call all-c-files-under, <src>):获取指定目录下的所有c文件;
$(call all-iaidl-files-under, <src>) :获取指定目录下的所有aidl文件;
$(call all-makefiles-under, <folder>):获取指定目录下的所有make文件;
示例:

 local_path := $(call my-dir) 
 include $(clear_vars) 
  
 # 获取所有子目录中的java文件
 local_src_files := $(call all-subdir-java-files) 
  
 # 当前模块依赖的动态java库名称
 local_java_libraries := com.gityuan.lib 
  
 # 当前模块的名称
 local_module := demo 
  
 # 将当前模块编译成一个静态的java库
 include $(build_static_java_library)