mirror of
https://github.com/Such-Software/hash-wallet.git
synced 2026-10-18 05:51:34 +02:00
jwinterm
c396e94b77
Drives the real app through real flows on a device while recording the screen,
then cuts ONE recording into both deliverables — store screenshots and
marketing video — so a listing can't drift out of sync with its own trailer.
integration_test/demo/
DemoSession adds what a passing test lacks: pacing (beat/hold/typeSlowly, so
footage is watchable rather than a strobe), timing marks reported through
binding.reportData, and seed guards. Scenarios reuse the existing 25 page
robots rather than reimplementing navigation:
core_store_set dashboard, receive, send (composed, NEVER broadcast),
wallets, security — the store screenshot set
onboarding_create welcome -> PIN -> seed -> dashboard
restore_from_seed restore -> syncing
swap_and_buy Trocador quote, stopping BEFORE creating a trade; Buy
skipped when no provider key, matching what reviewers see
tools/demo/
capture.sh orchestrates boot/record/cut/shots/reel
marks.py maps timing marks onto the recording; cuts, extracts frames,
builds manifests
reel.py branded master; reuses such_graphics video_transitions/video_qa
when ~/src/such-graphics is present, degrades cleanly when not
(this repo is public and must build without it)
build-apk.sh local APK via the CI container image
Seed safety — the demo wallet is a real wallet with real funds:
- seed comes from Vaultwarden at capture time, never the repo
- guardNoSeedOnScreen() fails the run on a visible mnemonic, catching both
the known seed and the generic shape of one (so freshly generated seeds
are caught too)
- unavoidable seed screens are wrapped in blindfold(); those spans are
excised from the video with 0.6s padding, and screenshots honour the same
padding
- marks.py refuses to build a publishable master if any clip was cut without
marks, since blindfold spans could not have been excised
Apple App Preview gets no touch indicators, captions, cards or music, and
reel.py enforces the 15-30s window rather than emitting an out-of-spec file.
Everything else keeps taps on, drawn by SurfaceFlinger via show_touches rather
than composited, so they look real.
Play sizing: the harness builds its own 1080x1920 AVD. The stock Medium Phone
AVD is 1080x2400 = 2.22:1 and Play rejects phone screenshots above 2:1.
Also gitignores android/app/upload-keystore.jks (and *.jks/*.keystore): the
Android workflow decodes ANDROID_KEYSTORE_BASE64 to exactly that path, so the
Play upload signing key was one `git add -A` away from being committed.
95 lines
4.7 KiB
Markdown
95 lines
4.7 KiB
Markdown
# Hash Bags — store screenshots
|
||
|
||
Three ways to produce the App Store / Play screenshots.
|
||
|
||
**Play (and all marketing video) runs on Linux** via the automated capture
|
||
harness — Path C, below. Only the **iOS** sets need macOS, because an iPhone/iPad
|
||
Simulator can't run on the Linux box.
|
||
|
||
## Required sizes (the Simulator outputs these exactly — don't hand-size)
|
||
| Store | Device to capture | Size | Count |
|
||
|---|---|---|---|
|
||
| App Store | **iPhone 16 Pro Max** (6.9") | 1290×2796 / 1320×2868 | 3–10 (required) |
|
||
| App Store | **iPad Pro 13" (M4)** | 2064×2752 | required *if* you ship iPad |
|
||
| Google Play | Pixel-class emulator | 1080×1920 (9:16) | 2–8 (required) |
|
||
|
||
---
|
||
|
||
## Path A — Manual (recommended for the first submission; ~15 min)
|
||
```bash
|
||
# iPhone
|
||
xcrun simctl boot "iPhone 16 Pro Max"; open -a Simulator
|
||
flutter run -d "iPhone 16 Pro Max" # from repo root; navigate the app, then:
|
||
store/screenshot.sh 01-home
|
||
store/screenshot.sh 02-receive
|
||
store/screenshot.sh 03-send
|
||
store/screenshot.sh 04-swap
|
||
store/screenshot.sh 05-settings
|
||
# iPad — repeat booted on the iPad sim
|
||
xcrun simctl boot "iPad Pro 13-inch (M4)"
|
||
flutter run -d "iPad Pro 13-inch (M4)"
|
||
OUT_DIR=store/screenshots-ipad store/screenshot.sh 01-home # ...etc
|
||
|
||
# Android (Play) — boot a Pixel emulator, run the app, then:
|
||
adb exec-out screencap -p > store/screenshots-play/01-home.png
|
||
```
|
||
`store/screenshot.sh` captures the booted simulator at the exact store size.
|
||
|
||
---
|
||
|
||
## Path B — Automated (fastlane snapshot; repeatable, multi-device/language)
|
||
Scaffolded here: `ios/fastlane/{Appfile,Snapfile,Fastfile}` +
|
||
`ios/RunnerUITests/HashBagsScreenshotsUITests.swift`.
|
||
|
||
**One-time setup (on the Mac):**
|
||
1. `cd ios && fastlane snapshot init` — drops `SnapshotHelper.swift` (matched to your fastlane version) into `ios/`. Move it into `ios/RunnerUITests/`.
|
||
2. In **Xcode** (`ios/Runner.xcworkspace`): File ▸ New ▸ Target ▸ **UI Testing Bundle**, name it **`RunnerUITests`**, target = `Runner`. Add `SnapshotHelper.swift` + `HashBagsScreenshotsUITests.swift` to it. Then edit the **Runner scheme ▸ Test** action and tick `RunnerUITests`.
|
||
3. **Screenshot-ready state:** wallet flows (create/PIN/seed/sync) are painful to drive, so make the app launch straight into a demo wallet when it sees the flag. In Dart, gate on `const bool.fromEnvironment('SCREENSHOT_MODE')` (or check `Platform.environment`/launch args): when true, restore a known demo wallet, skip onboarding, and stub balances. The UITest already passes `--dart-define=SCREENSHOT_MODE=true`.
|
||
4. **Accessibility:** the test taps by label/identifier. Add `Semantics(identifier: 'send_action')` (etc.) to the widgets you shoot, or rely on visible text ("Send", "Receive", "Swap", "Settings"). Tune the identifiers in the test.
|
||
|
||
**Run:**
|
||
```bash
|
||
cd ios && fastlane screenshots # → ios/screenshots/en-US/<device>-01-Home.png ...
|
||
```
|
||
|
||
---
|
||
|
||
---
|
||
|
||
## Path C — Automated capture harness (Play + all video; runs on Linux)
|
||
`tools/demo/` drives the real app on a headless emulator while recording the
|
||
screen, then cuts one recording into **both** the screenshots and the video.
|
||
See `tools/demo/README.md`.
|
||
|
||
```bash
|
||
cp tools/demo/demo.env.example tools/demo/demo.env # fill in; gitignored
|
||
export BW_SESSION=$(bw unlock --raw) # demo seed from Vaultwarden
|
||
|
||
tools/demo/build-apk.sh # debug APK via the CI container (Flutter 3.32.0)
|
||
tools/demo/capture.sh boot # creates/boots a 1080x1920 AVD
|
||
tools/demo/capture.sh all # record all scenarios, cut, shoot, assemble
|
||
```
|
||
|
||
Why it exists, beyond convenience:
|
||
- **Sizing.** It builds its own AVD at exactly 1080×1920 (16:9). The stock
|
||
"Medium Phone" AVD is 1080×2400 = **2.22:1**, which Play rejects (max 2:1).
|
||
- **Consistency.** Screenshots are frames of the same recording the trailer is
|
||
cut from, taken at the timestamps the scenario reports.
|
||
- **Seed safety.** Frames containing a mnemonic are bracketed by the scenario
|
||
and excised automatically; the tooling refuses to emit a publishable master
|
||
if any clip wasn't verified. The demo wallet holds real funds.
|
||
- **Apple rules.** The `apple-preview` profile force-disables touch indicators,
|
||
captions and music, and enforces Apple's 15–30s window.
|
||
|
||
Scenarios cover the core store set, onboarding/create, restore-from-seed, and
|
||
swap/buy.
|
||
|
||
---
|
||
|
||
## Upload
|
||
- **App Store Connect** ▸ your app ▸ version ▸ Previews and Screenshots → drag the 6.9" iPhone (and 13" iPad) sets.
|
||
- **Play Console** ▸ Store listing ▸ Phone screenshots → the 1080×1920 set; plus the **icon** (`store/play-icon-512.png`) and **feature graphic** (`store/play-feature-graphic-1024x500.png`).
|
||
|
||
> Reality check: for a *first* launch, Path A (manual) is faster. Path B pays off
|
||
> when you re-shoot across versions/locales. Either way it's a Mac task.
|