什么是aosp:
"Android Open-Source Project"的缩写。中文意为"Android 开放源代码项目"。
下载
下载前的准备工作:
1.ubuntu 操作系统
虽然Google官方证实在mac os 上也可以成功编译,但是目前我用macbook编译从来没有成功过,总是报一些莫名奇妙的错误也找不到原因,无奈将一台旧Windows笔记本改装ubuntu18.04后成功编译。Google官方推荐的源码编译环境也是ubuntu,所以选择ubuntu编译Android源码是最保险的策略,考虑到Android源码占用空间极大,磁盘最好预留250G以上空间。
ubuntu就的安装不再赘述了,安装成功打开终端,开始接下来的操作吧。
2.下载repo工具
mkdir ~/bin
PATH=~/bin:$PATH
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
chmod a+x ~/bin/repo
这里的访问可能会被墙,使用清华镜像代替之:
mkdir ~/bin
PATH=~/bin:$PATH
curl https://mirrors.tuna.tsinghua.edu.cn/git/git-repo > ~/bin/repo
chmod a+x ~/bin/repo
参考 repo清华镜像
执行curl时可能会提示curl没有,下载之:
sudo apt-get install curl
3.找个合适的位置新建文件夹:
mkdir aosp
cd aosp
4.环境准备
// 1.安装python
sudo apt-get install python
// 2.安装git:
sudo apt-get install git
// 3.配置git邮箱和账户
git config --global user.email “you@example.com”
git config --global user.name “Your Name”
// 4.安装jdk8:
sudo apt-get install openjdk-8-jdk
// 5.然后执行Java -version判断版本是否为8,如果不是需要配置,命令如下
sudo update-alternatives --config java
sudo update-alternatives --config javac
5.初始化仓库
因为Android源码工程巨大无比,而且因为墙的存在,直接链接Google的资源链接可能不稳定,因此在这里使用国内清华aosp镜像
参考清华AOSP镜像使用帮助
repo init -u https://aosp.tuna.tsinghua.edu.cn/platform/manifest
此时可能会提示无法连接到 gerrit.googlesource.com,这是因为repo的运行过程中会尝试访问官方的git源更新自己,如果想使用清华的镜像源进行更新,可以将如下内容复制到你的~/.bashrc里,并重启终端模拟器
export REPO_URL='https://mirrors.tuna.tsinghua.edu.cn/git/git-repo'
参考 repo清华镜像
如果需要某个特定的 Android 版本,
repo init -u https://aosp.tuna.tsinghua.edu.cn/platform/manifest -b android-8.1.0_r75
同步源码树:
repo sync
接下来就是漫长的源码下载过程....,在源码下载过程中会遇到各种各样的问题,然后终端进程就中止在那里不动了,解决这个问题,可以使用自动化脚本去同步,当进程中止后重新开始sync,步骤如下:
1.在aosp文件夹下创建一个脚本:
#!/bin/bash
repo sync
while [ $? = 1 ]; do
echo “======sync failed, re-sync again======”
sleep 3
repo sync
done
在shell中执行如下命令:
chmod a+x down.sh
./down.sh
接下来就是漫长的源码下载过程,整个8.1的源码大概70多个G,耐心等待吧。
编译
1.源码编译
安装编译所需要的软件:
sudo apt-get install git gnupg flex bison gperf build-essential
sudo apt-get install zip curl libc6-dev libncurses5-dev:i386 x11proto-core-dev
sudo apt-get install libx11-dev:i386 libreadline6-dev:i386 libgl1-mesa-glx:i386
sudo apt-get install libgl1-mesa-dev g++-multilib mingw32 tofrodos
// 这里会提示不能够下载mingw32,则需要在source.list文件中增加
deb http://us.archive.ubuntu.com/ubuntu trusty main universe
sudo apt-get install python-markdown libxml2-utils xsltproc zlib1g-dev:i386
sudo ln -s /usr/lib/i386-linux-gnu/mesa/libGL.so.1 /usr/lib/i386-linux-gnu/libGL.so
// 在本用户的.bashrc文件中增加
export LC_ALL=C
// 修改prebuilts/sdk/tools/jack-admin文件,找到文件中的这一行:
JACK_SERVER_COMMAND="java -Djava.io.tmpdir=$TMPDIR $JACK_SERVER_VM_ARGUMENTS -cp $LAUNCHER_JAR $LAUNCHER_NAME"
// 然后在该行添加-Xmx4096m,如:
JACK_SERVER_COMMAND="java -Djava.io.tmpdir=$TMPDIR $JACK_SERVER_VM_ARGUMENTS -Xmx4096m -cp $LAUNCHER_JAR $LAUNCHER_NAME"
重启终端
进入aosp文件夹,创建环境变量
source build/envsetup.sh
执行lunch命令,会列出所有可编译的Android架构版本
选择要编译的room,比如要编译arm架构lunch命令就是
lunch aosp_arm-eng
接下来执行编译命令:
make
可以视电脑配置状况适当增加线程数,增加编译速度,如:
make -j4
接下来又是漫长的等待,我自己大概是20小时后编译完成,继续耐心等待。
导入AndroidStudio
以下操作来自大神gityuan的博客,我只是文字的搬运工
1.终端进入aosp文件夹,依次执行如下命令:
soruce build/envsetup.sh
mmm development/tools/idegen/
./development/tools/idegen/idegen.sh
2.打开Android Studio, 点击File -> Open,选中前面生成的android.ipr文件即可, 该过程较耗时
加载后提速:
如果已经把全部项目导入到Android Studio,又想删除怎么办,其实有一个简单的方法就是进入目录Project Structure
-> Modules
, 可快速去除某些模块, 其中红色代码Exclueded选项(即代表已删除的目录), 如下图:
- 配置源码正确跳转
这里的配置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 28 Platform之外的所有依赖, 然后点击下图绿色的+
号来选择Jars or directories
,将frameworks添加进来, 也可添加其他所关注的源码;
下图便是添加后的结果图:
自此,Android源码的下载、编译、导入AS的操作全部完成,我们可以愉快地在AS中阅读代码了
Android 内核工程下载
在下载编译完成后便开心的阅读起了源码,但是读着读着发现有些不对劲,怎么Android 内核文件夹是空的?
网上搜索了一下,原来aosp工程是不包含kernel代码的,aosp编译时使用的是prebuilts里面预先编译好的Linux文件,
如果需要阅读kernel代码需要另行下载,好在这方面的资料也很多,找起来也不费劲
Android Kernel工程下载引导
这个网站详细说明了如何下载Kernel工程,有不同的Cpu架构对应的kernel工程可选
· common
· exynos
· goldfish
· lk
· samsung
· tegra
· msm
· omap
比如想下载common架构的kernel工程,git地址为:
git clone https://android.googlesource.com/kernel/common.git
因为墙的存在,这个地址是很难访问到的,使用清华镜像地址代替:
git clone https://mirrors.tuna.tsinghua.edu.cn/git/AOSP/kernel/common.git
下载完成后切换到aosp工程Android版本对应的分支即可