detox 21.0.0-breaking.new-global-lifecycle.0 → 21.0.1-rc.0

package/runners/jest/testEnvironment/listeners/DetoxCoreListener.js

@@ -7,54 +7,74 @@ const { getFullTestName, hasTimedOut } = require('../utils');
 
 const RETRY_TIMES = Symbol.for('RETRY_TIMES');
 
+const log = detoxInternals.log.child({ cat: 'lifecycle,jest-environment' });
+
 class DetoxCoreListener {
   constructor({ env }) {
-    this._startedTests = new WeakSet();
-    this._testsFailedBeforeStart = new WeakSet();
+    this._startedTests = new Set();
+    this._skippedTests = new Set();
+    this._testsFailedBeforeStart = new Set();
     this._env = env;
-    this._testRunTimes = 1;
-  }
-
-  _getTestInvocations(test) {
-    const { DETOX_RERUN_INDEX } = process.env;
-
-    if (!isNaN(DETOX_RERUN_INDEX)) {
-      return Number(DETOX_RERUN_INDEX) * this._testRunTimes + test.invocations;
-    } else {
-      return test.invocations;
-    }
+    this._circusRetryTimes = 1;
   }
 
   async setup() {
     // Workaround to override Jest's expect
-    if (detoxInternals.config.behaviorConfig.init.exposeGlobals) {
+    if (detoxInternals.config.behavior.init.exposeGlobals) {
       this._env.global.expect = detox.expect;
     }
   }
 
-  async run_describe_start({ describeBlock: { name, children } }) {
-    if (children.length) {
-      await detoxInternals.onRunDescribeStart({ name });
+  async run_describe_start({ describeBlock }) {
+    if (describeBlock.children.length) {
+      log.trace.begin(describeBlock.parent ? describeBlock.name : 'run the tests');
+      await detoxInternals.onRunDescribeStart({
+        name: describeBlock.name,
+      });
     }
   }
 
-  async run_describe_finish({ describeBlock: { name, children } }) {
-    if (children.length) {
-      await detoxInternals.onRunDescribeFinish({ name });
+  async run_describe_finish({ describeBlock }) {
+    if (describeBlock.children.length) {
+      await detoxInternals.onRunDescribeFinish({ name: describeBlock.name });
+      log.trace.end();
     }
   }
 
   async test_start({ test }) {
-    if (!_.isEmpty(test.errors)) {
+    const metadata = this._getTestMetadata(test);
+    if (metadata.status === 'failed') {
       this._testsFailedBeforeStart.add(test);
     }
 
+    log.trace.begin({
+      context: 'test',
+      status: metadata.status,
+      fullName: metadata.fullName,
+      invocations: metadata.invocations,
+    }, metadata.title);
+
     const circusRetryTimes = +this._env.global[RETRY_TIMES];
-    this._testRunTimes = isNaN(circusRetryTimes) ? 1 : 1 + circusRetryTimes;
+    this._circusRetryTimes = isNaN(circusRetryTimes) ? 1 : 1 + circusRetryTimes;
+  }
+
+  async test_skip({ test }) {
+    log.trace.end({ status: 'skip' }, getFullTestName(test));
+    this._skippedTests.add(test);
   }
 
-  async hook_start(_event, state) {
+  async test_todo({ test }) {
+    log.trace.end({ status: 'todo' }, getFullTestName(test));
+    this._skippedTests.add(test);
+  }
+
+  async hook_start(event, state) {
     await this._onBeforeActualTestStart(state.currentlyRunningTest);
+    log.trace.begin({ functionCode: event.hook.fn.toString() }, event.hook.type);
+  }
+
+  async hook_success() {
+    log.trace.end({ success: true });
   }
 
   async hook_failure({ error, hook }) {
@@ -62,61 +82,87 @@ class DetoxCoreListener {
       error,
       hook: hook.type,
     });
+
+    log.trace.end({ success: false, error });
   }
 
   async test_fn_start({ test }) {
     await this._onBeforeActualTestStart(test);
+
+    if (!this._testsFailedBeforeStart.has(test)) {
+      // Jest bug workaround: beforeAll hook errors result into an unterminated test_fn_start event.
+      log.trace.begin({ functionCode: test.fn.toString() }, 'test_fn');
+    }
+  }
+
+  async test_fn_success() {
+    log.trace.end({ success: true });
   }
 
   async test_fn_failure({ error }) {
     await detoxInternals.onTestFnFailure({ error });
+    log.trace.end({ success: false, error });
+  }
+
+  async test_done({ test }) {
+    const metadata = this._getTestMetadata(test);
+
+    if (this._startedTests.has(test)) {
+      await detoxInternals.onTestDone(metadata);
+      this._startedTests.delete(test);
+    }
+
+    log.trace.end(_.pick(metadata, ['status', 'timedOut']));
   }
 
   async _onBeforeActualTestStart(test) {
-    if (!test || test.status === 'skip' || this._startedTests.has(test) || this._testsFailedBeforeStart.has(test)) {
+    if (!this._isTestActuallyStarting(test)) {
       return;
     }
 
     this._startedTests.add(test);
+    await detoxInternals.onTestStart(this._getTestMetadata(test));
+  }
 
-    await detoxInternals.onTestStart({
+  _isTestActuallyStarting(test) {
+    return test && !this._isTestSkipped(test) && !this._startedTests.has(test) && !this._testsFailedBeforeStart.has(test);
+  }
+
+  _isTestSkipped(test) {
+    return test && this._skippedTests.has(test);
+  }
+
+  _getTestMetadata(test) {
+    const result = {
       title: test.name,
       fullName: getFullTestName(test),
-      status: 'running',
+      status: this._getTestStatus(test),
       invocations: this._getTestInvocations(test),
-    });
-  }
+    };
 
-  async test_done({ test }) {
-    if (this._startedTests.has(test)) {
-      await detoxInternals.onTestDone({
-        title: test.name,
-        fullName: getFullTestName(test),
-        status: test.errors.length ? 'failed' : 'passed',
-        invocations: this._getTestInvocations(test),
-        timedOut: hasTimedOut(test)
-      });
-
-      this._startedTests.delete(test);
+    if (result.status === 'failed') {
+      result.timedOut = hasTimedOut(test);
     }
+
+    return result;
   }
 
-  async run_finish(_event, state) {
-    if (this._hasFailedTests(state.rootDescribeBlock)) {
-      await detoxInternals.reportFailedTests([this._env.testPath]);
+  /** @returns { 'failed' | 'passed' | 'running'} */
+  _getTestStatus(test) {
+    if (!_.isEmpty(test.errors)) {
+      return 'failed';
     }
-  }
 
-  _hasFailedTests(block) {
-    if (block.children) {
-      for (const child of block.children) {
-        if (this._hasFailedTests(child)) {
-          return true;
-        }
-      }
+    if (test.status === 'done') {
+      return 'passed';
+    } else {
+      return test.status || 'running';
     }
+  }
 
-    return block.errors ? block.errors.length > 0 : false;
+  _getTestInvocations(test) {
+    const { testSessionIndex } = detoxInternals.session;
+    return testSessionIndex * this._circusRetryTimes + test.invocations;
   }
 }
 

package/runners/jest/testEnvironment/listeners/DetoxPlatformFilterListener.js

@@ -5,7 +5,7 @@ const { device } = require('../../../..');
 const PLATFORM_REGEXP = /^:([^:]+):/;
 
 class DetoxPlatformFilterListener {
-  constructor() {
+  setup() {
     this._platform = device.getPlatform();
   }
 

package/runners/jest/testEnvironment/listeners/SpecReporter.js

@@ -1,4 +1,5 @@
-const chalk = require('chalk').default;
+const chalk = require('chalk');
+const noop = require('lodash/noop');
 
 const { config, log, session } = require('../../../../internals');
 const { traceln } = require('../utils/stdout');
@@ -15,16 +16,21 @@ class SpecReporter {
     this._suitesDesc = '';
   }
 
-  get enabled() {
-    const jestSection = config.runnerConfig.jest;
+  setup() {
+    const jestSection = config.testRunner.jest;
     const reportSpecs = jestSection && jestSection.reportSpecs;
-
-    return reportSpecs !== undefined ? reportSpecs : session.workersCount === 1;
+    const enabled = reportSpecs !== undefined ? reportSpecs : session.workersCount === 1;
+
+    if (!enabled) {
+      this.run_describe_start = noop;
+      this.run_describe_finish = noop;
+      this.test_start = noop;
+      this.test_done = noop;
+      this.test_skip = noop;
+    }
   }
 
   run_describe_start(event) {
-    if (!this.enabled) return;
-
     if (event.describeBlock.parent !== undefined) {
       this._onSuiteStart({
         description: event.describeBlock.name,
@@ -33,16 +39,12 @@ class SpecReporter {
   }
 
   run_describe_finish(event) {
-    if (!this.enabled) return;
-
     if (event.describeBlock.parent !== undefined) {
       this._onSuiteEnd();
     }
   }
 
   test_start(event) {
-    if (!this.enabled) return;
-
     const { test } = event;
     this._onTestStart({
       description: test.name,
@@ -51,8 +53,6 @@ class SpecReporter {
   }
 
   test_done(event) {
-    if (!this.enabled) return;
-
     const { test } = event;
     const testInfo = {
       description: test.name,
@@ -62,8 +62,6 @@ class SpecReporter {
   }
 
   test_skip(event) {
-    if (!this.enabled) return;
-
     const testInfo = {
       description: event.test.name,
     };
@@ -110,7 +108,7 @@ class SpecReporter {
         .concat(suite.description)
         .concat((index === total - 1) ? ': ' : '');
     });
-    this._suitesDesc = chalk.bold.white(this._suitesDesc);
+    this._suitesDesc = chalk.bold(this._suitesDesc);
   }
 
   _traceTest({ description, invocations }, _status = undefined) {
@@ -118,7 +116,7 @@ class SpecReporter {
     const retriesDescription = (invocations > 1) ? chalk.gray(` [Retry #${invocations - 1}]`) : '';
     const status = chalk.gray(_status ? ` [${_status}]` : '');
     const desc = this._suitesDesc + testDescription + retriesDescription + status;
-    log.info({ event: 'SPEC_STATE_CHANGE' }, desc);
+    log.info({ cat: 'lifecycle' }, desc);
   }
 }
 

package/runners/jest/testEnvironment/listeners/WorkerAssignReporter.js

@@ -1,6 +1,6 @@
 const path = require('path');
 
-const chalk = require('chalk').default;
+const chalk = require('chalk');
 const _ = require('lodash');
 
 const { device } = require('../../../..');
@@ -12,8 +12,8 @@ class WorkerAssignReporter {
   }
 
   run_start() {
-    if (config.runnerConfig.jest.reportWorkerAssign) {
-      log.info({ event: 'WORKER_ASSIGN' }, `${this._formatTestName()} is assigned to ${this._formatDeviceName()}`);
+    if (config.testRunner.jest.reportWorkerAssign) {
+      log.info({ cat: 'lifecycle' }, `${chalk.bold(this._testName)} is assigned to ${this._formatDeviceName()}`);
     }
   }
 
@@ -25,10 +25,6 @@ class WorkerAssignReporter {
 
     return formattedDeviceName;
   }
-
-  _formatTestName() {
-    return chalk.whiteBright(this._testName);
-  }
 }
 
 module.exports = WorkerAssignReporter;

package/runners/jest/testEnvironment/utils/assertJestCircus27.js

@@ -1,8 +1,10 @@
 const fs = require('fs');
 const path = require('path');
 
+const resolveFrom = require('resolve-from');
 const semver = require('semver');
 
+const { log } = require('../../../../internals');
 const detoxPackageJson = require('../../../../package.json');
 const { DetoxRuntimeError } = require('../../../../src/errors');
 
@@ -25,6 +27,10 @@ function assertJestCircus27(maybeProjectConfig) {
     });
   }
 
+  const jestManifestPath = resolveFrom(process.cwd(), 'jest/package.json');
+  const jestManifest = require(jestManifestPath);
+  assertSupportedVersion(jestManifest.version);
+
   const circusVersion = require(circusPackageJson).version;
   if (!circusVersion) {
     throw new DetoxRuntimeError({
@@ -33,7 +39,14 @@ function assertJestCircus27(maybeProjectConfig) {
     });
   }
 
-  assertSupportedVersion(circusVersion);
+  if (jestManifest.version !== circusVersion) {
+    log.warn([
+      `jest-circus@${circusVersion} does not match jest@${jestManifest.version}.\n`,
+      `- jest@${jestManifest.version} resolved path:\n\t${jestManifestPath}`,
+      `- jest-circus@${circusVersion} resolved path:\n\t${circusPackageJson}`,
+      `\nPlease make sure that your versions match to avoid unexpected behavior!`,
+    ].join('\n'));
+  }
 
   return maybeProjectConfig;
 }
@@ -41,11 +54,12 @@ function assertJestCircus27(maybeProjectConfig) {
 function assertSupportedVersion(actualVersion) {
   const supportedRange = detoxPackageJson.peerDependencies.jest;
   const minSupportedVersion = semver.minVersion(supportedRange);
+  const action = semver.lt(actualVersion, minSupportedVersion) ? 'upgrade' : 'downgrade';
 
-  if (semver.lt(actualVersion, minSupportedVersion)) {
+  if (!semver.satisfies(actualVersion, supportedRange, { includePrerelease: true })) {
     throw new DetoxRuntimeError({
       message: `Detected an unsupported jest@${actualVersion} version.`,
-      hint: `Please upgrade your Jest test runner to the supported range: ${supportedRange}.`
+      hint: `Please ${action} your Jest test runner to the supported range: ${supportedRange}.`
     });
   }
 }

package/scripts/build_framework.ios.sh

@@ -1,62 +1,28 @@
 #!/bin/bash -e
 
-# Ensure Xcode is installed or print a warning message and return.
-xcodebuild -version &>/dev/null || { echo "WARNING: Xcode is not installed on this machine. Skipping iOS framework build phase"; exit 0; }
-
-detoxRootPath="$(dirname "$(dirname "$0")")"
-detoxVersion=`node -p "require('${detoxRootPath}/package.json').version"`
-
-sha1=`(echo "${detoxVersion}" && xcodebuild -version) | shasum | awk '{print $1}' #"${2}"`
-detoxFrameworkDirPath="$HOME/Library/Detox/ios/${sha1}"
-detoxFrameworkPath="${detoxFrameworkDirPath}/Detox.framework"
-
-
-function prepareAndBuildFramework () {
-  if [ -d "$detoxRootPath"/ios ]; then
-    detoxSourcePath="${detoxRootPath}"/ios
-    echo "Dev mode, building from ${detoxSourcePath}"
-    buildFramework "${detoxSourcePath}"
-  else
-    extractFramework
-  fi
-}
-
-function extractFramework () {
-  echo "Extracting Detox framework..."
-  mkdir -p "${detoxFrameworkDirPath}"
-  tar -xjf "${detoxRootPath}"/Detox-ios.tbz -C "${detoxFrameworkDirPath}"
-}
-
-function buildFramework () {
-  detoxSourcePath="${1}"
-  echo "Building Detox.framework from ${detoxSourcePath} into ${detoxFrameworkDirPath}"
-  mkdir -p "${detoxFrameworkDirPath}"
-  logPath="${detoxFrameworkDirPath}"/detox_ios.log
-  echo "Build log: ${logPath}"
-  echo -n "" > "${logPath}"
-  "${detoxRootPath}"/scripts/build_universal_framework.sh "${detoxSourcePath}"/Detox.xcodeproj "${detoxFrameworkDirPath}" &> "${logPath}" || {
-    echo -e "#################################\nError building Detox.framework:\n----------------------------------\n"
-    cat "${logPath}"
-    echo "#################################"
-    exit 1
-  }
-}
-
-function main () {
-  if [ -d "${detoxFrameworkDirPath}" ]; then
-    if [ ! -d "${detoxFrameworkPath}" ]; then
-      echo "${detoxFrameworkDirPath} was found, but could not find Detox.framework inside it. This means that the Detox framework build process was interrupted.
-         deleting ${detoxFrameworkDirPath} and trying to rebuild."
-      rm -rf "${detoxFrameworkDirPath}"
-      prepareAndBuildFramework
-    else
-      echo "Detox.framework exists, skipping..."
-    fi
-  else
-    prepareAndBuildFramework
-  fi
-
-  echo "Done"
-}
-
-main
+PROJECT=$1
+FRAMEWORK_OUTPUT_DIR=$2
+CONFIGURATION=Release
+PROJECT_NAME=Detox
+
+# Make sure the output directory exists
+
+rm -fr "${FRAMEWORK_OUTPUT_DIR}"
+mkdir -p "${FRAMEWORK_OUTPUT_DIR}"
+
+# Step 0. Xcode version
+
+USE_NEW_BUILD_SYSTEM="YES"
+echo "Using -UseNewBuildSystem=${USE_NEW_BUILD_SYSTEM}"
+
+# Step 1. Build Device and Simulator versions
+
+BUILD_SIM=`xcodebuild -project "${PROJECT}" -scheme "Detox" -UseNewBuildSystem=${USE_NEW_BUILD_SYSTEM} -configuration "${CONFIGURATION}" -sdk iphonesimulator -destination "generic/platform=iOS Simulator" build -showBuildSettings  | awk -F= '/TARGET_BUILD_DIR/{x=$NF; gsub(/^[ \t]+|[ \t]+$/,"",x); print x}'`
+
+echo ${BUILD_SIM}
+
+xcodebuild -project "${PROJECT}" -scheme "Detox" -UseNewBuildSystem=${USE_NEW_BUILD_SYSTEM} -configuration "${CONFIGURATION}" -sdk iphonesimulator -destination "generic/platform=iOS Simulator" build -quiet
+
+# Step 2. Copy the framework to output folder
+
+cp -fR "${BUILD_SIM}/${PROJECT_NAME}.framework" "${FRAMEWORK_OUTPUT_DIR}"/

package/scripts/build_local_framework.ios.sh

@@ -0,0 +1,62 @@
+#!/bin/bash -e
+
+# Ensure Xcode is installed or print a warning message and return.
+xcodebuild -version &>/dev/null || { echo "WARNING: Xcode is not installed on this machine. Skipping iOS framework build phase"; exit 0; }
+
+detoxRootPath="$(dirname "$(dirname "$0")")"
+detoxVersion=`node -p "require('${detoxRootPath}/package.json').version"`
+
+sha1=`(echo "${detoxVersion}" && xcodebuild -version) | shasum | awk '{print $1}' #"${2}"`
+detoxFrameworkDirPath="$HOME/Library/Detox/ios/framework/${sha1}"
+detoxFrameworkPath="${detoxFrameworkDirPath}/Detox.framework"
+
+
+function prepareAndBuildFramework () {
+  if [ -d "$detoxRootPath"/ios ]; then
+    detoxSourcePath="${detoxRootPath}"/ios
+    echo "Dev mode, building from ${detoxSourcePath}"
+    buildFramework "${detoxSourcePath}"
+  else
+    extractFramework
+  fi
+}
+
+function extractFramework () {
+  echo "Extracting Detox framework..."
+  mkdir -p "${detoxFrameworkDirPath}"
+  tar -xjf "${detoxRootPath}"/Detox-ios-framework.tbz -C "${detoxFrameworkDirPath}"
+}
+
+function buildFramework () {
+  detoxSourcePath="${1}"
+  echo "Building Detox.framework from ${detoxSourcePath} into ${detoxFrameworkDirPath}"
+  mkdir -p "${detoxFrameworkDirPath}"
+  logPath="${detoxFrameworkDirPath}"/detox_ios.log
+  echo "Build log: ${logPath}"
+  echo -n "" > "${logPath}"
+  "${detoxRootPath}"/scripts/build_framework.ios.sh "${detoxSourcePath}"/Detox.xcodeproj "${detoxFrameworkDirPath}" &> "${logPath}" || {
+    echo -e "#################################\nError building Detox.framework:\n----------------------------------\n"
+    cat "${logPath}"
+    echo "#################################"
+    exit 1
+  }
+}
+
+function main () {
+  if [ -d "${detoxFrameworkDirPath}" ]; then
+    if [ ! -d "${detoxFrameworkPath}" ]; then
+      echo "${detoxFrameworkDirPath} was found, but could not find Detox.framework inside it. This means that the Detox framework build process was interrupted.
+         deleting ${detoxFrameworkDirPath} and trying to rebuild."
+      rm -rf "${detoxFrameworkDirPath}"
+      prepareAndBuildFramework
+    else
+      echo "Detox.framework exists, skipping..."
+    fi
+  else
+    prepareAndBuildFramework
+  fi
+
+  echo "Done"
+}
+
+main

package/scripts/build_local_xcuitest.ios.sh

@@ -0,0 +1,53 @@
+#!/bin/bash -e
+
+# Ensure Xcode is installed or print a warning message and return.
+xcodebuild -version &>/dev/null || { echo "WARNING: Xcode is not installed on this machine. Skipping iOS xctest runner build phase"; exit 0; }
+
+detoxRootPath="$(dirname "$(dirname "$0")")"
+detoxVersion=`node -p "require('${detoxRootPath}/package.json').version"`
+
+sha1=`(echo "${detoxVersion}" && xcodebuild -version) | shasum | awk '{print $1}' #"${2}"`
+detoxXctestRunnerDirPath="$HOME/Library/Detox/ios/xcuitest-runner/${sha1}"
+
+function prepareAndBuildXctestRunner () {
+  if [ -d "$detoxRootPath"/ios ]; then
+    detoxSourcePath="${detoxRootPath}"/ios
+    echo "Dev mode, building XCUITest runner from ${detoxSourcePath}"
+    buildXctestRunner "${detoxSourcePath}"
+  else
+    extractXctestRunner
+  fi
+}
+
+function extractXctestRunner () {
+  echo "Extracting Detox XCUITest runner..."
+  mkdir -p "${detoxXctestRunnerDirPath}"
+  tar -xjf "${detoxRootPath}"/Detox-ios-xcuitest.tbz -C "${detoxXctestRunnerDirPath}"
+}
+
+function buildXctestRunner () {
+  detoxSourcePath="${1}"
+  echo "Building XCUITest runner from ${detoxSourcePath} into ${detoxXctestRunnerDirPath}"
+  mkdir -p "${detoxXctestRunnerDirPath}"
+  logPath="${detoxXctestRunnerDirPath}"/detox_ios_xcuitest.log
+  echo "Build log: ${logPath}"
+  echo -n "" > "${logPath}"
+  "${detoxRootPath}"/scripts/build_xcuitest.ios.sh "${detoxSourcePath}"/DetoxTester.xcworkspace "${detoxXctestRunnerDirPath}" &> "${logPath}" || {
+    echo -e "#################################\nError building DetoxTester.xctestrun:\n----------------------------------\n"
+    cat "${logPath}"
+    echo "#################################"
+    exit 1
+  }
+}
+
+function main () {
+  if [ ! -d "${detoxXctestRunnerDirPath}" ]; then
+    prepareAndBuildXctestRunner
+  else
+    echo "XCUITest-runner exists, skipping..."
+  fi
+
+  echo "Done"
+}
+
+main

package/scripts/build_xcuitest.ios.sh

@@ -0,0 +1,23 @@
+#!/bin/bash -e
+
+WORKSPACE=$1
+XCUITEST_OUTPUT_DIR=$2
+CONFIGURATION=Release
+PROJECT_NAME=DetoxTester
+
+# Clean up the output directory
+
+rm -fr "${XCUITEST_OUTPUT_DIR}"
+
+# Make sure the output directory exists
+
+mkdir -p "${XCUITEST_OUTPUT_DIR}"
+
+# Xcode version
+
+USE_NEW_BUILD_SYSTEM="YES"
+echo "Using -UseNewBuildSystem=${USE_NEW_BUILD_SYSTEM}"
+
+# Build Simulator version
+
+xcodebuild -workspace "${WORKSPACE}" -scheme "${PROJECT_NAME}" -UseNewBuildSystem=${USE_NEW_BUILD_SYSTEM} -configuration "${CONFIGURATION}" -sdk iphonesimulator -destination 'generic/platform=iOS Simulator' -derivedDataPath "${XCUITEST_OUTPUT_DIR}" -allowProvisioningUpdates build-for-testing -quiet

package/scripts/pack_ios.sh

@@ -1,23 +1,32 @@
 #!/bin/bash -e
 
 rm -rf Detox-ios-src.tbz
-rm -rf Detox-ios.tbz
+rm -rf Detox-ios-framework.tbz
+rm -rf Detox-ios-xcuitest.tbz
 rm -rf build_temp
 
 find ./ios -name Build -type d -exec rm -rf {} \;
 
-#Package sources
+# Package sources
 pushd . &> /dev/null
 cd ios
 tar --exclude-from=.tbzignore -cjf ../Detox-ios-src.tbz .
 popd &> /dev/null
 
-#Package prebuilt framework
+# Package prebuilt framework
 mkdir build_temp
-scripts/build_universal_framework.sh "ios/Detox.xcodeproj" "build_temp" &> build_temp/detox_ios.log
+scripts/build_framework.ios.sh "ios/Detox.xcodeproj" "build_temp" &> build_temp/detox_ios.log
 pushd . &> /dev/null
 cd build_temp
-tar --exclude-from=../ios/.tbzignore -cjf ../Detox-ios.tbz .
+tar --exclude-from=../ios/.tbzignore -cjf ../Detox-ios-framework.tbz .
 popd &> /dev/null
 
+# Package prebuilt xcuitest runner
+scripts/build_xcuitest.ios.sh "ios/DetoxTester.xcworkspace" "build_temp" &> build_temp/detox_ios_xcuitest.log
+pushd . &> /dev/null
+cd build_temp
+tar --exclude-from=../ios/.tbzignore -cjf ../Detox-ios-xcuitest.tbz .
+popd &> /dev/null
+
+# Cleanup
 rm -fr build_temp

package/scripts/postinstall.js

@@ -1,5 +1,11 @@
-if (process.platform === 'darwin' && !process.env.DETOX_DISABLE_POSTINSTALL) {
-	require('child_process').execFileSync(`${__dirname}/build_framework.ios.sh`, {
-		stdio: 'inherit'
-	});
+const { platform, env } = process;
+
+const isDarwin = platform === 'darwin';
+const shouldInstallDetox = !env.DETOX_DISABLE_POSTINSTALL;
+
+if (isDarwin && shouldInstallDetox) {
+  const execFileSync = require('child_process').execFileSync;
+
+  execFileSync(`${__dirname}/build_local_framework.ios.sh`, { stdio: 'inherit' });
+  execFileSync(`${__dirname}/build_local_xcuitest.ios.sh`, { stdio: 'inherit' });
 }