Skip to content

General: Track only smoke locales for Play Store screenshots#363

Merged
d4rken merged 1 commit into
mainfrom
general/screenshot-gitignore-smoke-only
May 4, 2026
Merged

General: Track only smoke locales for Play Store screenshots#363
d4rken merged 1 commit into
mainfrom
general/screenshot-gitignore-smoke-only

Conversation

@d4rken
Copy link
Copy Markdown
Member

@d4rken d4rken commented May 4, 2026

What changed

Play Store phone screenshots are now tracked in git for only the 6 smoke locales (en-US, de-DE, ja-JP, ar, zh-CN, pt-BR). The remaining 33 locales are gitignored and regenerated on demand. No user-facing change — Play Store retains previously-uploaded screenshots for locales not pushed in the next upload.

Technical Context

  • Mirrors the d4rken-org/capod#585 pattern. The smoke set matches SMOKE_LOCALES in fastlane/generate_screenshots.sh.
  • The .gitignore rule uses fastlane/metadata/android/*/images/phoneScreenshots/*.png followed by 6 !-include rules. en-US/images/icon.png and featureGraphic.png sit one level higher than phoneScreenshots/ so they are unaffected.
  • The app/src/screenshotTestGplayDebug/reference/ ignore is broadened to app/src/screenshotTest*/reference/ so any future flavor variant (e.g. FOSS) gets covered.
  • fastlane/generate_screenshots.sh now exits non-zero on a PNG count mismatch instead of just printing a warning, so partial renders fail loudly before the copy/upload steps.
  • .claude/rules/screenshots.md documents the manual regen + upload workflow, including the post-upload git clean -fdX fastlane/metadata/android cleanup (removes only ignored files) and the git checkout -- fastlane/metadata/android/{ckb-IR,ku-TR} restoration after remove_unsupported_languages.sh runs.
  • The 2 modified PNGs (pt-BR and zh-CN's 1_overview_light.png) come from a deterministic re-render and are visually identical to the previous content.

Review note

The retention assumption — Fastlane skips locales with no local files, so absent locales keep their Play Store screenshots — is current Fastlane uploader behavior, not a Play Store guarantee. After the next smoke-only upload, the screenshots.md doc instructs a one-time Play Console spot-check on a non-smoke locale (e.g. fr-FR) to validate.

Mirror the d4rken-org/capod#585 pattern: gitignore Play Store phone screenshots for non-smoke locales, keeping only the 6 smoke locales (en-US, de-DE, ja-JP, ar, zh-CN, pt-BR) tracked. The smoke set matches SMOKE_LOCALES in fastlane/generate_screenshots.sh.

Future screenshot refreshes only diff 6 locales x 6 screens = 36 PNGs instead of 234, so reviews stay readable. Full localization is generated + uploaded on demand via 'bundle exec fastlane screenshots_only'; Fastlane skips locales with no local files, so absent locales keep whatever Play Store currently has.

Also: fail generate_screenshots.sh non-zero on PNG count mismatch (was a soft warning), fix the stale '39 x 7 screens' comment in build-commands.md (it's 39 x 6), and add .claude/rules/screenshots.md describing the regen + upload + working-tree cleanup workflow.
@d4rken d4rken merged commit 3ebbf95 into main May 4, 2026
11 checks passed
@d4rken d4rken deleted the general/screenshot-gitignore-smoke-only branch May 4, 2026 19:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant