Adds manually-triggered GitHub Actions workflow to record Play Store screenshots using hardware-accelerated emulators with automated app setup.

Implementation

• Dynamic API level: Parses sdk-target from commons/gradle/libs.versions.toml (currently 35) rather than hardcoding
• Hardware acceleration: Enables KVM for GitHub's hardware-accelerated Android virtualization (10x+ faster than software emulation)
• Emulator config:
  • Google APIs, x86_64 architecture
  • Pixel 7 Pro device profile for realistic screenshots
  • GPU set to swiftshader_indirect for Linux runner compatibility
  • Animations and spellchecker disabled for consistency
  • Optional timezone configuration from gtfs_rts_values_gen.xml
  • 180 second boot timeout for reliable startup
• No AVD caching: Workflow intended for infrequent use (quarterly/yearly)
• Workspace setup: Uses ./.github/actions/setup for consistent environment configuration (submodules, JDK, Gradle)
• Flexible output modes: Boolean workflow input commitDirectly allows choosing between:
  • Creating a new branch with pull request (default)
  • Committing directly to the current branch
• Automated setup: Script in shared/setup-and-all-app-screenshots.sh handles:
  • Downloading and installing main mtransit-for-android app from latest GitHub release
  • Granting location permissions to org.mtransit.android package
  • Setting GPS coordinates based on transit service area (supports both GTFS and bike station coordinate formats)
  • Optional timezone configuration from GTFS metadata
  • Downloading and installing current repository's module app from latest release
  • Disabling Pixel Launcher to prevent crash dialogs
  • Launching main app and waiting 10 seconds for initialization before screenshot capture
  • Calling commons-android/pub/all-app-screenshots.sh to capture screenshots
• GPS Location Setup: Automatically parses area bounds from XML files:
  • GTFS transit: app-android/src/main/res-current/values/current_gtfs_rts_values_gen.xml (min/max lat/lng)
  • Bike stations: app-android/src/main/res/values/bike_station_values.xml (bike_station min/max lat/lng)
  • Calculates center point of service area and sets emulator GPS location
• Timezone Configuration (optional): Reads timezone from gtfs_rts_values_gen.xml and configures emulator accordingly
• Screenshot Quality Improvements:
  • Disables Pixel Launcher to prevent "not responding" crash dialogs
  • Adds -no-snapshot-save to emulator options to prevent saving corrupted launcher state
  • Launches main app before screenshot capture to ensure proper initialization
  • Results in clean, production-ready Play Store screenshots
• Screenshot recording: Captures screenshots for all configured languages and places them in app-android/src/main/play/listings/*/graphics/*-screenshots/*.png
• Output handling:
  • Uploads screenshot artifacts (30-day retention)
  • Creates/updates PR with new screenshots automatically against the correct base branch (when commitDirectly is false)
  • Commits directly to current branch (when commitDirectly is true)
  • Uses explicit title/body from commit message for PR creation

Workflow Location

Workflow placed in shared-overwrite/.github/workflows/ for distribution to all main repos via submodule sync.

Setup script placed in shared/ to be available during workflow execution without persisting in target repos.

Note: The workflow uses commons/gradle/libs.versions.toml path and supports multiple repository types (GTFS transit and bike stations) to correctly work when distributed to repositories that use commons as a submodule.

• Fixes Create CI workflow to record new screenshots #577

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.