Dev Solve

中文

English
日本語

中文

English
日本語

Appearance

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 工具更新，以获得最佳性能和最新功能支持。