一步步，打开第一扇窗口

先准备好，
再开始。

当前提供源码与离线依赖构建包。你需要在自己的 Apple Silicon Mac 上完成编译，安装过程中会显示进度与日志。

系统要求

Apple SiliconM5 等 ARM64 Mac

macOS 14+macOS 14 或更新版本

20 GB+可用磁盘空间

Xcode CLTApple 命令行开发工具

构建包已附带锁定的 Python、Java 和安卓运行依赖，无需单独安装 Homebrew、Python 或 Java。Apple 的开发工具需要在本机准备。

若尚未安装 Xcode Command Line Tools，在 Mac 终端运行以下命令，完成系统弹出的安装流程。

xcode-select --install

选择“完整构建包”，里面已有源码与 runtime-cache。无需再下载一份运行依赖。

你可以在版本页面查看 SHA-256。假设文件保存在 Downloads 文件夹，可用下面的命令核对：

shasum -a 256 ~/Downloads/M5-Android16-0.2.0-AOSP-microG.zip

保持解压后的文件夹结构，双击最外层 Build.command。它会找到旁边的源码与离线缓存，自动编译并配置 AOSP、Magisk 和 microG。阅读 Android SDK 协议后，输入 YES 继续。

编译结果安装到你的 Applications 文件夹。当前应用名称仍为 Android Subsystem。安装结束后，按下方指南完成 microG 自检，并测试实际需要的应用。

~/Applications/Android Subsystem.app

这是开发预览版当前不是免开发工具的签名、公证 DMG 安装包。新 AOSP 与 microG 通路仍需在 M5 上实际验收；编译成功不等于所有安卓应用都兼容。

运行完整包里的 Build.command 或 AndroidSubsystem/Migrate-to-AOSP.command。脚本会先退出管理应用、停止匹配当前配置的虚拟机，确认停机后再备份并更新配置。

保留配置，使用新的安卓环境6 GB 等内存设置会保留。纯 AOSP 使用独立数据环境，旧用户数据保留为离线备份；旧应用需要重新安装，应用内部数据不会自动迁移。新环境配置成功后才删除旧 Google APIs 系统镜像。

若升级中断，请保留日志后重新运行同一入口。现有私有 Python 缺失时，脚本会在更改配置前停止。

在安卓子系统的应用库中打开 microG 设置，进入“自检 / Self-Check”，检查服务、权限与签名兼容项。按应用需要授予通知、定位等权限，再停止并重新启动子系统，检查配置是否仍生效。

默认不会自动登录 Google、启用设备注册或云端推送，也不附带专有 DroidGuard。microG Companion 不是 Play 商店；Play Integrity、DRM、银行软件与反作弊兼容性不作保证。

构建成功或失败时，终端都会显示日志路径，按回车后才关闭。保留完整报错、日志、macOS 版本和出现问题的应用名称，便于排查。

~/Library/Application Support/AndroidSubsystem/logs/

日志不会自动上传。分享前请自行检查是否包含个人信息或应用数据。子系统源码内的 collect-diagnostics.py 可用于收集诊断。