讓打包作業繼續執行

先查看目前的開發者目錄和版本，並確認已安裝目標 Xcode。以下範例會將系統預設目錄切換為 /Applications/Xcode.app；使用其他版本時，請替換為實際的應用程式路徑。

xcode-select -p
xcodebuild -version
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
xcodebuild -version
xcrun --find swift

系統層級的切換會影響之後啟動的其他作業。若不同流水線需要使用不同版本，建議在作業環境中設定 DEVELOPER_DIR，避免不同作業反覆變更全域目錄。

DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer \
xcodebuild -list -workspace MyApp.xcworkspace

切換後先列出 Scheme，再執行一次 Archive。若缺少平台元件或尚未完成初次執行設定，請先在 macOS 圖形介面中初始化對應工具鏈，再重新執行自動化作業。

準備包含私鑰的憑證匯出檔、該檔案的密碼，以及符合 App 識別碼和發行方式的描述檔。只有憑證而沒有相對應的私鑰，通常無法完成程式碼簽章。

1. 使用執行建置作業的 macOS 帳戶開啟「鑰匙圈存取」，將憑證匯入該帳戶的鑰匙圈。
2. 展開憑證，確認下方有相對應的私鑰。使用下方指令檢查有效的程式碼簽署身分。
3. 依照所用 Xcode 版本的要求安裝描述檔；在專案簽章設定中確認 Team、Bundle Identifier 與發行方式。
4. 逐一檢查 App、Widget 和 Extension 的簽章設定，再執行 Archive 並驗證匯出結果。

security find-identity -v -p codesigning

CI 執行使用者的鑰匙圈環境可能與遠端桌面使用者不同。無人值守建置需要在作業中正確解鎖鑰匙圈，並設定必要的存取權限。密碼請從 CI 的受保護變數讀取，不要寫入程式碼儲存庫、指令輸出或工單。

若手動打包成功但 CI 失敗，請優先比對執行使用者和鑰匙圈狀態。回報簽章錯誤時，只提供憑證類型、有效期限與已去識別化的錯誤行，請勿上傳私鑰或憑證密碼。

請勿將重裝視為保留檔案的操作。重裝可能會清除系統與工作目錄；提交申請前，請先透過控制台工單確認處理範圍，並完成節點外備份。租期結束後，節點會執行磁碟抹除，請勿將到期節點當作資料還原來源。

備份至少應包含尚未推送的原始碼、建置設定、必要工件、描述檔及受保護的金鑰資料。DerivedData、依賴套件下載目錄等快取可以重新產生，但會延長還原後首次建置的時間。

完成備份不代表一定能順利還原。請將備份解壓縮到另一個獨立目錄，核對檔案數量與重要設定，並確認可以取回最近一次的產物，再停止原節點上的作業。重裝後請重新安裝工具鏈、還原簽章環境並註冊 runner。

登入訂單所屬帳戶，在控制台確認執行個體、到期時間與可選續租週期，再依頁面顯示的帳單完成付款。續租是否成功及新租期，以控制台即時顯示的結果為準，請勿依付款截圖或關閉瀏覽器前的畫面判斷。

僅支援 USDT-TRC20 與 Visa / Mastercard / Amex（透過 Stripe），一律以美元結算；實際可用的付款閘道以後端介面回傳為準。使用鏈上付款前，請確認網路、金額與收款資訊；刷卡完成後，請返回控制台查看帳單。

若帳單與執行個體狀態不一致，請提供訂單編號、帳單編號與交易參考資訊。請勿重複付款來嘗試修正狀態，也不要在工單中提供完整卡號。到期前請先備份工件與必要檔案，避免將續租流程當成資料備份方式。

先在控制台確認節點位址、連接埠、使用者名稱與執行個體狀態。判斷是連線逾時還是驗證失敗：前者優先檢查網路連通性，後者優先確認使用者名稱、密碼或金鑰。SSH 與 VNC 使用不同的連線資訊，請勿混用連接埠。

ssh -v -p PORT USER@HOST

請將 PORT、USER、HOST 替換成實際資訊。若日誌顯示主機指紋變更，請先透過可信的控制台資訊或工單確認原因，勿直接停用主機身分驗證。

遠端桌面適合檢查 macOS 圖形介面、鑰匙圈與 Xcode 設定；SSH 適合命令列操作和 CI。提交日誌前，請移除使用者名稱、位址和本機路徑中的敏感資訊，只保留錯誤類型與發生順序。

請確認以下四項：runner 是否在線上、作業標籤是否相符、專案是否允許使用該 runner，以及程序是否以正確的使用者執行。註冊成功只代表已建立關聯，不代表所有作業都會自動派送到該節點。

先提交僅輸出工具鏈資訊的測試作業，確認執行使用者、目錄和 Xcode 版本，再加入依賴安裝與簽章步驟。

whoami
pwd
xcode-select -p
xcodebuild -version
security find-identity -v -p codesigning

將 macOS、晶片架構與用途寫入標籤，並在專案設定中明確指定。首次整合時，請先限制同時執行一個作業，確認快取、鑰匙圈和產物目錄不會互相覆寫，再逐步增加並行數。註冊權杖屬於憑證，請勿放入工單或建置日誌。

先確認使用正確的 workspace、共用 Scheme 和 Release 設定。Archive 與模擬器建置是不同流程；裝置目標的簽章、架構和匯出設定需要另外確認。

xcodebuild -list -workspace MyApp.xcworkspace
xcodebuild archive \
  -workspace MyApp.xcworkspace \
  -scheme MyApp \
  -configuration Release \
  -destination 'generic/platform=iOS' \
  -archivePath build/MyApp.xcarchive

保留第一個實際錯誤及其前後文，不要只截取最後的「失敗」結論。分別檢查依賴安裝、指令碼階段、簽章階段和磁碟寫入。Archive 成功後仍須驗證匯出的工件，不能將封存完成視為已產生可發佈的套件。

先檢查磁碟使用量和作業狀態，再區分可重新產生的快取與需要保留的產物。請勿在作業執行期間刪除其依賴的目錄，也不要將原始碼、簽章資料或尚未上傳的 Archive 當成快取處理。

df -h
du -sh ~/Library/Developer/Xcode/DerivedData
du -sh ~/Library/Developer/Xcode/Archives

為快取與產物分別訂定保留規則。清理後，首次編譯和解析依賴套件可能會變慢，請將這次建置視為冷啟動驗證。若長期空間不足，先統計專案與工件的成長量，再選擇更合適的機型或 SSD 擴充項目。