Android Gradle托管设备启动3个API31模拟器分片失败求助

核心结论：资源不足是主要诱因，API 31的特性放大了资源压力 #

1. 内存资源限制是关键矛盾 #

• Pixel 4 API 31的模拟器默认内存占用远高于API 30：Android 12+（API 31及以上）启用了隐私沙箱、强化进程隔离等系统特性，单设备内存需求比API 30增加约20%-30%。
• 即使是32GB内存的M2 Mac，3个API 31模拟器的总内存占用（单设备至少4GB+虚拟机开销）加上系统、Gradle等进程消耗，会接近内存阈值，直接导致模拟器启动超时。而API 30的单设备内存需求更低，3个实例的总占用处于安全范围，因此能正常运行。

2. 错误触发的直接原因 #

报错中的EmulatorTimeoutException明确说明：Gradle等待模拟器启动的时间内，设备因资源不足无法完成初始化，超出了默认超时时间。

排查与解决步骤 #

• 自定义模拟器内存分配：在项目build.gradle中为Gradle管理的设备指定更小的内存，比如将单设备内存设为3GB：

  android {
    testOptions {
      managedDevices {
        devices {
          pixel4Api31(com.android.build.api.dsl.ManagedVirtualDevice) {
            device = "Pixel 4"
            apiLevel = 31
            systemImageSource = "aosp"
            hardwareProperties {
              ramSize = "3GB"
            }
          }
        }
      }
    }
  }
  

• 延长启动超时时间：在gradle.properties中添加参数，给模拟器更多初始化时间：

  android.experimental.androidTest.managedDeviceLaunchTimeout=600000
  

• 清理残留设备：先执行./gradlew cleanManagedDevices，彻底删除旧的模拟器实例，避免损坏的残留设备干扰新实例启动。
• 释放系统资源：运行测试前关闭浏览器、冗余工具等后台进程，减少内存占用。

额外验证方向 #

• 单独启动一个Pixel 4 API 31模拟器，观察启动速度和内存占用：若启动缓慢或内存占用过高，可直接确认资源问题；若单独启动正常但3个一起失败，进一步验证资源不足的结论。
• 升级Android Gradle Plugin（AGP）到最新稳定版：旧版AGP可能在管理API 31模拟器分片时存在兼容性问题。

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