本项目记录安卓操作系统移植到龙芯平台的过程中各种重要工作的文档。
截止2025年1月，龙芯已经完成AOSP12（ABI 1/旧世界）和 AOSP15(ABI 2/新世界)的初步移植工作。目前，AOSP12可以在模拟器和真机上启动到桌面，AOSP15运行到开机动画出现。已经做的工作包括：
- 移植工具链。针对旧世界和新世界ABI分别做了一套工具链，前者基于llvm15，后者基于llvm19。
- 各种安卓软件包添加LoongArch架构支持，包括构建系统以及运行一个基本系统所需要的大部分软件包。其中工作量相对较大的包括Bionic库和Art虚拟机等。
├── 01-toolchain.md ： 工具链编译文档
├── 02-bionic.md ： bionic移植、编译、测试文档
├── 03-Android12_setup.md ： AOSP整体设置、编译、烧录、运行步骤
├── 04-debug.md ： qemu运行以及各种移植过程中的调试技巧
├── 05-Notes-for-art.md ； 进一步移植JIT、OAT的注意事项
├── toolchain-ABI2.md : build toolchain for ABI version 2其中01-05开头的文档针对AOSP12编写， AOSP15可以参考。toolchain-ABI2.md针对AOSP15.
安卓12系统编译运行可以参考03-Android12_setup.md和安卓官方文档。由于绝大部分开源社区软件的LoongArch支持是面向新世界的，我们鼓励大家重点玩AOSP15.
安卓15的编译运行过程如下：
## initialize repo
$ repo init -u [email protected]:android-la64/manifest.git -b a15_larch
## synchronize repo
$ repo sync -c. build/envsetup.sh
lunch aosp_cf_x86_64_phone-trunk_staging-eng # 官方脚本似乎有点bug，直接lunch无法显示选择菜单
build_build_var_cache
lunch loongson_3a5000-trunk_staging-engm
安卓的运行可以参考这个仓库。其中aosp15目录下的内容是运行aosp15所需要的一些脚本、内核二进制等。
上述方法使用一个自定义的设备，涉及很多非标准的工作（包括device下的配置，虚拟/物理磁盘的分区和启动等）。由于设备（PC类）不符合安卓的期望，很多外设还没有完全工作起来，selinux等配置也没有调整到位，目前还有大量报错信息。近期我们为已有的cuttlefish设备(device/google/cuttlefish)添加了LA支持，使得在PC上可以和启动其他架构一样，通过官方支持的cuttlefish模拟器来启动LA安卓环境。
使用cuttlefish和上述编译运行过程稍有不同：
- manifests应该使用a15_larch_cf分支。
- lunch使用aosp_cf_loongarch64_phone-trunk_staging-eng。
- 运行启动参考官方流程。
## initialize repo
repo init -u [email protected]:android-la64/manifest.git -b a15_larch_cf
repo sync -c
lunch aosp_cf_loongarch64_phone-trunk_staging-eng
m
launch_cvd为了和其他架构尽量保持一致，我们使用u-boot来启动cuttlefish，在安卓的u-boot版本之上添加了LA支持。LA支持来自FlyGoat同学的u-boot版本，在此致谢!
安卓版u-boot添加了对安卓镜像启动的相关支持，因此cuttlefish设备配置和launch_cvd等工具代码不需要过多修改，和其他架构几乎一致。
内核配置和之前也有所不同，一些模块采用模块而不再是内置，另外使用安卓的clang编译器交叉编译（之前是gcc)。请参考内核源码的a15_larch_cf分支。
内核源码位于内核仓库，缺省配置文件参见上述仓库。
安卓是一个巨大的项目，目前的工作还十分初步，有大量需要进一步完善的地方。以下是一些下一步可能着手的方向：
- 安卓15系统启动到桌面
- 虚拟机的JIT和AOT模式。龙芯实验室一个同学已经完成了JIT模式支持所需要的大部分工作，能够通过几乎所有测试了。AOT还在进行中。这个对性能至关重要。
- 大量软件包的测试和进一步优化。由于时间关系，目前很多支持还没有得到充分测试，代码和文档也比较粗糙。
- 安卓系统在PC类硬件的配置完善和优化。安卓最适合的安装对象是移动设备，不过目前龙芯暂时没有手机类的产品线，我们是在龙芯PC上进行测试。现在的版本还缺很多东西，比如声音支持、有线网络的配置界面等。之前有一个开源项目android-x86做了很好的工作，让安卓在PC上能得到比较好的适配。可惜这个项目没有在继续维护。不过还有BlissOS等衍生项目可以参考。BTW, 安卓15的一个卖点是向桌面支持迈进了一大步：支持大屏幕多任务处理。可以预见，未来安卓在桌面上会越来越不违和。
- 安卓与Linux桌面的集成。龙芯实验室有同学在尝试移植waydroid，已经能够初步启动到界面。也许不久的将来，我们就可以在龙芯PC兼容运行很多安卓应用了。
- 安卓应用二进制翻译支持。要完整支持安卓生态，还需要二进制翻译，因为很多安卓软件会以ARM动态库形式提供部分功能。谷歌最近开源berberis软件，以便在x86上兼容运行riscv版安卓应用。龙芯实验室有位同学致力于在其基础上实现ARM安卓应用在LoongArch的运行。
- 尝试支持cuttlefish，目前直接用qemu，很多环境模拟不到位，可以参考riscv64实现cuttlefish模拟器。[update 0226: 已基本完成, 参见上边关于cuttlefish的说明]
- ...
同时，安卓也是一个设计精细和久经考验的产品级操作系统，有非常多值得学习和研究之处。安卓向一个全新架构的移植非常锻炼能力，欢迎大家来参与。
Happy Hacking!