macOS Mojave 10.14.4 下 Android 8.1源码编译详解
第0步:版本选择
AOSP版本选择很重要,如果选错了,会造成编译失败等各种问题,编译AOSP对Xcode的版本是有要求的;
比如:AOSP6.0-7.0,要求Xcode的版本是8.3,然而在MacOS 10.14上面是不支持Xcode8.3的这就很尴尬; 由于现在大家的Mac环境基本是更新到最新的10.14了,所以这里推荐大家选择Android-8.1.0_r1。
编译环境:
- OS: macOS Mojave 10.14.4
- JDK: 1.8.0_144
- Xcode: 10.2.1
- XcodeSDK: 10.11
- AOSP: android-8.1.0_r15
- Git: 2.21.0
第一步:创建区分大小写的磁盘映像
由于Mac OS的文件系统默认是不区分大小写的,Git 并不支持此类文件系统,而且此类文件系统会导致某些 Git 命令(例如 git status)的行为出现异常,所以我们需要在区分大小写的文件系统中对 AOSP 源文件进行操作。
通过 shell 使用以下命令创建磁盘映像:
# hdiutil create -type SPARSE -fs'Case-sensitive Journaled HFS+' -size 150g ~/android.dmg
这里设置分配150g的大小,这将创建一个 .dmg(也可能是 .dmg.sparseimage)文件,该文件在装载后可用作具有 Android 开发所需格式的存储卷。
如果您以后需要更大的存储卷,还可以使用以下命令来调整稀疏映像的大小:
# hdiutil resize -size <new-size-you-want>g ~/android.dmg.sparseimage
双击生成的.dmg.sparseimage文件,就会看到挂载的磁盘了,之后所有操作都在这个磁盘分区中进行,您可以像对待外接硬盘一样将其弹出(卸载)。
如果你喜欢在命令行中挂载/卸载分区,可以向 ~/.bash_profile 中添加辅助函数:
# mount the android file image functionmountAndroid { hdiutil attach ~/android.dmg.sparseimage -mountpoint /Volumes/android; } # unmount the android file image functionumountAndroid() { hdiutil detach /Volumes/android; }
注意文件名路径是否一致,要使.bash_profile配置生效,需要:
#source ~/.bash_profile
之后你就可以在命令行中通过mountAndroid和unmountAndroid来操作了。
第二步:安装所需的程序包
安装 Xcode 命令行工具:
一般在安装Xcode的时候会自动安装命令行工具,这里保险起见,检查一下:
# xcode-select--install
通过 macports.org 安装 MacPorts。
将以下内容添加到~/.bash_profile中
export PATH=/opt/local/bin:$PATH
通过 MacPorts 获取 Make、Git 和 GPG 程序包:
# POSIXLY_CORRECT=1 sudo port install gmake libsdl git gnupg
如果您使用 Mac OS X v10.4,还需要安装 bison:
# POSIXLY_CORRECT=1 sudo port install bison
设置文件描述符数量上限
在 Mac OS 中,可同时打开的文件描述符的默认数量上限太低,在高度并行的编译流程中,可能会超出此上限。
要提高此上限,请将下列行添加到 ~/.bash_profile 中:
# set the number of open files to be 1024 ulimit -S -n1024
第三步:下载源代码
安装Repo
Repo 是一款工具,可让您在 Android 环境中更轻松地使用 Git.
直接运行下面的命令:
# curl https://storage.googleapis.com/git-repo-downloads/repo > ~/repo
会在主目录下生成repo文件,接着给他赋予可执行的权限:
# chmod a+x ~/repo
为了可以方面的使用repo命令,我们把它移动到/opt/local/bin里面,因为这个路径我们在上一步中已经加入到PATH了,所以我们可以在任何一个地方执行repo命令;
# mv ~/repo /opt/local/bin
同步源码
进入第一步中创建好的分区,建立工作目录:
# mkdir aosp #cd aosp
repo的运行过程中会尝试访问官方的git源更新自己,如果想使用tuna的镜像源进行更新,可以将如下内容复制到你的~/.bash_profile里:
export REPO_URL='https://mirrors.tuna.tsinghua.edu.cn/git/git-repo/'
设置Git用户名和邮箱:
# gitconfig --global user.name"Your Name" # gitconfig --global user.email"[email protected]"
初始化repo,这里采用清华大学的镜像,并设置分支android-8.1.0_r15:
#repoinit-uhttps://aosp.tuna.tsinghua.edu.cn/platform/manifest -b android-8.1.0_r15
最后一步:
# repo sync
源码同步过程中常常会因为网络因素而断开,如果断开了继续执行repo sync命令即可,直到下载完成。
漫长的等待......
下载完成后差不多占用70G大小,因为我们后续不需要再进行分支切换与同步,所以我们可以把目录下的.repo文件夹给删除了,毕竟Mac的SSD容量宝贵,删除之后你会发现硬盘大小没有释放,这就有点尴尬了,这个问题目前也没找到解决的办法,我的方法是按照第一步创建一个新的分区,把内容拷贝进去,然后把旧的分区删了,这样空间就释放了。
编译源码
优化编译环境 设置 ccache
要使用 ccache,请在源代码树的根目录下执行以下命令:
#export USE_CCACHE=1 #export CCACHE_DIR=/<path_of_your_choice>/.ccache #prebuilts/misc/darwin-x86/ccache/ccache -M 50G
注意<path_of_your_choice>是你源码下载的根目录。
最后请将以下内容添加到 .bash_profile(或等同文件)中:
export USE_CCACHE=1
配置ANDROID_Java_HOME环境变量
在~/.bash_profile中添加以下内容,前提必须是安装了JDK1.8:
export ANDROID_JAVA_HOME=$(/usr/libexec/java_home -v1.8)
设置XcodeSDK的版本
执行以下命令,打开配置文件:
# vi build/soong/cc/config/x86_darwin_host.go
查看darwinSupportedSdkVersions,这里列出了支持的sdk版本:
darwinSupportedSdkVersions = []string{ "10.10", "10.11", "10.12", }
接着我们进入以下目录查看现有的XcodeSDK版本:
/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/
这里我们选择10.11的版本,如果没有MacOSX10.11.sdk则去MacOSX-SDKs 中下载一个,解压到该目录,并把其他版本的删除,确保只保留一个就行了。
开始编译
首先要把shell切换到bash(如果你使用的是zsh)
#chsh -s /bin/bash
初始化环境:
#source build/envsetup.sh
选择编译的分支:
#lunch
会出现以下列表:
Lunch menu... pick a combo: 1. aosp_arm-eng 2. aosp_arm64-eng 3. aosp_mips-eng 4. aosp_mips64-eng 5. aosp_x86-eng 6. aosp_x86_64-eng 7. aosp_car_arm-userdebug 8. aosp_car_arm64-userdebug 9. aosp_car_x86-userdebug 10. aosp_car_x86_64-userdebug ......
Which would you like? [aosp_arm-eng]
要求输入对应的数字:
如果你想在你的Nexus上设备运行,请参照官方设备对应列表选择;
如果你只想在本机的虚拟机上运行,Mac系统的话选择aosp_x86-eng即可。
最后一步,编译:
#make -j6
通过-jN参数来设置编译的并行任务数,以提高编译速度,在此前我的CPU核心数为6,这里N值最好选在6到12之间,这里我们设置6个并行任务进行编译。
这里需要注意的是,每次退出再进入命令行要执行以上命令之前,都要先执行:
#source build/envsetup.sh
编译中遇到的问题
问题1:Jack编译报错:communication error with Jack server
原因:JACK编译器不支持多用户同时编译,其他用户在编译,端口被占用。
解决方法:
如下:修改以下两个配置文件中的端口号server.service.port和server.admin.port,比如都改为8096/8097:
- ~/.jack-settings
- ~/.jack-server/config.properties
注意:
两个文件中的端口号必须一致。
修改后的端口号必须是没有被使用的。
问题2: 出现Try increasing heap size with java option '-Xmx'
原因: 出现这个错误是由于电脑内存不足;
解决方法:在命令行分别执行以下三条语句,然后继续编译;
#export JACK_SERVER_VM_ARGUMENTS="-Dfile.encoding=UTF-8 -XX:+TieredCompilation -Xmx4g" # ./prebuilts/sdk/tools/jack-adminkill-server # ./prebuilts/sdk/tools/jack-admin start-server
问题3: BISON_PKGDATADIR=external/bison/data prebuilts/misc/darwin-x86/bison/bison -d
在log中出现BSION等字样;
原因:网上说这个bsion的一个bug;
解决方法:拉取新的分支,重新编译 bison:
#cd external/bison #git cherry-pick c0c852bd6fe462b148475476d9124fd740eba160
如果这步骤发生错误了(比如之前删除了.repo文件夹)
这时候我们就把bison这个文件夹删除,下载一个新的:
wgethttps://android.googlesource.com/platform/external/bison/+archive/c0c852bd6fe462b148475476d9124fd740eba160.tar.gz
解压后进入bison文件夹,执行:
# mm # cp out/host/darwin-x86/bin/bison prebuilts/misc/darwin-x86/bison/
结束
最后一切顺利的话,经过漫长的编译后,最终会出现以下画面则说明编译Android系统成功了���