emulator.wtf API

• Fixed: fixed OIDC authentication for GitHub repositories using immutable subject claims.

GitHub actions emulator-wtf/actions@v1.2.1

• New: you can now pass/override SCM information to the action via environment variables. The following environment variables are supported:

  • EW_SCM_URL - Source control repository URL of the test run
  • EW_SCM_COMMIT - Commit identifier of the test run (hash)
  • EW_SCM_PR_URL - Pull request URL for the test run
  • EW_SCM_REF_NAME - Current branch/tag name

  Note that typically the values for these will be guessed automatically by the action, but in some cases you may want to override them.

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

Test execution

• Improved: added context and tips to the No tests! error message.

gradle-plugin 1.8.1

• New: the scm* family of dsl settings can now be passed in via environment variables:
  • EW_SCM_URL for scmUrl
  • EW_SCM_COMMIT for scmCommitHash
  • EW_SCM_PR_URL for scmPrUrl
  • EW_SCM_REF_NAME for scmRefName
• Maintenance: bumped default ew-cli version to 1.5.1.

ew-cli 1.5.1

• New: the --scm-* family of options can now be passed in via environment variables:
  • EW_SCM_URL for --scm-url
  • EW_SCM_COMMIT for --scm-commit
  • EW_SCM_PR_URL for --scm-pr-url
  • EW_SCM_REF_NAME for --scm-ref-name

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.