最終更新日 2014/04/25
Cocos2d-x 3.0 rc0 の開発環境構築手順をまとめます。

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

目次 Edit

まえおき Edit

  • インストールするCocos2d-xのバージョンは3.0rc0で、インストール先は C:\cocos2d-x\cocos2d-x-3.0rc0 とします。
  • インストールするPythonのバージョンは2.7.6で、インストール先は C:\Python27 とします。
  • Windows版の開発には VisualStudio 2013 を使用します。
    Cocos2d-x 3.0 は C++11 の機能を使用しているため、VisualStudio 2012 以降のバージョンが必要です。
    無料のExpressバージョンでも問題ありません。
    VisualStudio 2010は使用不可能です。

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

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

  1. Cocos2d-xの公式ダウンロードサイト http://www.cocos2d-x.org/download にアクセスして、対象のパッケージをダウンロードします。
    Download v3.0 rc0 をクリックしてダウンロードして下さい。
    cocos2dx_001_001.PNG
  2. ダウンロードした cocos2d-x-3.0rc0.zip を解凍します。
  3. 解凍された cocos2d-x-3.0rc0 フォルダを C:\cocos2d-x 以下にフォルダごと移動します。
    ↓こんなフォルダ階層になります。
    cocos2dx_001_002.PNG
  4. 以上でCocos2d-x本体のインストールは完了です。

Pythonのインストール Edit

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

  1. Python日本語公式サイト http://www.python.jp/ にアクセスして、2.7.6のWindowsインストーラをダウンロードします。
    Python 2.7.6 以下にある、Windowsインストーラからダウンロードしてください。
    python_001.PNG
  2. インストーラを実行してインストールを完了します。
    インストールオプションはデフォルトのままで問題ありません。
  3. インストールフォルダにパスを通します。
    システム環境変数のPathに C:\Python27 を追記して、パスを通してください。
  4. コマンドプロンプトを立ち上げ、
    python --version
    と打ち込んで、
    Python 2.7.6
    と表示されれば、Pythonの準備は完了です。

Cocos2d-xの環境設定 Edit

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

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

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

  1. コマンドラインから、
    C:\cocos2d-x\cocos2d-x-3.0rc0\setup.py
    を実行します。
  2. 設定されていない環境変数がある場合、
    Please enter its path (or press Enter to skip):
    という表示が出て、パスを指定するか、もしくはスキップするかを問われます。
    スキップする場合はそのままエンターキーを押し、指定する場合は、パスを指定してエンターキーを押して次に進んでください。
    下記のスクリーンショットは、ANT_ROOTの設定を問われているタイミングです。
    (必要ないのでここではスキップします)
    cocos2dx_005_001.PNG
  3. 環境変数を設定した場合は、PCを再起動する旨のメッセージが出るので、PCを再起動しましょう。
    cocos2dx_005_002.PNG
  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を押して先に進んでください。
  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も必須です。上記ページを参考に環境を構築してください。
  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
  4. Eclipseを起動
    簡単のため、プロジェクト用のEclipseワークスペースとしてMyGameのディレクトリをそのまま指定します。
    Eclipse起動時、もしくはEclipse起動後のツールバーのファイル>ワークスペースの切り替え>その他
    で表示されるワークスペース・ランチャーダイアログに、MyGameのパスを指定します。
    cocos2dx_004_002.PNG
  5. Eclipseの設定
    1. ツールバーの ウィンドウ>設定>一般>ワークスペース>リンクされたリソース で、『新規』ボタンを押します。
      名前は『COCOS2DX』で、ロケーションを『C:\cocos2d-x\cocos2d-x-3.0rc0』にして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\2d\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_006_001.PNG 317件 [詳細] filecocos2dx_005_002.PNG 281件 [詳細] filecocos2dx_005_001.PNG 292件 [詳細] filecocos2dx_004_009.PNG 268件 [詳細] filecocos2dx_004_008.PNG 246件 [詳細] filecocos2dx_004_007.PNG 291件 [詳細] filecocos2dx_004_006.PNG 258件 [詳細] filecocos2dx_004_005.PNG 263件 [詳細] filecocos2dx_004_004.PNG 252件 [詳細] filecocos2dx_004_003.PNG 317件 [詳細] filecocos2dx_004_002.PNG 279件 [詳細] filecocos2dx_004_001.PNG 123件 [詳細] filecocos2dx_003_001.PNG 294件 [詳細] filecocos2dx_002_003.PNG 145件 [詳細] filecocos2dx_002_002.PNG 168件 [詳細] filecocos2dx_002_001.PNG 281件 [詳細] filecocos2dx_001_002.PNG 255件 [詳細] filecocos2dx_001_001.PNG 275件 [詳細] filepython_001.PNG 246件 [詳細]

リロード   新規 編集 凍結 差分 添付 複製 名前変更   ホーム 一覧 単語検索 最終更新 バックアップ リンク元   ヘルプ   最終更新のRSS
Last-modified: 2014-04-25 (金) 01:46:33 (1124d)