detox 20.9.0 → 21.0.0-rc.0

package/Detox-android/com/wix/detox/21.0.0-rc.0/detox-21.0.0-rc.0-javadoc.jar.md5

@@ -0,0 +1 @@
+baeaa847e8b07933a9196e2709a0d1ca

package/Detox-android/com/wix/detox/21.0.0-rc.0/detox-21.0.0-rc.0-javadoc.jar.sha1

@@ -0,0 +1 @@
+32bab4951061cdcfd6468e343e466eef11c77f83

package/Detox-android/com/wix/detox/21.0.0-rc.0/detox-21.0.0-rc.0-javadoc.jar.sha256

@@ -0,0 +1 @@
+bb014ed3c149e55d5b8d935f23073d1f331e65429b4e08902e7fdbe4132abc47

package/Detox-android/com/wix/detox/21.0.0-rc.0/detox-21.0.0-rc.0-javadoc.jar.sha512

@@ -0,0 +1 @@
+194b9a7639c7fc57946f48f42631f27a05c0f40b76d5423680adf8f81e1888aba733f727304de39866ffc3936bec4601dc0a6a5e7edb2f7bc7c033c7a1fa7af5

package/Detox-android/com/wix/detox/21.0.0-rc.0/detox-21.0.0-rc.0-sources.jar.md5

@@ -0,0 +1 @@
+c584b6f2658b7f69fc7eff3078073ac7

package/Detox-android/com/wix/detox/21.0.0-rc.0/detox-21.0.0-rc.0-sources.jar.sha1

@@ -0,0 +1 @@
+25f5866687eefc92072df48f039a83cdd9c01920

package/Detox-android/com/wix/detox/21.0.0-rc.0/detox-21.0.0-rc.0-sources.jar.sha256

@@ -0,0 +1 @@
+e8e05f7765f67ec70e25b716f2aecbb3f12291718edacf529a6ce233c2a0d8ff

package/Detox-android/com/wix/detox/21.0.0-rc.0/detox-21.0.0-rc.0-sources.jar.sha512

@@ -0,0 +1 @@
+b383d1ad33a026c618b714a34d8e74c13deceda321bcaa2c8039f1aa78bf12cddcddd60f5f396cf25b661fb2423523794476ca6cc5b3ee8b2a96923564818905

package/Detox-android/com/wix/detox/{20.9.0/detox-20.9.0.pom → 21.0.0-rc.0/detox-21.0.0-rc.0.pom}

@@ -3,7 +3,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.wix</groupId>
   <artifactId>detox</artifactId>
-  <version>20.9.0</version>
+  <version>21.0.0-rc.0</version>
   <packaging>aar</packaging>
   <name>Detox</name>
   <description>Gray box end-to-end testing and automation library for mobile apps</description>

package/Detox-android/com/wix/detox/21.0.0-rc.0/detox-21.0.0-rc.0.pom.md5

@@ -0,0 +1 @@
+5c56a4ac0d2ed10b75b58b05972b6e18

package/Detox-android/com/wix/detox/21.0.0-rc.0/detox-21.0.0-rc.0.pom.sha1

@@ -0,0 +1 @@
+d2c190e331230f514dd4b3d76e0f7a61f5a701e7

package/Detox-android/com/wix/detox/21.0.0-rc.0/detox-21.0.0-rc.0.pom.sha256

@@ -0,0 +1 @@
+017b1737afb957c69c05ddd30b6847026d33bbbf26f04c9be5dc1b9ad0dee73d

package/Detox-android/com/wix/detox/21.0.0-rc.0/detox-21.0.0-rc.0.pom.sha512

@@ -0,0 +1 @@
+f7b03d096e8f3dda28682f9120d10d14dbe8db1ead87a337fcdb71eae70ea1d9b072049a6f0c7b5be210306ab8fadfdab3011729117bbb20aff447dd2b7f18e7

package/Detox-android/com/wix/detox/maven-metadata.xml

@@ -3,11 +3,11 @@
   <groupId>com.wix</groupId>
   <artifactId>detox</artifactId>
   <versioning>
-    <latest>20.9.0</latest>
-    <release>20.9.0</release>
+    <latest>21.0.0-rc.0</latest>
+    <release>21.0.0-rc.0</release>
     <versions>
-      <version>20.9.0</version>
+      <version>21.0.0-rc.0</version>
     </versions>
-    <lastUpdated>20230509160449</lastUpdated>
+    <lastUpdated>20230511153710</lastUpdated>
   </versioning>
 </metadata>

package/Detox-android/com/wix/detox/maven-metadata.xml.md5

@@ -1 +1 @@
-7053662d2e33fbb9e98df25bdd415049
+7b6098f8f092f7bc592374cba63aad5e

package/Detox-android/com/wix/detox/maven-metadata.xml.sha1

@@ -1 +1 @@
-6940fcfbcba3f2f2fe28a0c8990e4a73acc1b850
+1bea3260d9d2db371e06eece061a26c7746d7273

package/Detox-android/com/wix/detox/maven-metadata.xml.sha256

@@ -1 +1 @@
-de9c81ebd4571c1447448f166bdf72b47fac675208c055934ee0f982aebb530e
+d5be2a929ea68d45baa34a5ae791de4757714b2bcf6d1701416f02d4f65e4552

package/Detox-android/com/wix/detox/maven-metadata.xml.sha512

@@ -1 +1 @@
-e1d52b19982e6266e8adfb8e891c5ed79258c8aac5dbd3628ee9b7adb072db79379c4bf742d596817abaff76737f7d80709bb884d2236fe831a39ce7af6d4b79
+b8318205a970d79dd3ac0ae691e59115cc11466e851432df0d399117844a845f1cca601e562004654540eec787cede9dc3d66bfa1a95c292937a38bc0ed6f190

package/local-cli/build-framework-cache.js

@@ -9,7 +9,7 @@ module.exports.desc = 'Builds a cached Detox framework for the current environme
 
 module.exports.handler = async function buildFrameworkCache() {
   if (os.platform() === 'darwin') {
-    cp.execSync(path.join(__dirname, '../scripts/build_framework.ios.sh'), { stdio: 'inherit' });
+    cp.execSync(path.join(__dirname, '../scripts/build_local_framework.ios.sh'), { stdio: 'inherit' });
   } else {
     detox.log.info(`The command is supported only on macOS, skipping the execution.`);
   }

package/local-cli/build-xcuitest-cache.js

@@ -0,0 +1,16 @@
+const cp = require('child_process');
+const os = require('os');
+const path = require('path');
+
+const detox = require('../internals');
+
+module.exports.command = 'build-xcuitest-cache';
+module.exports.desc = 'Builds a cached Detox XCUITest-runner for the current environment in ~/Library/Detox. The cached framework is unique for each combination of Xcode and Detox version (MacOS only).';
+
+module.exports.handler = async function buildXCUITestCache() {
+  if (os.platform() === 'darwin') {
+    cp.execSync(path.join(__dirname, '../scripts/build_local_xcuitest.ios.sh'), { stdio: 'inherit' });
+  } else {
+    detox.log.info(`The command is supported only on MacOS, skipping the execution.`);
+  }
+};

package/local-cli/clean-framework-cache.js

@@ -10,7 +10,7 @@ module.exports.desc = "Deletes all Detox cached frameworks from ~/Library/Detox.
 
 module.exports.handler = async function cleanFrameworkCache() {
   if (os.platform() === 'darwin') {
-    const frameworkPath = path.join(os.homedir(), '/Library/Detox');
+    const frameworkPath = path.join(os.homedir(), '/Library/Detox/ios/framework');
     detox.log.info(`Removing framework binaries from ${frameworkPath}`);
     await fs.remove(frameworkPath);
   } else {

package/local-cli/clean-xcuitest-cache.js

@@ -0,0 +1,19 @@
+const os = require('os');
+const path = require('path');
+
+const fs = require('fs-extra');
+
+const detox = require('../internals');
+
+module.exports.command = 'clean-xcuitest-cache';
+module.exports.desc = "Deletes all Detox cached XCUITest-runners from ~/Library/Detox. Cached framework can be rebuilt using the 'build-xcuitest-cache' command (MacOS only).";
+
+module.exports.handler = async function cleanXCUITestCache() {
+  if (os.platform() === 'darwin') {
+    const frameworkPath = path.join(os.homedir(), '/Library/Detox/ios/xcuitest-runner');
+    detox.log.info(`Removing XCUITest-runner binaries from ${frameworkPath}`);
+    await fs.remove(frameworkPath);
+  } else {
+    detox.log.info(`The command is supported only on MacOS, skipping the execution.`);
+  }
+};

package/local-cli/rebuild-framework-cache.js

@@ -9,12 +9,12 @@ const log = require('../src/utils/logger').child({ cat: 'cli' });
 module.exports.command = 'rebuild-framework-cache';
 module.exports.desc = 'Rebuilds a cached Detox framework for the current environment in ~/Library/Detox. The cached framework is unique for each combination of Xcode and Detox version. (macOS only)';
 
-module.exports.handler = async function buildFrameworkCache() {
+module.exports.handler = async function rebuildFrameworkCache() {
   if (os.platform() === 'darwin') {
-    const frameworkPath = path.join(os.homedir(), '/Library/Detox');
+    const frameworkPath = path.join(os.homedir(), '/Library/Detox/ios/framework');
     log.info(`Removing framework binaries from ${frameworkPath}`);
     await fs.remove(frameworkPath);
-    cp.execSync(path.join(__dirname, '../scripts/build_framework.ios.sh'), { stdio: 'inherit' });
+    cp.execSync(path.join(__dirname, '../scripts/build_local_framework.ios.sh'), { stdio: 'inherit' });
   } else {
     log.info(`The command is supported only on macOS, skipping the execution.`);
   }

package/local-cli/rebuild-xcuitest-cache.js

@@ -0,0 +1,21 @@
+const cp = require('child_process');
+const os = require('os');
+const path = require('path');
+
+const fs = require('fs-extra');
+
+const log = require('../src/utils/logger').child({ cat: 'cli' });
+
+module.exports.command = 'rebuild-xcuitest-cache';
+module.exports.desc = 'Rebuilds a cached Detox XCUITest-runner for the current environment in ~/Library/Detox. The cached runner is unique for each combination of Xcode and Detox version (MacOS only).';
+
+module.exports.handler = async function rebuildXCUITestCache() {
+  if (os.platform() === 'darwin') {
+    const frameworkPath = path.join(os.homedir(), '/Library/Detox/ios/xcuitest-runner');
+    log.info(`Removing runner binaries from ${frameworkPath}`);
+    await fs.remove(frameworkPath);
+    cp.execSync(path.join(__dirname, '../scripts/build_local_xcuitest.ios.sh'), { stdio: 'inherit' });
+  } else {
+    log.info(`The command is supported only on MacOS, skipping the execution.`);
+  }
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "detox",
   "description": "E2E tests and automation for mobile",
-  "version": "20.9.0",
+  "version": "21.0.0-rc.0",
   "bin": {
     "detox": "local-cli/cli.js"
   },
@@ -76,6 +76,7 @@
     "multi-sort-stream": "^1.0.3",
     "multipipe": "^4.0.0",
     "node-ipc": "9.2.1",
+    "node-osascript": "^2.1.0",
     "proper-lockfile": "^3.0.2",
     "resolve-from": "^5.0.0",
     "sanitize-filename": "^1.6.1",
@@ -202,5 +203,5 @@
       }
     }
   },
-  "gitHead": "0d183a6fc5f3c6ba250ed7eba3393e169e72bea4"
+  "gitHead": "1ce46f1d465acddcab5b74337ca8b0ed22be1b33"
 }

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' });
 }

package/src/client/Client.js

@@ -72,6 +72,7 @@ class Client {
   async connect() {
     await this.open();
     const sessionStatus = await this.sendAction(new actions.Login(this._sessionId));
+    console.log('sessionStatus', sessionStatus);
     if (sessionStatus.appConnected) {
       this._onAppConnected();
     }
@@ -186,7 +187,9 @@ class Client {
       this._whenAppIsConnected = new Deferred();
       this._whenAppIsReady = new Deferred();
 
+      console.warn('App is not connected yet. Waiting for it to connect...');
       await this._whenAppIsConnected.promise;
+      console.warn('App is connected. Waiting for it to be ready...');
       // TODO: optimize traffic (!) - we can just listen for 'ready' event
       // if app always sends it upon load completion. On iOS it works,
       // but not on Android. Afterwards, this will suffice:
@@ -197,6 +200,7 @@ class Client {
     // TODO: move to else branch after the optimization
     if (!this._whenAppIsReady.isResolved()) {
       this._whenAppIsReady = new Deferred();
+      console.log('Waiting for app to become ready...');
       await this.sendAction(new actions.Ready());
       this._whenAppIsReady.resolve();
     }
@@ -215,6 +219,10 @@ class Client {
     await this.sendAction(new actions.WaitForActive());
   }
 
+  async sendToHome() {
+    await this.sendAction(new actions.SendToHome());
+  }
+
   async captureViewHierarchy({ viewHierarchyURL }) {
     return await this.sendAction(new actions.CaptureViewHierarchy({
       viewHierarchyURL
@@ -233,6 +241,12 @@ class Client {
     await this.sendAction(new actions.Shake());
   }
 
+  async terminateIfNeeded() {
+    if (this.isConnected) {
+      await this.sendAction(new actions.Terminate());
+    }
+  }
+
   async setOrientation(orientation) {
     await this.sendAction(new actions.SetOrientation(orientation));
   }
@@ -252,7 +266,7 @@ class Client {
   }
 
   async terminateApp() {
-    /* see the property injection from Detox.js */
+    /* see the property injection from DetoxWorker.js */
   }
 
   _scheduleSlowInvocationQuery() {
@@ -302,6 +316,7 @@ class Client {
   }
 
   _onAppConnected() {
+    console.log('App connected.');
     if (this._whenAppIsConnected.isPending()) {
       this._whenAppIsConnected.resolve();
     } else {

package/src/client/actions/actions.js

@@ -124,6 +124,24 @@ class WaitForActive extends Action {
   }
 }
 
+class SendToHome extends Action {
+  constructor() {
+    super('sendToHome');
+  }
+
+  get isAtomic() {
+    return true;
+  }
+
+  get timeout() {
+    return 0;
+  }
+
+  async handle(response) {
+    this.expectResponseOfType(response, 'sendToHomeDone');
+  }
+}
+
 class Shake extends Action {
   constructor() {
     super('shakeDevice');
@@ -142,6 +160,24 @@ class Shake extends Action {
   }
 }
 
+class Terminate extends Action {
+  constructor() {
+    super('terminate');
+  }
+
+  get isAtomic() {
+    return true;
+  }
+
+  get timeout() {
+    return 0;
+  }
+
+  async handle(response) {
+    this.expectResponseOfType(response, 'willTerminate');
+  }
+}
+
 class SetOrientation extends Action {
   constructor(params) {
     super('setOrientation', params);
@@ -325,6 +361,7 @@ module.exports = {
   Login,
   WaitForBackground,
   WaitForActive,
+  SendToHome,
   Ready,
   Invoke,
   ReloadReactNative,
@@ -336,4 +373,5 @@ module.exports = {
   SetOrientation,
   SetInstrumentsRecordingState,
   CaptureViewHierarchy,
+  Terminate,
 };