View in English

管理建置版本

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

你可以檢視你為 App 上傳的所有建置版本，以及各建置版本的後設資料，包括 Apple 建立之變體的大小。App 發佈之後，系統可能不會顯示某些建置版本。

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

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

檢視建置版本的後設資料

  1. 在「App」中，選取你的 App。

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

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

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

  4. 若要檢視建置版本的後設資料，請按一下「建置版本」直欄中出現的 App 圖像或建置版本字串。

    「iOS 建置版本」頁面上的「版本」區段。

  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 檔案大小」。

    「iOS 建置版本後設資料」頁面上的預計 App 檔案大小表。

    畫面上會出現顯示不同變體大小的表格。

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

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

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

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

檢視建置版本的裝置需求

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

「iOS 建置版本」頁面中的「裝置需求」區段。

  • 最低 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 圖像或建置版本字串。

    「iOS 建置版本」頁面上的「版本」區段。

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

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

    「iOS 建置版本後設資料」頁面中的「一般資訊」區段。圖中箭頭指向「下載 dSYM」的連結。
也請參閱 上傳建置版本 選擇要提交的建置版本 Reducing your app’s size（減少 App 大小） 最大建置版本檔案大小 設定是否在採用 Apple 晶片的 Mac 上供應 iPhone 和 iPad App Download debug symbols（下載除錯符號）