Unity 6.5 iOS 打包按鈕灰色怎麼辦?2026 新手修復

Unity 官方的 iOS 建置流程可拆成 兩個階段:先由 Unity 產生 Xcode 專案,再由 macOS 上的 Xcode 完成編譯、簽名與執行(Unity iOS 建置流程文件)。因此,遇到 Unity 6.5 iOS 打包按鈕灰色時,最快做法不是反覆重裝整個 Unity,而是先在 Unity Hub 確認同一版本已安裝 iOS Build Support,再建立並啟用 iOS Build Profile;若你使用 Windows,最多先輸出 Xcode 專案,最後建置、Simulator 測試與簽名仍要交給相容的 Mac 和 Xcode。

這篇排查指南適合哪些人

這篇內容適合第一次把 Unity 專案輸出成 iOS 應用程式的 Windows 學生,也適合已經使用 Mac、卻在 Build Profiles 找不到 iOS 或無法按下 Build 的新手。

如果課程快截止,你需要在「繼續修復本機」與「暫時使用遠端 Mac」之間作決定,下面會把每一種灰色狀態分開處理,而不是把所有問題都歸咎於 Unity。

先辨認灰色位置,再決定修復方向

「打包按鈕灰色」其實可能是四種不同故障。先看下表,避免下載錯誤模組或修改不相關設定。

你看到的現象 較可能的原因 第一個處理動作 階段性成功標準
Platform Browser 沒有 iOS 未安裝 iOS Build Support 在 Unity Hub 為目前編輯器補裝模組 重新開啟後能看到 iOS
看得到 iOS,但無法切換 模組安裝不完整或編輯器未重啟 關閉 Unity,檢查 Hub 的模組狀態 iOS 可選取並切換
iOS 已選取,但 Build 灰色 沒有啟用 iOS Build Profile,或專案設定未完成 建立並切換至 iOS Profile 能選輸出資料夾
Build 可按,Build And Run 灰色 Windows 環境或沒有可用的 Xcode 執行目標 先輸出 Xcode 專案,再到 Mac 處理 Xcode 專案成功產生

Unity 的 Platform Browser 用來查看與切換可用平台;官方參考也將平台選擇和安裝模組分開說明(Platform Browser 參考)。所以,第一步應該是確認「平台不存在」,還是「平台存在但目前沒有啟用」。

Platform Browser 找不到 iOS:先補齊課程工具包

Unity 6.5 並不是只裝好編輯器,就自動包含所有 iOS 輸出元件。iOS Build Support 可以理解成「讓 Unity 具備整理 iOS 作業檔案能力的課程工具包」;缺少它時,Platform Browser 不會按照你的需求自行下載。

請依照以下低風險流程處理:

  1. 關閉正在使用的 Unity 專案,記下專案使用的 Unity 6.5 編輯器版本。
  2. 開啟 Unity Hub,進入安裝項目,找到完全相同的 Unity 編輯器版本。
  3. 開啟該版本的模組管理畫面,確認是否有 iOS Build Support。
  4. 若未安裝,使用 Hub 的官方模組安裝流程補裝,不要從論壇或檔案分享站下載獨立模組。
  5. 等待安裝完成後,完全退出 Unity Hub 與 Unity 編輯器,再重新開啟。
  6. 重新進入 Platform Browser,確認 iOS 已經出現,並檢查能否選取。

Unity 官方的 Unity 6.5 說明與升級文件,應作為版本狀態和升級注意事項的主要依據(Unity 6.5 官方說明Unity 6.5 升級指南)。如果 Hub 顯示模組已安裝,但 iOS 仍完全不存在,先停止修改專案內容,重新確認「編輯器版本是否相同」與「模組安裝是否完成」。

看得到 iOS,為什麼 Build 仍然不能用?

這通常不是 iOS Build Support 的問題,而是 iOS Build Profile 尚未建立或沒有成為活動配置。Build Profile 可以理解成「這次作業要輸出到哪個平台的作業配置單」;你若仍停留在 Windows 或其他平台,Unity 沒有足夠資訊決定輸出格式,按鈕就可能維持不可用。

檢查項目 你要確認的內容 通過條件 未通過時的處理
Build Profile 已建立 iOS Profile 清單中出現 iOS 依官方流程建立新 Profile
Active Profile iOS Profile 已啟用 目前活動平台是 iOS 使用 Switch Profile 切換
場景 課程需要的場景已加入 開啟的是正式作業場景 先儲存並加入目前場景
識別碼 Bundle Identifier 不為空且格式合理 專案設定能保存 依 Unity Player Settings 檢查
輸出目標 選擇新的空資料夾 能開始產生 Xcode 專案 不要覆寫舊輸出資料夾

建立 Profile 後,使用 Switch Profile 將它設為活動配置;官方步驟可參考建立 Build Profile 的說明。Bundle Identifier 是應用程式的識別資料,不是隨便填一段文字即可,相關欄位可對照Unity application identifier 文件

此階段不要急著處理憑證、商店上架或完整發布流程。你的驗收標準只有一個:選擇新的輸出資料夾後,Unity 能產生一個 Xcode 專案。如果連這一步都做不到,先回頭檢查 Profile、場景和 Player Settings。

Windows 能否生成 iOS 專案?能力邊界要分清楚

Windows 上的 Unity 可以繼續製作場景、撰寫 C# 程式、設定資源,並在條件具備時整理出 Xcode 專案;但這不代表 Windows 能獨立完成 iOS 應用程式的最後建置。

可以把流程想成:

  • Unity:整理作業內容,輸出待裝訂的 Xcode 專案。
  • Xcode:在 Mac 上裝訂檔案、簽名蓋章,並把應用程式送到 Simulator 或實機。

因此,Windows 學生仍可先完成遊戲場景和程式邏輯,但若課程要求 Simulator 截圖、真機執行或完整應用程式檔案,就不能只依賴 Windows。Apple 的Xcode 系統要求頁面會列出不同 Xcode 版本對 macOS 的要求;若課程指定 Xcode 27,應以該頁面當時列出的相容條件為準,不要只看網路文章中的舊版本經驗。

你可以按照需求選擇環境:

  • 只需製作 Unity 內容:現有 Windows 通常足夠。
  • 需要互動除錯或 Simulator:借用學校允許使用的 Mac,或使用你有權限操作的遠端 Mac。
  • 只想驗證能否建置:可考慮建置自動化,但它不適合取代需要頻繁操作 Simulator 的學習流程。
  • 學校電腦禁止安裝軟體:不要繞過管理政策,應改用校方允許的連線方式。

若你打算使用遠端環境,可先閱讀遠端 Mac 使用情境,再查看學生可負擔的租用方案。選擇前要確認你的課程是否允許遠端操作,以及專案檔案能否依規定保存。

Mac 上 Build And Run 仍然灰色:按順序排除

切換到 Mac 後,按鈕仍然不可用,不代表一定是 Unity 壞掉。請把問題分成「Xcode 環境、執行目標、帳號簽名、專案內容」四類,逐項觀察:

  1. 檢查 Xcode 是否存在:在 Mac 上直接開啟 Xcode,確認不是只有命令列工具,並等待首次元件安裝完成。
  2. 核對 macOS 與 Xcode 條件:按照 Apple 的系統要求頁面確認相容性;若不符合,停止升級或降級猜測,先換到符合課程要求的 Mac 環境。
  3. 選擇執行目標:課程若只要求 Simulator,就先選可用的模擬器;真機測試則需要可連線的裝置與相應簽名條件。
  4. 區分帳號和簽名問題:沒有開發者帳號、Team 未設定或憑證無效,會在 Xcode 階段出錯,不等於 Unity 的 Build Profile 失效。
  5. 查看 Xcode 專案錯誤:若 Unity 能產生專案,但 Xcode 編譯失敗,先讀取第一個紅色錯誤,分辨是套件、原生程式碼、資源或簽名問題。
  6. 不要關閉安全檢查:不要共享 Apple 帳號或憑證,不要使用未知修復腳本,也不要安裝來源不明的外掛;這些做法可能讓課程專案和個人資料都難以追查。

Unity 的 iOS Player Settings 會影響識別碼、架構與其他輸出設定,可參考官方 iOS Player Settings 文件。先用空白專案測試,通常比直接在含有大量外掛的正式作業上反覆修改更容易定位問題。

最後用空白專案做環境驗收

你可以用以下清單,在提交作業前建立一個清楚的停止條件。每完成一項就勾選;在哪一項卡住,問題範圍就集中在哪一層。

  • [ ] Unity Hub 中,Unity 6.5 編輯器與 iOS Build Support 是同一個安裝版本。
  • [ ] 重新啟動編輯器後,Platform Browser 能看到 iOS。
  • [ ] 已建立 iOS Build Profile,並用 Switch Profile 將它設為活動配置。
  • [ ] 空白場景或課程指定場景已加入建置清單。
  • [ ] Bundle Identifier 已設定,且沒有留在空白或明顯無效的狀態。
  • [ ] Unity 能輸出一個新的 Xcode 專案,而不是只停留在 Build 灰色。
  • [ ] Mac 上已安裝符合課程條件的 Xcode,並能正常開啟。
  • [ ] 先選擇 Simulator 驗證,再判斷是否需要真機和簽名。
  • [ ] 若 Xcode 報錯,已把它與 Unity 按鈕狀態分開記錄。
  • [ ] 已保存 Unity 專案、Xcode 輸出和錯誤紀錄,方便切換環境後重試。

如果空白專案可以輸出並在 Mac 上啟動,而正式專案不行,問題通常落在插件、資源、原生設定或專案本身;如果空白專案也卡在 iOS 選項或 Xcode 建置,則應優先修復環境。若 Windows 已能生成 Xcode 專案,但作業還要求 Simulator 截圖、真機測試或簽名檔案,繼續耗時間重裝 Windows 端 Unity 通常沒有幫助,切換到相容的 Mac 會更直接。

對只需要一次課程驗收的學生,短期租用 KVMFLUX 的遠端 Mac 可以先用空白 Unity 專案確認「輸出 Xcode 專案 → Mac 建置 → Simulator 啟動」這條路是否可行;它比在 Windows 上反覆嘗試不可用的 Build And Run 更符合問題所在。不過,如果你要長期進行高負載開發、需要實體 iPhone 或 USB 除錯,購買或借用本地 Mac 仍然更合適;遠端連線也會受到頻寬、延遲和學校網路政策影響。

先把模組、Profile 和 Xcode 邊界驗收清楚,再把正式作業搬過去,通常比一開始就更換整套工具更省時間。

iOS 建置卡關?用 KVMFLUX 遠端 Mac 快速完成打包

無需立即更換電腦,透過 KVMFLUX 租用遠端 Mac,處理 iOS 專案建置需求。 當本機缺少 iOS 建置環境或按鈕持續呈灰色時,使用 KVMFLUX 可減少繁複的設定與排錯時間。 學生與開發者可按實際需求使用 KVMFLUX 遠端資源,靈活完成測試、封裝及提交前準備。 立即選擇適合的 KVMFLUX 方案,讓你的 Unity iOS 專案不再受限於目前的電腦環境。

Mac Mini M4 · 16GB / 256GB
按日$19.3 /天
按週$52.2 /週
按月$96.7 /月
按季$263 /季