flame-harness-screenshot

flame-harness-screenshot

Phase 9 of the flutter-flame-harness pipeline. Captures KO and EN store screenshots by driving the game's integration_test harness on the required device sizes (ads hidden), fills ASO metadata (keywords, localized titles, descriptions), and uploads the screenshots via fastlane.

All file schemas (config.md, state.md, pipeline-log.md) and the phase transition table are defined in docs/harness-protocol.md — that document is the single source of truth (§1 for config.md and credentials_dir; §2 for state.md; §6 for log schemas; §7 for the screenshot → submit transition and the status: running rule). Do not redefine schemas here.

Prerequisites: The game has been built and uploaded (Phase 8 flame-harness-build). The iOS simulator is a 6.7" iPhone model and the Android emulator is a phone-sized device. flutter drive and fastlane must be installed on the developer's macOS machine.

Input — Read Inputs

Before any action, load:

1. docs/harness/config.md — extract app_slug, bundle_id, app_name, and default_language (per protocol §1).
2. docs/harness/state.md — confirm next_role: screenshot (per protocol §2).

Derive the game root path: <projects-dir>/<app_slug>/.

Phase 1 — Harness Setup

Copy the integration_test template

Copy templates/screenshots_test.dart.template into the game's integration_test/ directory:

mkdir -p <game>/integration_test
cp templates/screenshots_test.dart.template \
   <game>/integration_test/screenshots_test.dart

Adapt the TODO markers

Open <game>/integration_test/screenshots_test.dart and replace every // TODO(generator): comment block with the game's real screen-driving code:

• Replace <__APP_SLUG__> in the import with the actual package name (from config.md app_slug, converting hyphens to underscores).
• Seed mock SharedPreferences / Hive / Isar data to skip first-run tutorials and show a representative UI state (high score, coins, unlocked skins).
• Wire the locale controller to force the locale to the SCREENSHOT_LOCALE dart-define value so screenshots are language-deterministic regardless of the simulator's system locale.
• Replace the placeholder screen list with the game's actual key screens (home, gameplay, game-over/results, optional secondary screen), keeping zero-padded two-digit name prefixes so fastlane and App Store Connect receive them in order.