理解Android编译命令

时间  2020-01-04
标签 理解 android 编译 命令 栏目 Android 繁體版
原文   原文链接

工欲善其事，必先利其器，对于想要深刻学习Android源码，必须先掌握Android编译命令.java

1、引言

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

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

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

2、编译命令

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

接下来，解释一下本文开头的引用的命令：shell

source /opt/android1204_17.conf  //初始化jdk环境变量（这个不是必需的，因厂商而异）
source setenv.sh  //初始化编译环境，包括后面的lunch和make指令
lunch  //指定这次编译的目标设备以及编译类型
make  -j12 //开始编译，默认为编译整个系统，其中-j12表明的是编译的job数量为12。

全部的编译命令都在envsetup.sh文件能找到相对应的function，好比上述的命令lunch，make，在文件必定能找到api

function lunch(){
    ...
}

function make(){
    ...
}

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

2.1 代码编译

编译指令 解释
m 在源码树的根目录执行编译
mm 编译当前路径下全部模块，但不包含依赖
mmm [module_path] 编译指定路径下全部模块，但不包含依赖
mma 编译当前路径下全部模块，且包含依赖
mmma [module_path] 编译指定路径下全部模块，且包含依赖
make [module_name] 无参数，则表示编译整个Android代码

下面列举部分模块的编译指令：app

模块 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；

3、编译系统

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)

若是以为本文对您有所帮助，请关注个人微信公众号：gityuan， 微博：Gityuan。 或者点击这里查看更多关于gityuan我的信息

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程