解決 cocos2d-x 在 Xcode 中安裝後不顯示模板問題（Hackintosh 完美方案）

問題背景

許多開發者在 Hackintosh（黑蘋果）環境下安裝 cocos2d-x 後，發現 Xcode 新建專案時找不到 cocos2d-x 模板。這通常不是安裝腳本失敗，而是權限問題導致模板檔案無法被 Xcode 正確識別。

根因分析

cocos2d-x 安裝腳本會將模板複製到 ~/Library/Developer/Xcode/Templates/cocos2d-x/。在 Hackintosh 上，~/Library 目錄的擁有者與權限常因系統遷移、手動修改導致異常，造成 Xcode 無法讀取模板內容，介面顯示全紅的「禁止存取」圖示。

分步解決方案

1. 確認模板是否已複製

開啟 Finder，按 Shift+Command+G 輸入 ~/Library/Developer/Xcode/Templates/，查看是否存在 cocos2d-x 資料夾。若無，請重新執行 install-templates-xcode.sh。

2. 顯示隱藏的 Library 資料夾

若 Finder 找不到 Library，同樣用「前往資料夾」輸入 ~/Library 進入，或在 Dock 的 Finder 圖示右鍵選「前往資料夾...」。

3. 修正 Xcode 目錄權限

1. 進入 ~/Library/Developer/Xcode，空白處右鍵選「顯示簡介」（Get Info）。
2. 展開底部「共享與權限」，點擊右下角鎖圖示解鎖（需輸入管理員密碼）。
3. 將所有使用者權限改為「讀與寫」。
4. 點擊齒輪圖示 → 「應用到包含的項目...」 → 確認。

4. 登出並重新登入

此步驟關鍵：修改權限後必須登出當前使用者再登入，讓系統重新建立權限快取。之後再進 Templates/cocos2d-x/ 紅線應已消失。

5. 驗證 Xcode 模板

重新啟動 Xcode，新建專案 → 選擇 iOS/macOS 分頁，即可看到 cocos2d-x 模板群。

常見誤區

• ❌ 僅修改 Templates 子目錄權限而非父目錄 Xcode，導致繼承失效。
• ❌ 修改權限後未登出，權限未生效。
• ❌ 使用 sudo chmod -R 777 暴力修改，破壞系統完整性保護（SIP）。

延伸建議

若仍無法顯示，請檢查 Xcode 版本與 cocos2d-x 版本相容性（如 Xcode 15+ 需 cocos2d-x 4.0+），並確認 ~/Library/Developer/Xcode/Templates/File Templates/ 下同樣擁有正確權限。