Android源码开发环境搭建

Posted by Gityuan on August 13, 2016

一. 准备

本文介绍采用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选项(即代表已删除的目录), 如下图:

as_modules

2.3 配置源码正确跳转

这里的配置JDK/SDK,是用于解决在分析和调试源码的过程,能正确地跳转到目标源码,而非SDK中的代码。 点击File菜单下的Project Structure.

Step 1 新建JDK

Project Structure -> SDKs, 新建 JDK(None), 其中JDK目录可选择跟原本JDK一致即可, 然后删除其classpath和SourcePath的内容,确保使用Android系统源码文件

jdk_none

Step 2 配置SDK

Project Structure -> SDKs, 选中Android API 25 Platform, 然后选择其Java SDK为前面新建的JDK(None)

sdk_none

Step 3 选择SDK

Project Structure -> Project -> 选中Project SDK, 选择前面的Android API 25 Platform

project_sdk

Step 4 建立依赖

Project Structure -> Modules -> android -> Dependencies: 先删除Android API 25 Platform之外的所有依赖, 然后点击下图绿色的+号来选择Jars or directories,将frameworks添加进来, 也可添加其他所关注的源码;

project_dependencies

下图便是添加后的结果图:

project_result

三. 在线调试

前面已搭建好了Android的源码调试环境, 接下来可以在线调试源码. 首先,需要一台具有debug版的手机, 打开开发者选项, 允许USB调试.

3.1 attach系统进程

frameworks各大核心服务运行在system_server进程, 在调试器上名字为system_process,通过如下操作attach到我们要调试的目标进程, 同理, 要调试其他app进程也是这个方式.

as_attach

3.2 进入调试

首先需要设置断点, 一旦进入断点便会停下来, 可以查看当时各个线程/变量值. 关于调试下一步等快捷键, 只需点击Tools即可看到.

as_debugger

四. 相关知识点

搭建源码过程涉及一些知识点,这里再进一步说明,在源码开发过程一定离不开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>

欢迎关注微信公众号: Android达摩院 , 微博: weibo.com/gityuan