App Store Connect 輔助說明

App Store Connect / 管理建置版本 / 檢視建置版本和建置版本後設資料

管理建置版本

檢視建置版本和建置版本後設資料

你可以檢視你至今為 App 上傳的所有建置版本,以及各建置版本的後設資料。其中資訊包括 Apple 建立之變體的大小和建置版本的傳送進度。

注意:App 發佈之後,系統可能不會顯示某些建置版本。

瞭解如何使用 App Store Connect API 取得建置版本資訊(可能為英文網站)。

必要角色:帳號持有人、管理、App 管理或開發者。請參閱角色權限

檢視建置版本的後設資料

  1. 在「App」中,選取你要檢視的 App。

  2. 按一下「TestFlight」標籤頁來檢視所有建置版本。

  3. 在側邊欄中,選取你要檢視其建置版本後設資料的平台。

    注意:建置版本會依照版本編號來整理。若要查看你為每個版本上傳的建置版本,請按一下版本編號旁的收合三角形。若要檢視建置版本組別,請按一下建置版本編號。

  4. 若要檢視建置版本的後設資料,請展開版本編號區段,然後在表格的「建置版本」直欄中,選取 App 圖像或建置版本字串。

    此截圖呈現「TestFlight」標籤頁,其中「版本 1.0」下有一個建置版本列表。每個建置版本均具有可點按的圖像和建置版本字串。
  5. 在建置版本頁面中,按一下「建置版本後設資料」標籤頁。

    「建置版本後設資料」頁面會顯示建置版本的檔案大小(例如壓縮檔案大小、重要內容大小和 App 內其他內容大小),以及其他建置版本相關資訊。

檢視建置版本的檔案大小

在你將建置版本上傳至 App Store Connect 之後,建置版本會經過「App 瘦身」(App thinning)。這套程序會針對不同裝置與作業系統版本建立 App 變體。你可以直接在 App Store Connect 中檢視某個變體在客戶裝置上佔用的空間大小。

注意:你的 App 核准發佈之後,系統就會以數位版權管理(DRM)來加密 App 並重新壓縮 App。App 的二進位檔大小,可能會比你在 App Store Connect 中上傳的二進位檔更大。系統無法預先判斷 App 確切的最終檔案大小。

  1. 在「App」中,選取你要檢視的 App。

  2. 按一下「TestFlight」標籤頁來檢視所有建置版本。

  3. 在側邊欄中,選取你要檢視其建置版本的平台。

  4. 若要檢視建置版本的檔案大小,請展開版本編號區段,然後在表格的「建置版本」直欄中,選取 App 圖像或建置版本字串。

  5. 在建置版本頁面中,按一下「建置版本後設資料」標籤頁。

  6. 在「一般資訊」下,按一下「App Store 檔案大小」。

    此截圖中的表格顯示各種裝置類型的預估 App 檔案大小,包括下載和安裝大小。

    畫面上隨即顯示表格,列出不同變體的大小。

    • 裝置類型是變體的目標裝置。通用裝置代表可在所有支援的作業系統和目標裝置上執行的變體,這類變體會傳送給執行 iOS 8 和較早版本的客戶、透過「Apple 校務管理」和「Apple 商務管理」或行動裝置管理(MDM)來大量購買的 App 的客戶,或傳送給使用 iTunes 12.6 及較早版本下載 App 的客戶。

    • 安裝大小是 App 在客戶裝置上佔用的磁碟空間。安裝大小也會顯示於 App 產品頁面的「資訊」區段中。

    • 下載大小是指透過空中傳輸方式(使用行動數據頻寬或 Wi-Fi)下載的壓縮後 App 大小。

如果有任何裝置變體的大小超過 200 MB 的空中傳輸下載限制,則「建置版本」表內的建置版本字串以及「App 檔案大小」表內的變體大小旁,都會出現黃色警告圖像。按一下警告圖像以閱讀完整的警告內容。Apple 也會向你發送包含此項資訊的電子郵件。

檢視建置版本的上傳狀態

在 App Store Connect 的「建置版本上傳」區段下,你可以檢視建置版本的版本與建置版本編號、上傳狀態以及建立日期。上傳狀態提供警告、錯誤和其他資訊等詳情,可讓你充分瞭解傳送進度。

如果建置版本的上傳狀態不明,請透過 Feedback Assistant(使用者意見程式)提交工作單(選取「Developer Tools & Resources」(開發者工具和資源)> TestFlight),或聯絡我們。請務必在你的問題報告中納入版本與建置版本編號、上傳日期和時間、相關記錄等詳細資訊。

  1. 在「App」中,選取你要檢視的 App。

  2. 按一下「TestFlight」標籤頁來檢視所有建置版本。

  3. 在側邊欄中,選取你要檢視其建置版本的平台。

  4. 若要檢視建置版本的傳送進度,請展開「建置版本上傳」,然後查看「狀態」直欄中的狀態。

    秘訣:使用「建置版本上傳」表格右上方的「所有狀態」下拉式選單,即可依照狀態篩選。

  5. 選取狀態以檢視任何錯誤、警告或資訊的詳情。如果建置版本的狀態為「失敗」,請先解決所有問題,再重新上傳。

    注意:

    • 只要建置版本為「完成」狀態,你就可以選取「建置版本」直欄中的建置版本字串,或按一下「完成」,藉此存取更多詳細資訊(包含後設資料)。

    • 即使狀態為「完成」,仍可能會出現警告或其他詳細資訊,你應該加以檢視,並在下次上傳前解決問題。

    • 如果你上傳的建置版本處於「處理中」狀態超過 24 小時,代表可能發生問題。若要解決問題,請透過 Feedback Assistant(使用者意見程式)提交工作單,或聯絡我們

下表提供各建置版本上傳狀態的詳細資訊。

狀態

說明

正在等待上傳

建置版本的傳送作業已啟動,Apple 正在等待你上傳建置版本。

處理中

建置版本的上傳作業仍在處理中。當建置版本處理完畢後,你會收到電子郵件通知,且「建置版本上傳」下的表格會顯示更新後的狀態。

如果你上傳的建置版本處於「處理中」狀態超過 24 小時,代表可能發生問題。若要解決問題,請透過 Feedback Assistant(使用者意見程式)提交工作單,或聯絡我們

失敗

建置版本已處理完畢,但發生問題。請選取建置版本以檢視潛在的錯誤、警告以及失敗的相關資訊。請務必解決所有錯誤,再重新上傳建置版本。

注意:如果建置版本上傳失敗,你可以在下次上傳時重複使用同一建置版本編號。

完成

建置版本的上傳作業已處理成功,現在可以進行測試。

注意:如果此狀態旁出現警告標記,請在下次上傳之前,先檢視可能的警告或其他資訊。

注意:除了 App Store Connect 中的狀態會適時更新之外,你也會在建置版本變成「處理中」、「失敗」或「完成」時收到電子郵件通知。

檢視建置版本的裝置需求

Apple 使用你的建置版本設定來計算裝置在執行你的 App 時所需的最低作業系統版本。你可以在「建置版本後設資料」頁面驗證建置版本的裝置需求。

此截圖呈現「iOS 建置版本」頁面上的「裝置需求」區段,其中包含 iOS、macOS 和 visionOS 的最低版本、LS 最低系統版本、支援的架構、裝置通訊協定、裝置系列,以及配備需求。
  • 「最低 iOS 版本」是你在建置版本中提供的 MinimumOSVersion

  • 「最低 macOS 版本」是裝置在執行你的 App 時所需的最低 macOS 版本,由 App Store 判定。

    Apple 使用你在建置版本中提供的 LSMinimumSystemVersion(如果適用)以及與 MinimumOSVersion 最相關的 macOS 版本,自動計算最低 macOS 版本。如果你曾在定價與供應狀況區段中選取最低 macOS 版本,且該值高於 LSMinimumSystemVersion 或與 MinimumOSVersion 最相關的 macOS 版本,則系統會改爲顯示你選取的版本。

  • 「LS 最低系統版本」是你在建置版本中自由提供的 LSMinimumSystemVersion

下載 dSYM 檔案

如果你上傳到 App Store Connect 的 App 包含了 Bitcode,Apple 會產生偵錯符號(dSYM)檔案。你必須先從 Xcode 或 App Store Connect 下載這個檔案,才能在 Xcode 中檢視記錄。

注意:自 Xcode 14 起,我們不再要求 tvOS 或 watchOS App 須提供 Bitcode,且 Apple 不再接受從 Xcode 14 提交 Bitcode。你僅能下載現有 Bitcode 提交項目的 dSYM 檔案;從 Xcode 14 或以上版本提交的項目將不再提供 dSYM 檔案。

瞭解如何使用 dSYM 檔案來分析當機報告(可能為英文網站)。

若要從 App Store Connect 下載某一建置版本的 dSYM 檔案:

  1. 在「App」中,選取你要檢視的 App。

  2. 按一下「TestFlight」標籤頁來檢視所有建置版本。

  3. 在側邊欄中,選取你要檢視其建置版本後設資料的平台。

    注意:建置版本會依照版本編號來整理。若要查看你為每個版本上傳的建置版本,請按一下「版本」標籤頁,然後展開版本編號旁的收合三角形。若要檢視建置版本組別,請按一下「建置版本組別」標籤頁。

  4. 若要檢視建置版本的 dSYM 檔案,請展開版本編號區段,然後在表格的「建置版本」直欄中,選取 App 圖像或建置版本字串。

    此截圖呈現「TestFlight」標籤頁,其中「版本 1.0」下有一個建置版本列表。每個建置版本均具有可點按的圖像和建置版本字串。
  5. 在建置版本頁面中,按一下「建置版本後設資料」標籤頁。

  6. 在「一般資訊」下,按「下載 dSYM」。

    此截圖呈現 iOS「建置版本後設資料」頁面的「一般資訊」區段,其中標示了藍色箭頭圖案,指向「包含符號」之下的「下載 dSYM」連結。