chore(e2e): detox config cleanup

Author: Krzysztof Wojnar

.gitignore

@@ -64,3 +64,5 @@ android/.settings
 # Local environment (direnv)
 .envrc
 
+# e2e
+*Example/artifacts

Example/.detoxrc.js

@@ -1,2 +1,2 @@
-const utils = require('../scripts/detox-utils.cjs');
+const utils = require('../scripts/e2e/detox-utils.cjs');
 module.exports = utils.commonDetoxConfigFactory('ScreensExample');

Example/package.json

@@ -9,10 +9,10 @@
     "format": "prettier --write --list-different './src/**/*.{js,ts,tsx}'",
     "lint": "eslint --ext '.js,.ts,.tsx' --fix src && yarn check-types && yarn format",
     "check-types": "tsc --noEmit",
-    "build-e2e-ios": "detox build --configuration ios.release",
-    "build-e2e-android": "detox build --configuration android.release",
-    "test-e2e-ios": "detox test --configuration ios.release --take-screenshots failing",
-    "test-e2e-android": "detox test --configuration android.release --take-screenshots failing",
+    "build-e2e-ios": "detox build --configuration ios.sim.release",
+    "build-e2e-android": "detox build --configuration android.emu.release",
+    "test-e2e-ios": "detox test --configuration ios.sim.release --take-screenshots failing",
+    "test-e2e-android": "detox test --configuration android.emu.release --take-screenshots failing",
     "postinstall": "patch-package"
   },
   "dependencies": {

FabricExample/.detoxrc.js

@@ -1,3 +1,3 @@
-const utils = require('../scripts/detox-utils.cjs');
+const utils = require('../scripts/e2e/detox-utils.cjs');
 module.exports = utils.commonDetoxConfigFactory('FabricExample');
 

FabricExample/package.json

@@ -8,10 +8,10 @@
     "lint": "eslint .",
     "start": "npx react-native start",
     "test": "jest",
-    "build-e2e-ios": "detox build --configuration ios.release",
-    "build-e2e-android": "detox build --configuration android.release",
-    "test-e2e-ios": "detox test --configuration ios.release --take-screenshots failing",
-    "test-e2e-android": "detox test --configuration android.release --take-screenshots failing",
+    "build-e2e-ios": "detox build --configuration ios.sim.release",
+    "build-e2e-android": "detox build --configuration android.emu.release",
+    "test-e2e-ios": "detox test --configuration ios.sim.release --take-screenshots failing",
+    "test-e2e-android": "detox test --configuration android.emu.release --take-screenshots failing",
     "postinstall": "patch-package"
   },
   "dependencies": {

scripts/detox-utils.cjs renamed to scripts/e2e/detox-utils.cjs

@@ -1,6 +1,7 @@
 const ChildProcess = require('node:child_process');
+const { iosDevice } = require('./ios-devices');
 
-const CI_AVD_NAME = 'e2e_emulator';
+const CI_ADB_NAME = 'e2e_emulator';
 
 const isRunningCI = process.env.CI != null;
 
@@ -11,10 +12,10 @@ const apkBulidArchitecture = isRunningCI ? 'x86_64' : 'arm64-v8a';
 const testButlerApkPath = isRunningCI ? ['../Example/e2e/apps/test-butler-app-2.2.1.apk'] : undefined;
 
 function detectLocalAndroidEmulator() {
-  // "DETOX_AVD_NAME" can be set for local developement
-  const detoxAvdName = process.env.DETOX_AVD_NAME ?? null;
-  if (detoxAvdName !== null) {
-    return detoxAvdName
+  // "DETOX_ADB_NAME" can be set for local developement
+  const detoxAdbName = process.env.DETOX_ADB_NAME ?? null;
+  if (detoxAdbName !== null) {
+    return detoxAdbName
   }
 
   // Fallback: try to use Android SDK
@@ -36,18 +37,17 @@ function detectLocalAndroidEmulator() {
     // TODO: consider giving user a choice here.
     return avdList[0];
   } catch (error) {
-    const errorMessage = `Failed to find Android emulator. Set "DETOX_AVD_NAME" env variable pointing to one. Cause: ${error}`
+    const errorMessage = `Failed to find Android emulator. Set "DETOX_ADB_NAME" env variable pointing to one. Cause: ${error}`
     console.error(errorMessage);
     throw new Error(errorMessage);
   }
 }
 
 function detectAndroidEmulatorName() {
-  return isRunningCI ? CI_AVD_NAME : detectLocalAndroidEmulator();
+  return isRunningCI ? CI_ADB_NAME : detectLocalAndroidEmulator();
 }
 
 /**
- * @type {Detox.DetoxConfig}
  * @param {string} applicationName name (FabricExample / ScreensExample)
  * @returns {Detox.DetoxConfig}
  */
@@ -94,14 +94,12 @@ function commonDetoxConfigFactory(applicationName) {
     devices: {
       simulator: {
         type: 'ios.simulator',
-        device: {
-          type: 'iPhone 16 Pro',
-        },
+        device: iosDevice,
       },
       attached: {
         type: 'android.attached',
         device: {
-          adbName: CI_AVD_NAME,
+          adbName: CI_ADB_NAME,
         },
         utilBinaryPaths: testButlerApkPath,
       },

scripts/e2e/ios-devices.js

@@ -0,0 +1,37 @@
+const DEFEAULT_APPLE_MODEL = 'iPhone 17';
+const DEVICE_MODEL = process.env.E2E_APPLE_DEVICE || DEFEAULT_APPLE_MODEL
+const DEFEAULT_IOS_VERSION = 'iOS 26.2';
+
+/**
+ * @return {`iOS ${string}`} requested version of ios, or default if not specified
+ */
+function getiosVersion() {
+    const passedVersion = process.env.E2E_IOS_VERSION;
+    if (passedVersion) {
+        if (passedVersion.startsWith('iOS ')) {
+          return /** @type {`iOS ${string}`} */ (passedVersion);
+        }
+        return `iOS ${passedVersion}`;
+    }
+    return DEFEAULT_IOS_VERSION;
+}
+
+/**
+ * @typedef {Object} AppleDevice - creates a new type named 'SpecialType'
+ * @property {string} type - a string which represents a model of an iPhone
+ * @property {`iOS ${string}`} os - operation system version
+ */
+
+/** 
+ * @satisfies {AppleDevice}
+ * @readonly
+ * */
+const iosDevice = {
+  type: DEVICE_MODEL,
+  os: getiosVersion(),
+};
+
+module.exports = {
+  iosDevice,
+  getiosVersion,
+};