Mac下编译Android源码,并导入IntelliJ IDEA进行源码阅读

野风技术札记 2019-06-27

  • macOS High Sierra 版本 10.13.4
  • Xcode 9.3
  • aosp分支:android-8.1.0_r20

准备编译环境

具体参考官方文档

  1. 安装 jdk8u45 or newer
  2. 安装xcode命令行
xcode-select --install
  1. 安装编译需要用到的其他包

使用Homebrew安装(官方文档使用的是MacPorts)

brew install gmake libsdl git gnupg

_NOTE_: gmake 可以不用安装,使用xcode自带的就可以

  1. 设置可以同时打开的文件数限制,避免编译时超出限制

在 ~/.bash_profile 添加如下语句

# set the number of open files to be 1024
ulimit -S -n 1024
  1. 创建区分大小写的APFS宗卷

官方文档创建的是区分大小写HFS+磁盘镜像,我们这边使用区分大小写的APFS卷宗
Mac下编译Android源码,并导入IntelliJ IDEA进行源码阅读

1. 打开磁盘工具按下图步骤操作:

Mac下编译Android源码,并导入IntelliJ IDEA进行源码阅读

2. 设置宗卷大小

具体大小根据自己情况设定,配额大小最好不要小于200G
Mac下编译Android源码,并导入IntelliJ IDEA进行源码阅读

下载源码

具体参考官方文档-下载源码
本文使用清华大学aosp镜像下载源码,具体步骤参考清华大学aosp镜像提供的教程。

  1. 下载repo
mkdir ~/bin
curl https://mirrors.tuna.tsinghua.edu.cn/git/git-repo > ~/bin/repo
chmod +x ~/bin/repo

在~/.bash_profile中将刚才创建的~/bin目录添加进PATH

export PATH=~/bin:$PATH
  1. 建立工作目录
mkdir WORKING_DIRECTORY
cd WORKING_DIRECTORY
  1. 初始化仓库

指定master分支

repo init -u https://aosp.tuna.tsinghua.edu.cn/platform/manifest

若要指定android版本,如下:

repo init -u https://aosp.tuna.tsinghua.edu.cn/platform/manifest -b android-8.1.0_r20
  1. 同步源码树

repo sync 或者 repo sync -j4 # 指定并发数
NOTE: repo sync有时会失败,可能要运行多次,才能同步完源码,可以使用以下循环脚本:

#!/usr/bin/env bash
repo sync -j4
while [ $? -ne 0 ]
do
    repo sync -j4
done

编译源码

具体参考官方文档-编译源码

source build/envsetup.sh
lunch aosp_x86_64-eng # 或者直接运行lunch, 在出现的选项中选择编译目标
make -j8 # 根据cpu核心数(物理线程)选择并发数,公式:并发数=cpu核心数(物理线程) x 2

编译过程比较漫长,在我的机子上大概用了2个多小时

编译遇到的问题

  1. mac sdk10.13 不支持编译,如下:

internal error: Could not find a supported mac sdk: ["10.10" "10.11" "10.12"]

[44/44] bootstrap out/soong/.minibootstrap/build.ninja.in
[4/4] out/soong/.bootstrap/bin/minibp out/soong/.bootstrap/build.ninja
[860/861] glob external/clang/utils/TableGen/Android.bp
[54/54] out/soong/.bootstrap/bin/soong_build out/soong/build.ninja
FAILED: out/soong/build.ninja
out/soong/.bootstrap/bin/soong_build -t -b out/soong -d out/soong/build.ninja.d -o out/soong/build.ninja Android.bp
internal error: Could not find a supported mac sdk: ["10.10" "10.11" "10.12"]
ninja: build stopped: subcommand failed.
20:24:32 soong failed with: exit status 1

解决方法
修改AOSP/build/soong/cc/config/x86_darwin_host.go文件,添加10.13支持,如下

darwinSupportedSdkVersions = []string{
    "10.10",
    "10.11",
    "10.12",
    "10.13", // 添加mac sdk 10.13
}
  1. 遇到bison错误
FAILED: out/soong/.intermediates/external/selinux/checkpolicy/checkpolicy/darwin_x86_64/gen/yacc/external/selinux/checkpolicy/policy_parse.c out/soong/.intermediates/external/selinux/checkpolicy/checkpolicy/darwin_x86_64/gen/yacc/external/selinux/checkpolicy/policy_parse.h
BISON_PKGDATADIR=external/bison/data prebuilts/misc/darwin-x86/bison/bison -d --defines=out/soong/.intermediates/external/selinux/checkpolicy/checkpolicy/darwin_x86_64/gen/yacc/external/selinux/checkpolicy/policy_parse.h -o out/soong/.intermediates/external/selinux/checkpolicy/checkpolicy/darwin_x86_64/gen/yacc/external/selinux/checkpolicy/policy_parse.c external/selinux/checkpolicy/policy_parse.y

解决方法
bison打补丁,重新编译(Patch bison fix for High Sierra and build bison:):

cd AOSP/external/bison
git cherry-pick c0c852bd6fe462b148475476d9124fd740eba160
mm
cp AOSP/out/host/darwin-x86/bin/bison AOSP/prebuilts/misc/darwin-x86/bison/

将源码导入IntelliJ IDEA

导入IDEA前 - 配置

  1. 运行如下命令,生成IDE工程信息文件 android.iprandroid.iml
source build/envsetup.sh # 在新终端下需要执行这一步
mmma development/tools/idegen
development/tools/idegen/idegen.sh
  1. 由于aosp工程很大,在导入IDEA前需要先修改配置:

    1. 修改VM内存大小
      打开IDEA 菜单栏 Help > Edit Custom VM Options,添加
-Xms1g 
-Xmx5g
  1. 修改文件大小限制,打开区分大小写选项

    打开IDEA 菜单栏 Help -> Edit custom properties, 添加
idea.max.intellisense.filesize=100000
idea.case.sensitive.fs=true

NOTE: 重启IDEA使配置生效

  1. 用IDEA找到AOSP目录下的android.ipr文件,打开AOSP工程,耐心等待,索引需要一定时间

导入IDEA后 - 配置

  1. 创建SDK 1.8 (No Libraries),确保代码跳转到是aosp源码,而不是系统安装的JDK,如下

NOTE 注意要删掉Classpath里面所有的jar
Mac下编译Android源码,并导入IntelliJ IDEA进行源码阅读

  1. 删除Modules中的dependencies,只保留<Module source>1.8 (No Libraries)

Mac下编译Android源码,并导入IntelliJ IDEA进行源码阅读

  1. 将生成的资源文件ID目录out/target/common/R添加进源码目录,避免R资源索引找不到,如图:

Mac下编译Android源码,并导入IntelliJ IDEA进行源码阅读

最后 Synchronize 整个工程同步下(打开IDEA菜单 File -> Synchronize),稍稍等待后就可以愉快的阅读Android源码了。

相关推荐