写在前面
最近因为工作需要又要编译Android源码,看了官方文档,又搜索了很多中文博客,发现一个问题:多数博主都是亦步亦趋的翻译了Android官方介绍,新手如果按照这些博客去做往往做到一半会发现各种问题,影响效率。
希望能通过这篇博客帮助到更多的Android开发者(我希望能帮助到有脑子、看了博客能理清楚编译源码思路的开发者,而不是伸手党)。有时间会补充每个环节的细节。
阿里校招开始了!欢迎同学们投递简历,详见文末二维码!
事前准备
我使用Mac pro + 移动硬盘 + Pixel 3XL编译刷机
- 操作系统:Mac OS 10.14(或Linux),不推荐Windows,坑多
- 存储空间:120G(很多博客写40/60G,大坑,完全不够用),一定要设置为“Mac OS 扩展(区分大小写,日志式)”
- 手机:专门买了Pixel 3XL做测试设备,Pixel 2/3/3XL都有部分是v版,不支持解锁,买之前一定要看清楚!不想浪费钱用模拟器也行
- 软件:这里也是大坑,很多博客都在最后写出现xxx error,是要更新xxx
- vpn:大家都懂,有了梯子方便很多,没有也行,下载源码或其他软件时选择国内镜像
- platform-tools:第一次用24编译出错,改成29就好了
- Java:我用Java 8,编译过程没报错
- Xcode:我的是9.4.1,编译没报错
- Homebrew、GnuPG、Gerrit、环境变量等的错误提示都很明显,随便Google/百度都有答案,不细写了,注意一点,提前配置好git config
- Python:新版repo(新手先简单理解repo=下载器)要使用Python3.6+,但Python3.6+在repo运行过程中会强制校验SSL证书,所以可以在repo里加两行代码跳过校验
import ssl
ssl._create_default_https_context = ssl._create_unverified_context
编译
整个流程是这样:初始化repo->下载源码->下载驱动->编译->刷机
这里要注意!很多博客会写下载源码后直接编译,但如果不下载手机对应的驱动,编译出来的镜像是不能刷机的,刷了容易变砖!
下载源码前要看自己的手机是否支持Android高版本!拿着Nexus 3是刷不了Android 10的!在这里查:https://source.android.com/setup/start/build-numbers#source-code-tags-and-builds
敲黑板:如果英语过关,一定要官网的英文文档,有些文档中文版更新不及时,非常误事!比如最新的源码版本介绍,中文版比英文版的更新晚整一个月!
初始化repo,下载源码
看官方文档:https://source.android.com/setup/build/downloading
嫌麻烦直接按我的介绍敲命令行:
$ cd
$ mkdir ~/bin
$ PATH=~/bin:$PATH
$ curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
$ chmod a+x ~/bin/repo
$ mkdir WORKING_DIRECTORY(替换为你的目标源码目录)
$ cd WORKING_DIRECTORY(进入你的目标源码目录)
$ repo init -u https://android.googlesource.com/platform/manifest
$ repo init -u https://android.googlesource.com/platform/manifest -b android-10.0.0_r30
$ repo sync(开始下载,几十个G,我下了4个小时)
下载驱动
看这里:https://developers.google.com/android/drivers,如果不是Nexus/Pixel就自己找原厂资源吧
下完两个zip包,解压出来2个sh文件,放在你的源码目录下(就是上一步的WORKING_DIRECTORY),使用sh命令分别运行两个文件,完事
编译
嫌麻烦直接按我的介绍敲命令行:
$ make clobber(清空之前的编译产物)
$ source build/envsetup.sh
$ lunch
$ 15(这里要对应你的测试收集,比如我用Pixel 3XL,这里就敲“15”,具体看这里:https://source.android.com/setup/build/running#selecting-device-build)
$ make -j8(邪恶..8代表并行8个编译任务,一般选CPU核数*2,我用Mac pro编了7个小时)
这里有个坑,要配置环境变量,保证“echo $ANDROID_PRODUCT_OUT”输出的结果是:WORKING_DIRECTORY/out/target/product/crosshatch,crosshatch替换为你编译的版本
刷机
如果用模拟器就不用往下看了,这里命令行直接敲“emulator”等模拟器启动就好
- 进入开发者模式,打开“OEM 解锁”开关
- 进入刷机模式,看这里:https://source.android.com/setup/build/running,命令行或物理组合键都能进
- 嫌麻烦直接按我的介绍敲命令行:
$ fastboot flashing unlock(或fastboot oem unlock,分别适用于新旧手机)
$ fastboot flashall -w
完
正常到这里,你能看到手机自动重启,然后进入了一个Android 1.5一样简陋的页面,只有WebView、Camera、Phone等十来个基础应用,恭喜,刷机成功!