萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 電腦基礎知識 >  >> 電腦基本常識

Cocos2d-x 3.x 在 Win7 + VS2012 環境配置完整指南 (Python 2.7 + 命令列建專案)

本文記錄 Cocos2d-x 3.1.1 版本在 Windows 7 系統、Visual Studio 2012 開發環境下的完整配置流程,採用新版命令列工具建立專案,適合 C++ 開發者快速上手。

環境需求清單

軟體版本/說明下載來源
Visual Studio2012 (含 Update 4 推薦) / 2013 / 2015 CommunityMicrosoft 官網 / Visual Studio Dev Essentials
Cocos2d-x SDK3.1.1 (或 3.x 穩定版)官網下載頁
Python2.7.x (3.x 不相容) — 勾選「Add python.exe to Path」Python 官網

步驟 1:安裝 Visual Studio 2012

  • 安裝時選擇「C++ 桌面開發」工作負載,確保包含 MFC、ATL、Windows SDK。
  • 安裝完成後建議套用 Update 4 (修正編譯器 Bug、提升穩定性)。

步驟 2:解壓 Cocos2d-x

  • 將下載的 cocos2d-x-3.1.1.zip 解壓至 **無中文、無空格、路徑較短** 的目錄,例:E:\cocos2d-x-3.1.1。

步驟 3:安裝 Python 2.7

  • 執行安裝程式,**務必勾選「Add python.exe to Path」** (將 Python 加入系統環境變數)。
  • 安裝後開啟 CMD 驗證:輸入 python --version 應顯示 Python 2.7.x。

步驟 4:配置環境變數 (關鍵步驟)

  1. 右鍵「電腦」→ 內容 → 進階系統設定 → 環境變數。
  2. 系統變數 下編輯 Path,新增兩條路徑 (依實際解壓路徑調整):
    E:\cocos2d-x-3.1.1\tools\cocos2d-console\bin
    E:\cocos2d-x-3.1.1 (可選,方便直接呼叫腳本)
  3. 新增系統變數 COCOS_CONSOLE_ROOT = E:\cocos2d-x-3.1.1\tools\cocos2d-console\bin (部分腳本依賴此變數)。
  4. 打開**新的** CMD 視窗驗證:輸入 cocos 應顯示命令列幫助資訊;輸入 python 進入互動模式。

步驟 5:使用命令列建立 C++ 專案

新版 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**。

步驟 6:編譯執行 Win32 專案

  1. 進入專案目錄:cd E:\Projects\CocosProjects\MyGame
  2. 編譯 Win32 專案:cocos compile -p win32 (首次會下載預編譯庫、配置 CMake,需較久時間)。
  3. 或直接用 VS2012 開啟 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),每個遊戲一個子資料夾。
  • 版本控制: 專案根目錄初始化 Git,.gitignore 排除 build/, bin/, .cocos/, proj.*/build/ 等編譯產物。
  • 升級引擎: 新版引擎釋出時,建議建立新專案再遷移原始碼/資源,避免舊專案配置殘留衝突。
  • IDE 推薦: VS2012/2013/2015 + Visual Assist X (程式碼導航/重構) + VsVim (Vim 模擬) 體驗最佳。

結語

完成上述配置,您即擁有可在 Win7 + VS2012 上開發、除錯、發布 Cocos2d-x 3.x C++ 跨平台遊戲的完整環境。建議先跑通官方範例 (cpp-tests),再著手開發自有專案。

copyright © 萬盛學電腦網 all rights reserved