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 也會向你發送包含此項資訊的電子郵件。

檢視建置版本的裝置需求

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. 若要檢視建置版本的後設資料,請按一下「建置版本」直欄中出現的 App 圖像或建置版本字串。

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

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

    在 iOS 建置版本後設資料頁面的「一般資訊」區段會顯示一個指標影像,指向「包含符號」之下的「下載 dSYM」連結。