WSL For Android | 在Windows上获取可编译的AOSP源代码

（好久没上简书了，这是一篇两年前写的简单教程，忘记发了哈哈哈哈，补上！）

我们经常看到一些技术文章分析,例如 Android源码分析Activity启动流程、Android Luncher实现分析，还有涉及到硬件层的同学会面对的Wifi，Bluetooth实现分析等等。

然后，问题来了，这些源码在哪里看？

如何阅读源代码，大概是每个Android学习者都绕不过的问题。
当年的我也是这样小白过来的，翻了翻Sdk里下载的源码，怎么人家说的这些文件夹我都没有? 我都全局搜索了怎么还是没有他说的这个类？这个XML哪里来的？...
各种尴尬迷茫不知所措....

直到我百度到了AOSP

什么是AOSP

AOSP，即 Android Open Source Project。

作为一个开源项目，内容我们可以简单理解为Android完整源代码，下面这张是我们每个开始学习Android的同学都接触过的一张Android架构图。

经典款Android结构图

AOSP概览截图

第二张图是源自AOSP官网说明的概览截图。

其中的Android堆栈图和我们见过的Android架构图基本一致，只是在Linux内核层上多出了HAL，硬件抽象层，看说明主要是包含音视频，蓝牙，传感器之类的硬件内容。（未免误人子弟就不多讲了，毕竟我也不不怎么熟悉，内容已经严重偏离标题。。。）

于是乎，大家应该理解了，不同于SDK中的阉割版源码（通常只能用来查看常用类），
AOSP项目是包含上述架构图中全部内容，完整可编译的，甚至可以直接打包成rom给手机刷机的版本。

完整的Android源码是包含Application层的，也即包含许多Android内置应用，如堆栈图中标注的Luncher，短信，相机，联系人等等应用的完整代码。如果想要实现类似功能，对比Android原生实现是一定要做的。
出于学习，这些项目也是个很好的选择，对理解Android系统运行的机制和实现原理都非常有帮助。

（扯了这么久终于到了今天的重点）
通常我们有两种方法获取源代码，一是直接前往一些在线网站浏览，二是自己下载一份完整代码到本地。

在线浏览AOSP源代码

这里分享一个比较好用的网站 AndroidXRef ，这个也是许多大神的共同推荐（强行给自己拉高下档次）
网站上有Android各个历史版本的完整代码，支持文件搜索，还是很好用的。特别是需要查看特定版本差异时，不是下载一份Aosp就能搞定的。

本地获取AOSP项目源码

然而在线代码仅能用于浏览，并受限于网络，使用起来也不是那么顺畅。自然，获取一套本地的Aosp代码就饿很有必要了，不仅是可以方便查看学习，还可以自己修改,编译打包。通常如果想要成为一名系统或是驱动工程师，这是必不可少的一步。

Aosp官网有详细的教程指导我们一步步按顺序获取并编译运行源代码。

但是在获取代码这一步，考虑到AOSP体积庞大，国际网络需要翻墙还不稳定，真的使用官方说明来操作，绝对是一次痛不欲生的经历。所以本文采用的是通过清华大学镜像站的说明方法来获取代码。

在获取代码后，可以继续学习Aosp官网上的源码编译相关知识。

清华大学开源软件镜像站
 AOSP官方网站（需翻墙）

需要注意的是，AOSP代码只能在Linux和Mac上进行编译，以往的
Windows用户只能通过虚拟机或者安装双系统来解决。但是随着
WSL的推出，我们也可以直接在windows上通过Linux子系
统来操作了。
如果没有合适的Linux操作途径，windows用户就只能下载来纯看代码了

准备工作

1.一块足够大的硬盘，不说编译了，就算存放代码你也需要30G，建议留足100G的空间，即使AOSP并不会用到这么多。
2.如果你是Win10电脑，必须已经开启了WSL，可以直接运行ubuntu
bash。如果还没有，请看 Win10 直接运行内置Linux子系统
3.通畅高速的网络

开始

我使用的是Win10 Linux子系统来进行操作。

清华大学镜像站说明中提供了两种方法，这里采用的是使用每月更新的初始化包。该方法获取的是最新的AOSP代码版本，如果需要下载指定版本的AOSP，可以参考说明，选择传统方法。

1.安装Repo

Repo以 Git 为基础构建的代码库管理工具，具体信息可以参考这里。这里我们先简单的将Repo当作获取代码，并保持更新的工具就好。

打开ubuntu on windows，分别执行以下命令

# 在主目录下创建bin文件夹  ~/是linux下的主目录
mkdir ~/bin
# 将bin文件添加到PATH，类似windows下的环境变量
PATH=~/bin:$PATH
# 下载repo到路径下
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
# 添加可执行权限
chmod a+x ~/bin/repo

2.下载初始化包

在空余的硬盘下创建好存放代码的文件夹AndroidSource，
在bash中切换到指定目录，使用执行以下命令

一，使用传统方法

切换到工作目录，该节方法取自镜像站说明。

初始化仓库:
repo init -u https://aosp.tuna.tsinghua.edu.cn/platform/manifest

**如果提示无法连接到 gerrit.googlesource.com，请参照[git-repo的帮助页面](https://mirrors.tuna.tsinghua.edu.cn/help/git-repo)的更新一节。**
如果需要某个特定的 Android 版本([列表](https://source.android.com/source/build-numbers.html#source-code-tags-and-builds))：
repo init -u https://aosp.tuna.tsinghua.edu.cn/platform/manifest -b android-4.0.1_r1

同步源码树（以后只需执行这条命令来同步）：
repo sync

二，下载每月更新的初始包

# 切换到我Z盘上的AndroidSource文件夹
cd /mnt/z/AndroidSource
# 下载初始化包
wget https://mirrors.tuna.tsinghua.edu.cn/aosp-monthly/aosp-latest.tar

在bash中通过wget下载

1.wget 是Linux下的下载命令
2.在WSL中mnt文件夹对应windows的文件架构，例如通过 mnt/c 来访问C盘
3.注意不要直接在bash主目录下载大文件，Linux子系统位于系统盘，C盘会撑不住。

不过这里我开始下载后 Ctrl + C 取消掉了...

感觉网速有点慢，然后反应过来在win10上完全不必要wget 。

所以正确操作是打开迅雷,直接下载到目录下..（会不会有看一行操作一行的同学想要打我）

一般人我不告诉

换到迅雷预计时间减少36小时，并且直观的看到文件大小29G，这个才是Linux和win10的完美结合有没有！！！

3.解压并检出代码

漫长的下载完成后，解压下载文件，并在bash中通过repo sync检出完整目录。

复制一下镜像站的说明

tar xf aosp-latest.tar
cd AOSP   # 解压得到的 AOSP 工程目录
# 这时 ls 的话什么也看不到，因为只有一个隐藏的 .repo 目录
repo sync # 正常同步一遍即可得到完整目录
# 或 repo sync -l 仅checkout代码

tar是linux中的压缩命令，xf表明解压指定文件。
这里同样建议使用winrar等windows平台软件进行解压，相对WSL的文件效率会高出很多。
当代码检出完成，我们就可以在AOSP目录下看到完整的项目源代码了。

使用 repo sync 时，可能会出现 /usr/bin/env : python ：No Such file or directory 提示，这是由于WSL中的Python没有正确安装。
输入 apt-get install python 安装python2.7即可。

然后继续

image.png

  sudo apt-get install git-core gnupg flex bison gperf build-essential 
  zip curl zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 
  lib32ncurses5-dev x11proto-core-dev libx11-dev lib32z-dev ccache 
  libgl1-mesa-dev libxml2-utils xsltproc unzip

上述软件包是AOSP建议ubuntu14.04安装的，WSL虽然版本为16.04了，但由于过于精简，缺失依赖比较严重，以上我们也最好在开始全部安装一遍的。不必担心过多软件会重复安装，linux会自动筛选缺失的程序。