MacOS M1 (Big Sur ARM64) AOSP构建异常与模拟器启动故障排查

前置基础环境错位说明 #

当前使用的android-11.0.0_r35版本构建体系仅内置x86_64 Darwin主机的Soong编译配置，无ARM64 Darwin适配项，构建过程会自动将M1架构主机识别为x86_64平台，所有主机侧编译工具均为x86_64格式、依靠Rosetta转译运行，这一环境错位是构建链路出现兼容性问题的核心前提。

具体排查流程 #

• 校验initrd镜像本身的压缩格式有效性
  • 定位构建产出的ramdisk镜像路径，通用ARM64模拟器目标的镜像一般存储在out/target/product/[对应产品名称]/ramdisk.img
  • 执行file out/target/product/*/ramdisk.img确认镜像头标识，正常lz4压缩的ramdisk会明确标注格式类型
  • 调用lz4解压器直接测试镜像可读性：lz4 -d out/target/product/[产品名]/ramdisk.img ramdisk_test.cpio，如果能正常解出可读取的cpio归档内容，说明镜像本身压缩格式无损坏，问题源在内核侧的解压支持逻辑。
• 核对目标内核的解压配置开关
  • 打开对应模拟器内核的defconfig配置文件（路径一般为kernel/arch/arm64/configs/ranchu_defconfig），检查两项核心配置：
    • 确认CONFIG_RD_LZ4已设置为y，即lz4解压逻辑被直接编入内核启动本体
    • 确认配置裁剪流程没有因为交叉编译环境变量偏移，意外关闭lz4解压支持、或错误加载不匹配的其他压缩格式配置
  • 注意3.18版本内核的ramdisk解压逻辑要求，所有ramdisk对应的解压驱动必须内置进内核镜像，不能编译为独立模块，否则在ramdisk加载阶段内核无法调用对应解压逻辑。
• 排查转译运行的工具链带来的格式偏移
  • 校验ramdisk打包链路的工具架构：找到负责生成ramdisk的mkbootfs、lz4打包工具（一般存储在out/host/darwin-x86/bin/目录），确认这些x86_64格式的工具在Rosetta转译运行时，是否存在lz4压缩格式输出和arm64内核内置解压端的版本不兼容问题
  • 手动调用M1原生的lz4工具对构建产出的未压缩cpio格式ramdisk源包重新压缩，替换原有镜像后重新启动模拟器测试。
• 校验内核ramdisk加载的路径匹配性
  • 检查模拟器启动时传入的内核命令行参数，确认ramdisk在内核镜像中的偏移量和实际存储位置匹配
  • 启动模拟器时在内核命令行追加earlyprintk参数，输出ramdisk加载阶段的底层日志，确认内核读取到的镜像块魔数和lz4标准魔数（0x184D2204）一致，如果魔数读取错误，说明打包流程的镜像布局存在错位。

内容的提问来源于stack exchange，提问作者emitrax