完成 Flash 應用開發並打包為 IPA 後，上傳至 App Store Connect（舊稱 iTunes Connect）是發布上架的關鍵步驟。本文詳細記錄從應用狀態確認、發布憑證更新、到 Application Loader 上傳的完整流程與避坑指南。

一、確認應用狀態：必須為「Waiting for Upload」

1. 登入 App Store Connect，進入「我的 App」選擇目標應用。
2. 查看左下角狀態標籤，只有顯示「Waiting for Upload」（等待上傳）時才能上傳 IPA。
3. 若狀態為其他（如「Prepare for Submission」、「Waiting for Review」等），需點擊「Activity」或「版本」頁面的「Binary Details」按鈕，將狀態重置為「Waiting for Upload」。

常見應用狀態對照表

狀態	含義	可否上傳
Waiting for Upload	等待上傳二進制文件	✅ 是
Waiting for Review	上傳成功，排隊審核中	❌ 否
In Review	正在審核	❌ 否
Developer Rejected	開發者自行撤回	需先在 Binary Details 改回 Waiting for Upload
Rejected / Approved	審核拒絕 / 通過	需建立新版本

二、更新發布用.mobileprovision 與 .p12 憑證（關鍵）

開發階段與發布階段必須使用不同的憑證組合。開發用 Development 憑證，發布必須用 Distribution 憑證。

1. 下載 AppleWWDRCA 根憑證（僅首次需操作）

1. 進入 Apple Developer → Certificates, Identifiers & Profiles → Certificates → Distribution。
2. 下載 AppleWWDRCA.cer（Apple Worldwide Developer Relations Certification Authority）。
3. 必須在 macOS 上雙擊安裝至 Keychain Access，為後續所有 Apple 簽發的憑證提供信任鏈。Windows 無法直接完成此步驟，建議借用 Mac 或使用雲端 Mac 服務（如 MacStadium、GitHub Actions macOS runner）。

2. 申請 Distribution 證書

1. 同頁面點擊「+」創建新憑證 → 選擇「App Store and Ad Hoc」→ Continue。
2. 上傳 CSR（Certificate Signing Request）文件：
   • macOS：鑰匙串 → 憑證助理 → 從憑證機構請求憑證 → 存入磁碟。
   • Windows：需安裝 OpenSSL，命令行生成私鑰與 CSR（見下文）。
3. 下載生成的 ios_distribution.cer，在 Mac 上雙擊安裝至 Keychain。

3. Windows 環境生成 CSR 與 .p12（OpenSSL 命令行）

:: 1. 安裝 OpenSSL (Win32/Win64) 並配置環境變數
:: 2. 以管理員身份運行 cmd，進入 OpenSSL\bin 目錄
:: 3. 生成私鑰
openssl genrsa -out mykey.key 2048

:: 4. 生成 CSR（修改 email、CN、C 為你的信息）
openssl req -new -key mykey.key -out CertificateSigningRequest.certSigningRequest -subj "/emailAddress=your@email.com, CN=Your Name, C=CN"

:: 5. 上傳 CSR 到 Apple Developer 下載 cer 後，轉換為 PEM
openssl x509 -in ios_distribution.cer -inform DER -out ios_distribution.pem -outform PEM

:: 6. 合成 .p12（需輸入匯出密碼，Flash 發布時需填入）
openssl pkcs12 -export -inkey mykey.key -in ios_distribution.pem -out ios_distribution.p12

4. 生成 Distribution Provisioning Profile

1. Apple Developer → Profiles → Distribution → 「+」創建新 Profile。
2. 類型選「App Store」，選擇對應 App ID、剛創建的 Distribution 證書、命名（如 AppStore_MyApp）。
3. 下載 .mobileprovision 文件。

5. Flash 發布設置應用新憑證

• 發布設置 → Deployment 標籤 → 選擇新下載的 .p12 與 .mobileprovision。
• 輸入 .p12 匯出時設定的密碼。
• 發布生成 IPA，此即為待上傳的 Binary。

三、使用 Transporter（或舊版 Application Loader）上傳 IPA

注意：Apple 已停止更新 Application Loader，現推薦使用 Transporter（Mac App Store 免費下載）或 Xcode 內建的「Organizer → Distribute App」。

Transporter 上傳步驟

1. 安裝 Transporter，使用 Apple ID 登入（需雙因子認證）。
2. 拖拽 IPA 文件到窗口，或點擊「+」選擇文件。
3. Transporter 會自動驗證簽名、權限、Bundle ID 一致性等。
4. 驗證通過後點擊「Deliver」（交付），等待上傳完成。
5. 上傳成功後，App Store Connect「活動」頁面會出現新構建版本，稍後可在「版本」頁選擇提交審核。

四、常見上傳失敗原因與解決

錯誤提示	核心原因	解決方案
Invalid Code Signing Entitlements	.mobileprovision 與 .p12 不匹配、或缺少 AppleWWDRCA 信任鏈	重新生成 Distribution 憑證組，確保 Mac Keychain 包含 WWDRCA
Bundle ID mismatch	IPA 的 Bundle ID 與 App Store Connect 記錄不一致	檢查 Flash 發布設置 General → App ID，必須與開發者後台完全一致
Missing Push Notification Entitlement	App ID 啟用了 Push 但 Provisioning Profile 未包含	重新編輯 Profile 勾選 Push，重新下載並發布
Icon dimensions incorrect	圖標尺寸/格式不符合規範	Flash 發布設置 Icons 標籤指定正確尺寸 PNG（1024x1024 為必填）
Transporter 驗證卡住/極慢	網絡/蘋果服務器問題	嘗試不同時段、切換網絡、或用 Xcode Organizer 上傳

五、上傳後的後續流程

1. App Store Connect → 「我的 App」→ 選擇版本 → 「構建版本」區域選擇剛上傳的 IPA。
2. 填寫「版本資訊」（更新說明）、確認「年齡分級」、「定價與供應」。
3. 點擊「提交審核」，等待 Apple 審核（通常 24-48 小時）。
4. 審核通過後，可選擇「手動發布」或「自動發布」上架。

總結檢查清單

• [ ] 應用狀態為 Waiting for Upload
• [ ] 使用 Distribution 而非 Development 憑證組
• [ ] Mac Keychain 已安裝 AppleWWDRCA 根憑證
• [ ] .p12 與 .mobileprovision 配對正確、密碼無誤
• [ ] Flash 發布設置 Icons 所有尺寸 PNG 就緒
• [ ] 使用 Transporter（或 Xcode）上傳驗證

完成上傳後，剩下的就是耐心等待審核結果。建議在開發階段就準備好發布憑證流程，避免上線前臨時踩坑延誤檔期。