Unity 6.6 已輸出 iOS 用 Xcode 專案,但你沒有本地 Mac 可完成簽名和封存。
最快做法:本週先確認 Unity 輸出與發佈目標,再安全同步完整專案到遠端 Mac,由 Xcode 建置、簽名及封存;封存完成後仍須驗證上傳狀態,不能直接當成已上架。
這篇適合在 Windows 或 Linux 上使用 Unity 6.6、需要準備 iOS 發佈建置的個人開發者。
如果你已經匯出 Xcode 專案,或正要把手動建置接到小團隊的遠端 Mac 流程,可以按以下時間線逐段檢查。
先釐清 Unity 輸出與 Xcode 封存的分工
Unity 的 iOS 流程要分成兩段看:先由 Unity 產生 Xcode 專案,再由 Xcode 執行後續建置、簽名和封存。Unity 官方的 iOS 建置與交付流程說明了這個流程分工;官方環境設定文件亦指出,完成 iOS 建置所需的本地 Xcode 步驟需要 macOS。
Unity 官方文件以 6000.6 標示 Unity 6.6 的版本文件。這個版本資訊並不能證明你的 Xcode、原生插件或簽名設定一定相容;你仍須依目標專案實際使用的版本和依賴逐項核對。Unity 6.6 iOS 環境設定文件可作為起點。
你需要特別分清以下幾種容易混在一起的問題:
- 輸出不等於封存:Unity 產生 Xcode 專案,只代表完成匯出階段;Xcode 是否能編譯、簽名及產生 archive,要另行確認。
- 工程檔不等於完整專案:只複製工程檔,可能漏掉資源、原生程式碼、外掛或建置所需設定。
- 開發簽名不等於發佈設定:簽名身分、佈建描述檔、應用程式識別碼和 entitlements 要符合當前建置用途。
- 封存不等於平台接收:Xcode Organizer 顯示封存,不代表 App Store Connect 已完成處理,更不代表審核通過。
第一步:在匯出前鎖定目標與專案需求
在 Unity 開始匯出前,先記下這次要準備的發佈目標、Bundle Identifier、建置類型,以及專案是否包含原生插件或自訂建置腳本。稍後在 Xcode 核對時,這份記錄可以協助你發現 Unity 專案設定和 Xcode target 不一致的地方。
接著在 Unity 的 iOS 建置設定中檢查輸出內容和必要選項。Unity 的 iOS 建置設定參考列出該版本相關設定;不同版本或專案設定可能改變可見選項,請以你實際使用的編輯器畫面及文件為準,不要依照其他版本的教學猜選單名稱。
若有 Swift、Objective-C 或其他原生擴充,先辨認它們在 Xcode 專案中的位置與依賴關係。Unity 的 Xcode 專案結構說明可協助你理解匯出後的專案構成;外掛本身的設定則應查閱其官方文件,或在目標專案中實際重現。
第二步:同步完整副本,保護簽名材料
把整份 Xcode 專案同步到遠端 Mac,而不是只傳送 .xcodeproj 或其中一個工程檔。依專案實際情況,保留建置所需的資源、原生程式碼、設定檔與外掛;若使用 Pods 或自訂腳本,也要確認遠端環境有重現它們所需的檔案與步驟。
使用版本控制時,先確認送出的提交版本,並確保忽略規則沒有漏掉必要依賴。透過安全檔案傳輸時,則要核對傳輸後的檔案完整性和工作目錄,避免在不同副本上分別修改而無法追蹤差異。
注意:簽名憑證的私密金鑰不是一般專案檔案,不要提交到程式碼儲存庫,也不要貼進建置日誌或支援訊息。Apple 說明了憑證類型及保護要求;傳送或安裝簽名材料時,應採用你能控管權限的安全方式。
若對遠端操作或資料處理有疑問,可先查看 VPSOmni 的使用入門說明及資料隱私資訊,再決定如何同步專案與管理憑證。
第三步:在遠端 Mac 核對 Xcode 與原生依賴
登入遠端 Mac 後,先確認工作目錄、Xcode 專案和同步來源符合預期,再檢查實際使用的 Xcode 及專案 targets。不要只因專案能開啟,就推斷所有插件或自訂腳本都已準備妥當。
你可以先用命令列檢視工程中的 schemes 和 targets:
xcodebuild -list -project YourGame.xcodeproj
以下是示意輸出,實際名稱以專案為準:
Information about project "YourGame":
Targets:
Unity-iPhone
Schemes:
Unity-iPhone
如果專案含有 Pods、原生插件或額外產生步驟,逐項依照插件文件處理,並記下首次解析或生成的結果。若出現錯誤,先確認問題是在檔案同步、依賴解析,還是 Xcode 專案本身;不要未查原因就反覆改簽名設定。
第四步:依用途核對 iOS 程式碼簽名
開始建置前,把 Unity 專案的 Bundle Identifier 與 Xcode target 的應用程式識別碼對起來,再檢查團隊、entitlements、簽名身分和佈建描述檔。Apple 的分發前 Xcode 專案設定說明可用來核對專案層級的分發設定;若使用開發用途的描述檔,則參考 Apple 的開發佈建描述檔建立指南確認其適用範圍。
Apple Developer 的程式碼簽名材料與 App Store Connect API 金鑰用途不同。前者與應用程式簽名相關,後者不能取代簽名憑證或佈建描述檔。檢查時不要在截圖或日誌中暴露私密金鑰、憑證內容或其他敏感資料。
你可以依以下條件選擇檢查路徑:
- 若只是要在目前專案中確認可編譯,先使用與該測試目的相符的建置設定,並核對必要的簽名資料;否則回到 Unity 專案與 Xcode target,比對識別碼及設定是否一致。
- 若目標是準備發佈用封存,先確認該次發佈所需的團隊、簽名身分、描述檔與 entitlements,再進入封存;若仍有欄位不明,先停止操作,查閱 Apple 文件或團隊既有發佈設定。
- 若建置依賴原生插件或自訂腳本,先在遠端 Mac 重現該依賴的必要步驟;否則先不要把問題歸因於簽名。
| 檢查項目 | 在哪裡核對 | 不一致時先做什麼 |
|---|---|---|
| Bundle Identifier/應用程式識別碼 | Unity 專案設定與 Xcode target | 先確認這次發佈使用的識別碼,再同步修正相關設定 |
| 團隊與簽名身分 | Xcode 專案簽名設定及可用憑證 | 確認你使用的團隊和簽名材料是否符合建置用途 |
| 佈建描述檔與 entitlements | Xcode target 與對應的 Apple Developer 設定 | 核對描述檔適用範圍及權利設定,不以 API 金鑰代替 |
| 插件、Pods、自訂腳本 | 專案依賴與其官方文件 | 先重現依賴步驟,再判斷是否進入建置 |
第五步:先建置,再封存並留存證據
簽名設定核對後,先執行一次符合目前目標的代表性建置。如果編譯失敗,按階段回查:Unity 匯出結果、原生依賴、Xcode 編譯訊息、簽名設定。只有錯誤確實指向簽名時,才集中排查簽名材料,避免在錯誤階段來回修改造成新的問題。
建置通過後,使用 Xcode 的封存流程產生 archive,再透過 Organizer 檢查封存內容。Apple 的Xcode 封存與分發流程文件說明封存及後續分發的操作脈絡。每次操作都建議留存提交版本、建置設定和關鍵錯誤訊息,讓你或團隊成員能追溯這次封存是由哪份專案產生。
封存成功只代表 Xcode 完成該階段,不要把它寫成 App Store Connect 已接收。若你在這個階段遇到簽名錯誤,請先依錯誤訊息和操作階段定位,並使用不含敏感資料的紀錄協助排查。
上傳前:逐項驗證,不把封存當成完成
準備繼續上傳前,先在 Organizer 檢查 archive,並依發佈目標執行適用的驗證。接著確認版本號、建置編號、應用程式識別碼與簽名資訊都對應到這次發佈任務;任何一項仍不確定,都應先停止上傳並查清楚,而不是靠後續平台處理來猜測原因。
如果你選擇上傳,再到 App Store Connect 查看建置處理狀態。Apple 的建置檔與中繼資料檢視說明可協助你確認平台上的建置資料。上傳後仍須區分「已送出」、「處理中」及可供後續操作等狀態;它們不是同一件事,也不能直接代表審核結果。
常見問題
Unity 6.6 匯出的 iOS Xcode 專案,要怎麼傳到遠端 Mac?
同步完整 Xcode 專案及其實際建置依賴,再於遠端 Mac 確認工作副本和來源提交一致。不要只複製工程檔,也不要把簽名私密金鑰提交到儲存庫。使用版本控制或安全檔案傳輸後,先檢查檔案和依賴,再開始建置。
Unity 產生 Xcode 專案後,怎樣在 Mac 上完成 iOS 封存?
先確認 Xcode、targets、原生依賴和簽名設定,再執行代表性建置。建置通過後使用 Xcode 封存流程產生 archive,並在 Organizer 檢查。Unity 匯出完成不代表 Xcode 已完成封存;封存後也要另行驗證上傳前的發佈資訊。
遠端 Mac 建置 Unity iOS 專案,要檢查哪些簽名設定?
先對照 Unity 與 Xcode 的應用程式識別碼,再核對團隊、entitlements、簽名身分和佈建描述檔是否符合目前用途。不要以 App Store Connect API 金鑰代替程式碼簽名材料,也不要在日誌或共用檔案中暴露私密金鑰。
Unity iOS 封存完成後,怎麼確認可以上傳 App Store Connect?
先在 Organizer 檢查 archive 和適用的驗證結果,再核對版本、建置編號與簽名資訊。上傳後還須到 App Store Connect 確認建置處理狀態。封存成功、完成上傳和通過審核是不同階段,不能互相代替。
若你目前以 Windows 或 Linux 開發,自己補上一台常駐 Mac 會帶來硬體採購、閒置成本和維護責任;只靠手動傳檔,也容易讓遠端副本與本機版本脫節。若你的需求是階段性完成 Xcode 建置、簽名和封存,遠端租用 Mac 可讓你按專案安排 macOS 工作環境,不必為短期發佈先購置實機。開始前,先對照 VPSOmni 的遠端 Mac 使用資訊,確認服務交付方式符合你的 Unity 專案、Xcode 工具鏈與簽名管理要求;若工作負載長期固定或需要實體介面,則應把自購設備一併納入評估。
常見問題
Unity 6.6 匯出的 iOS Xcode 專案要怎麼同步到遠端 Mac?
同步整份 Xcode 專案及它實際依賴的資源、原生程式碼與設定,不要只傳送單一工程檔。你可用版本控制或安全檔案傳輸建立一致的工作副本,再在遠端 Mac 核對提交版本與檔案狀態。簽名憑證的私密金鑰不要放進程式碼儲存庫。
Unity 產生 Xcode 專案後,如何在 Mac 上完成 iOS 封存?
先在遠端 Mac 確認 Xcode 版本、專案 target、原生依賴和必要的解析步驟,再確認簽名設定一致。完成代表性建置後,使用 Xcode 的封存流程產生可檢查的 archive,並在 Organizer 查看封存內容。Unity 匯出成功本身不等於 Xcode 已完成建置或封存。
遠端 Mac 建置 Unity iOS 專案前,要核對哪些簽名設定?
比對 Unity 專案的 Bundle Identifier、Xcode target 的應用程式識別碼、團隊、entitlements 與目前使用的簽名身分及佈建描述檔。依發佈目的確認所用設定,不要把 App Store Connect API 金鑰當成程式碼簽名憑證;私密金鑰也不應出現在範例、日誌或共用儲存庫。
Unity iOS 專案封存後,怎麼確認可以上傳 App Store Connect?
先在 Xcode Organizer 檢查封存並執行適用的驗證,再確認版本、建置編號與簽名資料符合本次發佈目標。若選擇上傳,之後還要到 App Store Connect 查看建置處理狀態;本機封存或驗證完成,都不能單獨證明平台已接收建置,更不代表審核通過。
