Detox Android端无法通过--workers参数并行运行多设备测试的咨询

核心问题定位 #

采用android.attached类型+通配设备名.*的配置组合时，Detox 不会像 iOS 端那样自动识别全部匹配设备并向不同 worker 分发测试任务，这是 Android 与 iOS 平台 Detox 实现逻辑的原生差异，也是--workers参数不生效的核心原因。

可落地实现步骤 #

• 前置准备
  执行adb devices获取所有已启动、可正常调试的 Android 设备序列号，例如emulator-5554、emulator-5556，确认两台设备均无未授权调试提示、未处于锁屏状态。
• 配置适配（二选一）

1. Detox 自动管理模拟器模式：将原配置的type字段从android.attached修改为android.emulator，移除通配的name: ".*"配置。此时传入的--workers N参数会被识别为自动创建 N 台独立的 Android 模拟器实例，每台实例绑定一个独立测试 worker，自动完成任务分片调度。
2. 手动启动模拟器模式：不要在单一配置条目下使用通配设备名，为每台已启动的模拟器创建独立配置项，每个条目的name字段填写对应设备的精确序列号，配置示例：

   "android.sim.debug.5554": {
     "binaryPath": "...",
     "build": "...",
     "type": "android.attached",
     "name": "emulator-5554"
   },
   "android.sim.debug.5556": {
     "binaryPath": "...",
     "build": "...",
     "type": "android.attached",
     "name": "emulator-5556"
   }
   

   该模式下 Detox 调度器会自动遍历所有处于可用状态的配置项，为每个 worker 分配独立的设备绑定。

• 参数补全
  执行测试命令时搭配分片参数，避免所有 worker 重复执行全量用例：2 个 worker 并行时，分别对应 1/2、2/2 的分片范围，通过脚本自动为每个 worker 注入对应分片参数即可。
  示例命令：

detox test --configuration android.sim.debug --workers 2 --shard=<分片序号>/2

常见卡点排查 #

• Detox 版本需不低于 20.6.0，该版本之前的 Android 端存在已知调度 bug：通配设备匹配时仅绑定第一台在线设备，其余设备永远不会被调度
• 每台设备需完成 Detox 前置环境配置：关闭系统动画、授予测试应用悬浮窗权限、关闭锁屏密码
• 命令或配置中不得硬编码单设备标识，避免 worker 调度被强制锁定到单台设备
• 真机并行场景下，需通过环境变量ADB_DEVICE_ARG为每个独立 worker 指定绑定的设备序列号，Detox 原生不会自动为真机 worker 遍历选择可用设备

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