转载:http://www.istarx.cc/2018/02/03/download-android-source-code/
在查看源代码以及二次开发的过程中避免不了和源代码打交道。本文记录了在Mac OS(当前10.13.2版本)下载、编译Android源代码过程。
设置编译环境
Mac上默认安装是在一个保留大小写但是不区分大小写的环境下进行的,但是git命令并不能很好的支持该环境,后续编译也不能正常进行。因此在Mac上下载Android源代码之前要新建一个始终区分大小写的文件系统中,并在此文件系统中对源码进行编译等操作。
安装JDK以及 Xcode 命令行工具
安装jdk
你可以在java官网上下载最新或指定的jdk版本进行安装。也可以使用HomeBrew命令来进行安装:
brew cask info java # 查看java最新版本相关信息 brew cask install java # 安装java最新版本 |
也可以通过如下命令来进行特定版本的安装:
brew tap caskroom/versions brew cask info java8 brew cask install java8 |
Android 7.0 (Nougat) - Android 8.0 (O)在Ubuntu上需要OpenJDK8,Mac OS上需要jdk8u45或更高版本。
安装Xcode命令行工具
xcode-select --install |
如果你已经安装过Xcode,则只需要在第一次打开的时候同意许可即可。
创建大小写敏感的磁盘映像
创建磁盘映像
-
通过磁盘文件系统创建映像
通过
应用程序—>实用工具—>磁盘工具
,选择文件-->新建映像-->空白映像
,填写名称大小(编译至少需要25G空间,如果是设置缓存等功能,则需要更大的控件),格式选择Mac OS 扩展 (区分大小写,日志式)。 -
通过shell命令
hdiutil create -type SPARSE -fs 'Case-sensitive Journaled HFS+' -size 40g ~/AndroidSourceCode/android.dmg
输出如下图:
新建的image文件可能是一个
.dmg
,也可能是一个.dmg.sparseimage
。可以使用如下命令来调整稀疏映像的大小:
hdiutil resize -size <new-size-you-want>g ~/AndroidSourceCode/android.dmg.sparseimage
装载及卸载磁盘映像
执行装载卸载映像,只需要执行一下命令即可:
hdiutil attach ~/AndroidSourceCode/android.dmg.sparseimage -mountpoint /Volumes/android; # 装载 hdiutil detach /Volumes/android # 卸载 |
为了方便装载及卸载映像,可以把上述代码写进.bashrc
或zshrc
或者类似的文件中:
# mount the android file image function mountAndroid { hdiutil attach ~/AndroidSourceCode/android.dmg.sparseimage -mountpoint /Volumes/android; } # unmount the android file image function unmountAndroid { hdiutil detach /Volumes/android; } |
接着执行source .bashrc
或者source .zshrc
就可以使用mountAndroid
命令装载映像,unmmountAndroid
命令卸载映像。
下载源代码
初始化Repo
新建一个专门存放repo的bin文件夹,并将其添加到PATH变量中:
mkdir ~/bin PATH=~/bin:$PATH # 也可以执行 echo 'export PATH=~/bin:$PATH' >> ~/.zshrc 命令 |
然后下载Repo工具,在命令行中输入以下命令:
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo chmod a+x ~/bin/repo |
如果没有VPN,则可以用清华的镜像地址替换谷歌的地址。
REPO_URL = 'https://gerrit-googlesource.lug.ustc.edu.cn/git-repo' |
替换为:
REPO_URL = 'https://aosp.tuna.tsinghua.edu.cn/git-repo' |
加载之前创建的稀疏映像,新建工作目录:
cd /Volumes/android mkdir source_code cd source_code |
执行repo初始化指令
repo init |
如果指定地址和分支,则使用:
repo init -u https://aosp.tuna.tsinghua.edu.cn/platform/manifest -b android-8.0.0_r31 |
初始化成功之后在工作目录下会有一个.repo
文件夹,包含了清单文件。
同步Android源代码树
在工作目录下运行如下命令,经过漫长的等待即可以下载到对应分支的源代码了。
repo sync |
如果已经有源码,并需要更换清华源,则需要替换.repo/manifests/default.xml
中的同步源码
<manifest> <remote name="aosp" - fetch=".." + fetch="https://aosp.tuna.tsinghua.edu.cn/" review="https://android-review.googlesource.com/" /> <default revision="refs/tags/android-8.0.0_r31" remote="aosp" |
通过下载使用每月更新的初始化包同步代码
由于上述同步工作需要下载30G的数据,任何环节出问题都可能造成同步失败,所以可以使用清华的每月初始化包进行同步代码。
下载https://mirrors.tuna.tsinghua.edu.cn/aosp-monthly/aosp-latest.tar最新的源代码tar包以及对应的md5文件,下载完成后执行以下MD5校验一下。
具体执行过程如下:
-
先下载repo工具;
-
下载初始化包并同步;
wget -c https://mirrors.tuna.tsinghua.edu.cn/aosp-monthly/aosp-latest.tar # 下载初始化包 wget -c https://mirrors.tuna.tsinghua.edu.cn/aosp-monthly/aosp-latest.tar # 下载初始化包对应的md5码 MD5 aosp-latest.tar #校验MD5码 tar xf aosp-latest.tar cd AOSP # 解压得到的 AOSP 工程目录,这时 ls 的话什么也看不到,因为只有一个隐藏的 .repo 目录 repo sync # 正常同步一遍即可得到完整目录或 repo sync -l 仅checkout代码
切换分支
以每月更新的初始化包下载的代码,分支为默认分支,需要切换到所需的分支上。
cd .repo/manifests git branch -a | cut -d / -f 3 repo init -u https://aosp.tuna.tsinghua.edu.cn/platform/manifest -b android-8.0.0_r31 repo sync |
之后就可以使用命令编译源码了。
编译源代码
清除编译操作的所有输出
建议在 bash 环境下执行,否则会出现莫名其妙的问题。
make clobber |
设置环境
Android 源代码种与编译相关的文件都放在 build 目录中,其中envsetup.sh
脚本是初始化环境所用:
source build/envsetup.sh |
可以简写为:
. build/envsetup.sh |
选择目标
使用lunch
命令,可以在该命令后面添加参数,参数采用 BUILD-BUILDTYPE
的形式指定编译目标,其中 BUILD
指特定功能组合的代号,而BUILDTYPE
则有 user
、userdebug
、eng
三种:
user
:权限受限;适用于生产环境;userdebug
:与“user”类似,但具有 root 权限和可调试性;是进行调试时的首选编译类型;eng
:具有额外调试工具的开发配置;
如果在lunch
命令后面不添加参数,则需要从提示菜单中选择一个编译目标。
编译代码
Android 源码编译命令为 make
,参数为-jN
,N 是介于所使用计算机硬件线程总数的1~2倍之间。
make -j8 |
常用的编译命令:
make -k # 继续编译 m # 编译完整的Android源代码 mm # 此命令必须进入指定的工程的目录进行编译 mmm # 可以在任何一级目录编译任意指定的工程 |
编译 fastboot 和 adb
编译 fastboot 和 adb 命令如下:
make fastboot adb |
之后可以使用物理按键的方式((对于Nexus系列可以参考这里))或者 adb reboot bootloader
命令重启进入引导加载程序。
解锁及加锁引导加载程序
如果要刷写定制系统,例如各个 Android 厂商的定制 ROM,需要解锁引导加载程序,而引导加载程序默认处于锁定状态。解锁会导致系统清楚设备上的所有数据,so,在解锁之前请先备份重要文件。
解锁引导加载程序的步骤如下:
-
在设置—系统—关于本机,点按
版本号
7次,当看到“您已处于开发者模式”这条消息后,点按返回按钮; -
进入开发者选项,然后启用 OEM 解锁和 USB 调试,如果 OEM 解锁处于不可用状态,则需要链接互联网,以便设备至少签到一次,之后如果仍处于锁定状态,说明设备可能已被运营商锁定 SIM 卡;
-
adb reboot bootloader
命令进入引导加载程序; -
执行以下命令以解锁:
fastboot flashing unlock # 2015 之后发布的设备 fastboot oem unlock # 2014 年及之前发布的设备
-
在屏幕上确认解锁;
对于加锁过程,只需要重启到引导加载程序以后执行以下命令即可:
fastboot flashing lock # 2015 之后发布的设备 fastboot oem lock # 2014 年及之前发布的设备 |
使用 Android Studio 加载源代码
在编译完全部源代码一次之后查看out/host/darwin-x86/framework/idegen.jar
是否存在,如不存在,则使用如下命令生成该文件:
source build/envsetup.sh lunch [编译全部源代码时选择的参数] mmm development/tools/idegen/ |
接下来生成配置文件:
development/tools/idegen/idegen.sh |
之后会在源码目录下生成android.ipr
和android.iml
文件。
打开 Android Studio 加载ipr文件即可。
遇到的问题
-
RPC failed; curl 18 transfer closed with outstanding read data remaining.
因为curl的postBuffer默认值太小的原因,重新在终端配置一下这个值就可以了。
git config –global http.postBuffer 524288000
-
curl: (22) The requested URL returned error: 404 Server does not provide clone.bundle; ignoring.
无视即可
-
error.GitError: device/asus/fugu-kernel rev-list (’^fb4baab945ff1b696b84a8bd9af3d54032d3cfaa’, ‘HEAD’, ‘–’): fatal: bad object HEAD
cd AOSP/device/asus/fugu-kernel git fetch --all
-
curl: (35) LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to android.googlesource.com:443
升级系统自带的libressl, openssl 和 curl 即可
-
repo sync discarding xxx commits.
repo forall -c 'git reset --hard; git clean -f -d -x';
-
external/error_prone/soong/Android.bp:1:1: “soong-java-config-error_prone” depends on undefined module “soong-java-config” ninja: error: rebuilding ‘out/soong/.minibootstrap/build.ninja’: subcommand failed.
删除soong相关的文件
external/error_prone/soong
以及out
文件夹,然后执行repo sync
命令。 -
Could not find a supported mac sdk: [“10.10” “10.11” “10.12”]
下载 10.13 版本的SDK,解压到
/Applications/XCode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/
目录下 -
frameworks/layoutlib: MODULE.darwin.JAVA_LIBRARIES.temp_layoutlib already defined by frameworks/base/tools/layoutlib.
删除源码中的 framworks 文件夹,重新执行
repo sync
-
FAILED: out/soong/.intermediates/system/tools/aidl/libaidl- common/darwin_x86_64_static/gen/yacc/system/tools/aidl/aidl_language_y.cpp out/soong/.intermediates/system/tools/aidl/libaidl-common/darwin_x86_64_static/gen/yacc/system/tools/aidl/aidl_language_y.h
是因为 bison 造成的,需要给 bison 打补丁,并且替换现有的 /prebuilt/ 目录下的二进制文件,具体做法如下:
cd /Volumes/AOSP/external/bison git cherry-pick c0c852bd6fe462b148475476d9124fd740eba160 mm cp /Volumes/AOSP/out/host/darwin-x86/bin/bison /Volumes/AOSP/prebuilts/misc/darwin-x86/bison/
参考网址https://groups.google.com/forum/#!topic/android-building/D1-c5lZ9Oco
-
Unsupported curl, please use a curl not based on SecureTransport. Jack server installation not found
brew install curl --with-openssl echo 'export PATH=$(brew --prefix curl)/bin:$PATH' >> ~/.zshrc source ~/.zshrc caffeinate make -j8 # caffeinate是为了防止OS X 进入睡眠
-
/bin/bash: xz: command not found
brew install xz
-
Couldn’t locate the directory development/tools/idegen
是因为编译时使用zsh,要切换到bash环境下:
bash mmm development/tools/idegen/
-
fatal error: error in backend: IO failure on output stream.
是因为磁盘分区小了,扩大磁盘分区:
sudo hdiutil resize -size <new-size-you-want>g ~/android.dmg.sparseimage