App Store Connect 輔助說明

支援 / App Store Connect / 管理建置版本 / 上傳建置版本

管理建置版本

上傳建置版本

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

帳號中加入 App 後,你就可以使用 Xcode、Swift Playground、altool 或 Transporter 上傳建置版本。如果使用 App Store Connect API,建議你透過 Transporter 命令列工具和 JSON Web Token(JWT)進行認證以上傳二進位檔。你用於 API 的相同 JWT 也可以用來上傳二進位檔。當你的 App 有所變更時,你可以上傳更多建置版本、分發建置版本以供測試,或提交你的 App 以供審查

第一次上傳建置版本時,系統會在你的帳號中建立 App 的 Beta 版本。不過,建置版本需要先經過 Apple 系統處理,才會在 App Store Connect 中顯示。你會在此程序完成時收到電子郵件。

每一次你上傳建置版本時,系統會使用位於 App 套件中的套件識別碼和版本編號,來與 App Store Connect 中的 App 與版本記錄建立關聯。建置版本字串不會重複,其作用是在整個系統中識別特定建置版本。

你也可以使用 Xcode Cloud 建立和上傳建置版本。Xcode Cloud 可讓你採用「持續整合和持續發布」(CI/CD)這種標準做法,有助你持續監控並改善軟體品質,確保你的 App 或架構一直處於可發布的狀態。進一步瞭解 Xcode Cloud(可能為英文網站)

你也可以選擇使用 Apple 託管式背景素材架構來上傳素材。素材會與建置版本分開管理。進一步瞭解

瞭解即將推出的上傳要求。

使用 Xcode 來上傳你的 App 的二進位檔案

Xcode 是 Apple 的整合式開發環境(IDE)。你能使用 Xcode 來打造 iPhone、iPad、Mac、Apple TV、Apple Vision Pro 和 Apple Watch 等 Apple 產品所適用的 App。Xcode 提供的工具能管理你整個開發流程,從 App 建立、測試、最佳化,直到提交至審查團隊。

若要瞭解如何使用 Xcode 來上傳 App 的二進位檔,請參閱 Distributing your app for beta testing and releases(發佈你的 App 以進行 Beta 測試和發佈),或在 Xcode 中選擇「Help > Xcode Help」(輔助說明 > Xcode 輔助說明)並搜尋「Distributing your app for beta testing and releases」。

在 Mac App Store 下載 Xcode

支援的 Xcode 版本

App Store Connect 支援下列 Xcode 版本來上傳你的 App,讓你可以將 App 發佈給客戶,或使用 TestFlight 分發給測試人員。你還可以查看傳送進度(包括警告、錯誤和傳送記錄)以及先前的傳送歷史記錄。

注意:從 2026 年開始,你必須使用 Xcode 14 或以上版本來上傳 App 至 App Store Connect。

目標類型

建置時使用的 Xcode 版本

上傳時使用的 Xcode 版本

iOS App

iOS App 延伸功能

watchOS App 延伸功能

Xcode 16 或以上版本

Xcode 6 或以上版本

macOS App

Xcode 6 或以上版本

Xcode 6 或以上版本

tvOS App

Xcode 16 或以上版本

Xcode 7.1 或以上版本

visionOS App

Xcode 16 或以上版本

Xcode 12 或以上版本

Transporter 和 altool 支援所有目標類型的上傳作業。

使用 altool 來上傳你的 App 的二進位檔案

你可以使用 Xcode 內附的 xcrun 來叫用 altool。這個命令列工具能讓你進行驗證並上傳你的 App 二進位檔案到 App Store Connect。請在「終端機」的命令列中指定下列指令之一:

$ xcrun altool --validate-app -f file -t platform -u username [-p password] [--output-format xml]
$ xcrun altool --upload-app -f file -t platform -u username [-p password] [--output-format xml]

進一步瞭解如何使用 altool。

使用 Transporter 來上傳你的 App 的二進位檔案

Transporter 是款 macOS App,提供簡單而輕鬆的方式,讓你將 App 上傳到 App Store Connect 以供發佈。你還可以查看傳送進度(包括警告、錯誤和傳送記錄)以及先前的傳送歷史記錄。

注意:自 2026 年開始,若要繼續使用 Aspera 和 Signiant 傳輸通訊協定來上傳 App,你必須使用將於今年稍晚發佈的 Transporter 版本。若使用預設的 HTTPS 傳輸通訊協定上傳,則不受影響。

你可以在 Mac App Store 下載最新版本的 Transporter。

如需詳細資訊,請參閱《Transporter 輔助說明》。