Android编译系统(一、环境与命令)

绝地灬酷狼 2023-08-17 16:47 120阅读 0赞

# 1. 概述 #

Android 编译系统是Android源码的一部分,在学习Android编译系统之前,可以参照[使用AndroidStudio查看并调试Android源码][AndroidStudio_Android] 来搞定源码和编译环境

Android Build 系统用来编译 Android 系统，Android SDK 以及相关文档。该系统主要由 Make 文件，BP文件,Shell 脚本以及 Python 脚本组成，其中最主要的是 Make 文件和BP文件。

Build 系统中最主要的处理逻辑都在 Make 文件中，而其他的脚本文件只是起到一些辅助作用

整个 Build 系统中的 Make 文件可以分为三类：

*  第一类是 Build 系统核心文件  
    此类文件定义了整个 Build 系统的框架，而其他所有 Make 文件都是在这个框架的基础上编写出来的。Build 系统核心文件全部位于 aosp/build/core
    
    ![format_png][]
 *  第二类是针对某个产品（一个产品可能是某个型号的手机或者平板电脑）的 Make 文件  
    这些文件通常位于 device 目录下，该目录下又以公司名以及产品名分为两级目录,对于一个产品的定义通常需要一组文件，这些文件共同构成了对于这个产品的定义。
    
    ![format_png 1][]
    
    如图device下的AAA代表公司名称,F16代表产品编号
 *  第三类是针对某个模块的 Make 文件。  
    整个系统中，包含了大量的模块，每个模块都有一个专门的 Make 文件，这类文件的名称统一为“Android.mk”，该文件中定义了如何编译当前模块。Build 系统会在整个源码树中扫描名称为“Android.mk”的文件并根据其中的内容执行模块的编译。

# 2. 编译 Android 系统 #

关于源码的下载,编译和调试,可以查看:[使用AndroidStudio查看并调试Android源码][AndroidStudio_Android]

核心的编译命令只有以下3句:

source build/envsetup.sh 
    lunch XXX
    make -j8

## source build/envsetup.sh ##

命令 `source build/envsetup.sh`引入了 `build/envsetup.sh`脚本。该脚本的作用是初始化编译环境，并引入一些辅助的 Shell 函数，这其中就包括第二步使用 lunch 函数。  
当我们执行过 `source build/envsetup.sh` 后可以使用 `hmm`命令来查看常用的一些命令的含义:

![format_png 2][]

除此之外，该文件中还定义了其他一些常用的函数，这些函数分为以下几类

### 编译指令 ###

<table> 
 <thead> 
  <tr> 
   <th>命令</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>m</td> 
   <td>在源码树的根目录执行编译</td> 
  </tr> 
  <tr> 
   <td>mm</td> 
   <td>编译当前路径下所有模块，但不包含依赖</td> 
  </tr> 
  <tr> 
   <td>mmm [module_path]</td> 
   <td>编译指定路径下所有模块，但不包含依赖</td> 
  </tr> 
  <tr> 
   <td>mma</td> 
   <td>编译当前路径下所有模块，且包含依赖(通常在第一次编译某个模块时,我们都会使用该命令)</td> 
  </tr> 
  <tr> 
   <td>mmma [module_path]</td> 
   <td>编译指定路径下所有模块，且包含依赖</td> 
  </tr> 
  <tr> 
   <td>make [module_name]</td> 
   <td>如果无参数，则表示编译整个Android代码</td> 
  </tr> 
 </tbody> 
</table>

> 建议：首次编译时采用make/mma/mmma编译；当依赖模块已经编译过的情况，则使用mmm/mm编译

### 代码搜索 ###

<table> 
 <thead> 
  <tr> 
   <th>命令</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>cgrep</td> 
   <td>在所有C/C++文件中执行搜索</td> 
  </tr> 
  <tr> 
   <td>jgrep</td> 
   <td>在所有Java文件中执行搜索</td> 
  </tr> 
  <tr> 
   <td>ggrep</td> 
   <td>在所有Gradle文件中执行搜索</td> 
  </tr> 
  <tr> 
   <td>mangerp</td> 
   <td>在所有AndroidManifest.xml文件中执行搜索</td> 
  </tr> 
  <tr> 
   <td>mgrep</td> 
   <td>在所有Android.mk文件中执行搜索</td> 
  </tr> 
  <tr> 
   <td>sepgrep</td> 
   <td>在所有sepolicy文件中执行搜索</td> 
  </tr> 
  <tr> 
   <td>resgrep</td> 
   <td>在所有res/*.xml文件中执行搜索</td> 
  </tr> 
  <tr> 
   <td>sgrep</td> 
   <td>在所有资源文件中执行搜索</td> 
  </tr> 
 </tbody> 
</table>

上述指令用法最终实现方式都是基于grep指令，在当前路径下进行搜索的,各个指令用法格式：

xgrep [keyword]  //xgrep代表的是上表的各个搜索指令

例如想要搜索所以AndroidManifest中包含`launcher3`的位置:

mangrep launcher3

结果如图所示:  
![format_png 3][]

### 导航指令 ###

<table> 
 <thead> 
  <tr> 
   <th>命令</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>croot</td> 
   <td>切换到Android根目录</td> 
  </tr> 
  <tr> 
   <td>cproj</td> 
   <td>切换到工程根目录</td> 
  </tr> 
  <tr> 
   <td>godir [filename]</td> 
   <td>跳转到包含某个文件的目录</td> 
  </tr> 
 </tbody> 
</table>

这里需要注意的是cproj的原理是一层一层的执行`cd ..`直到找到Android.mk文件为止,所以如果你的项目是使用`Android.bp`文件作来编译的话,则这个指令会不好用.如图展示了成功和失败的情况:  
成功:  
![format_png 4][]

失败:  
![format_png 5][]  
可以看到DeskClock使用的是Android.bp 所以没法使用cproj来进行导航

### 信息查询 ###

<table> 
 <thead> 
  <tr> 
   <th>命令</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>hmm</td> 
   <td>查询所有指令的help信息</td> 
  </tr> 
  <tr> 
   <td>findmakefile</td> 
   <td>查询当前目录所在工程的Android.mk文件路径(对Android.bp无效)</td> 
  </tr> 
  <tr> 
   <td>print_launch_menu</td> 
   <td>查询lunch的所有可选项</td> 
  </tr> 
  <tr> 
   <td>printconfig</td> 
   <td>查询各项编译变量值</td> 
  </tr> 
  <tr> 
   <td>gettop</td> 
   <td>查询Android源码的根目录</td> 
  </tr> 
  <tr> 
   <td>gettargetarch</td> 
   <td>获取TARGET_ARCH值</td> 
  </tr> 
 </tbody> 
</table>

### 其他常用命令 ###

*  make clean：执行清理操作，等价于 `rm -rf out/`
 *  make update-api：更新API，在framework API改动后需执行该指令，Api记录在目录`frameworks/base/api`

[AndroidStudio_Android]: https://blog.csdn.net/cfy137000/article/details/83718735
[format_png]: /images/20230809/0779dff8800f454688df8dde7f084ac0.png
[format_png 1]: /images/20230809/f1243ea042b546a79f6b871d66c82e8a.png
[format_png 2]: /images/20230809/9ff4260fe5154a2b8b23e3264a7bb042.png
[format_png 3]: /images/20230809/c0f0ef5180ea47cbb6a7d345686235d7.png
[format_png 4]: /images/20230809/55db206b841c4a5ca9d6b1dfc1623808.png
[format_png 5]: /images/20230809/5459dbccaae14768ae92019482b75144.png