裝置沒有出現在 Xcode 27 Device Hub，或已配對卻無法啟動 App？
最快判斷：無線配對要求 Mac 與裝置能在同一個 Wi-Fi 網路互相發現；它不是跨網際網路連線方式。這週先驗收網路發現、配對授權及真機執行，再決定是否把測試交給遠端 Mac。
需要透過 Xcode 27 配對 iPhone、iPad 或 Apple Watch 的開發者，可依本文逐步檢查連線與調試流程。
維護遠端 Mac 開發環境或 CI 的工程師，可用這份流程確認主機和真機是否真的具備連線條件。
負責測試准入的 QA 與平台負責人，則可據此區分模擬器測試、真機調試和遠端節點可用性。
最後更新於 2026 年 10 月 24 日；版本與配對條件依 Apple 的 Xcode 27 發布說明、Device Hub 配對文件及相關裝置文件核對。
第一階段：Device Hub 配對與模擬器測試，驗收目標不同
先界定你要通過的關卡：本文驗收的是「真機能否被配對、執行 App 並進入調試」，不是完整的自動化真機 CI。Device Hub 管理實體裝置連線；模擬器是在 Mac 上測試虛擬裝置；遠端 Mac 則是你透過網路操作的主機。三者不能互相代替。
Apple 的配對說明要求 Mac 與符合條件的 iPhone、iPad 或 Apple Watch 位於同一個 Wi-Fi 網路，並指出依平台或裝置條件可能需要額外操作。這項條件不能延伸解讀成「只要能 SSH 或遠端桌面進入 Mac，就能隔著網際網路無線配對真機」。請先對照官方配對流程及裝置條件，把「同網路可發現」當成待驗證的前提，而非預設成立。
開始前，把通過標準寫清楚：裝置出現在 Xcode 清單只是發現或連線狀態的證據，還不足以證明調試鏈路正常。至少還要確認配對已完成、裝置端授權有效、實際 App 可安裝啟動，且 Xcode 能建立調試工作階段。
第二階段：檢查版本與網路條件，再開始配對
Xcode 27 Device Hub 無線配對需要什麼網路條件？重點是 Mac 與測試裝置必須能在同一個 Wi-Fi 網路互相發現。訪客 Wi-Fi、用戶端隔離、網路分段或裝置管理政策都可能影響發現；但若沒有診斷資料，不要把某一種網路設定直接認定為故障原因。
先記錄目前正在執行的 Xcode 版本、裝置系統版本與目標平台，再依 Apple 的系統需求列表和發布說明核對支援狀態。不要以「已安裝 Xcode 27」推定所有連接的裝置都符合條件；若正在評估 Xcode 27.1 RC，也不要把 RC 文件或行為當成正式版保證。
配對前逐項確認：
- Mac 與裝置連上可互相發現的 Wi-Fi，而不是只確認兩者都能上網。
- 若使用公司、實驗室或訪客網路，請網路管理者確認裝置間的發現流量是否受限制；保留網路名稱與限制狀態，方便比對。
- 確認裝置已解鎖，並留意配對時可能出現的裝置端確認提示。
- 準備有線配對作為排查備案。若無線發現失敗，先按 Apple 文件檢查網路條件，再用有線路徑判斷問題是否只發生在無線發現階段。
- 把實際 Xcode、作業系統與裝置版本寫進紀錄，避免後續把不同環境的結果當成同一次測試。
第三階段：從 Device Hub 配對，完成裝置端授權
在 Device Hub 選取可用裝置，依畫面完成配對；配對期間若 iPhone、iPad 或 Apple Watch 顯示確認要求，請在裝置端完成並記錄提示內容。完成後重新檢查裝置狀態，不要只憑曾經點過配對按鈕就判定成功。
iPhone 無法出現在 Xcode 27 Device Hub 時，先分開排查「沒有被發現」和「發現後配對失敗」。前者回到同一 Wi-Fi 網路及網路隔離條件檢查；後者記下 Xcode 與裝置端的錯誤訊息，確認裝置是否要求重新信任或完成其他授權。若無線路徑仍無法確認，嘗試文件支援的有線配對方式，並保留兩種路徑的結果供比較。
配對後還需要開啟 Developer Mode 嗎？依裝置與系統條件而定；若裝置要求 Developer Mode，你必須依提示啟用，並完成系統要求的確認流程。Apple 說明了如何在裝置啟用 Developer Mode。未完成裝置端步驟時，不能只因 Xcode 無法執行 App，就判斷為 Xcode 或配對故障。
第四階段：用真實 App 區分配對、簽署與執行問題
裝置已出現在 Device Hub 後，選取正確的 Scheme，將執行目標指定為已配對的實體裝置，再執行一次實際 App。Apple 將在模擬器或實體裝置執行 App分開說明；模擬器成功不能代替真機安裝、啟動與調試驗收。
依錯誤所在的階段定位，不要把所有失敗都歸到「無線連線」：
- 裝置不在清單：檢查網路發現、配對狀態與連線方式。
- 裝置已列出但無法執行：檢查 Developer Mode、信任狀態與裝置端確認。
- 建置或安裝遇到簽署錯誤：核對團隊簽署設定、描述檔與裝置註冊。Apple 的簽署與 provisioning profile 說明和註冊單一裝置流程可用來確認各自責任範圍。
- App 已啟動但無法調試：保留 Xcode 錯誤、裝置端表現與連線狀態，再檢查目前使用的執行目標及調試工作階段。
記錄建置結果、安裝與啟動狀態、調試是否建立，以及錯誤文字。這份紀錄能讓後續復測與簽署排查對照同一條鏈路，而不是依賴「看起來有連上」。
第五階段：遠端 Mac 與本地 Mac，按可驗證條件選擇
遠端 Mac 能透過 Device Hub 無線調試 iPhone 嗎？只有在遠端主機與真機確實具備 Device Hub 所要求的網路發現及後續連線條件時，才有理由進行驗收。SSH、遠端桌面或網頁控制台能連到主機，只能證明你可以存取主機，不能證明真機也能被該主機發現。
| 選項 | 適用的驗收工作 | 主要限制與判斷條件 |
|---|---|---|
| 本地 Mac＋同網真機 | 直接驗收配對、安裝、啟動與調試 | 仍須確認 Wi-Fi 發現與裝置端授權；網路隔離時需先處理網路條件 |
| 遠端 Mac＋真機 | 主機和裝置具備可驗證的同網發現及後續連線時 | 遠端主機可登入不代表真機可達；不可把跨網際網路的主機存取當成配對證據 |
| Mac 模擬器 | 不依賴實體裝置的程式碼與介面測試 | 模擬器通過不等於真機配對、裝置行為或真機准入通過 |
| 分層 CI | 將一般建置與模擬器測試，和必要的真機驗證分開安排 | 必須為真機步驟指定有實際連線條件的執行環境，並保存真機結果 |
遠端 Mac 真機調試應以連線證據決定，不要先假設服務端已提供真機直連。若網路拓撲、設備存取方式或裝置端連線條件無法核實，將真機配對留在本地；遠端節點可負責建置或適合由模擬器完成的測試。若選擇租用遠端主機，可先從VMSPIN 的服務入口了解存取方式，再依自身網路條件驗證是否符合真機工作流程。
第六階段：斷線復測後再決定測試准入
配對與首次執行都成功後，還要測試連線中斷時的恢復行為。記錄裝置是否仍出現在 Xcode、是否需要重新配對、裝置端是否再次要求授權，以及已啟動的建置或調試工作是否仍可繼續。裝置重新出現，不代表原本的建置任務也已恢復；兩者要分開記錄。
最終准入紀錄至少應包括：
- Xcode 與裝置系統版本，以及實際測試的平台。
- Mac 和裝置的網路拓撲、無線或有線配對方式。
- 配對結果、Developer Mode 與裝置端授權狀態。
- 真實 App 的建置、安裝、啟動和調試結果。
- 斷線後裝置重新連線狀態，以及工作是否需要重跑。
若本地 Mac 的同網配對與調試閉環通過，可在該環境完成真機驗收；若遠端 Mac 只有主機登入成功、沒有裝置可達的證據，就不要把它列為真機節點。模擬器可承擔適合的測試，但不能替代真機准入。對需要遠端建置或暫時使用 macOS 的團隊，租用 Mac 可免去先購置實機的負擔；不過它無法自動消除主機與真機間的網路限制，也不保證跨網無線配對。先核對VMSPIN 的方案資訊，再依已驗收的網路與設備條件決定是否租用；若工作必須直接連接本地實體裝置，使用本地 Mac 會是更合適的選擇。