先把每個預期的語言與裝置組合、實際畫面、輸出檔案和 App Store Connect 展示逐項核對;fastlane snapshot 任務結束,不等於素材已合格。若你要更新多語言商店截圖,請把生成、檔案檢查、內容驗收和上傳後確認分成不同關卡。
適合準備產生或更新 iOS App Store 截圖的獨立開發者,避免手動採集漏項。
也適合維護多語言產品頁、要確認各語言與裝置產物的人。
若你負責 Mac 自動化或發布流程,本文的檢查項目可用來避免把部分失敗當成完整交付。
01 先固定交付範圍,再設定 fastlane snapshot
開跑前先寫清楚「要交付什麼」,不要先執行工具,再從輸出資料夾猜自己原本想收哪些素材。
對每個目標語言,列出產品頁需要呈現的功能畫面、應使用的語言設定,以及本次要提交的裝置展示位置。像是首頁、核心操作流程或付費畫面,應依你的產品功能選定;不要把仍在載入、未登入或含測試資料的畫面當成正式素材。
接著將範圍對應到 fastlane snapshot 的設定。fastlane 文件提供以語言與模擬器裝置等條件執行截圖工作的方式;參數文件亦列出 languages、devices、scheme、output_directory 等設定項目。請以目前採用的 fastlane 文件核對選項與格式,不要沿用其他專案的舊設定。fastlane 截圖入門文件及 snapshot 參數說明可供核對。
留一份「預期語言 × 裝置 × 畫面」清單作為驗收基準。這是工作範圍,不是保證一定會輸出的檔案數量;測試失敗、畫面未到達或設定錯誤,都可能令實際產物不完整。
02 多語言維護者:逐張驗證畫面內容
檔名有語言代碼,只能幫你分類,不能證明畫面已切到該語言。抽查每種語言的代表性畫面,直接看 App 內的字串、日期、數字格式與地區顯示。
- [ ] 畫面中的主要文案符合目標語言,沒有回退到預設語言。
- [ ] 按鈕、導覽列、錯誤提示與功能名稱都已本地化,不只首頁標題正確。
- [ ] 長字串沒有被裁切、遮住或擠出螢幕;不同語言的版面也可讀。
- [ ] 日期及地區格式符合預期,畫面沒有殘留佔位文字、測試帳號或除錯資訊。
- [ ] 同一版本 App 的代表性畫面能對照各語言,避免拿不同建置版本混在一起驗收。
遇到部分文字未翻譯,先確認 App 的本地化資源與執行時語言,再查測試是否真的按目標語言啟動。Apple 的本地化說明可協助你核對本地化概念;但截圖是否符合產品頁用途,仍須檢查實際圖像。
03 裝置負責人:把模擬器目標和商店要求分開核對
fastlane 設定的模擬器目標,描述的是自動化要在哪些模擬器環境執行;App Store Connect 接受哪些截圖尺寸,則由 Apple 的素材規格決定。兩者不是同一份清單。
在交付前,依本次商品頁要使用的裝置位置,到 Apple 的截圖規格說明確認目前適用的尺寸要求。再檢查實際圖檔的像素尺寸與方向,不要僅因模擬器名稱相似,就推定輸出圖檔符合上傳條件。
| 驗收選項 | 你要核對的資料 | 可通過的條件 | 不符合時的處理 |
|---|---|---|---|
| 語言範圍 | fastlane 設定與畫面文案 | 預期語言都有產物,畫面內容相符 | 檢查語言設定、本地化資源及測試啟動狀態 |
| 模擬器目標 | 裝置設定、方向及輸出尺寸 | 圖檔符合本次商店位置的規格 | 重新核對 Apple 當前規格,再調整採集目標 |
| 任務結果 | 測試結果、執行記錄、輸出目錄 | 預期組合均有檔案,且無失敗漏報 | 找出失敗組合,不要把整體結束當成全數成功 |
| 素材內容 | 實際畫面、圖像格式與可讀性 | 展示 App 的真實功能,無錯誤或載入遮蔽 | 修正測試流程或素材後重新產生 |
| 商店展示 | App Store Connect 的語言、位置及排序 | 上傳素材與本次版本、產品頁相符 | 在商店後台重新確認所選素材與呈現 |
表格中的判定要分開執行:尺寸符合,不代表內容正確;檔案存在,也不代表已放到正確的商店語言或裝置位置。Apple 會依當前規格管理可接受的截圖尺寸,因此不要把舊文章列出的固定尺寸表當成永久規則。
04 自動化負責人:排除任務成功但產物缺漏
執行 fastlane snapshot 後,先看測試結果與記錄,再看輸出目錄。不要只看終端機最後一行或整個工作流程是否結束。官方文件說明了 snapshot 的採集方式及設定;你仍要依自己的工作流程確認錯誤是否會停止任務,以及部分組合失敗時是否留下明確結果。snapshot 文件應和實際執行記錄一起檢查。
- [ ] 將預期的語言與裝置組合逐項對照輸出目錄。
- [ ] 確認每個預期組合都有圖檔;缺檔時追查測試、啟動流程及輸出路徑。
- [ ] 查看失敗測試與錯誤記錄,確認流程沒有在部分失敗後繼續產生看似完整的交付。
- [ ] 檢查圖檔能正常開啟,尺寸、方向及格式符合這次使用情境。
- [ ] 保留設定、測試結果和輸出資料的對照記錄,讓同事能重查這批素材從哪次工作流程產生。
如果檔案缺漏,先判斷是「沒有執行該組合」、「測試未走到截圖畫面」還是「產物寫到另一個目錄」。只重跑整個流程,卻不保留失敗組合與原因,容易讓同一問題在下一次發布時重現。
05 素材審核者:分清楚畫面真實與審核通過
逐張打開候選圖檔,確認畫面呈現的是 App 的實際使用狀態。主要功能不能被載入畫面、錯誤資料、登入頁或除錯提示遮住。也要確認文字清晰、版面沒有明顯截斷,且素材與當前產品功能一致。
Apple 的截圖指南說明商品頁截圖應呈現 App 的實際體驗。這與「工具能不能產生圖檔」是不同的驗收面向:自動化流程正常,不代表內容已符合商店素材要求;素材看起來合格,也不能單獨證明提交後一定通過審核。
06 發布負責人:在 App Store Connect 核對最終展示
上傳完成後,進入 App Store Connect 檢查截圖所在的語言、裝置展示位置與排序。確認選取的是本次版本和產品頁對應的素材,而不是目錄中另一語言或舊版本的檔案。Apple 的上傳與管理截圖說明可用來核對後台管理方式。
留存本次生成結果、檔案清單與商店後台展示的可複核記錄。模擬器中的 iOS App Store 截圖只證明你取得了圖檔;它不證明素材已成功上傳、被放在正確位置,或 App 已通過審核。這幾項狀態要分別確認。
07 常見問題
fastlane snapshot 怎樣產生不同語言的 iOS 截圖?
先設定預期語言、模擬器裝置及執行用的 scheme,再確認測試能切換至目標語言並抵達要截取的畫面。執行後按語言與裝置檢查輸出資料,不要以設定檔中的項目取代實際產物驗收。
任務顯示成功,輸出資料夾卻缺少截圖怎麼辦?
依序比對預期組合、測試結果、執行記錄和實際輸出路徑。確認是否有某項測試失敗、畫面沒有到達截圖步驟,或檔案被寫入另一個目錄。缺少產物的組合未查清前,不要把這批素材標記為完整。
怎樣確認自動生成的截圖語言與裝置正確?
直接檢視每種語言的文案、日期與地區顯示,再確認圖檔尺寸和方向符合本次商店提交位置。檔名可作索引,但不能代替畫面檢查;同一版本 App 的代表畫面有助於對照不同語言的實際呈現。
模擬器截圖可以直接放上 App Store 商品頁嗎?
不能只憑「從模擬器產生」就判定可用。你還要核對 Apple 當前的截圖規格、素材內容與商品頁位置;上傳後再確認 App Store Connect 的語言、裝置分類和排序。產圖、上傳與審核是不同狀態。
08 沒有常駐 Mac 時的執行選擇
若目前依賴個人 Mac 手動截圖,常見限制是工作站離線時無法執行、Xcode 與模擬器佔用本機硬碟,以及每次發布都要重新確認環境。Windows 或 Linux 主機也不能直接代替執行 Xcode 與 iOS 模擬器的 macOS 工作環境。
如果截圖任務只是偶爾執行,先比較本機、短期遠端 Mac 與自購設備的使用週期;若要反覆產生素材或把工作流程接入常駐建置環境,遠端 Mac 可讓你按需求使用 macOS,而不必專為截圖任務先購置一台 Mac。你可先查看 CALMVPS 的遠端 Mac 服務資訊,再按預期執行週期核對方案與費用。
若你需要固定高負載、長期穩定使用,或必須連接實體裝置與周邊,自購 Mac 可能更合適;若需要臨時補足 Xcode、iOS 模擬器與截圖流程,再評估租用遠端 Mac。無論選哪種環境,交付標準都相同:逐項確認語言、裝置、真實畫面、輸出檔案,以及 App Store Connect 的最終展示。