本文記錄 Cocos2d-x 3.1.1 版本在 Windows 7 系統、Visual Studio 2012 開發環境下的完整配置流程,採用新版命令列工具建立專案,適合 C++ 開發者快速上手。
| 軟體 | 版本/說明 | 下載來源 |
|---|---|---|
| Visual Studio | 2012 (含 Update 4 推薦) / 2013 / 2015 Community | Microsoft 官網 / Visual Studio Dev Essentials |
| Cocos2d-x SDK | 3.1.1 (或 3.x 穩定版) | 官網下載頁 |
| Python | 2.7.x (3.x 不相容) — 勾選「Add python.exe to Path」 | Python 官網 |
cocos2d-x-3.1.1.zip 解壓至 **無中文、無空格、路徑較短** 的目錄,例:E:\cocos2d-x-3.1.1。python --version 應顯示 Python 2.7.x。Path,新增兩條路徑 (依實際解壓路徑調整):E:\cocos2d-x-3.1.1\tools\cocos2d-console\binE:\cocos2d-x-3.1.1 (可選,方便直接呼叫腳本)COCOS_CONSOLE_ROOT = E:\cocos2d-x-3.1.1\tools\cocos2d-console\bin (部分腳本依賴此變數)。cocos 應顯示命令列幫助資訊;輸入 python 進入互動模式。新版 Cocos2d-x 3.x **不再提供 Visual Studio 專案範本**,必須使用 cocos 命令列工具建立專案結構。
cocos new MyGame -p com.mycompany.mygame -l cpp -d E:\Projects\CocosProjects
參數說明:
new:建立新專案子命令。MyGame:專案名稱 (無空格、特殊字元)。-p com.mycompany.mygame:Android 套件名稱 (反向域名格式),**必填**,影響 Android 專案結構。-l cpp:程式語言 (cpp 或 lua / js)。-d E:\Projects\CocosProjects:專案父目錄,**實際專案將建立於 E:\Projects\CocosProjects\MyGame**。cd E:\Projects\CocosProjects\MyGamecocos compile -p win32 (首次會下載預編譯庫、配置 CMake,需較久時間)。proj.win32\MyGame.sln,設為啟動專案,按 F5 偵錯執行。| 問題 | 原因與解決 |
|---|---|
cocos 非內部/外部命令 | 環境變數未生效 → 重開 CMD / 重啟電腦 / 檢查 Path 路徑正確性 (含 bin 目錄) |
| Python 版本錯誤 / 模組缺失 | 必須用 Python 2.7.x;若缺模組用 pip install 模組名 安裝 |
| 編譯錯誤:找不到 Windows SDK / 編譯器版本不符 | VS2012 需安裝 Windows 8.0 SDK;專案屬性 → 一般 → 平台工具組 選 v110 (VS2012) 或 v110_xp |
| Android 建置失敗 | 需另行配置 NDK、SDK、Ant/Gradle、環境變數 (ANDROID_NDK_ROOT, ANDROID_SDK_ROOT) — 另文說明 |
| 專案路徑含中文/空格 | **嚴禁**,會導致 Python 腳本、CMake、NDK 建置失敗 |
E:\CocosProjects),每個遊戲一個子資料夾。.gitignore 排除 build/, bin/, .cocos/, proj.*/build/ 等編譯產物。完成上述配置,您即擁有可在 Win7 + VS2012 上開發、除錯、發布 Cocos2d-x 3.x C++ 跨平台遊戲的完整環境。建議先跑通官方範例 (cpp-tests),再著手開發自有專案。