Precompiled Detox Android (aka .aar) bundling

Detox-Android code is now available as a precompiled package (i.e. an .aar) -- bundled into the npm package. This allows apps to configure it as an immediately available dependency, instead of a compiling one - which requires recompilation in every app build.

• Migration instructions are available here
• Fresh-installation instructions are available here

Integration with Detox Instruments

This release adds initial integration between Detox and Detox Instruments (#1165).

If you run Detox tests with --record-performance all, it will load or use the already loaded Profiler framework and call its APIs to record performance metrics for each test. The artifacts manager will put each test recording (.dtxrec) into an appropriate folder inside your artifacts location.

Also, the deprecation of "specs" property in package.json has been revoked - it continues to serve as a default test root directory (#1290).

More details can be found in the CHANGELOG.

Enhancements for the screenshot artifacts subsystem

Features

#1281 - feat: --take-screenshot manual mode by default

---

Adds --take-screenshot manual mode, which is used by default from now on.

In manual mode, device.takeScreenshot is enabled as well, but beforeEach.png and afterEach.png screenshots are not being taken.

To have device.takeScreenshot API disabled forcibly, use --take-screenshot none.

---

Bugfixes

#1276 - fix(android): install APK with a file path that needs escaping

Take screenshots on demand

Adds await device.takeScreenshot(name) method.
More details: #904

Bugfixes for the logger subsystem

1. hotfix: redundant logs in the folder (#1268) - 2dabadd

   Prevents uncontrolled creation of detox_<pid>.log files in the current working directory, when using --record-logs and not specifying the location of the artifacts (which is an autogenerated artifacts/<configuration>_<timestamp> folder).

2. fix: stabilize simulator log recording (#1273) - 65e1975

   Addresses sporadic hanging of a test runner due to a race condition caused by 3rd-party tail npm package: setTimeout (=> @watch()), 1000 . The tail object is apt to subscribe itself to FS events on the sly via creating a watcher (fs.watch()) even after fs.unwatch() has been called.

Take screenshots — Beta preview

More details here: #904

Take screenshot — alpha preview

12.1.4-screenshot

test: update snapshots

12.1.3

Publish 12.1.3 [ci skip]

Detox 12.1.1

Fixed a crash in the previous release (#1240)

Detox 12.1.0

• Detox now disables test mode in React Native, which should fix various animations and other issues (#1234)
• New arguments infrastructure is included (#1109)