React Native安卓Detox+Jest测试报错：device未定义及APK缺失

咱们一步步拆解你遇到的三个问题，逐个击破：

1. app-debug-androidTest.apk: No such file or directory 文件缺失错误 #

这个问题的核心是Detox依赖的测试专用APK没有正确生成，或者路径配置不符合你的React Native版本规则。

解决方案： #

• 第一步：手动验证APK生成
  先单独执行Detox配置中的build命令，确认是否能生成测试APK：

  cd android && ./gradlew assembleDebug assembleAndroidTest -DtestBuildType=debug
  

  执行完成后，查看APK输出目录：

  ls android/app/build/outputs/apk/debug/
  

  如果能看到app-debug-androidTest.apk和app-debug.apk，说明生成成功，接下来修正路径配置即可。

• 第二步：修正APK路径配置
  React Native 0.51版本的debug APK默认会输出到debug子目录下，而非直接在apk根目录。所以需要修改package.json里Detox配置的binaryPath：

  "android.emu.debug": {
    "binaryPath": "android/app/build/outputs/apk/debug/app-debug.apk",
    "build": "pushd android && ./gradlew assembleDebug assembleAndroidTest -DtestBuildType=debug && popd",
    "type": "android.emulator",
    "name": "Pixel_API_27"
  }
  

  Detox会自动在同目录下寻找测试APK（app-debug-androidTest.apk），只要文件存在就会自动安装。

• 如果手动执行build也没生成测试APK
  检查Android项目的build.gradle文件：

  • 确认android节点下包含sourceSets.androidTest配置，正确指向你的测试目录
  • 确保gradle插件版本与RN 0.51兼容（一般为2.3.3左右）

2. ReferenceError: device is not defined 未定义错误 #

这个问题是因为Detox的全局对象（device、element等）没有被正确注入到Jest环境中，大概率是初始化脚本的配置不符合Jest语法。

解决方案： #

• 修正初始化脚本的超时设置
  你的init.js用了Jasmine的超时配置，但你使用的是Jest测试框架，需要改成Jest的语法：

  const detox = require('detox');
  const config = require('../package.json').detox;
  
  // 替换Jasmine配置为Jest的超时设置
  jest.setTimeout(120000);
  
  beforeAll(async () => {
    await detox.init(config);
  });
  
  afterAll(async () => {
    await detox.cleanup();
  });
  

• 确保E2E的Jest配置正确
  检查e2e/config.json，必须指定正确的测试环境和初始化脚本：

  {
    "testEnvironment": "node",
    "setupTestFrameworkScriptFile": "./init.js",
    "testMatch": ["**/*.spec.js"]
  }
  

  这里的testEnvironment: "node"是关键——Detox的E2E测试需要在Node环境下运行，不能使用默认的jsdom环境。

3. 测试超时问题 #

这个问题是前两个错误导致的连锁反应：测试无法正常执行，最终触发Jest的超时机制。只要解决了上面两个问题，超时问题会自动消失。如果还是出现超时，可以适当调高超时时间（比如改成150000），但不建议超过200000。

最后，重新运行测试 #

先清理之前的build缓存，再执行测试命令：

cd android && ./gradlew clean && cd ..
detox test --configuration android.emu.debug

额外注意两点：

• 确认模拟器名称和Detox配置里的name: "Pixel_API_27"完全一致，且adb devices能识别到该模拟器
• React Native 0.51版本较老，Detox 6.x虽兼容，但如果后续仍有问题，可以考虑升级到对应兼容的Detox版本

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