fastlane snapshot 多語言截圖怎麼自動驗收?2026 清單

先把每個預期的語言與裝置組合、實際畫面、輸出檔案和 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 的最終展示。