一. 准备
本文介绍采用Android Studio来搭建源码调试环境
1.1 下载Android Studio
**调整内存大小: ** Android Studio需要大量的内存来加载Android源码，所以经常会遇到内存不足的问题, 需要加大内存.
点击Help-> Edit Custom VM Options, 比如 “-Xms4096m -Xmx4096m”
更多资料:
1.2 下载Android系统源码
1.2.1 安装repo
mkdir ~/bin
PATH=~/bin:$PATH
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
chmod a+x ~/bin/repo
1.2.2 初始化repo
mkdir ~/aosp //创建目录，可自己定义
cd ~/aosp
git config --global user.name "Gityuan" //配置git的用户名
git config --global user.email "gityuan@google.com" //配置git的邮箱
1.2.3 下载原生Android源码
如下第一条是下载master分支代码；如果需要下载某条指定分支，可通过第二条命令，比如指定分支android-7.0.0_r1， 其他分支信息可查看https://source.android.com/source/build-numbers.html#source-code-tags-and-builds.
repo init -u https://android.googlesource.com/platform/manifest
repo init -u https://android.googlesource.com/platform/manifest -b android-7.0.0_r1
初始完成后，可以开始同步代码，其中如下第一条是同步所有可用的project，第二条只同步当前初始化的分支，第三条是只同步frameworks/base库。
repo sync
repo sync -c -j4
repo sync platform/frameworks/base -c -j4
相关资料:
1.2.4 编译Android源码
以build aosp的eng版本为例：(当然build前需要先配置jdk环境)
make clobber //删除所有先去build所产生的output文件
source build/envsetup.sh //创建环境变量
lunch aosp_arm-eng //选择build target
make -j4 //build源码
二. 搭建源码环境
2.1 生成IDE相关文件
idegen专门为IDE环境调试源码而设计的工具， 依次执行如下命令：
soruce build/envsetup.sh
mmm development/tools/idegen/
./development/tools/idegen/idegen.sh
以上3个步骤的含义依次如下:
Step 1: 用于初始化环境变量
Step 2: 生成文件out/host/linux-x86/framework/idegen.jar
Step 3: 源码根目录生成文件android.ipr(工程相关设置), android.iml(模块相关配置)
2.2 源码导入Android Studio
打开Android Studio， 点击File -> Open，选中前面生成的android.ipr文件即可， 该过程较耗时
(a) 加载前配置文件提速：
打开android.iml文件，有大量excludeFolder，是指不会导入到AS的模块，默认除了以下14个文件夹之外的所有文件都会导致到AS工程，
这显然还会非常庞大的，那么我们可以有选择的导入 如下：
<excludeFolder url="file://$MODULE_DIR$/.repo"/>
<excludeFolder url="file://$MODULE_DIR$/external/bluetooth"/>
<excludeFolder url="file://$MODULE_DIR$/frameworks/base/docs"/>
<excludeFolder url="file://$MODULE_DIR$/out/host"/>
<excludeFolder url="file://$MODULE_DIR$/prebuilt"/>
(b) 加载后提速：
如果已经把全部项目导入到Android Studio，又想删除怎么办，其实有一个简单的方法就是进入目录Project Structure -> Modules，
可快速去除某些模块, 其中红色代码Exclueded选项(即代表已删除的目录), 如下图:
2.3 配置源码正确跳转
这里的配置JDK/SDK，是用于解决在分析和调试源码的过程，能正确地跳转到目标源码，而非SDK中的代码。
点击File菜单下的Project Structure.
Step 1 新建JDK
Project Structure -> SDKs, 新建 JDK(None), 其中JDK目录可选择跟原本JDK一致即可,
然后删除其classpath和SourcePath的内容，确保使用Android系统源码文件
Step 2 配置SDK
Project Structure -> SDKs, 选中Android API 25 Platform, 然后选择其Java SDK为前面新建的JDK(None)
Step 3 选择SDK
Project Structure -> Project -> 选中Project SDK, 选择前面的Android API 25 Platform
Step 4 建立依赖
Project Structure -> Modules -> android -> Dependencies:
先删除Android API 25 Platform之外的所有依赖, 然后点击下图绿色的+号来选择Jars or directories，将frameworks添加进来, 也可添加其他所关注的源码；
下图便是添加后的结果图:
三. 在线调试
前面已搭建好了Android的源码调试环境, 接下来可以在线调试源码. 首先,需要一台具有debug版的手机, 打开开发者选项, 允许USB调试.
3.1 attach系统进程
frameworks各大核心服务运行在system_server进程, 在调试器上名字为system_process,通过如下操作attach到我们要调试的目标进程, 同理, 要调试其他app进程也是这个方式.
3.2 进入调试
首先需要设置断点, 一旦进入断点便会停下来, 可以查看当时各个线程/变量值. 关于调试下一步等快捷键, 只需点击Tools即可看到.
四. 相关知识点
搭建源码过程涉及一些知识点，这里再进一步说明，在源码开发过程一定离不开repo和git命令，其中关于Git命令的用法，大家可以看如下：
4.1 build类型
build类型有eng, userdebug, user这3者的区别：
| 类型 | eng | userdebug | user |
|---|---|---|---|
| ro.debuggable | 1 | 1 | 0 |
| ro.kernel.android.checkjni | 1 | 0 | 0 |
| ro.secure | 0 | 0 | 1 |
| adb(默认状态) | 打开 | 打开 | 关闭 |
eng/userdebug版本会开启不同的debug属性以及默认打开adb； 而user版本则关闭debug属性且默认关闭adb功能。
4.2 Repo命令说明
Android系统源码是有非常多的git库组成的，为例更加便捷方便地管理所有的git库，便有了repo存在的价值。 Repo是一个库管理工具，是建立在git之上，为了更好的管理具有多个git库的工具。
init:
repo init -u <URL> [<OPTIONS>]
- -u: manifest所在URL，例如 https://android.googlesource.com/platform/manifest；
- -b: 指定版本，例如
android-7.0.0_r1 - -m: manifest名，默认为 default.xml.
sync:
repo sync //同步所有的可用project
repo sync PROJECT0 PROJECT1 ... //同步一个或多个project
upload:
repo upload [<PROJECT_LIST>]
diff:
repo diff
download: 从review系统 下载指定的change, 到本地project.
repo download <TARGET> <CHANGE>
例如：从库platform/build中将change 23823 拉到本地：
repo download platform/build 23823
forall: 让每一个git库都执行相应的command
repo forall [<PROJECT_LIST>] -c <COMMAND>
微信公众号 Gityuan | 微博 weibo.com/gityuan | 博客 留言区交流