Cocos Code IDE 學習筆記：Win32 Runtime 構建與 C++/Lua 混合開發調試

Cocos Code IDE 開發實戰：Win32 Runtime 構建、C++ 場景接管與 Lua/C++ 協同調試

本文記錄 Cocos2d-x Lua 專案在 Windows 下的完整開發流程：從專案創建、Runtime 構建、VS 調試配置、C++ 場景替換到 Lua 調用 C++ 綁定。

1. 專案創建與初始編譯

• Cocos Code IDE → New Project → Cocos Lua Project。
• 用 VS 打開 proj.win32/*.sln，編譯運行，出現預設農場場景（由 main.lua 驅動）。

2. 構建 Win32 Runtime 實現 IDE 與 VS 雙向調試

1. IDE 右鍵專案 → Cocos Tools → Build Custom Runtimes → 勾選 Build Win32 Runtime。
2. 完成後 runtime/win32/ 下生成 (專案名).exe。
3. IDE → Debug Configurations → 選擇該 exe → Apply → Debug，即可在 IDE 斷點調試 Lua，VS 斷點調試 C++。

3. C++ 代碼修改後的增量編譯

• 修改 C++ 代碼（如 AppDelegate.cpp）後，務必保存。
• IDE 右鍵專案 → Easy Shell → Open... → 輸入 cocos compile -p win32。
• 此命令增量編譯 C++ 並更新 Runtime exe，無需重新 Build Runtime。

4. 接管場景入口：替換預設 Lua 場景

發現 AppDelegate::applicationDidFinishLaunching() 修改場景無效，查找發現真正入口在 Runtime.cpp 的 startRuntime()。
修改該處創建並 runWithScene() 自己的 C++ 場景（如 HelloWorld::createScene()），註釋掉連接層 ConnectWaitLayer。
若出現畫面放大異常，註釋 main.lua 中 setDesignResolutionSize(480,320,0)。

5. Lua 調用 C++ 綁定要點

• 需在具體 CCNode 物件上調用方法，如 sprite:someMethod()。
• 綁定層通常由 tolua++ 自動生成，確保類導出正確。

6. 常見坑與解決

• VS 編譯錯誤：檢查 luaXML.lua、LuaXML_lib.lua 路徑與 require 一致性。
• Runtime 不更新：確認執行了 cocos compile -p win32 且無報錯。
• 設計分辨率衝突：C++ 代碼與 Lua 設置衝突時，以 C++ 為準或統一管理。

總結

Cocos Lua 專案的核心工作流：
Lua 邏輯開發 (IDE) ↔ C++ 引擎擴展/性能模塊 (VS) ↔ Runtime 橋接雙向調試。
掌握 cocos compile -p win32 增量編譯與 Runtime.cpp 入口控制，是高效混合開發的關鍵。