核心前提（不满足必失败）

1. 系统：macOS 14 Sonoma / 13 Ventura（官方原生支持 M3）
2. 硬件：16GB+ 内存，≥250GB 空闲硬盘
3. 致命要求：Mac 默认磁盘不区分大小写，AOSP 必须用区分大小写的 APFS 卷宗

   一、1 分钟创建专用磁盘（必做）

   打开 磁盘工具 → 左上角 文件 → 新建 APFS 卷宗

   • 名称：AOSP
   • 格式：APFS（区分大小写）
   • 大小：分配 250GB+ 后续所有操作都在这个卷宗内执行：

   cd /Volumes/AOSP

   二、安装基础工具（M3 专属）

   1. 安装 Xcode 命令行工具 

   弹窗点击安装，无需完整 Xcode。

   2. 安装 Homebrew（ARM 版）

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   配置环境变量（M3 专属路径）：
   echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc 
   source ~/.zshrc

   3. 安装 AOSP 编译依赖

   brew install git git-lfs ccache repo make
   git lfs install
   

   4. 系统优化（解决编译报错）

   编辑配置文件:

   open ~/.zshrc
   添加以下内容（文件句柄 + 编译加速）：
   

   # 提升文件打开数（编译必需）
   ulimit -n 8192
   ulimit -u 8192
   # ccache 编译缓存（提速 50%+）
   export USE_CCACHE=1
   export CCACHE_DI

   生效配置

   source ~/.zshrc

   三、同步 AOSP 源码（Android 14 推荐）
   1.配置Git
   git config --global user.name "你的名字" git config --global user.email "你的邮箱"
   2.初始化源码（国内镜像，秒同步）
   创建目录并初始化（中科大镜像，比谷歌源快 10 倍）：
   mkdir android14 && cd android14 
   repo init -u git://mirrors.ustc.edu.cn/aosp/platform/manifest -b android-14.0.0_r50

   3.同步源码
   repo sync -j16 --no-clone-bundle
   完成提示：repo sync finished

   四、M3 芯片专属修复（唯一兼容操作）

   M3 无需关闭 SIP！仅需移除系统隔离属性：

   xattr -r -d com.apple.quarantine prebuilts/

   五、编译 Android 系统

   1. 初始化编译环境

   2. 选择编译目标（M3 首选）

   选择 aosp_arm64-eng（ARM64 工程版，带调试权限）
   3. 开始编译
   # M3 芯片推荐线程数，自动适配核心 m -j$(nproc)
   编译成功提示：

   #### build completed successfully ####
   编译产物：out/target/product/generic_arm64/
   

   六、运行系统（M3 性能拉满）

   直接启动 ARM 架构模拟器：

   emulator
   M3 运行 ARM 模拟器比 Intel 快 3~5 倍，无卡顿。
   

   七、真机刷机（进阶）

   1. 解锁设备 Bootloader（仅 Pixel / 小米等支持）
   2. lunch 选择对应机型（如 aosp_coral-eng）
   3. 刷机：fastboot flashall

   八、M3 专属常见问题

   1. Too many open files
      执行 source ~/.zshrc，确认 ulimit -n 为 8192
   2. 编译闪退
      降低线程数：m -j8
   3. 文件大小写报错
      回到第一步，必须在区分大小写的卷宗操作
   4. Repo 同步失败
      重新执行 repo sync，支持断点续传

   核心总结 

   1. 唯一硬要求：区分大小写的 APFS 卷宗
   2. M3 优势：无需关 SIP，原生支持 ARM 编译，模拟器性能极强
   3. 标准流程：创建磁盘 → 装工具 → 同步源码 → 编译 → 运行
   4. 适用场景：Framework 开发、系统服务定制、HAL 调试、ROM 编译