fastlane snapshotの多言語スクリーンショットをどう自動検収する?2026年チェックリスト

fastlaneの公式ガイドでは、snapshotを使って言語やシミュレーター構成に応じたスクリーンショットを取得できます(fastlaneのスクリーンショット入門)。ただし、実行が終わっただけでは素材の合格を意味しません。fastlane snapshotの多言語スクリーンショット検収では、言語、端末、画面内容、ファイル、App Store Connectでの表示を別々に確認してください。

独立開発者:iOS Appの多言語スクリーンショットを作成・更新し、手作業での取りこぼしを減らしたい方。
多言語アプリの担当者:各言語と端末の組み合わせに、正しい画像がそろっているか確かめたい方。
リリース・自動化担当者:Mac上のビルド工程に撮影を加え、失敗を見逃さず納品したい方。

01 個人開発者が決める撮影範囲

撮影を始める前に、何を納品すれば完了なのかを決めます。対象言語、見せたい画面、必要な端末表示を一覧にしてください。ここが曖昧なまま設定すると、画像は生成されても「何が足りないか」を判断できません。

fastlaneのsnapshotでは、言語やシミュレーターの対象を設定できます。設定方法や項目の現在の説明は、snapshotのアクションリファレンスで確認してください。必要な組み合わせ数は、あなたが選んだ言語と端末の範囲から算出します。設定上の予定数を、実際に生成された画像数として扱わないでください。

選択肢 適する状況 検収時に見る点
代表画面を絞って撮影 変更箇所や特定のローカライズを確認したい 対象画面が漏れていないか
言語と端末を広く指定 ストア素材をまとめて更新したい 予定した全組み合わせに画像があるか
手作業で追加撮影 自動化しにくい画面や例外的な表示がある 自動生成分と手動分の区別、版の一致

スクリーンショットで伝える機能と、今回のアプリのバージョンも記録します。後から同じ画像を再確認できるよう、撮影設定と出力先を成果物にひもづけてください。

02 多言語担当者が見る画面の実内容

画像のファイル名は、画面内の言語が正しいことを証明しません。各画像を開き、翻訳漏れ、フォールバック言語、途中で切れた文言、仮テキストが残っていないかを見ます。アプリ内の文言だけでなく、日付や地域によって変化する表示も確認対象です。

確認項目 合格の判断 不合格時の切り分け
画面内の文言 対象言語で自然に表示され、未翻訳文言がない ロケール設定と翻訳リソースを確認
日付・地域表示 指定した言語・地域に対応している 言語設定と地域設定を分けて確認
画面の状態 実際の機能が見え、読み込み中やエラーで隠れていない テストデータ、ログイン状態、待機条件を確認
画面間の整合性 同じアプリ版の画面として統一されている ビルドと撮影時の設定を照合

アプリのローカライズの考え方は、AppleのLocalization資料も参照できます。同じ画面を複数言語で並べて比べると、文言の長さによるレイアウト崩れや、画面ごとに異なる翻訳の混在を見つけやすくなります。

03 端末カバレッジと提出先の照合

撮影に指定したシミュレーターと、App Store Connectで素材を提出する対象は、同じものとして扱わないでください。Appleのスクリーンショット仕様は、提出先で求められる画像条件を定めています。対象の表示枠や仕様は更新される可能性があるため、固定の端末一覧を流用せず、Appleの最新スクリーンショット仕様を確認します。

比較軸 fastlane snapshotの撮影対象 App Store Connectの提出対象
目的 シミュレーターから画像を取得する ストア上の表示素材を管理する
確認するもの 設定したシミュレーター、向き、出力ファイル 現行仕様、言語、端末の表示枠
合格の証拠 対応する画像と撮影結果がある 素材が正しい場所にアップロードされ、意図どおり表示される

iOSシミュレーターのスクリーンショットは、提出素材の候補にはなります。しかし、取得できたことだけで提出要件への適合やアップロード完了が確認できるわけではありません。向きや画像形式、内容を確認したうえで、提出先の条件と照合してください。

04 自動化担当者が追う処理結果

タスクの終了表示だけを見て、すべての撮影に成功したと判断しないでください。テスト結果、実行ログ、出力ディレクトリを確認し、想定した組み合わせごとにファイルがそろっているかを照合します。失敗した組み合わせがあっても、別の組み合わせの処理が続く場合があります。

観測結果 判断 次の操作
ログに失敗があり、画像もない 撮影未完了 失敗した言語・端末の条件とログを調査
実行は終了したが、予定より画像が少ない 成果物不足 設定、出力先、組み合わせごとの結果を確認
画像はあるが内容が不正 内容不合格 ロケール、テスト状態、画面遷移を確認
画像とログがそろっている 次の検収へ進む 画面内容と提出先での表示を確認

処理を止める条件やエラー時の扱いは、使用中の設定とfastlaneの説明を照らして確認します。出力先が以前の実行結果を含む場合は、今回の実行で作られたファイルかどうかも区別してください。古い画像が残っていると、新しい撮影が成功したように見えることがあります。

注意:ファイルが存在すること、画像の内容が正しいこと、App Store Connectに表示されること、審査で受け入れられることは、それぞれ別の確認項目です。

05 素材レビュー担当者が確認する品質

画像ごとに、実際のアプリ機能が見える状態かを確認します。ログイン画面、読み込み表示、エラー、仮データが主要な機能を覆っている場合は、ファイルが正常に作られていても素材として差し戻します。形式や透明部分などの画像ファイル上の問題も、画面内容とは分けて点検してください。

Appleのスクリーンショットに関する審査ガイドラインでは、スクリーンショットがアプリの内容を正確に示すことが求められます。自動取得に成功した状態と、素材がガイドラインに沿う状態、審査結果を混同しないでください。最終判断は、提出する画像と該当するAppleの要件を照合して行います。

06 リリース担当者が確認するアップロード後の表示

アップロード後は、App Store Connectで言語、表示先、並び順、実際の見え方を確認します。選んだ画像が今回のアプリ版と製品ページに合っているかも見直してください。Appleのアップロードとローカライズ素材の管理手順に沿って、提出先で状態を確認します。

撮影設定、生成ファイル、アップロード後の画面を、後から追える形で保管します。シミュレーターの出力だけでは、アップロード成功も審査通過も証明できません。必要に応じて、スクリーンショット生成とApp Store Connect上の確認を別々の工程として記録してください。

07 よくある確認事項

fastlane snapshotで言語ごとの画像を生成する流れ

対象言語と撮影画面を決め、fastlaneのsnapshot設定で言語とシミュレーターを指定します。実行後はファイル名だけで判定せず、各画像に表示された文言と地域表示を確認します。設定項目の詳細は、利用しているfastlaneの公式リファレンスで確認してください。

実行が成功したのに画像が不足する場合

タスクの終了状態と、成果物の完成状態を分けて調べます。予定した言語・端末の組み合わせを一覧にして、ログ、テスト結果、出力ディレクトリを照合してください。過去の実行画像が残っていると不足を見落とすため、今回の実行で生成されたファイルかも確認します。

画像の言語と端末を対応づける方法

ファイル名やフォルダー構成を確認した後、画像内の文言、日付、地域表示を実際に見ます。さらに、撮影に使ったシミュレーターや向きと出力画像を対応づけてください。ファイル名だけを根拠にすると、別言語や別端末の画像を誤って採用するおそれがあります。

シミュレーター画像をそのままストアに使えるか

撮影済み画像は提出候補ですが、提出要件を満たすかは別途確認が必要です。Appleの現在の仕様と内容ガイドラインを照合し、App Store Connectへのアップロード後に言語、表示先、並び順を確認してください。画像の生成は、アップロードや審査の完了を示すものではありません。

08 Mac環境を使う判断と次の確認

手元の環境だけで続ける場合、Macが使えない開発環境ではXcodeやiOSシミュレーターを動かせず、撮影工程が止まります。ローカルのMacに集約する方法もありますが、ストレージや常時稼働の維持が負担になり、撮影と日常作業が同じマシンを取り合うことがあります。まずは利用条件を含むCALMVPSの料金情報を確認し、必要な期間と作業内容に合うか比較してください。

一度だけの撮影で、すでに手元に適切なMacがあるなら、レンタルは不要です。継続的に重い処理を回す場合や、物理デバイス接続が必要な場合も、専用の実機を含む別の構成が適します。一方、Xcodeとシミュレーターを使う一時的な検証や、常駐Macを持たずに撮影環境を用意したい場合は、CALMVPSのMac利用プランを候補にし、ツール、シミュレーター、ファイル受け渡しが自分の検収手順に合うか確認してから選んでください。