【Android】AOSP源码下载及编译 for mac

字数 2106阅读 453

本文记录了AOSP在Mac系统上下载和编译的过程。

采用的系统是 macOS 10.13.1

所使用的AOSP分支是 android-8.1.0_r7

系统预留空间 大于200G

一. 环境配置

    环境配置,官网给出了非常全的教程:Build Environment

    对于Mac用户来说,需要配置的相对也不会很多

    1. 创建大小写敏感文件系统

           AOSP源码编译需要一个大小写敏感的文件系统环境,所以我们自己需要创建一个。打开Terminal,输入

hdiutil create -type SPARSE -fs 'Case-sensitive Journaled HFS+' -size 150g ~/android.dmg

        上面的150g就是我们创建的文件系统的可用大小,android.dmg就是我们创建的文件系统镜像,其存放的目录可以在任何地方,这里我们暂时制定在用户根目录下。之后找到该文件双击后,就可以将其挂载到系统文件系统中。我们可以在Finder左侧看到新挂载的文件系统。

    另外对于创建好的镜像文件,我们也可以重新分配其大小

hdiutil resize -size <newsize>g ~/android.dmg


    2.安装JDK

对于Mac用户来说我们系统自带了Open JDK7,不过如果编译的是7.0以上的android系统的话,则需要Open JDK 8 的环境,所以我们自己需要下载安装,我们可以到官网选择需要的版本进行下载Java官网

下面列出Android版本与JDK的对应关系:

Android 7.0 (Nougat) - Android 8.0 (O release): Ubuntu - OpenJDK 8, Mac OS - jdk 8u45 or newer

Android 5.x (Lollipop) - Android 6.0 (Marshmallow): Ubuntu - OpenJDK 7, Mac OS - jdk-7u71-macosx-x64.dmg

Android 2.3.x (Gingerbread) - Android 4.4.x (KitKat): Ubuntu - Java JDK 6, Mac OS - Java JDK 6

Android 1.5 (Cupcake) - Android 2.2.x (Froyo): Ubuntu - Java JDK 5


    3.安装Repo

    Repo是AOSP中用于下载和管理源码的工具,也可以将其看成是git的上层管理控制工具。我们可以通过Terminal进行下载,

mkdir ~/bin

curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/

repochmod a+x ~/bin/repo

之后我们需要将repo配置到环境变量中,打开 ~/.bash_profile,我们将以下代码加入到文件最后一行

PATH=~/bin:$PATH

重新打开Terminal,我们输入repo后可以看到配置成功。


    4. 安装XCode

    Xcode为AOSP提供Native编译环境,对于Xcode的安装我们可以直接通过App Store进行安装,目前Xcode版本为9.x,SDK版本为10.13,不过对于8.x版本的Android源码来说,该版本有点高,我们需要在完成Xcode的安装后再下载一个低版本的SDK,我们可以到这里去下载:MacOSX SDK下载,我们可以下载MacOSX10.12.sdk.tar.xz

下载完成之后,Terminal输入

tar -jxvf MacOSX10.12.sdk.tar.xz

进行解压,可以获得一个MacOSX10.11.sdk的目录,之后我们通过Finder,在应用程序中找到我们Xcode,右键显示包内容,进入到Xcode里面,之后将我们刚解压出来的文件放到Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs目录下。

安装Xcode command line tools

xcode-select --install


    5. 其他依赖库安装

官方推荐用MacPorts来安装,需要从MacPorts官网安装一个MacPorts,MacPorts官网,安装完之后将其配置到环境变量之中,也就是将export PATH=/opt/local/bin:$PATH配置到~/.bash_profile最后一行。

之后安装 gmake libsdl git gnupg bison,通过Terminal输入

POSIXLY_CORRECT=1 sudo port install gmake libsdl git gnupg bison

回车后即可进行安装,首次可能会出现更新的问题,需要根据其给出的提示进行相应的操作。

如果出现Port gmake not found的错误的话,可以先执行

sudo port -d sync

当然如果用其他包管理器可以下载到 gmake libsdl git gnupg bison 的话也是可以的。


二. AOSP源码下载

    对于在国内的开发者来说,使用国内的镜像站下载源码是个不错的选择,我们这里推荐清华镜像站

其为我们提供了初始化包的下载方式,一开始我们可以不需要使用repo进行拉取代码,对于这个初始化包我们有两种下载方式:

    一种是使用其官网提供的方法,首先打开终端Terminal,定位到需要存放源码的目录,输入

wget -c https://mirrors.tuna.tsinghua.edu.cn/aosp-monthly/aosp-latest.tar # 下载初始化包

     按回车后,就会从镜像站下载资源包,需要注意的是,这个包大小有40多G,所以下载过程需要花费非常漫长的时间,另外不支持断点续传。

     另外一种下载方式是使用第三方下载器,比如使用迅雷,直接在下载地址中输入https://mirrors.tuna.tsinghua.edu.cn/aosp-monthly/aosp-latest.tar,即可进行下载。

     这里推荐使用第二种方式,主要是速度快,而且支持断点续传,非常方便。下载完成之后,我们会获得一个aosp-latest.tar的文件,这是源码的压缩包。


三. 代码同步更新

 我们将aosp-latest.tar放到大小写敏感的文件系统中,使用tar命令进行解压

tar xf aosp-latest.tar

cd AOSP

可以获得一个AOSP目录,里面包含一个隐藏的.repo目录,我们需要将镜像站的地址更新到里面的配置文件中。打开.repo/manifest.xml,找到里面的

<remote name="aosp"

       fetch="https://android.googlesource.com"

       review="android-review.googlesource.com"/>

将   fetch="https://android.googlesource.com" 改成 fetch="https://aosp.tuna.tsinghua.edu.cn"

另外,打开.repo/manifests.git/config,将url = https://android.googlesource.com/platform/manifest 修改为url = https://aosp.tuna.tsinghua.edu.cn/platform/manifest。

做完这些之后,我们将Terminal定位到AOSP目录,输入

repo sync

注意:使用清华镜像的需要注意的是,因为我们有修改manifest文件,而.repo整个文件也是通过git进行管理的,所以首次sync会提示文件没有commit,所以需要先到.repo目录下执行git 的 add、commit操作。

sync操作需要一个漫长到等待过程,成功后就可以在AOSP目录看到最新的源码资源。

使用Repo一个比较好的地方是,即使更新中途断网了也没关系,因为其有记忆功能,重新输入该命令,会跳过已经更新的资源。


四. 查看和切换分支

在AOSP目录下,我们可以用repo来查看当前所有可切换的分支,输入

cd .repo/manifests

git branch -a | cut -d / -f 3

可以列出所有的分支

从中选择android-8.1.0_r7,进行切换,切换的命令如下

repo init -b android-8.1.0_r7

repo sync

之后花费一些时间等待切换即可。

五. 编译

编译需要执行一下几个过程

1. 进入到AOSP目录,执行 

make clobber

这会清除之前的缓存文件。

2. 之后执行

source build/envsetup.sh

初始化一些环境变量

3. 接下来输入

lunch aosp_arm-eng

选择目标编译版本。

如果不想使用该版本的话,我们可以直接输入lunch,其会提示所有的可以编译的版本。

4. 编译

make -j4

输入该命令后就会开始执行编译,整个过程会持续1~2个小时,请耐心等待。


六. 运行

直接在AOSP目录下运行

emulator


七. 问题记录处理

    1. bison bug

    我们在编译的时候可能会遇到的一个问题,这是AOSP源码里面的一个问题,解决方法是通过Terminal

cd  external/bison

git cherry-pick c0c852bd6fe462b148475476d9124fd740eba160

mm

完成后回到AOSP目录执行

cp out/host/darwin-x86/bin/bison  prebuilts/misc/darwin-x86/bison/

之后执行make -j4就能正常编译

该问题在 https://groups.google.com/forum/#!msg/android-building/D1-c5lZ9Oco/hPBVZ0ElEAAJ 中有讨论到。

推荐阅读更多精彩内容