detox 20.45.1 → 20.46.0

package/Detox-android/com/wix/detox/20.46.0/detox-20.46.0-sources.jar.md5

@@ -0,0 +1 @@
+f92fee8e55802955d0d0c8c0e8d17a9d

package/Detox-android/com/wix/detox/20.46.0/detox-20.46.0-sources.jar.sha1

@@ -0,0 +1 @@
+0e247005d3b10b618a1e60fc4c5980f39c0f4161

package/Detox-android/com/wix/detox/20.46.0/detox-20.46.0-sources.jar.sha256

@@ -0,0 +1 @@
+d62189a293ef9a32eba47253df150f55af4e6c3f1389fab5d7e655abd6d2f450

package/Detox-android/com/wix/detox/20.46.0/detox-20.46.0-sources.jar.sha512

@@ -0,0 +1 @@
+6638d6c8dd8491bd39bd8ce705ea287df708fe295956da5ca575fbf3c93eaba22ef37a26f8ac035413146416dfc08d0d48b436726d472e8bfa2b4ab8ffeee5f0

package/Detox-android/com/wix/detox/{20.45.1/detox-20.45.1.pom → 20.46.0/detox-20.46.0.pom}

@@ -3,7 +3,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.wix</groupId>
   <artifactId>detox</artifactId>
-  <version>20.45.1</version>
+  <version>20.46.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/20.46.0/detox-20.46.0.pom.md5

@@ -0,0 +1 @@
+8743ffbe906bda40e18f4f56f0b17731

package/Detox-android/com/wix/detox/20.46.0/detox-20.46.0.pom.sha1

@@ -0,0 +1 @@
+f238ef617997264a605dd604a42b1580b4c10d69

package/Detox-android/com/wix/detox/20.46.0/detox-20.46.0.pom.sha256

@@ -0,0 +1 @@
+adf08d12927e279de3e410db7bb58191baaf62b351090f082e476cec1deaf7e0

package/Detox-android/com/wix/detox/20.46.0/detox-20.46.0.pom.sha512

@@ -0,0 +1 @@
+2af20a02179995ca60fe481cd9a80e0981520c04f7369350db8935bb59248737bf06792f6f7208f4ee9e6b3a7165484e4a2471b0c657c12f603e0fae865de1f4

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

@@ -3,11 +3,11 @@
   <groupId>com.wix</groupId>
   <artifactId>detox</artifactId>
   <versioning>
-    <latest>20.45.1</latest>
-    <release>20.45.1</release>
+    <latest>20.46.0</latest>
+    <release>20.46.0</release>
     <versions>
-      <version>20.45.1</version>
+      <version>20.46.0</version>
     </versions>
-    <lastUpdated>20251030165738</lastUpdated>
+    <lastUpdated>20251116141022</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-91b7d57a8c6d220ea8c0b302350ef444
+2188c9401bfa538bb0576bc5167edf47

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

@@ -1 +1 @@
-0431fedec1af54a5b47e09664c672f8003b7f995
+f6ca6f49b2cdfd86faae22d064c6a8f584ab5479

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

@@ -1 +1 @@
-cf40046dbf6b26afe2d8f472072098db3f5b841c1f030a8e11dad03318aca4b7
+15ef80746452d06400cb3c56a76949bbc5cb34b31142fa6b5e9a7c7a672d67dd

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

@@ -1 +1 @@
-c0081527b1fa7a3cea51e8c56321165cf7295dc351def86ca6c102b3a73e26efc3e8ab765e1ccf625fb4df2d17252d6d1aff03c471c4dfd173db32456880f652
+8461cb4d98b01f06622281fe12897cd437d33b2b40914f761fd4d5b38045095117d37817686411d6a5744e6e4ef1d35294386a61680dac5549177ae9ac9ff5e8

package/detox.d.ts

@@ -363,6 +363,42 @@ declare global {
             [prop: string]: unknown;
         }
 
+        /**
+         * `minimal`: Configuration for a minimal system UI.
+         * `genymotion`: Configuration for a Genymotion-equivalent system UI.
+         *
+         * Visit https://github.com/wix/Detox/blob/master/detox/src/devices/allocation/drivers/android/utils/systemUICfgPresets.js to learn about
+         * the specifics of each preset.
+         */
+        type DetoxSystemUIPresetName = 'minimal' | 'genymotion';
+        type DetoxSystemUI = DetoxSystemUIPresetName | DetoxSystemUIConfig;
+
+        interface DetoxSystemUIConfig {
+            extends?: DetoxSystemUIPresetName;
+
+            /**
+             * Note: For 'hide' to work in Google emulators, need to set `hw.keyboard=yes` in AVD configuration (i.e.
+             * in manually `config.ini` file or via AVD Manager on Android Studio).
+             */
+            keyboard?: 'hide' | 'show' | null;
+            touches?: 'hide' | 'show' | null;
+            pointerLocationBar?: 'hide' | 'show' | null;
+            /** Note: 2-button mode is not supported in recent Android versions; Detox ignores it to avoid confusion. */
+            navigationMode?: '3-button' | 'gesture' | null;
+            statusBar?: DetoxSystemUIStatusBarConfig;
+        }
+
+        interface DetoxSystemUIStatusBarConfig {
+            notifications?: 'show' | 'hide' | null;
+            wifiSignal?: 'strong' | 'weak' | 'none' | null;
+            /** Disclaimer: Some Android versions fail to set the network type (3g, lte, etc.) */
+            cellSignal?: 'strong' | 'weak' | 'none' | null;
+            batteryLevel?: 'full' | 'half' | 'low' | null;
+            charging?: boolean | null;
+            /** In "hhmm" format (e.g. "1234" for 12:34) */
+            clock?: string | null;
+        }
+
         type DetoxBuiltInDeviceConfig =
             | DetoxIosSimulatorDriverConfig
             | DetoxAttachedAndroidDriverConfig
@@ -378,6 +414,9 @@ declare global {
         interface DetoxSharedAndroidDriverConfig {
             forceAdbInstall?: boolean;
             utilBinaryPaths?: string[];
+
+            /** Disclaimer: Some features are not seamlessly supported by all Android versions and vendors. */
+            systemUI?: DetoxSystemUI;
         }
 
         interface DetoxAttachedAndroidDriverConfig extends DetoxSharedAndroidDriverConfig {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "detox",
   "description": "E2E tests and automation for mobile",
-  "version": "20.45.1",
+  "version": "20.46.0",
   "bin": {
     "detox": "local-cli/cli.js"
   },
@@ -120,5 +120,5 @@
   "browserslist": [
     "node 14"
   ],
-  "gitHead": "43b45aefe4249aebe34622f63389b363591362ae"
+  "gitHead": "992fb3900be3b5f95c2a38d2bd12440f048b3363"
 }

package/src/configuration/composeDeviceConfig.js

@@ -60,6 +60,97 @@ function composeDeviceConfigFromAliased(opts) {
   return { ...deviceConfig };
 }
 
+/**
+ * Validates systemUI configuration
+ * @param {string | object} systemUI - The systemUI configuration
+ * @param {string} deviceAlias - The device alias for error reporting
+ * @param {DetoxConfigErrorComposer} errorComposer - Error composer instance
+ */
+function validateSystemUIConfig(systemUI, deviceAlias, errorComposer) {
+  if (_.isString(systemUI)) {
+    if (!['minimal', 'genymotion'].includes(systemUI)) {
+      throw errorComposer.malformedDeviceProperty(deviceAlias, 'systemUI');
+    }
+    return;
+  }
+
+  if (!_.isObject(systemUI)) {
+    throw errorComposer.malformedDeviceProperty(deviceAlias, 'systemUI');
+  }
+
+  if (systemUI.extends !== undefined) {
+    if (!['minimal', 'genymotion'].includes(systemUI.extends)) {
+      throw errorComposer.malformedDeviceProperty(deviceAlias, 'systemUI');
+    }
+  }
+
+  if (systemUI.keyboard !== undefined && systemUI.keyboard !== null) {
+    if (!['hide', 'show'].includes(systemUI.keyboard)) {
+      throw errorComposer.malformedDeviceProperty(deviceAlias, 'systemUI');
+    }
+  }
+
+  if (systemUI.touches !== undefined && systemUI.touches !== null) {
+    if (!['hide', 'show'].includes(systemUI.touches)) {
+      throw errorComposer.malformedDeviceProperty(deviceAlias, 'systemUI');
+    }
+  }
+
+  if (systemUI.pointerLocationBar !== undefined && systemUI.pointerLocationBar !== null) {
+    if (!['hide', 'show'].includes(systemUI.pointerLocationBar)) {
+      throw errorComposer.malformedDeviceProperty(deviceAlias, 'systemUI');
+    }
+  }
+
+  if (systemUI.navigationMode !== undefined && systemUI.navigationMode !== null) {
+    if (!['3-button', 'gesture'].includes(systemUI.navigationMode)) {
+      throw errorComposer.malformedDeviceProperty(deviceAlias, 'systemUI');
+    }
+  }
+
+  if (systemUI.statusBar !== undefined && systemUI.statusBar !== null) {
+    if (!_.isObject(systemUI.statusBar)) {
+      throw errorComposer.malformedDeviceProperty(deviceAlias, 'systemUI');
+    }
+
+    if (systemUI.statusBar.notifications !== undefined && systemUI.statusBar.notifications !== null) {
+      if (!['hide', 'show'].includes(systemUI.statusBar.notifications)) {
+        throw errorComposer.malformedDeviceProperty(deviceAlias, 'systemUI');
+      }
+    }
+
+    if (systemUI.statusBar.wifiSignal !== undefined && systemUI.statusBar.wifiSignal !== null) {
+      if (!['weak', 'strong', 'none'].includes(systemUI.statusBar.wifiSignal)) {
+        throw errorComposer.malformedDeviceProperty(deviceAlias, 'systemUI');
+      }
+    }
+
+    if (systemUI.statusBar.cellSignal !== undefined && systemUI.statusBar.cellSignal !== null) {
+      if (!['strong', 'weak', 'none'].includes(systemUI.statusBar.cellSignal)) {
+        throw errorComposer.malformedDeviceProperty(deviceAlias, 'systemUI');
+      }
+    }
+
+    if (systemUI.statusBar.batteryLevel !== undefined && systemUI.statusBar.batteryLevel !== null) {
+      if (!['full', 'half', 'low'].includes(systemUI.statusBar.batteryLevel)) {
+        throw errorComposer.malformedDeviceProperty(deviceAlias, 'systemUI');
+      }
+    }
+
+    if (systemUI.statusBar.charging !== undefined && systemUI.statusBar.charging !== null) {
+      if (!_.isBoolean(systemUI.statusBar.charging)) {
+        throw errorComposer.malformedDeviceProperty(deviceAlias, 'systemUI');
+      }
+    }
+
+    if (systemUI.statusBar.clock !== undefined && systemUI.statusBar.clock !== null) {
+      if (!_.isString(systemUI.statusBar.clock) || !/^\d{2}\d{2}$/.test(systemUI.statusBar.clock)) {
+        throw errorComposer.malformedDeviceProperty(deviceAlias, 'systemUI');
+      }
+    }
+  }
+}
+
 /**
  * @param {DetoxConfigErrorComposer} errorComposer
  * @param {Detox.DetoxDeviceConfig} deviceConfig
@@ -147,6 +238,14 @@ function validateDeviceConfig({ deviceConfig, errorComposer, deviceAlias }) {
     }
   }
 
+  if (deviceConfig.systemUI !== undefined) {
+    validateSystemUIConfig(deviceConfig.systemUI, deviceAlias, errorComposer);
+
+    if (!deviceConfig.type.match(/^android\.(emulator|genycloud|attached)$/)) {
+      throw errorComposer.unsupportedDeviceProperty(deviceAlias, 'systemUI');
+    }
+  }
+
   if (_.isObject(deviceConfig.device)) {
     const expectedProperties = EXPECTED_DEVICE_MATCHER_PROPS[deviceConfig.type];
     /* istanbul ignore else */

package/src/devices/allocation/DeviceAllocator.js

@@ -50,13 +50,14 @@ class DeviceAllocator {
 
   /**
    * @param {DeviceCookie} cookie
+   * @param {{ deviceConfig: Detox.DetoxDeviceConfig }} [configs]
    * @returns {Promise<DeviceCookie>}
    */
-  async postAllocate(cookie) {
+  async postAllocate(cookie, configs) {
     const tid = this._ids.get(cookie.id);
     return await log.trace.complete({ data: cookie, id: tid }, `post-allocate: ${cookie.id}`, async () => {
       const updatedCookie = typeof this._driver.postAllocate === 'function'
-        ? await this._driver.postAllocate(cookie)
+        ? await this._driver.postAllocate(cookie, configs)
         : undefined;
 
       return updatedCookie || cookie;

package/src/devices/allocation/drivers/AllocationDriverBase.d.ts

@@ -8,7 +8,7 @@ export interface DeallocOptions {
 export interface AllocationDriverBase {
   init?(): Promise<void>;
   allocate(deviceConfig: any): Promise<DeviceCookie>;
-  postAllocate?(deviceCookie: DeviceCookie): Promise<DeviceCookie | void>;
+  postAllocate?(deviceCookie: DeviceCookie, configs?: { deviceConfig: Detox.DetoxDeviceConfig }): Promise<DeviceCookie | void>;
   free(cookie: DeviceCookie, options: DeallocOptions): Promise<void>;
   cleanup?(): Promise<void>;
   emergencyCleanup?(): void;

package/src/devices/allocation/drivers/android/AndroidAllocDriver.js

@@ -0,0 +1,68 @@
+/**
+ * @typedef {import('../AllocationDriverBase').AllocationDriverBase} AllocationDriverBase
+ * @typedef {import('../../../common/drivers/DeviceCookie').DeviceCookie} DeviceCookie
+ */
+
+const log = require('../../../../utils/logger').child({ __filename });
+const sleep = require('../../../../utils/sleep');
+
+const DeviceInitCache = require('./utils/DeviceInitCache');
+const SystemUIDemoMode = require('./utils/SystemUICfgHelper');
+
+/**
+ * @abstract {AllocationDriverBase}
+ */
+class AndroidAllocDriver {
+  /**
+   * @param {object} options
+   * @param {import('../../../common/drivers/android/exec/ADB')} options.adb
+   */
+  constructor({
+    adb
+  }) {
+    this._adb = adb;
+    this._systemUIInitCache = new DeviceInitCache();
+  }
+
+  /**
+   * @param {DeviceCookie & { adbName: string }} deviceCookie
+   * @param {{ deviceConfig: Detox.DetoxSharedAndroidDriverConfig }} configs
+   * @returns {Promise<DeviceCookie>}
+   */
+  async postAllocate(deviceCookie, { deviceConfig }) {
+    const { adbName } = deviceCookie;
+
+    if (deviceConfig.systemUI) {
+      if (this._systemUIInitCache.hasInitialized(adbName)) {
+        log.debug(`Skipping System UI setup for ${adbName}, already initialized`);
+      } else {
+        await this._setupSystemUI(deviceCookie, deviceConfig);
+        this._systemUIInitCache.setInitialized(adbName);
+      }
+    }
+    return deviceCookie;
+  }
+
+  /**
+   * @param {DeviceCookie & { adbName: string }} deviceCookie
+   * @param {Detox.DetoxSharedAndroidDriverConfig} deviceConfig
+   * @private
+   */
+  async _setupSystemUI(deviceCookie, deviceConfig) {
+    const { adbName } = deviceCookie;
+    
+    const systemUIDemoMode = new SystemUIDemoMode({ adb: this._adb, adbName });
+    const systemUIConfig = systemUIDemoMode.resolveConfig(deviceConfig.systemUI);
+
+    log.debug(`Running keyboard behavior setup for ${adbName}`);
+    await systemUIDemoMode.setupKeyboardBehavior(systemUIConfig);
+
+    log.debug(`Running system UI setup for ${adbName}`);
+    await systemUIDemoMode.setupPointerIndicators(systemUIConfig);
+    await systemUIDemoMode.setupNavigationMode(systemUIConfig);
+    await systemUIDemoMode.setupStatusBar(systemUIConfig);
+    log.debug(`Finished system UI setup for ${adbName}`);
+  }
+}
+
+module.exports = AndroidAllocDriver;

package/src/devices/allocation/drivers/android/attached/AttachedAndroidAllocDriver.js

@@ -1,12 +1,10 @@
 /**
- * @typedef {import('../../AllocationDriverBase').AllocationDriverBase} AllocationDriverBase
  * @typedef {import('../../../../common/drivers/android/cookies').AndroidDeviceCookie} AndroidDeviceCookie
  */
 
-/**
- * @implements {AllocationDriverBase}
- */
-class AttachedAndroidAllocDriver {
+const AndroidAllocDriver = require('../AndroidAllocDriver');
+
+class AttachedAndroidAllocDriver extends AndroidAllocDriver {
   /**
    * @param {object} options
    * @param {import('../../../../common/drivers/android/exec/ADB')} options.adb
@@ -14,7 +12,7 @@ class AttachedAndroidAllocDriver {
    * @param {import('../FreeDeviceFinder')} options.freeDeviceFinder
    */
   constructor({ adb, deviceRegistry, freeDeviceFinder }) {
-    this._adb = adb;
+    super({ adb });
     this._deviceRegistry = deviceRegistry;
     this._freeDeviceFinder = freeDeviceFinder;
   }
@@ -36,13 +34,17 @@ class AttachedAndroidAllocDriver {
 
   /**
    * @param {AndroidDeviceCookie} deviceCookie
-   * @returns {Promise<void>}
+   * @param {{ deviceConfig: Detox.DetoxSharedAndroidDriverConfig }} configs
+   * @returns {Promise<AndroidDeviceCookie>}
    */
-  async postAllocate(deviceCookie) {
+  async postAllocate(deviceCookie, configs) {
     const { adbName } = deviceCookie;
 
     await this._adb.apiLevel(adbName);
     await this._adb.unlockScreen(adbName);
+    await super.postAllocate(deviceCookie, configs);
+
+    return deviceCookie;
   }
 
   /**

package/src/devices/allocation/drivers/android/emulator/EmulatorAllocDriver.js

@@ -1,18 +1,15 @@
 /**
- * @typedef {import('../../AllocationDriverBase').AllocationDriverBase} AllocationDriverBase
  * @typedef {import('../../../../common/drivers/android/cookies').AndroidDeviceCookie} AndroidDeviceCookie
  */
 
 const _ = require('lodash');
 
 const log = require('../../../../../utils/logger').child({ cat: 'device,device-allocation' });
+const AndroidAllocDriver = require('../AndroidAllocDriver');
 
 const { patchAvdSkinConfig } = require('./patchAvdSkinConfig');
 
-/**
- * @implements {AllocationDriverBase}
- */
-class EmulatorAllocDriver {
+class EmulatorAllocDriver extends AndroidAllocDriver {
   /**
    * @param {object} options
    * @param {import('../../../../common/drivers/android/exec/ADB')} options.adb
@@ -34,7 +31,7 @@ class EmulatorAllocDriver {
     emulatorVersionResolver,
     emulatorLauncher
   }) {
-    this._adb = adb;
+    super({ adb });
     this._avdValidator = avdValidator;
     this._deviceRegistry = deviceRegistry;
     this._emulatorVersionResolver = emulatorVersionResolver;
@@ -88,14 +85,19 @@ class EmulatorAllocDriver {
 
   /**
    * @param {AndroidDeviceCookie} deviceCookie
+   * @param {{ deviceConfig: Detox.DetoxSharedAndroidDriverConfig }} configs
+   * @returns {Promise<AndroidDeviceCookie>}
    */
-  async postAllocate(deviceCookie) {
+  async postAllocate(deviceCookie, configs) {
     const { adbName } = deviceCookie;
 
     await this._emulatorLauncher.awaitEmulatorBoot(adbName);
     await this._adb.apiLevel(adbName);
     await this._adb.disableAndroidAnimations(adbName);
     await this._adb.unlockScreen(adbName);
+    await super.postAllocate(deviceCookie, configs);
+
+    return deviceCookie;
   }
 
   /**

package/src/devices/allocation/drivers/android/genycloud/GenyAllocDriver.js

@@ -1,10 +1,10 @@
 /**
- * @typedef {import('../../AllocationDriverBase').AllocationDriverBase} AllocationDriverBase
  * @typedef {import('../../../../common/drivers/android/cookies').GenycloudEmulatorCookie} GenycloudEmulatorCookie
  */
 
 const Timer = require('../../../../../utils/Timer');
 const log = require('../../../../../utils/logger').child({ cat: 'device' });
+const AndroidAllocDriver = require('../AndroidAllocDriver');
 
 const GenyRegistry = require('./GenyRegistry');
 
@@ -13,10 +13,7 @@ const events = {
   GENYCLOUD_TEARDOWN: { event: 'GENYCLOUD_TEARDOWN' },
 };
 
-/**
- * @implements {AllocationDriverBase}
- */
-class GenyAllocDriver {
+class GenyAllocDriver extends AndroidAllocDriver {
   /**
    * @param {object} options
    * @param {import('../../../../common/drivers/android/exec/ADB')} options.adb
@@ -32,7 +29,7 @@ class GenyAllocDriver {
     instanceLauncher,
     recipeQuerying,
   }) {
-    this._adb = adb;
+    super({ adb });
     this._detoxSessionId = detoxSession.id;
     this._genyRegistry = genyRegistry;
     this._instanceLauncher = instanceLauncher;
@@ -73,8 +70,10 @@ class GenyAllocDriver {
 
   /**
    * @param {GenycloudEmulatorCookie} cookie
+   * @param {{ deviceConfig: Detox.DetoxSharedAndroidDriverConfig }} configs
+   * @returns {Promise<GenycloudEmulatorCookie>}
    */
-  async postAllocate(cookie) {
+  async postAllocate(cookie, configs) {
     const instance = await this._instanceLauncher.connect(cookie.instance);
     this._genyRegistry.updateInstance(instance);
 
@@ -88,6 +87,8 @@ class GenyAllocDriver {
       });
     }
 
+    await super.postAllocate(cookie, configs);
+
     return {
       ...cookie,
       adbName: instance.adbName,

package/src/devices/allocation/drivers/android/utils/DeviceInitCache.js

@@ -0,0 +1,21 @@
+class DeviceInitCache {
+  constructor() {
+    this._cache = new Map();
+  }
+
+  /**
+   * @param {string} adbName
+   * @returns {boolean}
+   */
+  hasInitialized(adbName) {
+    return this._cache.get(adbName) === true;
+  }
+
+  /** @param {string} adbName */
+  setInitialized(adbName) {
+    this._cache.set(adbName, true);
+  }
+}
+
+module.exports = DeviceInitCache;
+

package/src/devices/allocation/drivers/android/utils/SystemUICfgHelper.js

@@ -0,0 +1,187 @@
+/**
+ * @typedef {import('../../../../common/drivers/DeviceCookie').DeviceCookie} DeviceCookie
+ */
+
+const _ = require('lodash');
+
+const { DetoxConfigError } = require('../../../../../errors');
+const sleep = require('../../../../../utils/sleep');
+
+const presets = require('./systemUICfgPresets');
+
+const batteryPrecents = {
+  full: 100,
+  half: 50,
+  low: 20,
+};
+
+const navigationModes = {
+//  For clarity: 2-button mode is not supported in recent Android versions; Detox ignores it to avoid confusion
+//  '2-button': 'com.android.internal.systemui.navbar.twobutton',
+  '3-button': 'com.android.internal.systemui.navbar.threebutton',
+  'gesture': 'com.android.internal.systemui.navbar.gestural',
+};
+
+/**
+ * Maps a nullish value (null or undefined) to undefined, otherwise applies the function.
+ *
+ * @param {any | undefined | null} value
+ * @param {(value: any) => any | undefined} fn
+ * @returns {any | undefined}
+ */
+const nullishOrMap = (value, fn) => (value === undefined || value === null) ? undefined : fn(value);
+
+/**
+ * Helper class for initializing Android System UI demo mode.
+ */
+class SystemUICfgHelper {
+  /**
+   * @param {object} options
+   * @param {object} options.adb An ADB shell wrapper with a shell method
+   * @param {string} options.adbName The ADB device name
+   */
+  constructor({ adb, adbName }) {
+    this._adb = {
+      shell: async (cmd) => {
+        await adb.shell(adbName, cmd);
+        await sleep(200);
+      },
+    };
+  }
+
+  /**
+   * Resolves the system UI configuration, handling presets and extends.
+   *
+   * @param {Detox.DetoxSystemUI} systemUICfg
+   * @returns {Detox.DetoxSystemUIConfig}
+   */
+  resolveConfig(systemUICfg) {
+    const preset = _.isString(systemUICfg) && this._resolvePreset(systemUICfg);
+    if (preset) {
+      return preset;
+    }
+
+    /** @type {Detox.DetoxSystemUIConfig} */
+    // @ts-ignore
+    const _systemUICfg = systemUICfg;
+
+    if (_systemUICfg.extends) {
+      const preset = this._resolvePreset(_systemUICfg.extends);
+      return _.chain({})
+        .merge(preset)
+        .merge(_systemUICfg)
+        .omit('extends')
+        .value();
+    }
+    return _systemUICfg;
+  }
+
+  /**
+   * @param {Detox.DetoxSystemUIConfig} systemUIConfig
+   */
+  async setupKeyboardBehavior(systemUIConfig) {
+    const showKbd = nullishOrMap(systemUIConfig.keyboard, (keyboard) => Number(keyboard === 'show'));
+
+    if (showKbd !== undefined) {
+      await this._adb.shell(`settings put Secure show_ime_with_hard_keyboard ${showKbd}`);
+    }
+  }
+
+  /**
+   * @param {Detox.DetoxSystemUIConfig} systemUIConfig
+   */
+  async setupPointerIndicators(systemUIConfig) {
+    const showTouches = nullishOrMap(systemUIConfig.touches, (touches) => Number(touches === 'show'));
+    if (showTouches !== undefined) {
+      await this._adb.shell(`settings put system show_touches ${showTouches}`);
+    }
+
+    const showPointerLocationBar = nullishOrMap(systemUIConfig.pointerLocationBar, (pointerLocationBar) => Number(pointerLocationBar === 'show'));
+    if (showPointerLocationBar !== undefined) {
+      await this._adb.shell(`settings put system pointer_location ${showPointerLocationBar}`);
+    }
+  }
+
+  /**
+   * @param {Detox.DetoxSystemUIConfig} systemUIConfig
+   */
+  async setupNavigationMode(systemUIConfig) {
+    const navigationMode = nullishOrMap(systemUIConfig.navigationMode, (navigationMode) => navigationModes[navigationMode]);
+    if (navigationMode !== undefined) {
+      await this._adb.shell(`cmd overlay enable ${navigationMode}`);
+    }
+  }
+
+  /**
+   * Ref: https://android.googlesource.com/platform/frameworks/base/+/master/packages/SystemUI/docs/demo_mode.md
+   *
+   * @param {Detox.DetoxSystemUIConfig} systemUIConfig
+   */
+  async setupStatusBar(systemUIConfig) {
+    const { statusBar: statusBarConfig } = systemUIConfig;
+    if (_.isUndefined(statusBarConfig)) {
+      return;
+    }
+
+    // Enable, then get out (= reset status-bar) and back into demo mode
+    await this._adb.shell('settings put global sysui_demo_allowed 1');
+    await this._adb.shell('am broadcast -a com.android.systemui.demo -e command exit');
+    await this._adb.shell('am broadcast -a com.android.systemui.demo -e command enter');
+
+    // Force status bar content
+    const notificationsVisible = nullishOrMap(statusBarConfig.notifications, (notifications) => Number(notifications === 'show'));
+    if (notificationsVisible !== undefined) {
+      await this._adb.shell(`am broadcast -a com.android.systemui.demo -e command notifications -e visible ${notificationsVisible}`);
+    }
+
+    const wifiSignal = nullishOrMap(statusBarConfig.wifiSignal, (wifiSignal) => wifiSignal);
+    if (wifiSignal !== undefined) {
+      await this._adb.shell('am broadcast -a com.android.systemui.demo -e command network -e wifi hide');
+      if (wifiSignal !== 'none') {
+        const wifiLevel = wifiSignal === 'strong' ? 4 : 2;
+        await this._adb.shell(`am broadcast -a com.android.systemui.demo -e command network -e wifi show -e level ${wifiLevel} -e fully true`);
+      }
+    }
+
+    const cellSignal = nullishOrMap(statusBarConfig.cellSignal, (cellSignal) => cellSignal);
+    if (cellSignal !== undefined) {
+      await this._adb.shell('am broadcast -a com.android.systemui.demo -e command network -e mobile hide');
+      if (cellSignal !== 'none') {
+        const cellLevel = cellSignal === 'strong' ? 4 : 2;
+        await this._adb.shell(`am broadcast -a com.android.systemui.demo -e command network -e mobile show -e level ${cellLevel} -e fully true -e datatype none`);
+      }
+    }
+
+    const clock = nullishOrMap(statusBarConfig.clock, (clock) => clock);
+    if (clock !== undefined) {
+      await this._adb.shell(`am broadcast -a com.android.systemui.demo -e command clock -e hhmm ${clock}`);
+    }
+
+    // Best to keep this last due to a "charging" indicator animation which can
+    // break UI changes made by consequent commands
+    const batteryLevel = nullishOrMap(statusBarConfig.batteryLevel, (level) => batteryPrecents[level]);
+    const charging = nullishOrMap(statusBarConfig.charging, (isCharging) => String(isCharging));
+    if (batteryLevel !== undefined || charging !== undefined) {
+      const command = 'am broadcast -a com.android.systemui.demo -e command battery' +
+        (batteryLevel !== undefined ? ` -e level ${batteryLevel}` : '') +
+        (charging !== undefined ? ` -e plugged ${charging}` : '');
+      await this._adb.shell(command);
+      await sleep(1500); // Wait for the charging animation to finish
+    }
+  }
+
+  /**
+   * @param {Detox.DetoxSystemUI} presetName
+   * @returns {Detox.DetoxSystemUIConfig | null}
+   * @private
+   */
+  _resolvePreset(presetName) {
+    const preset = presets[presetName];
+    if (!preset) {
+      throw new DetoxConfigError(`Invalid system UI preset name '${presetName}'`);
+    }
+    return preset;
+  }
+}
+
+module.exports = SystemUICfgHelper;

package/src/devices/allocation/drivers/android/utils/systemUICfgPresets.js

@@ -0,0 +1,35 @@
+/**
+ * @type Detox.DetoxSystemUIConfig
+ */
+const minimalConfigPreset = {
+  keyboard: 'hide',
+  touches: 'show',
+  navigationMode: '3-button',
+  statusBar: {
+    notifications: 'hide',
+    wifiSignal: 'strong',
+    cellSignal: 'none',
+    batteryLevel: 'full',
+    charging: false,
+    clock: '1337',
+  },
+};
+
+/**
+ * @type Detox.DetoxSystemUIConfig
+ */
+ const genyConfigPreset = {
+  keyboard: 'hide',
+  statusBar: {
+    notifications: 'hide',
+    wifiSignal: 'strong',
+    cellSignal: 'none',
+    batteryLevel: 'full',
+    charging: true,
+  },
+};
+
+module.exports = {
+  minimal: minimalConfigPreset,
+  genymotion: genyConfigPreset,
+};

package/src/devices/runtime/drivers/android/AndroidDriver.js

@@ -266,7 +266,7 @@ class AndroidDriver extends DeviceDriverBase {
     const call = duration ? EspressoDetoxApi.longPress(x, y, duration, _shouldIgnoreStatusBar): EspressoDetoxApi.longPress(x, y, _shouldIgnoreStatusBar);
     await this.invocationManager.execute(call);
   }
-  
+
   async generateViewHierarchyXml(shouldInjectTestIds) {
     const hierarchy = await this.invocationManager.execute(DetoxApi.generateViewHierarchyXml(shouldInjectTestIds));
     return hierarchy.result;

package/src/errors/DetoxConfigErrorComposer.js

@@ -406,6 +406,8 @@ Please check your Detox config${this._atPath()}`,
         return this._invalidPropertyType('headless', 'a boolean value', deviceAlias);
       case 'readonly':
         return this._invalidPropertyType('readonly', 'a boolean value', deviceAlias);
+      case 'systemUI':
+        return this._invalidPropertyType('systemUI', "'minimal', 'genymotion' or an object", deviceAlias);
       default:
         throw new DetoxInternalError(`Composing .malformedDeviceProperty(${propertyName}) is not implemented`);
     }
@@ -425,6 +427,8 @@ Please check your Detox config${this._atPath()}`,
         return this._unsupportedPropertyByDeviceType('readonly', ['android.emulator'], deviceAlias);
       case 'utilBinaryPaths':
         return this._unsupportedPropertyByDeviceType('utilBinaryPaths', ['android.attached', 'android.emulator', 'android.genycloud'], deviceAlias);
+      case 'systemUI':
+        return this._unsupportedPropertyByDeviceType('systemUI', ['android.emulator', 'android.genycloud', 'android.attached'], deviceAlias);
       default:
         throw new DetoxInternalError(`Composing .unsupportedDeviceProperty(${propertyName}) is not implemented`);
     }

package/src/realms/DetoxPrimaryContext.js

@@ -174,7 +174,7 @@ class DetoxPrimaryContext extends DetoxContext {
     this[_cookieAllocators][deviceCookie.id] = deviceAllocator;
 
     try {
-      return await deviceAllocator.postAllocate(deviceCookie);
+      return await deviceAllocator.postAllocate(deviceCookie, { deviceConfig });
     } catch (e) {
       try {
         await deviceAllocator.free(deviceCookie, { shutdown: true });

package/Detox-android/com/wix/detox/20.45.1/detox-20.45.1-sources.jar.md5

@@ -1 +0,0 @@
-437da6c0a5ae2c1d4977a5cb3c594381

package/Detox-android/com/wix/detox/20.45.1/detox-20.45.1-sources.jar.sha1

@@ -1 +0,0 @@
-46a778d2606c567f78710bdd758ecfe44e3e97a8

package/Detox-android/com/wix/detox/20.45.1/detox-20.45.1-sources.jar.sha256

@@ -1 +0,0 @@
-686ba729c1fd277f3d65743f0d9986cb87aa0e09893ea7b1a774b9b4b3c50bfb

package/Detox-android/com/wix/detox/20.45.1/detox-20.45.1-sources.jar.sha512

@@ -1 +0,0 @@
-2339b87ef6be1b8c719fc4f4b85c645ce09ae62f1dceac7e1045e08f35a9e376e3b1421b1c619690e8c3e1682d4491730e1f8b4d304f2d7f2a707810495d6913

package/Detox-android/com/wix/detox/20.45.1/detox-20.45.1.pom.md5

@@ -1 +0,0 @@
-43ac5b85bfa0841e9d6d174bad45c8cc

package/Detox-android/com/wix/detox/20.45.1/detox-20.45.1.pom.sha1

@@ -1 +0,0 @@
-b67f418f459b003c18fbcd07e4126b9c83f9dda8

package/Detox-android/com/wix/detox/20.45.1/detox-20.45.1.pom.sha256

@@ -1 +0,0 @@
-05ae1f6e116faadd83a030406cbe6776ee6e36762505e59e563c861a98cbc31e

package/Detox-android/com/wix/detox/20.45.1/detox-20.45.1.pom.sha512

@@ -1 +0,0 @@
-195b29f8eac21dbce9cea79a5f0097e14307568400f96dfc5a058117deceb9ccf99c4a0867a9a72d2d019b3c07fb41453c661b16b5235f398df816c5a815b51c