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 15 或以上版本 |
Transporter 和 altool 支援所有目標類型的上傳作業。
使用 App Store Connect API 來上傳 App 的二進位檔
App Store Connect API 是一個 REST API,可自動化執行 App Store Connect 中的作業。
呼叫此 API 需要使用 JSON Web 代號(JWT)進行認證。請從貴組織的 App Store Connect 帳號取得金鑰來建立代號。瞭解如何建立 API 金鑰來簽署 JWT。
你可以使用 App Store Connect API 來上傳 App 的二進位檔。進一步瞭解。
使用 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]
使用 Transporter 來上傳 App 的二進位檔
Transporter 是款 macOS App,提供簡單而輕鬆的方式,讓你將 App 上傳到 App Store Connect 以供發佈。你還可以查看傳送進度(包括警告、錯誤和傳送記錄)以及先前的傳送歷史記錄。
注意:自 2026 年開始,若要繼續使用 Aspera 和 Signiant 傳輸通訊協定來上傳 App,你必須使用將於今年稍晚發佈的 Transporter 版本。若使用預設的 HTTPS 傳輸通訊協定上傳,則不受影響。
你可以在 Mac App Store 下載最新版本的 Transporter。