![0.png](https://p3-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/0e056774621b4a96ae98f7c4eaca550a~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAgdmluY2VudF93b28=:q75.awebp?rk3s=f64ab15b&x-expires=1753136217&x-signature=PR5EMhoUPCuLWlicC3XGQp7A9HQ%3D) # 前言本系列希望从应用开发者的角度出发，将系统层面各个系统服务的脉络及运行原理呈现出来。由于个人知识面有限，若有错误，欢迎大家积极指出，共同讨论，一起进步。 # 适用于个人的开发环境配置开篇就来配置我们的开发环境吧，其中包括3部分：[系统环境安装](https://juejin.cn/post/7435951637891743798)、[AOSP代码下载及编译](https://juejin.cn/post/7436011859327533110)、[单步调试和单编运行](https://juejin.cn/post/7438219500372459574)。 # 软硬件要求 * 操作系统：**Win11专业版 + WSL2**（Windows 11 专业版 24H2 26100.2033） * CPU：**尽可能高配置，缩短编译时间**（13th Gen Intel(R) Core(TM) i9-13900H 2.60 GHz 14核） * 内存：**至少32G，最好64G**（Samsung 32G DDR5 5600MHz + Samsung 8G DDR5 5200MHz） * 硬盘：**1T及以上，Android13的源代码+编译产物大概要占400G左右**（Samsung MZVL21T0HCLR-00BL2 1T） *注：括号中为我的机器配置，供参考。我的机器原本有两条8G内存，两个插槽，为了编译，增加了一条32G，8G就留了一条没有换下来。* # 安装操作系统推荐安装Win11 专业版，家庭版不能安装WSL，请勿浪费时间。Win11镜像推荐到[官网下载](https://www.microsoft.com/zh-cn/software-download/windows11/)，纯净安全，无负担。推荐使用[Rufus系统安装启动盘制作工具](https://rufus.ie/zh/)，完全免费，傻瓜式安装Win11。 **注：如果可能的话，推荐重新分区，为WSL单独建立一个500G左右的分区，方便后续管理。** # 安装WSL2 1. 在BIOS中开启CPU的**虚拟化支持（Virtualization Technology）**，简称VT选项。一般都是**默认开启**的，只要你的机器能启动Android Studio中的模拟器就说明VT选项已经打开了。 Intel平台示例 ![image.png](https://p3-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/61201dde62214a5ba722dd9986d6e06e~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAgdmluY2VudF93b28=:q75.awebp?rk3s=f64ab15b&x-expires=1753136217&x-signature=7iZJsVZyQYzAABtEDw2tIxA2FYk%3D) AMD平台示例 ![image.png](https://p3-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/3ccd0c07c5644dc1970718ba21b95f24~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAgdmluY2VudF93b28=:q75.awebp?rk3s=f64ab15b&x-expires=1753136217&x-signature=Tj5NjEJmFOFeL5x2as3peumsXXo%3D) 2. Windows中的配置：控制面板->程序->启用或关闭Windows功能，勾选**Hyper-V**、**适用于 Linux 的 Windows子系统**和**虚拟机平台**，**重启系统**。 ![3.png](https://p3-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/1a3828e5f67e45fca3e84c2d78baddc7~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAgdmluY2VudF93b28=:q75.awebp?rk3s=f64ab15b&x-expires=1753136217&x-signature=7fgvq6dj5UzjIKwHSjzlp3yn6Hk%3D) 3. 安装WSL2。当前是2024年11月，默认安装已经是WSL2。据广大网友提醒，WSL1不支持编译AOSP，所以切勿浪费时间。 ```sh # 查看WSL支持的Linux发行版本 wsl -l -o # 安装指定分发，从上面列表中选一个Ubuntu（AOSP官方指定的编译系统） wsl --install -d Ubuntu-22.04 ``` ![4.png](https://p3-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/f29960bd09744b75bb3f68b41e23d0ed~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAgdmluY2VudF93b28=:q75.awebp?rk3s=f64ab15b&x-expires=1753136217&x-signature=gcsBWGVXAxoBiW2XCjm7oTaHSLg%3D) 4. 待安装完成后，查看WSL版本。 ```sh # 查看当前系统中存在的所有Linux实例 # Name: 实例名 # State: 当前状态 # Version: WSL版本 wsl -l -v # wsl -v 显示更详细的版本信息。其他命令解释请查询 wsl --help ``` ![5.png](https://p3-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/4bd9999c20444030833c31d6bc49a026~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAgdmluY2VudF93b28=:q75.awebp?rk3s=f64ab15b&x-expires=1753136217&x-signature=Y7NkLQESrQ1Pr%2BMiKc8rKQqxAfI%3D) 5. 迁移WSL。我们需要在WSL中存放编译AOSP代码，需要巨大的磁盘空间，不幸的是，WSL默认安装在系统盘中，地主家的系统盘也没这么富裕啊，所以需要安装以下步骤迁移到一个500G或更大的分区中。 ```sh # 1.查看Linux实例 wsl -l -v # 2.关闭Linux实例 wsl --terminate <实例名称> # 关闭指定实例 wsl --shutdown # 关闭所有实例 # 3.导出Linux实例 wsl --export <实例名称> <导出地址> # 例如：wsl --export Ubuntu-22.04 E:\ubuntu2204.tar # 4.卸载系统盘实例 wsl --unregister <实例名称> # 5.导入实例到其他盘 wsl --import <新的实例名称> <新的实例存放地址> <导入实例文件地址> # 例如：wsl --import ubuntu2204 E:\ubuntu2204 E:\ubuntu2204.tar # 6.启动并进入Linux系统 wsl -d <新的实例名称> -u # 例如：wsl -d ubuntu2204 -u root ``` 另外，可以通过命令行提示符cmd顶部提供的快捷入口进入Linux。 ![6.png](https://p3-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/aa27367e91f3465f9d585345230de0c1~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAgdmluY2VudF93b28=:q75.awebp?rk3s=f64ab15b&x-expires=1753136217&x-signature=TyP4PDA%2BOZAB8FaKQiUD5jTUApU%3D) 6. 在Linux系统中可能需要科学上网，因此代理配置必不可少。微软官网提供了详细的[WSL配置参考](https://learn.microsoft.com/zh-cn/windows/wsl/wsl-config)。这里列出我选用的配置项。注：使配置项生效需要重启WSL（wsl --shutdown）。 ```sh # 文件位置：C:\Users\<用户名>\.wslconfig [wsl2] # 启用镜像网络特性支持 networkingMode=mirrored # WSL2/WSLg DNS 代理隧道，以便由 Windows 代理转发 DNS 请求（请根据实际需要启用） dnsTunneling=true # WSL2/WSLg 子系统的 Windows 防火墙集成，以便 Hyper-V 或者 WPF 能过滤子系统流量（请根据实际需要启用） firewall=true # 是否强制 WSL2/WSLg 子系统使用 Windows 代理设置（请根据实际需要启用） autoProxy=true # 配置WSL能使用的核心数 processors=8 # 配置内存大小，一般为物理内存的50%，AOSP编译要求至少16GB，因此您的机器至少需要32G物理内存 memory=20GB # 交换分区大小，一般为内存大小的2倍 swap=40GB [experimental] # 启用空闲内存自动缓慢回收 autoMemoryReclaim=gradual ``` 7. 在Ubuntu下安装下载编译AOSP源码所需的软件包，此命令来自[AOSP官方文档](https://source.android.com/docs/setup/start/requirements?hl=zh-cn#install-packages)。**安装之前，强烈建议先替换Ubuntu软件安装源，国内用户一般都会遇到无法安装问题。具体操作请参见文末章节(apt-get install报错)。** ```sh sudo apt-get install git-core gnupg flex bison build-essential zip curl zlib1g-dev libc6-dev-i386 x11proto-core-dev libx11-dev lib32z1-dev libgl1-mesa-dev libxml2-utils xsltproc unzip fontconfig ``` 8. 为python3创建全局软连接，保证后续安装步骤都默认执行python3。 ```sh sudo ln -s /usr/bin/python3 /usr/bin/python # 确认python版本 python --version ``` # Q\&A ## apt-get install报错 ![7.png](https://p3-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/4eef43890fe34a3f831511597df75d11~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAgdmluY2VudF93b28=:q75.awebp?rk3s=f64ab15b&x-expires=1753136217&x-signature=g9Tu7YWBMKXPUs7II34JpReSHhg%3D) 需要使用[清华大学镜像](https://mirrors.tuna.tsinghua.edu.cn/help/ubuntu/)作为安装源。 ```sh # 1.备份系统安装源 cp /etc/apt/sources.list /etc/apt/sources.list.bak # 2.清空上面的文件，复制清华大学的镜像安装源到文件中，具体操作可以参见清华大学网页介绍 vi /etc/apt/sources.list # 3.更新安装源 sudo apt-get update # 4.更新软件(可选) sudo apt-get upgrade ``` # 参考 [Microsoft官网WSL安装使用文档](https://learn.microsoft.com/zh-cn/windows/wsl/install) [Microsoft官网WSL配置文件说明](https://learn.microsoft.com/zh-cn/windows/wsl/wsl-config) [AOSP官方文档](https://source.android.google.cn/docs/setup/about?hl=zh-cn)