若要在既有的 iOS 專案中使用 cocos2d,通常需要整合 cocos2d 引擎、靜態庫、相依 framework,並調整 Build Settings 與入口程式。以下整理常見步驟。
先到官方網站下載 cocos2d 引擎,將引擎複製到工程目錄,再透過 Add Files 加入 Xcode 專案。加入後,確認檔案路徑與群組結構正確。


依 cocos2d 版本需求加入相依 framework,並在 Build Settings 中設定 Valid Architectures、Enable Bitcode、Other Linker Flags、Header Search Paths、Other C Flags 與預編譯標頭路徑。若使用舊版 cocos2d,常需停用 Bitcode,並補上相關編譯旗標。




在 pch 中,Objective-C 環境需要引入 Foundation 與 UIKit;C++ 環境則需引入 cocos2d。同時,main 函式中的應用程式代理類別,要改為自訂的 AppController,讓系統啟動時進入 cocos2d 的控制器。





完成設定後,建議先檢查搜尋路徑是否正確、pch 是否被納入、AppController 是否可編譯,以及 cocos2d 靜態庫是否已連結。若出現找不到標頭或符號,多半是 Header Search Paths、Library Search Paths 或 Linker Flags 未設定完整。