Detox项目配置指南：从零开始搭建移动端自动化测试环境

Detox项目配置指南：从零开始搭建移动端自动化测试环境

Detox Gray box end-to-end testing and automation framework for mobile apps 项目地址: https://gitcode.com/gh_mirrors/de/Detox

前言

Detox作为一款强大的移动端自动化测试框架，能够帮助开发者高效执行端到端测试。本文将详细介绍如何为React Native项目配置Detox测试环境，涵盖iOS和Android双平台的完整配置流程。

环境准备

在开始配置前，请确保满足以下基础条件：

1. 已安装Node.js开发环境
2. 已配置相应平台的开发环境（Xcode或Android Studio）
3. 项目为标准的React Native项目（Expo项目需采用特殊配置方式）

第一步：初始化Detox

安装依赖

根据项目类型选择对应的安装方式：

React Native项目

npm install detox --save-dev
npm install jest-circus --save-dev

原生iOS项目

npm install detox --save-dev

初始化配置

执行初始化命令后，Detox会自动生成必要的配置文件：

detox init

生成的文件包括：

• .detoxrc.js：主配置文件
• e2e/jest.config.js：Jest测试配置
• e2e/starter.test.js：示例测试文件

第二步：应用构建配置

iOS配置要点

1. 指定构建命令（如xcodebuild）
2. 配置正确的应用二进制文件路径
3. 设置正确的scheme和构建配置

Android配置要点

1. 配置gradle构建命令
2. 指定APK文件路径
3. 设置正确的构建变体

第三步：设备配置

iOS模拟器配置

devices: {
  simulator: {
    type: 'ios.simulator',
    device: {
      type: 'iPhone 12' // 可替换为其他设备型号
    }
  }
}

Android模拟器配置

emulator: {
  type: 'android.emulator',
  device: {
    avdName: 'Pixel_3a_API_30_x86' // 替换为你的AVD名称
  }
}

第四步：Android专项配置（重点）

4.1 Gradle配置调整

修改android/build.gradle：

1. 确保minSdkVersion ≥ 18
2. 添加Kotlin支持
3. 添加Detox依赖仓库

修改android/app/build.gradle：

1. 配置测试构建类型
2. 添加Detox依赖
3. 配置ProGuard规则

4.2 添加测试类

创建DetoxTest.java文件，注意：

1. 使用正确的包名
2. 确认主Activity名称
3. 配置合理的超时参数

4.3 网络配置

1. 创建网络安全配置文件
2. 允许本地明文通信
3. 在Manifest中注册配置

第五步：构建应用

执行构建命令（根据目标平台选择）：

# iOS调试版本
detox build --configuration ios.sim.debug

# Android发布版本
detox build --configuration android.emu.release

常见问题排查

1. 构建失败：检查构建命令是否正确
2. 设备连接问题：确认模拟器/设备已就绪
3. 测试超时：适当调整超时参数

结语

完成以上配置后，你的项目已经具备了Detox自动化测试能力。建议从示例测试文件开始，逐步扩展测试场景。良好的测试配置是持续集成的重要基础，值得投入时间进行完善。

Detox Gray box end-to-end testing and automation framework for mobile apps 项目地址: https://gitcode.com/gh_mirrors/de/Detox