ew-cli 1.5.0

• New (enterprise customers only): All emulators on API versions 23, 24, 28, 29, and 30 now use the x86_64 architecture instead of x86. Customers on the Startup and Scaleup plans get this change immediately without having to upgrade ew-cli.

gradle-plugin 1.8.0

• New (enterprise customers only): All emulators on API versions 23, 24, 28, 29, and 30 now use the x86_64 architecture instead of x86. Customers on the Startup and Scaleup plans get this change immediately without having to upgrade the plugin.
• Maintenance: bumped default ew-cli version to 1.5.0.

GitHub actions emulator-wtf/actions@v1.2.0

• New (enterprise customers only): All emulators on API versions 23, 24, 28, 29, and 30 now use the x86_64 architecture instead of x86. Customers on the Startup and Scaleup plans get this change immediately without having to upgrade actions.
• Maintenance: bumped default ew-cli version to 1.5.0.

CircleCI orb emulator-wtf/emulator-wtf@0.3.0

• New (enterprise customers only): All emulators on API versions 23, 24, 28, 29, and 30 now use the x86_64 architecture instead of x86. Customers on the Startup and Scaleup plans get this change immediately without having to upgrade the orb.
• Maintenance: bumped default ew-cli version to 1.5.0.

Emulators

• Maintenance: we have changed the architecture of emulators on API levels 23, 24, 28, 29, and 30 from x86 to x86_64. API level 27 devices remain the sole exception using the x86 architecture.

  NOTE: enterprise customers need to update to ew-cli 1.5.0 / Gradle plugin 1.8.0 / GitHub action 1.2.0 / CircleCI orb 0.3.0 or later to get this change.

Emulators

• New: all Android Test Device (ATD) emulator models now have 4GiB of RAM instead of 2GiB. This should reduce the amount of OOMs and memory pressure on the emulator, especially with larger apps and test suites.

  NOTE: enterprise customers need to update to ew-cli 1.4.3 / Gradle plugin 1.7.3 / GitHub action 1.1.1 / CircleCI orb 0.2.1 or later to get this change.

ew-cli 1.4.3

• New (enterprise customers only): ATD emulators now have 4GiB of RAM instead of 2GiB. Customers on the Startup and Scaleup plans get this change immediately without having to upgrade ew-cli.

gradle-plugin 1.7.3

• New (enterprise customers only): ATD emulators now have 4GiB of RAM instead of 2GiB. Customers on the Startup and Scaleup plans get this change immediately without having to upgrade the plugin.
• Maintenance: bumped default ew-cli version to 1.4.3.

GitHub actions emulator-wtf/actions@v1.1.1

• New (enterprise customers only): emulators with API version 29 and higher now have 4GiB of RAM instead of 2GiB. Customers on the Startup and Scaleup plans get this change immediately without having to upgrade the action.
• Improved: we increased the maximum APK size to 1GiB.
• Maintenance: bumped default ew-cli version to 1.4.3.

CircleCI orb emulator-wtf/emulator-wtf@0.2.1

• New (enterprise customers only): emulators with API version 29 and higher now have 4GiB of RAM instead of 2GiB. Customers on the Startup and Scaleup plans get this change immediately without having to upgrade the orb.
• Improved: we increased the maximum APK size to 1GiB.
• Maintenance: bumped default ew-cli version to 1.4.3.

ew-cli 1.4.2

• Improved: all invalid options now print a proper error and usage help instead of a stack trace.
• Improved: we increased the maximum APK size to 1GiB.

gradle-plugin 1.7.2

• Improved: we increased the maximum APK size to 1GiB.
• Maintenance: bumped default ew-cli version to 1.4.2.

gradle-plugin 1.7.1

Info

New (enterprise customers only): the emulator binary and system images are now loosely pinned to the emulator.wtf Gradle plugin version.

CI pipelines that randomly start to fail because we’ve made an emulator binary update is a bad day for everyone - you can now control when you get the updates by updating the emulator.wtf Gradle plugin in a timely manner.

NOTE: we won’t be keeping old combinations available forever, if you stay on a relatively old version of the Gradle plugin you will get a silent update.

• New (enterprise customers only): This version updates all non-ATD emulators with API version 29 and later from 2GiB to 4GiB of RAM. Customers on the Startup and Scaleup plans get this change immediately without having to upgrade the emulator.wtf Gradle plugin.
• Maintenance: bumped default ew-cli version to 1.4.1.

ew-cli 1.4.1

Info

New (enterprise customers only): the emulator binary and system images are now loosely pinned to the ew-cli version.

CI pipelines that randomly start to fail because we’ve made an emulator binary update is a bad day for everyone - you can now control when you get the updates by updating ew-cli in a timely manner.

NOTE: we won’t be keeping old combinations available forever, if you stay on a relatively old version of ew-cli you will get a silent update.

• New (enterprise customers only): This version updates all non-ATD emulators with API version 29 and later from 2GiB to 4GiB of RAM. Customers on the Startup and Scaleup plans get this change immediately without having to upgrade ew-cli.

Emulators

• New: API 29 and later emulators now have 4GiB of RAM instead of 2GiB. This should reduce the amount of OOMs and memory pressure on the emulator, especially with larger apps and test suites.

  NOTE: enterprise customers need to update to ew-cli 1.4.1 / Gradle plugin 1.7.1 / GitHub action 1.1.1 or later to get this change.

ew-cli 1.4.0

• Improved: large APK uploads now use multiple parallel connections, making uploads substantially faster.

gradle-plugin 1.7.0

• Maintenance: bumped default ew-cli version to 1.4.0.

GitHub actions emulator-wtf/actions@v1.1.0

• Maintenance: bumped default ew-cli version to 1.4.0.

Test execution

• Maintenance: test collection timeout has been increased to 2 minutes.

Emulators

• New: added API 37 emulator images. List of device combinations added:
  • device=Pixel2,version=37
  • device=Pixel7,version=37
  • device=NexusLowRes,version=37
  • device=Monitor,version=37
  • device=Tablet10,version=37
  • See all available emulator images here.

ew-cli 1.3.3

• The connectivity-check command now performs upload performance measurements against our backend.

Emulators

• Added 77.42.115.125 and 65.109.17.223 to our outbound IPs. There will be a grace period of two weeks before we start sending traffic from these addresses.
• Removed 157.180.105.69 from our outbound IP address list.

ew-cli 1.3.2

• Fixed: corner-case connectivity issue where ew-cli could stall for minutes before running any tests.

gradle-plugin 1.6.1

• Fixed: crash when using the Gradle Test Reporting API on Gradle 9.4.0 and later.
• Maintenance: bumped default ew-cli version to 1.3.2.

GitHub actions emulator-wtf/actions@v1.0.1

• Maintenance: bumped default ew-cli version to 1.3.2.

CircleCI orb 0.1.1 emulator-wtf/emulator-wtf@0.1.1

• Maintenance: bumped default ew-cli version to 1.3.2.

emulator.wtf API

• Fixed: SCIM compatibility issues with Okta and Microsoft Entra.

ew-cli 1.3.1

• Fixed: slow or stalled file uploads would not time out correctly, causing test runs to hang.

GitHub actions emulator-wtf/actions@v1.0.0

The emulator.wtf GitHub actions have moved!

Important

• emulator-wtf/run-tests@v1.0.0 is now emulator-wtf/actions/run-tests@v1.0.0.
• emulator-wtf/configure-credentials@v1.0.0 is now emulator-wtf/actions/configure-credentials@v1.0.0.

Changes since emulator-wtf/run-tests@v1.0.0-rc02:

• New: Sessions are now generally available for all users.
• New: use the emulator-wtf/actions/use-emulator@v1.0.0 action to make use of a generic adb-connected emulator in your workflows.
• Improved: reduced test setup overhead for runs with large APK files across many shards. You can expect up to 10x less time from test submission to the first test start when using a very large number of shards.
• Improved: the emulator-wtf/actions repository has immutable releases.
• Fixed: increased client-side test run timeout to account for repeat attempts of flaky tests.
• Fixed: report proper result-file download timing.
• Fixed: properly parse the GITHUB_REF_NAME env var when running in GitHub Actions.
• Maintenance: default ew-cli version has been bumped to 1.3.0.

Breaking changes in v1.0.0 compared to emulator-wtf/run-tests@v0.9.11:

We’ve made a bunch of breaking changes in v1.0.0. Read more about the 1.0.0 release and breaking changes.

• Breaking: GitHub Tokenless authentication via passing GITHUB_TOKEN as the token is no longer supported. Please switch to OIDC authentication instead. Read more here.
• Breaking: video recording is now enabled by default.
• Breaking: the default device is now Pixel7 30.
• Breaking: GPU acceleration is now turned on by default.
• Breaking: fixed pulled directories containing the root folder name twice.

ew-cli 1.3.0

• New: Sessions are now generally available for all users.
• Improved: reduced test setup overhead for runs with large APK files across many shards. You can expect up to 10x less time from test submission to the first test start when using a very large number of shards.

Test execution

• Fixed: support test targets that mix full class names and specific methods from legacy CLI versions.

CircleCI orb 0.1.0 emulator-wtf/emulator-wtf@0.1.0

• Maintenance: bumped default ew-cli version to 1.3.0.

gradle-plugin 1.6.0

• Maintenance: bumped default ew-cli version to 1.3.0.

ew-cli 1.2.2

• Fixed: you can now run multiple ew-cli instances with --egress-tunnel.

gradle-plugin 1.5.4

• Fixed: plugin no longer fails to apply on Kotlin Multiplatform projects with AGP 9 where withDeviceTest {} is declared after the plugins {} block.
• New: added support for com.android.kotlin.multiplatform.library plugin (AGP 9 KMP Android library), automatically creating testAndroidMainWithEmulatorWtf and related tasks.
• Maintenance: bumped default ew-cli version to 1.2.2.

ew-cli 1.2.1

• Fixed: report proper result-file download timing.
• Fixed: explicitly provided --scm-* parameters are now correctly honored and missing ones are guessed from environment when running on CI.
• Fixed: properly parse the GITHUB_REF_NAME env var when running in GitHub Actions.

Test execution

• Fixed: added a transparent workaround for rare process failed to attach crashes on API 34.

emulator.wtf web app

• The test run list rows are now actual links, making it easier to open them in a new tab.

emulator.wtf API

• New: The egress tunnel feature is now generally available. It is still considered experimental, however.

Test execution

• Fixed: reverted a bad deploy that caused the results XML output to change, affecting things like timing calculations and Develocity reports.

gradle-plugin 1.5.1

• Fixed: egressLocalhostForwardIp now properly forwards the value to ew-cli instead of crashing.

emulator.wtf web app

• Fixed: linking emulator.wtf with a GitHub organization from the web app.

Test execution

• Fixed: added a workaround for a rare occasion of test execution with Android Test Orchestrator getting stuck on API 34 devices.

ew-cli 1.2.0

• New: added --shard-unit flag with a test_classes option that ensures all test methods within a class run on the same shard (defaults to test_methods).
• Fixed: increased client-side test run timeout to account for repeat attempts of flaky tests.

gradle-plugin 1.5.0

• New: added shardUnit configuration option to control sharding granularity. Can be set to ShardUnit.TEST_CLASSES to shard at the test class level, or ShardUnit.TEST_METHODS (default) to shard at the test method level.
• Fixed: increased client-side test run timeout to account for repeat attempts of flaky tests.
• Maintenance: bumped default ew-cli version to 1.2.0.

CircleCI orb 0.0.5 emulator-wtf/emulator-wtf@0.0.5

• New: added shard_unit option to control sharding granularity. Can be set to either test_classes or test_methods (default), where test_classes will place whole test classes on the same shard, and test_methods will shard at the test method level.
• Fixed: increased client-side test run timeout to account for repeat attempts of flaky tests.
• Maintenance: bumped default ew-cli version to 1.2.0.

Emulators

• New: disabled captive portal detection. This will help in cases where the egress tunnel exits from a limited-network node and the emulator figures it’s completely offline.
• New: added API 36 emulator images. List of device combinations added:
  • device=Pixel2,version=36
  • device=Pixel7,version=36
  • device=NexusLowRes,version=36
  • device=Monitor,version=36
  • device=Tablet10,version=36
  • device=Pixel2Atd,version=36
  • device=Pixel7Atd,version=36
  • device=NexusLowResAtd,version=36
  • device=Tablet10Atd,version=36
  • See all available emulator images here.

ew-cli 1.1.0

• New: added flag --testcase-duration-hint to provide an average test-case runtime hint for --shard-target-runtime or --num-balanced-shards. More info: here.
• Fixed: ew-cli no longer hangs if setting up an adb session fails.

gradle-plugin 1.4.0

• New: added support for testcaseDurationHint. More info: here.
• Maintenance: bumped default ew-cli version to 1.1.0.

GitHub action emulator-wtf/run-tests@v1.0.0-rc02

• New: added support for testcase-duration-hint. More info: here.
• Maintenance: bumped default ew-cli version to 1.1.0.

CircleCI orb 0.0.4 emulator-wtf/emulator-wtf@0.0.4

• New: added support for testcase_duration_hint, num_balanced_shards and shard_target_runtime. More info: here.
• Maintenance: bumped default ew-cli version to 1.1.0.

Test execution

• Improved: --shard-target-runtime uses a better heuristic for guessing the number of shards when there’s no historical data available.

emulator.wtf web app

• Fixed: SSO login now correctly redirects to the test results page after having previously logged out from a different account.