Skip to content

macOS M1 芯片运行 Android 模拟器指南

问题描述

在配备 Apple Silicon M1 芯片的 macOS Big Sur 11.0.1 系统上运行 Android Studio 4.1 时,虽然通过 Rosetta 转译后可以成功构建项目,但 Android 模拟器会出现 "CPU does not support VT-x" 错误。即使使用 ARM 架构的系统镜像,模拟器运行也非常缓慢,严重影响开发效率。

VT-x 错误示例

解决方案

方法一:安装正确的 Android Studio 版本(推荐)

最新版本支持

自 2021 年 7 月起,Android Studio 已正式支持 Apple Silicon M1 芯片。建议直接下载官方 ARM64 版本。

  1. 访问 Android Studio 官方下载页面
  2. 选择 Android Studio Arctic Fox (2020.3.1) 或更高版本的 arm64 版本
  3. 完成安装并启动 Android Studio

方法二:重新安装模拟器组件

如已安装 Android Studio 但模拟器无法正常工作,可尝试重新安装模拟器组件:

  1. 打开 Android Studio
  2. 进入 Tools → SDK Manager → SDK Tools 标签页
  3. 取消勾选 'Android Emulator' → 点击 OK
  4. 当尝试运行应用或启动 AVD 时,会提示安装模拟器错误
  5. 点击 OK,系统将自动下载正确的 M1 兼容版本

方法三:创建正确的虚拟设备

确保使用 ARM64 架构的系统镜像:

  1. Tools → SDK Manager
  2. 安装 Android 11 (R) 或 12.0 (S) → 点击 Apply
  3. Tools → AVD Manager → Create Virtual Device
  4. 选择带有 Google Play Store 图标的设备 → 点击 Next
  5. 在 "Other Images" 标签页中选择 arm64-v8a 架构的镜像

ARM64 镜像选择

方法四:完全重新安装(适用于迁移用户)

数据备份

此方法会删除所有 Android Studio 相关文件和设置,请提前备份重要项目。

如果是从 Intel Mac 迁移到 M1 Mac,可能需要完全清除旧安装:

bash
# 删除应用程序
rm -Rf /Applications/Android\ Studio.app

# 删除配置文件和缓存
rm -Rf ~/Library/Preferences/AndroidStudio*  
rm -Rf ~/Library/Preferences/com.google.android.*  
rm -Rf ~/Library/Preferences/com.android.*  
rm -Rf ~/Library/Application\ Support/AndroidStudio*  
rm -Rf ~/Library/Logs/AndroidStudio*  
rm -Rf ~/Library/Caches/AndroidStudio*  
rm -Rf ~/.AndroidStudio*  
rm -Rf ~/.gradle  
rm -Rf ~/.android  
rm -Rf ~/Library/Android*  
rm -Rf /usr/local/var/lib/android-sdk/

# 可选:删除项目(谨慎操作)
rm -Rf ~/AndroidStudioProjects

完成后重新下载并安装 Android Studio ARM64 版本

方法五:解决常见问题

ADB 命令找不到或 CPU 类型错误

bash
# 安装 Rosetta(如果尚未安装)
softwareupdate --install-rosetta

# 设置 ADB 环境变量
export ANDROID_HOME=/Users/$USER/Library/Android/sdk
export PATH=$ANDROID_HOME/platform-tools:$PATH

KAPT 不工作问题

参考 官方问题追踪StackOverflow 解决方案

NDK 未知主机架构错误

解决 Unknown host CPU architecture: arm64 错误的方法参见 这里

性能优化建议

  1. 使用最新的 Android Studio 版本:持续更新以获得更好的 M1 优化
  2. 选择适当的 API 级别:Android 11 (R) 和 12 (S) 对 ARM64 有最好支持
  3. 分配足够内存:在 AVD 设置中为模拟器分配充足的 RAM
  4. 关闭工具窗口模式:如果遇到性能问题,尝试取消勾选 Tools → Emulator → Launch in a tool window

结论

随着 Android Studio 对 Apple Silicon M1 芯片的官方支持,现在可以在 macOS M1 设备上流畅运行 Android 模拟器。关键点是确保使用正确的 ARM64 版本 Android Studio 和 arm64-v8a 系统镜像。如遇问题,重新安装模拟器组件或完全清除旧安装通常能解决问题。

保持 Android Studio 和 SDK 工具更新,以获得最佳性能和最新功能支持。