Update Store

Update Store

ストアスクリーンショットの自動撮影・合成と、メタデータテキスト（description, release_notes等）の更新を行う。

前提

• デバッグモードのアプリにはストアスクショ用のカスタムエクステンション（ccpocket.navigateToStoreScenario）が登録済み
• Marionette MCPのcall_custom_extensionが使用可能
• ImageMagickがインストール済み（compose.shで使用）
• sim-tap.swift: 同梱のSwiftスクリプト（scripts/sim-tap.swift）。macOSアクセシビリティAPIでSimulatorのネイティブダイアログ（通知許可等）をラベル指定でタップできる

ワークフロー

Step 1: バージョン確認 & 変更分析

# 最新リリースタグ
git tag -l 'ios/v*' --sort=-v:refname | head -1

# 現在のバージョン
grep '^version:' apps/mobile/pubspec.yaml

# 前回リリースからの変更コミット
git log $(git tag -l 'ios/v*' --sort=-v:refname | head -1)..HEAD --oneline -- apps/mobile/

CHANGELOGの最新セクションも確認:

head -80 CHANGELOG.md

変更内容を分析し、UI変更があったかどうかを判断する。

Step 2: 更新対象の選択

AskUserQuestion（multiSelect）で更新対象を確認する。 変更分析結果に基づいて推奨をdescriptionに含める。

スクリーンショット（8シナリオ）:

メタデータテキスト:

上記のファイルパスは apps/mobile/ からの相対パス。

Step 3: メタデータテキスト更新（選択された場合）

CHANGELOGの内容をベースに:

• release_notes — CHANGELOG最新セクションを簡潔にまとめる
• description — 新機能に応じて追記・修正
• promotional_text — キャッチコピーを更新

更新後、AskUserQuestionで内容確認を挟む。

Step 4: iPhone スクリーンショット撮影（選択された場合）

4-1. デバイス確認 & シミュレーター起動

xcrun simctl list devices available | grep -E "iPhone 17|iPad Pro.*13"

ソフトウェアキーボードを無効化（全デバイス共通、セッション冒頭で1回実行）:

defaults write com.apple.iphonesimulator ConnectHardwareKeyboard -bool true

これによりソフトウェアキーボードが表示されなくなり、日本語キーボードがスクショに映り込む問題を防止する。

iPhone 17 Proシミュレーターを起動し、ライトモードに設定:

xcrun simctl boot "iPhone 17 Pro" 2>/dev/null || true
xcrun simctl ui booted appearance light

4-2. アプリ起動 & Marionette接続

dart-mcp launch_app でアプリを起動:

root: /Users/k9i-mini/Workspace/ccpocket/apps/mobile
device: <iPhone 17 Pro の device ID>

起動後、dart-mcp list_running_apps でDTD URIを取得し、connect_dart_tooling_daemon で接続。

dart-mcp get_app_logs でVM Service URIを取得し、marionette connect で接続。

4-3. 各シナリオのスクショ撮影

テーマ設定: アプリ起動後、カスタムエクステンションでテーマを切り替える（01〜07はライトテーマ）:

• marionette call_custom_extension: ccpocket.setTheme / { "theme": "light" }
• 値: light, dark, system

言語設定: 必要に応じてカスタムエクステンションで言語を切り替える:

• marionette call_custom_extension: ccpocket.setLocale / { "locale": "en" }
• 値: en, ja, zh, "" (システムデフォルト)

選択された各シナリオに対して:

1. 遷移: marionette call_custom_extension

   • extension: ccpocket.navigateToStoreScenario
   • params: { "scenario": "<シナリオ名>" }

2. 待機: 2-3秒（描画完了を待つ。New SessionやImage Attachなど複雑なUIは3秒推奨）

3. 撮影:

   xcrun simctl io booted screenshot apps/mobile/fastlane/screenshots/en-US/<key>.png
   

4. 戻る: marionette call_custom_extension

   • extension: ccpocket.popToRoot

5. 待機: 1秒（ルートへの遷移完了）

08_dark_theme の撮影: 01〜07撮影後、ccpocket.setTheme で dark に切り替え、Session List シナリオを撮影する。

4-4. アプリ停止

dart-mcp stop_app でアプリを停止。

xcrun simctl shutdown "iPhone 17 Pro" 2>/dev/null || true

Step 5: iPad スクリーンショット撮影（選択された場合）

Step 4と同じフローをiPadで実行。

5-1. iPadシミュレーターの全画面表示を保証

iPadでアプリが互換モード（iPhone用の小さいウィンドウ + 黒帯）で起動する場合がある。 これはシミュレーターのキャッシュが原因のため、撮影前にシミュレーターをリセットする:

# シミュレーターをシャットダウン（起動中の場合）
xcrun simctl shutdown "iPad Pro 13-inch (M4)" 2>/dev/null || true

# シミュレーターのコンテンツとキャッシュをリセット
xcrun simctl erase "iPad Pro 13-inch (M4)"

# 起動 & ダークモード設定
xcrun simctl boot "iPad Pro 13-inch (M4)" 2>/dev/null || true
xcrun simctl ui booted appearance dark

重要: erase を実行するとアプリもアンインストールされるため、必ずクリーンインストールが行われる。これにより互換モード問題を防止する。

ネイティブダイアログの自動dismissl: erase 後は通知・音声認識・マイク等のパーミッションダイアログが再度表示される。アプリ起動後、各シナリオ撮影前に同梱の sim-tap.swift で全て閉じる:

# 「許可」ボタンが見つからなくなるまで繰り返しタップ
while swift .claude/skills/update-store/scripts/sim-tap.swift tap "許可" 2>/dev/null; do sleep 1; done

5-2. スクショ撮影 & 解像度検証

撮影後、スクショの解像度がiPadのネイティブ解像度と一致するか検証する:

xcrun simctl io booted screenshot apps/mobile/fastlane/screenshots/en-US/ipad_<key>.png

# 解像度検証（互換モード検出）
WIDTH=$(sips -g pixelWidth apps/mobile/fastlane/screenshots/en-US/ipad_<key>.png | tail -1 | awk '{print $2}')
HEIGHT=$(sips -g pixelHeight apps/mobile/fastlane/screenshots/en-US/ipad_<key>.png | tail -1 | awk '{print $2}')
echo "Screenshot: ${WIDTH}x${HEIGHT}"
# iPad Pro 13-inch (M4): 2064x2752 が期待値
# 解像度が大幅に小さい場合は互換モードで起動しているため、eraseからやり直す

もし解像度が期待値と異なる場合は、flutter clean → flutter build ios --simulator でクリーンビルドしてやり直すこと。

5-3. アプリ停止

アプリ停止後:

xcrun simctl shutdown "iPad Pro 13-inch (M4)" 2>/dev/null || true

Step 6: スクリーンショット合成 & 配置

cd apps/mobile && bash fastlane/screenshots/compose.sh

このスクリプトが行うこと:

• iPhone/iPad の raw スクショにデバイスフレーム・テキストオーバーレイを追加
• en-US と ja の両方のframed画像を生成
• fastlane/screenshots/store/ へコピー（fastlane deliver用）
• fastlane/metadata/android/ へコピー（Google Play用）
• docs/images/screenshots.png を更新（READMEバナー）

Step 7: 確認

# 生成画像の確認
ls -la apps/mobile/fastlane/screenshots/store/en-US/
ls -la apps/mobile/fastlane/screenshots/store/ja/

# 変更ファイル一覧
git diff --stat

シナリオ名 ↔ ファイルキー対応表

注意事項

• New Session シナリオ: ボトムシートがaddPostFrameCallbackで自動表示されるため、3秒待機推奨
• Markdown Input シナリオ: DraftServiceで入力欄にテキストが事前セットされる。キーボードは非表示のまま撮影すること（ConnectHardwareKeyboard を有効化済み）
• Image Attach シナリオ: モック画像が自動的に添付される
• シミュレーターデバイス名: Xcode バージョンにより正確な名前が異なる場合がある。xcrun simctl list devices available で確認
• compose.sh: ImageMagick (convert / magick) が必要。PNGタイムスタンプを除去して不要なgit diffを防止