Release Testify 1.0.0 - Beta 1 · Shopify/android-testify

1.0.0-beta1 -- May 2, 2020

Breaking changes introduced. Bumped Testify to 1.0.0-beta1

⚠️ Screenshot images now are written to subdirectories under the screenshot directory on device. Screenshot paths on device now include the full device key and such are properly defined to fully represent the device configuration used to generate the images.
This can be a breaking change if you use custom scripting to pull/access screenshot images from the emulator.
⚠️ The emulator locale is now encoded into the device key by default. Previously, only the language was encoded in the key. You can disable this behavior using the Locale (testify-experimental-locale) feature.
This change will require you to rename your baseline image directory to include the full locale path.
TestifyFeatures
Enable or disable some features at runtime via manifest entry or in code.
ScreenshotRule.withExperimentalFeatureEnabled
Used in conjunction with TestifyFeatures, you can selectively enable an experimental feature on the test rule. Features are reset after assertSame is called.
TestifyLayout can now accept a layout resource name or a layout resource ID.
This is useful for library projects where resource IDs are not stable.
Two new bitmap capture algorithms have been added. You can now select between PixelCopy, Canvas and DrawingCache capture methods.
These can be enabled with by passing either CanvasCapture or PixelCopyCapture to withExperimentalFeatureEnabled, or by enabling testify-canvas-capture or testify-experimental-capture in your manifest.

⚠️ Breaking Change
The testify {} gradle extension been restructured. Testify no longer requires the testify extension to be defined in your project.
This is particularly valuable for Android library projects as Testify can now correctly infer most settings automatically.
Most settings can now be inferred. Testify now supports multiple flavor dimensions and product flavors.
- testContextId has been deleted and is no longer needed.
- applicationIdSuffix has been deleted. Its value can now be inferred.
- installTask has been added. You can specify which task to run to install your APK. This is automatically inferred, but you may wish to override the default value.
- installAndroidTestTask has been added. You can specify which task to run to install the Android Instrumentation test package. This is automatically inferred, but you may wish to override the default value.
  You can view the inferred extension values by running ./gradlew testifySettings
Added verbose logging support. Add -Pverbose=true to your gradle commands to enable verbose logging. e.g. ./gradlew Sample:screenshotTest -Pverbose=true
The device key is now based off the emulator locale, not language. (e.g. en_US instead of just en)
Testify plugin no longer requires adb root access. screenshotPull and screenshotClear can now work on any device or Google Play emulator image.

screenshotClear will now properly delete files when running from a Windows client.
Screenshots are now copied to the correct baseline directory when captured on a landscape emulator.
Screenshots are now copied to the correct baseline directory regardless of emulator locale.
Testify now more accurately detects the appropriate install task for your project. Testify relies on this to correctly insall your APK for testing and can now infer more project types correctly.
Correctly set and get the locale language and region on API 22.
Correctly support overridden display density.