Expo React Native iOS应用Detox测试API URL配置及构建问题咨询

问题 #

我有一个使用Expo构建的React Native应用，已集成Detox自动化测试。通过npx expo run:ios导出项目以生成binaryPath，当前detox.config.js配置如下：

/* eslint-disable */
module.exports = {
  logger: {
    level: process.env.CI ? 'debug' : undefined
  },
  testRunner: {
    args: {
      config: './e2e/jest.config.js',
      maxWorkers: process.env.CI ? 2 : undefined,
      _: ['e2e']
    }
  },
  artifacts: {
    plugins: {
      log: process.env.CI ? 'failing' : undefined,
      screenshot: process.env.CI ? 'failing' : undefined
    }
  },
  apps: {
    'ios.release': {
      type: 'ios.app',
      binaryPath:
        'ios/build/Build/Products/Release-iphonesimulator/application.app',
      build:
        'export RCT_NO_LAUNCH_PACKAGER=true && \\n        xcodebuild \\n        -workspace ios/application.xcworkspace \\n        -UseNewBuildSystem=NO \\n        -scheme application \\n        -configuration Release \\n        -sdk iphonesimulator \\n        -derivedDataPath ios/build \\n        -quiet'
    }
  },
  devices: {
    simulator: {
      type: 'ios.simulator',
      headless: Boolean(process.env.CI),
      device: {
        type: 'iPhone 15 Pro Max'
      }
    }
  },
  configurations: {
    'ios.sim.release': {
      device: 'simulator',
      app: 'ios.release',
    }
  }
};

package.json中的构建脚本如下：

{
    "e2e:build": "detox build -c ios.sim.release",
    "e2e:test": "detox test -c ios.sim.release",
    "e2e": "yarn e2e:build && yarn e2e:test"
}

通过上述脚本构建出的应用未指向期望的API URL（预发环境变量），登录时出现默认网络错误。现咨询：

1. 如何让构建产物指向目标API URL？
2. 当前detox.config.js的build配置存在哪些问题？
3. 是否有其他构建方式？

回答 #

一、让构建产物指向目标API URL的方法 #

Expo项目的环境变量必须在构建阶段注入，常用两种实现方式：

• 直接在构建命令前注入环境变量
  先确保代码中通过expo-constants读取环境变量（比如Constants.expoConfig.extra.API_URL），然后修改detox的build命令，在xcodebuild前添加环境变量声明：

  export RCT_NO_LAUNCH_PACKAGER=true && export API_URL=https://preprod-api.example.com && xcodebuild -workspace ios/application.xcworkspace -scheme application -configuration Release -sdk iphonesimulator -derivedDataPath ios/build -quiet
  

• 通过Xcode用户定义参数传递
  在Xcode项目中添加API_URL的用户定义设置，代码中通过info.plist读取该值，然后在detox的build命令中追加参数：

  xcodebuild ... -userdefines API_URL=https://preprod-api.example.com
  

二、当前detox.config.js的build配置问题 #

1. 缺失环境变量注入逻辑：整个build命令没有传递预发环境的API_URL，导致应用只能使用默认的API地址。
2. 使用过时的构建系统参数：-UseNewBuildSystem=NO是Xcode旧版本的参数，当前Xcode默认使用新构建系统，保留该参数可能引发兼容性问题，建议移除。
3. 命令换行符格式错误：配置中的\\n在shell中无法正确解析，应该用单个反斜杠\作为换行续行符，或者直接把命令写成单行。

三、其他构建方式 #

1. 借助Expo EAS Build生成测试包
   在eas.json中配置预发环境的profile，指定环境变量后，用eas build --profile preprod --platform ios生成测试包，再在detox.config.js中指定该包的binaryPath。
2. 导出项目时直接注入环境变量
   执行npx expo run:ios时就传递环境变量：

   API_URL=https://preprod-api.example.com npx expo run:ios --configuration Release
   

   生成的Xcode项目会包含该环境变量，后续detox构建无需额外配置。
3. 使用自定义shell脚本封装构建逻辑
   把环境变量注入、xcodebuild命令等逻辑写到单独的shell脚本（比如scripts/build-e2e-ios.sh），然后在detox.config.js中指定build: './scripts/build-e2e-ios.sh'，便于维护复杂的构建流程。

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