Support pre-release API versions?

[swankjesse]

We’re using android-emulator-runner in OkHttp and it’s rad!

Recently we started developing a feature that will ship on Android API 37, to be released sometime in 2026. It requires a lot more setup vs. using android-emulator-runner.

https://github.com/yschimke/okhttp/blob/6276a39abbc3628b815f127b7712ca36295df0de/.github/workflows/build.yml#L399-L483

It would be very nice if android-emulator-runner had built-in support for unreleased Android SDKs.

Thank you!

[ychescale9]

Both api-level and system-image-api-level support any arbitrary value e.g. 37.0, CinnamonBun. Is this what you meant?

[swankjesse]

Oh that’s rad. I’ll give that a go. Thank you!

[yschimke]

Do we have any examples of this working? I suspect it might be related to the system images being 16kg page size and non standard names?

Testing with

square/okhttp#9383 -> logs https://github.com/square/okhttp/actions/runs/27693768383/job/81911389414?pr=9383

[yschimke]

raised https://issuetracker.google.com/issues/524601393

[yschimke]

Agent advised that the issue might be the action waiting for boot_completed, but not for package/activity services?

      - name: Run Tests
        uses: reactivecircus/android-emulator-runner@v2
        with:
          api-level: ${{ matrix.api-level }}
          target: ${{ matrix.target }}
          arch: ${{ matrix.arch }}
          emulator-boot-timeout: 1200
          # These must match the options used to create the snapshot above: the emulator only
          # restores a cached snapshot when the boot options are identical. The action default
          # includes -no-snapshot, which would otherwise force a slow cold boot.
          emulator-options: >
            -no-window
            -gpu swiftshader_indirect
            -noaudio 
            -no-boot-anim
            -camera-back none
            -memory ${{ matrix.memory || '2048' }}
          # The action waits for sys.boot_completed, but the package/activity services can still
          # be coming up (seen on API 37: "Can't find service: package" during APK install).
          # Wait for them before connectedCheck. No-op on levels where they're already up.
          script: |
            timeout 300 bash -c 'until adb shell service check package | grep -q found; do sleep 2; done'
            timeout 300 bash -c 'until adb shell service check activity | grep -q found; do sleep 2; done'
            ./gradlew -PandroidBuild=true connectedCheck
        env:
          API_LEVEL: ${{ matrix.api-level }}

[yschimke]

That got further but still fails. Maybe a clean test in this repo might be easier to follow.