最終更新日 2014/12/16
Cocos2d-x 3.2 の開発環境構築手順をまとめます。

このバージョンは最新ではありません。
最新版はCocos2d-x開発環境の構築を参照してください。

目次 Edit

まえおき Edit

  • インストールするCocos2d-xのバージョンは3.2 で、インストール先は C:\cocos2d-x\cocos2d-x-3.2 とします。
  • インストールするPythonのバージョンは2.7.8で、インストール先は C:\Python27 とします。
  • Windows版の開発には VisualStudio 2013 を使用します。
    Cocos2d-x 3.2 は C++11 の機能を使用しているため、VisualStudio 2012 以降のバージョンが必要です。
    無料のExpressバージョンでも問題ありません。
    VisualStudio 2010は使用不可能です。
  • Android版のNDKのバージョンはr9dです。cocos2d-x3.2はr10では動かないようです。
    公式にはr10より前のバージョンのリンクが無い感じですが、直リンクでダウンロードできます。windows版はこちら↓
    64bit版 https://dl.google.com/android/ndk/android-ndk-r9d-windows-x86_64.zip
    32bit版 https://dl.google.com/android/ndk/android-ndk-r9d-windows-x86.zip
    手順については後述します。

Cocos2d-x本体のインストール Edit

Cocos2d-x 3.2 をインストールします。基本的には、ダウンロードしたファイルを解凍して任意のフォルダにコピーするだけです。

  1. Cocos2d-xの公式ダウンロードサイト http://www.cocos2d-x.org/download にアクセスして、対象のパッケージをダウンロードします。
    Download v3.2 をクリックしてダウンロードして下さい。
    cocos2dx_001_001.PNG
  2. ダウンロードした cocos2d-x-3.2.zip を解凍します。
  3. 解凍された cocos2d-x-3.2 フォルダを C:\cocos2d-x 以下にフォルダごと移動します。
    (__MACOSXフォルダもありますが、これは無視してください。mac にインストールする場合は必要?すみませんwindows環境しかありません…)
    ↓こんなフォルダ階層になります。
    cocos2dx_001_002.PNG
  4. 以上でCocos2d-x本体のインストールは完了です。

Pythonのインストール Edit

Python 2.7.8 をインストールします。3.x系は問題が出る場合があるようなので、使用しないほうがよいです。

  1. Python日本語公式サイト http://www.python.jp/ にアクセスします。
  2. ページ左側にある Python 2.7.8 の下のダウンロードをクリックして、ダウンロードページに移動します。
    python_001.PNG
  3. 『Windows x86 MSI Installer (2.7.8)』をクリックして、インストーラをダウンロードします。
    (64ビット版もこちらで問題ありません)
    python_002.PNG
  4. ダウンロードした、インストーラ(python-2.7.8.msi)を実行します。
    インストールオプションはデフォルトのままで問題ありません。
  5. インストールフォルダにパスを通します。
    システム環境変数のPathに C:\Python27 を追記して、パスを通してください。
    python_003.PNG
  6. コマンドプロンプトを立ち上げ、
    python --version
    と打ち込んで、
    Python 2.7.8
    と表示されれば、Pythonの準備は完了です。

Cocos2d-xの環境設定 Edit

setup.pyという環境変数設定用のツールが付属されおり、対話型でCocos2d-xに必要な環境変数の設定を行えます。
setup.pyによって設定される環境変数は以下の通りです。

環境変数名内容備考
COCOS2D_CONSOLE_ROOTC:\cocos2d-x\cocos2d-x-3.2\tools\cocos2d-console\binsetup.pyにより自動で設定されます
NDK_ROOTC:\Android\android-ndkAndroid版が必要なければスキップ可
ANDROID_SDK_ROOTC:\Android\android-sdkAndroid版が必要なければスキップ可
ANT_ROOTiOS版が必要なければスキップ可

COCOS2D_CONSOLE_ROOTにパスが通されることにより、後述のcocosコマンドがどこからでも使えるようになります。

  • 上記からもわかる通り、Android版の環境を整えたい場合はAndroid SDKおよびNDKの環境設定が必要になります。
    このページでも後述していますが、Android開発環境が整っていない場合 Android開発環境の構築 を参考にしてこのタイミングで開発環境を構築するのが良いかもしれません。
    この時点でAndroidの設定項目をスキップして、後でAndroid環境を設定し、setup.pyを実行する形でも問題ないと思います。
    NDK_ROOTとANDROID_SDK_ROOTの環境変数を設定してるだけ?な気もするので、setup.py自体必要ないかもしれません。

以下、setup.pyによる環境設定の手順となります。

  1. コマンドラインから、
    C:\cocos2d-x\cocos2d-x-3.2\setup.py
    を実行します。
  2. 設定されていない環境変数がある場合、
    Please enter the path of [環境変数名] (or press Enter to skip):
    という表示が出て、パスを指定するか、もしくはスキップするかを問われます。
    スキップする場合はそのままエンターキーを押し、指定する場合は、パスを指定してエンターキーを押して次に進んでください。
    下記のスクリーンショットでは、ANT_ROOTの設定を問われていますが、必要ないのでスキップしています。
    また、すでに環境変数の設定がされている場合は上書きされます。
    cocos2dx_005_001.PNG
  3. 環境変数を設定した場合は、PCを再起動する旨のメッセージが出るので、PCを再起動しましょう。
  4. PCを再起動したら、Cocos2d-xの環境設定は完了です。

Cocos2d-xプロジェクトの新規作成 Edit

Cocos2d-xの新規プロジェクトを作成します。
プロジェクトを作成するフォルダは D:\projects 直下とします。
プロジェクト名は『MyGame』とします。

  1. コマンドプロンプトを開き、
    cocos new MyGame -p com.MyCompany.MyGame -l cpp -d D:\projects
    と入力してエンターキーを押します。
    成功すると、以下の様なログが出力されます。
    cocos2dx_002_001.PNG
    cocosコマンドが認識出来ない場合は、前項のCocos2d-x環境設定(COCOS2D_CONSOLE_ROOT)に失敗しています。
    再度設定を行うか、PCの再起動を忘れていないか確認してください。
    コマンドの内容を軽く以下に説明しておきます。
    cocosCocos2d-xのコンソールコマンドです。プロジェクトの作成の他にも、ビルドや実行などがcocosコマンドから可能なようです。
    new最初の引数には、cocosコマンドの種類を指定します。newは、新規のプロジェクトを作りますよという指定です。
    -p com.MyCompany.MyGameパッケージ名を指定します。
    -l cpp使用する言語を指定します。cppはC++言語を使用するという意味です。
    -d D:\projectsプロジェクトを作成するディレクトリを指定します。この場合、D:\projectsに、MyGameというプロジェクト(フォルダ)が生成されます。
  2. プロジェクトフォルダが D:\projects\MyGame として生成されていると思うので確認してみてください。

Windows版 Edit

前項で作成したMyGameプロジェクトをWindows版としてビルド、実行する手順です。

  1. VisualStudio2013(もしくは2012)がインストールされていなければインストールしてください。
  2. D:\projects\MyGame\proj.win32\MyGame.sln をダブルクリックしてVisualStudio2013を起動します。
    アップグレードのダイアログが表示されるので、OKを押してアップグレードを行ってください。
    プロジェクトファイルがVisualStudio2013向けにアップグレードされます。
  3. ツールバー>ビルド>ソリューションのリビルド で、ソリューションをリビルドします。
    ビルドが開始され、出力ウィンドウにずらずらーっとビルドログが出力されます。
    よく見るとwarningが大量に出ていたりしますが、とりあえず気にしないでください。
    (略)
    4>  MyGame.vcxproj -> D:\projects\MyGame\proj.win32\Debug.win32\MyGame.exe
    ========== すべてリビルド: 4 正常終了、0 失敗、0 スキップ ==========
    な感じでログが完了していればビルドは成功です。
  4. ツールバー>デバッグ>デバッグ開始 でアプリケーションを実行します。
    HelloWorld なウィンドウが立ち上がれば成功です。
    cocos2dx_006_001.PNG

Android版 Edit

前項で作成したMyGameプロジェクトをAndroid版としてビルド、実行する手順です。
Android版が必要が必要無ければこの項は無視してかまいません。

  1. Androidの開発環境が必要です。
    開発環境が整っていない場合 Android開発環境の構築 を参考にして開発環境を構築してください。
    Android NDKも必須です。上記ページを参考に環境を構築してください。
    NDKは、r9dを使用してください、r8でもr10でもダメです。
    公式にはリンクがはられていないようなので、直リンクからr9dをダウンロードしてください。
    64bitOSはこちら https://dl.google.com/android/ndk/android-ndk-r9d-windows-x86_64.zip
    32bitOSはこちら https://dl.google.com/android/ndk/android-ndk-r9d-windows-x86.zip
  2. 環境変数の設定
    前項のCocos2d-xの開発環境構築で、環境変数の設定が完了している必要があります。
    Windowsのシステム環境変数に以下がきちんと設定されているか確認してください。
    環境変数名
    ANDROID_SDK_ROOTC:\Android\android-sdk
    NDK_ROOTC:\Android\android-ndk
    これらの環境変数は、後述する build_native.py が内部で参照しています。
  3. コマンドプロンプトからビルドを実行
    Eclipseで設定すればEclipse上からビルドできますが、基本としてはCocos2d-xのビルドはPythonファイルで外部からビルドします。
    以下、Pythonファイルからビルドする基本的な手順です。
    ビルドだけで、実行はまだです。
    1. コマンドプロンプトを立ち上げ、プロジェクトのandroidフォルダに移動
      cd /d D:\projects\MyGame\proj.android
    2. 続けて、ビルド用のPythonファイルを実行
      build_native.py
      すると、ビルドが開始されます。
      以下のようなログが出力されて終了すればビルドは成功です。
      cocos2dx_003_001.PNG
      Warningが結構出ますが、とりあえずスルーで…。
  4. Eclipseを起動
    簡単のため、プロジェクト用のEclipseワークスペースとしてMyGameのディレクトリをそのまま指定します。
    Eclipse起動時、もしくはEclipse起動後のツールバーのファイル>ワークスペースの切り替え>その他
    で表示されるワークスペース・ランチャーダイアログに、MyGameのパスを指定します。
    cocos2dx_004_002.PNG
  5. Eclipseの設定
    1. ツールバーの ウィンドウ>設定>一般>ワークスペース>リンクされたリソース で、『新規』ボタンを押します。
      名前は『COCOS2DX』で、ロケーションを『C:\cocos2d-x\cocos2d-x-3.2』にしてOKを押します。(この設定は必要ないかもしれません)
    2. ツールバーの ウィンドウ>設定>C/C++>ビルド>環境 で、『追加』ボタンを押します。
      名前は『NDK_ROOT』で、値を『C:\Android\android-ndk』にしてOKを押します。
    3. ツールバーの ウィンドウ>設定>C/C++>コード解析 で、『Syntax and Semantic Errors』のチェックを外し、適用ボタンを押します。
  6. Cocos2d-xライブラリプロジェクトを追加
    『ファイル>新規>プロジェクト』で、新規プロジェクトダイアログを開きます。
    cocos2dx_004_003.PNG
    『Android>既存コードからのAndroidプロジェクト』を選択して『次へ』ボタンを押します。
    cocos2dx_004_004.PNG
    『プロジェクトのインポートダイアログ』が表示されたら、ルート・ディレクトリーの参照ボタンを押し、フォルダーの箇所に
    D:\projects\MyGame\cocos2d\cocos\platform\android\java
    を指定し、OKボタンを押します。
    cocos2dx_004_008.PNG
    プロジェクト名にlibcocos2dxが表示されていることを確認して、完了ボタンを押します。
    cocos2dx_004_005.PNG
    パッケージエクスプローラーにlibcocos2dxが表示されていれば成功です。
  7. ゲーム本体のプロジェクトを追加
    前項のCocos2d-xライブラリプロジェクトと同じ要領で、ゲーム本体のプロジェクト、今回で言う所のMyGameプロジェクトを追加します。
    手順は前項と全く一緒で、『プロジェクトのインポートダイアログ』のルート・ディレクトリーのフォルダー指定を
    D:\projects\MyGame\proj.android
    とします。
    プロジェクト名にMyGameが表示されていることを確認して、完了ボタンを押します。
    cocos2dx_004_006.PNG
    パッケージエクスプローラーにMyGameが表示されていれば成功です。
    • 完了ボタンを押した際に、
      プロジェクト説明が無効です
      なエラーが出る場合があります。その場合は、ファイル>インポート>一般 >既存プロジェクトをワークスペースへ からプロジェクトをインポートしてみてください。
      cocos2dx_004_009.PNG
  8. パッケージエクスプローラーに2つのプロジェクトが追加されているかを確認
    libcocos2dxとMyGame(もしくはproj.android)が存在するか確認します。
    cocos2dx_004_007.PNG
    上記のようになっていれば、成功です。
  9. アプリケーションの実行
    Eclipseのパッケージエクスプローラーのproj.androidプロジェクトを右クリック>デバッグ>Androidアプリケーション から開始します。
    Android端末が適切に接続されている、もしくは仮想デバイスが適切に設定されていれば、アプリケーションが実行されるはずです。

添付ファイル: filecocos2dx_004_007.PNG 211件 [詳細] filecocos2dx_004_009.PNG 208件 [詳細] filecocos2dx_004_006.PNG 224件 [詳細] filecocos2dx_004_005.PNG 219件 [詳細] filecocos2dx_004_008.PNG 221件 [詳細] filecocos2dx_004_004.PNG 220件 [詳細] filecocos2dx_004_003.PNG 227件 [詳細] filecocos2dx_004_002.PNG 205件 [詳細] filecocos2dx_003_001.PNG 264件 [詳細] filecocos2dx_006_001.PNG 228件 [詳細] filecocos2dx_002_001.PNG 258件 [詳細] filecocos2dx_005_001.PNG 249件 [詳細] filepython_003.PNG 205件 [詳細] filepython_002.PNG 213件 [詳細] filepython_001.PNG 234件 [詳細] filecocos2dx_001_002.PNG 203件 [詳細] filecocos2dx_001_001.PNG 214件 [詳細]

リロード   新規 編集 凍結 差分 添付 複製 名前変更   ホーム 一覧 単語検索 最終更新 バックアップ リンク元   ヘルプ   最終更新のRSS
Last-modified: 2014-12-16 (火) 23:45:11 (888d)