移轉專案與所需檔案
建議從版本控制庫簽出程式碼；逐一確認未納入版本控制的設定檔與建置資源。傳輸前先盤點敏感資料，避免將憑證寫入儲存庫或記錄檔。
完成檢查：在雲端目錄中找到預期的專案檔案，並確認敏感檔案的存取範圍。
初次使用 · 操作指南
從租用雲端 Mac，到取得第一份建置成果。
本指南適用於準備在獨享實體 Mac 上執行 Xcode 或 macOS CI 的開發者。先確認機型與節點，再取得連線資訊、檢查工具鏈，最後執行一次可重現的建置。
頁面中的命令與回應皆為範例，不代表已為您的專案完成設定。實際連線參數、設備狀態與交付進度，請以控制台顯示為準。
首次建置檢查清單
01 / 04
先確認這四項，再將專案交由遠端節點執行。
- 設備
- 選擇 M4 或 M4 Pro 獨享實體機
- 位置
- 確認團隊所需的可租用節點
- 連線
- 依控制台提供的資訊建立連線
- 建置
- 記錄工具鏈版本與成果路徑
範例檢查清單 · 實際設定以訂單及控制台為準
依任務尋找
從目前進度接著開始。
五個入口依實際操作順序排列；已有訂單的使用者可直接前往連線或疑難排解步驟。
開通流程 · 操作示範
四個步驟完成首次登入。
右側時間僅用於說明一次示範操作的時間分配，並非交付時限。實際交付時間及連線資訊是否已產生，請以控制台中的訂單與設備狀態為準。
約 4 分鐘示範操作總計，不含設備交付等待時間
- 01 示範約 1 分鐘
選擇機型與節點
依專案的記憶體與儲存需求選擇可租用方案，再依團隊所在地與協作時區選擇節點。先確認方案涵蓋範圍，再開始訂購。
- 02 示範約 1 分鐘
完成訂購
確認租期與選購的附加項目後提交訂單。供應情況與實際可用的付款閘道，以控制台即時顯示為準。
- 03 示範約 1 分鐘
取得連線資訊
等待設備顯示就緒，再從控制台查看指派給該執行個體的位址、帳戶與連線說明。請勿直接複製公開範例中的憑證。
- 04 示範約 1 分鐘
首次登入並檢查環境
建立連線後，確認目前帳戶、磁碟空間與 Xcode 工具鏈版本；若不符，請先停止自動化工作並記錄輸出。
連線與命令 · 去識別化範例
先連上節點，再驗證一次建置。
SSH 適合簽出程式碼、執行建置與檢查記錄；若需操作 Xcode 圖形介面，請依執行個體提供的遠端桌面連線說明操作。
$ ssh developer@192.0.2.10
Last login: example session
$ xcodebuild -version
Xcode
Build version: example
$ xcodebuild -workspace App.xcworkspace \
-scheme App -configuration Release \
-destination 'generic/platform=iOS' build
** BUILD SUCCEEDED **
$ fastlane build
[example] Build completed
[example] Artifact: ./build/App.ipa執行前請逐項替換
- 位址與帳戶：範例位址無法用於連線；請只使用控制台為目前執行個體提供的參數。
- 專案與 Scheme：將命令中的專案檔案與 Scheme 換成儲存庫的實際名稱，並確認目標平台。
- 成功判定：請同時檢查結束代碼、建置記錄與成果檔案。範例輸出並非您專案的執行記錄。
從本機到雲端
要移轉的是可重現的流程，不只是專案檔案。
從本機 Mac 移轉至雲端 Mac：先確保能取得原始碼與相依項目，再確認工具鏈，最後將 CI 工作指向新的執行節點。
確認 Xcode 與相依項目
記錄本機使用的 Xcode、命令列工具與套件管理相依項目版本；在雲端重新解析相依項目，並比對專案最低系統版本與架構需求。
完成檢查：同一個 Scheme 能從命令列啟動建置，且已記錄版本差異。
串接 CI Runner
為新節點設定專屬 Runner 身分與任務標籤，先執行不需要發布憑證的驗證工作，再確認打包所需權限。
完成檢查：測試工作在預期節點執行，且記錄與成果皆可追溯。
Xcode 雲端建置
讓第一份建置成果成為可供核對的基準。
先手動完成一次完整建置，保留版本、命令與錯誤輸出，再決定是否交由自動化工作執行。不同專案的簽署與相依項目需求須分別設定。
01
簽出專案
使用團隊認可的方式取得儲存庫，確認目標提交版本、子模組與鎖定檔；先執行 git status，避免根據未知變更判斷建置結果。
02
妥善保管簽署資料
確認由誰管理憑證、描述檔與所需金鑰，以及哪些人可讀取。請勿將私密金鑰放入公開儲存庫，也不要將完整憑證貼到疑難排解支援單。
03
執行建置
先確認 xcodebuild -version 與專案 Scheme，再執行專案實際使用的建置命令；記錄結束代碼與第一個有效錯誤，不要只截取記錄檔末尾。
04
取得建置成果
檢查成果檔案、大小與產生路徑，再依團隊流程封存或移出。建置成功訊息不能取代對實際檔案與簽署結果的檢查。
CI/CD 串接
先驗證 Runner，再啟用自動化打包。
串接 GitLab CI macOS Runner 時，需在節點安裝並註冊 Runner，將其連結至具備權限的專案，並以任務標籤限制工作執行位置。註冊方式、存取範圍與並行設定，應遵循團隊自身的 CI 管理政策。
第一個驗證工作可只輸出系統與 Xcode 版本。這能證明工作已送達預期的 Apple Silicon 節點，但無法證明簽署、下載相依項目與發布步驟都已就緒。
打包前的權限檢查
- Runner 身分：確認註冊範圍、執行帳戶與任務標籤，避免工作被其他節點接手。
- 專案存取：確認該執行帳戶可存取儲存庫、子模組與私有相依項目。
- 簽署存取：僅向確實需要打包的工作提供必要資料；並確認記錄檔不會顯示敏感值。
- 成果存放位置：執行完整打包工作前，先決定封存目錄、讀取權限與清理責任。
fastlane 可納入既有打包流程，但無法取代專案本身的權限、簽署與版本確認。
疑難排解
先找出問題發生在哪個步驟。
聯絡團隊前，請記錄發生時間、執行個體所屬的訂單編號、執行的操作與已去識別化的錯誤資訊；請勿傳送密碼、私密金鑰、簽署憑證或未遮蔽的專案資料。
無法連線
先確認控制台中的設備狀態、位址與帳戶，再檢查本機網路與使用的連線方式。記下連線命令、錯誤類型與發生時間，並遮蔽憑證資訊。
建置失敗
記錄提交版本、Xcode 版本、Scheme、完整命令與第一個有效錯誤。區分取得相依項目、編譯、簽署與匯出階段，不要只提供「建置失敗」的最後一行訊息。
磁碟空間不足
檢查專案目錄、建置快取與成果檔案的磁碟用量，先確認哪些檔案可由團隊安全清除。附上已去識別化的空間統計與錯誤路徑，避免誤刪仍需封存的成果。
存取權限異常
確認目前的執行帳戶、檔案擁有權，以及儲存庫或簽署資料的授權範圍。記錄受影響的路徑與錯誤訊息，請勿透過擴大所有檔案的權限來迴避問題。
準備好開始了嗎？
選好節點，讓下一次建置有明確的執行環境。
先確認三種機型與租期，再於控制台查看即時可租用狀況。連線後，先從一次可重現的驗證建置開始。