Detox

Hotfixes

Fixes detox.cleanup() error if Detox is launched with --cleanup CLI argument.

Features

• Screenshots: configure which screenshots to take (#1980, @noomorph)
• Screenshots: take appNotReady.png screenshot if launchApp() fails (#1971, @noomorph)

Fixes

• General: prevent hanging builds on detox.init() timeout (#1968, @noomorph)

Miscellaneous

• Documentation updates in #1990 (@SRandazzo) and #1998 (@noomorph)

Android:

• Restrict patching of emulators' skin config to older emulators (#1982)

iOS:

• Fix Detox build logging in case of failures (#1974)

Android:

• Fixed issue with DetoxJUnitRunner.

Detox now comes as a prebuilt framework on iOS, thus lowering npm install times and saving some build issues that happen due to unexpected Xcode setups.

To support this, Detox needs Swift 5 support, so the iOS requirements have changed slightly:

• Xcode: 10.2 or higher
  • iOS Simulator Runtime: iOS 12.2 or higher

This does not require that your app require iOS 12.2, only that you build and run your app on Xcode 10.2 or above, and use an iOS 12.2 or above simulator.

Removed unneeded dependencies from Detox library's Gradle build script (#1950).

Detox users - you can now apply these changes to the way you import Detox in your app scripts:

dependencies {
-    androidTestImplementation('com.wix:detox:+') { transitive = true } 
+    androidTestImplementation('com.wix:detox:+')
-    androidTestImplementation 'junit:junit:4.12'
}

Namely, remove transitive=true and remove junit altogether from the androidTestImplementation configuration.

Further potential fixes to crashes originating in prettyPrint functions inside Detox on iOS.

Wire all tester-side (non-device) logs through Detox' central logger (bunyan).
That includes all custom Jest reporters and users' in-test logs (i.e. usage of console.xxx() methods). The latter can be disabled using the --use-custom-logger false argument to Detox' CLI.

• Introduced a VPAT to Detox (see here)

Android:

• Minor fix to make new code more Proguard friendly (#1937)

Android:

• Continue with error-visibility improvements: make full native stack-trace available on the tester-side in (native) runtime errors (#1932).
• Fix build-files typo: detoxKotlinVerion -> detoxKotlinVersion (#1930)

Android:
More visibility/Ux improvements

• Introduce ANR's monitor to warn when app becomes nonresponsive, alongside thread-dump data (#1926, #1925)

Features

• feat(config): extensible artifacts json (#1923)
• feat(artifacts): codec option for simulator video recording (#1920) …

tl;dr

Artifacts plugins have become more configurable from package.json, see a short example below:

{
  "detox": {
    "artifacts": {
      "plugins": {
        "video": {
          "android": {
            "bitRate": 4000000
          },
          "simulator": {
            "codec": "hevc"
          },
        }
      }
    }
  }
}

Android:

• Added DetoxJUnitRunner for android instruments recording (#1903).

Android:

• Tone down (soften) Detox' tap gesture by increasing the inter-events gap (down, up) (#1902).

Android:

Visibility / Ux improvments:

• Added an important Ux feature of catching, reporting and immediately failing tests which are otherwise bound to time-out due to crashes in early app-launch stages (#1880).
• Added a new artifact feature (beta) 🎉 : A detox timeline summary json file, readable for visual representation by chrome://tracing. You can start playing with it by passing the --record-timeline all argument to Detox' CLI. A special thanks to @trofima for this! (#1894).

iOS:

• Added a discouraging notation in Docs with respect to using the by.text() matcher.

General:

• Upgrade demo and test environment using Jest to new Jest 25.1.x.

• Vastly improve logging in case detox init fails (#1705)

Android:

• Fixed an issue where -read-only was passed in into emulators in undesired use cases (#1870)
• Hot-fixed an issue with Detox-instrumentation integration

Android: Done some prep work for helping out RN developers with a refactor in RN 0.62 (#1801)

• iOS: Print the framework build log in case of a failure.
• Android: Apply improvements and adjustments recently made for tap() API to tapAtPoint() as well.

Fixes broken artifact creation on iOS in 15.1.0 (see https://github.com/wix/Detox/pull/1848)

Internal changes for instruments artifact recording