はじめに

Axmol Engine は、Cocos2d-x v4.0 からフォークされたオープンソースの C++ マルチプラットフォームゲームエンジンです。iOS / Android / Windows / macOS / WebAssembly / Xbox など幅広いプラットフォームに対応しています。

本記事では Android向けの開発環境セットアップ に絞って手順を紹介します。

環境

Axmol のセットアップスクリプトは PowerShell で書かれています。macOS / Linux では bash モードでも動作します。

brew install powershell

brew install --cask android-studio

または公式サイトからダウンロードしてインストールします。

起動後、セットアップウィザードに従って以下をインストールしてください。

git clone https://github.com/axmolengine/axmol.git

cd axmol

-p android を指定することで、Android 開発に必要な NDK が自動インストールされます。

./setup.ps1 -p android

バージョン	インストールされる NDK
axmol-v2	r23d（23.3.12186248）
axmol-v3	r27d

⚠️ NDK について注意 Android Studio の SDK Manager には対応する NDK バージョンが表示されないことがあります。 setup.ps1 -p android コマンドを使うことで正しいバージョンが自動インストールされます。

スクリプト完了後、ターミナルを再起動して環境変数を反映させます。

source ~/.zshrc  # または ~/.bashrc

axmol new -p com.yourname.hellocpp -d ./projects -l cpp HelloCpp

cd ./projects/HelloCpp

IDE から開発・デバッグしたい場合は -c オプションでプロジェクトファイルを生成します。

axmol -p android -c

生成された proj.android フォルダを Android Studio で開きます。

File → Open → ./projects/HelloCpp/proj.android

NDK のバージョンが合っていない場合に発生します。Axmol ルートフォルダで以下を実行します。

./setup.ps1 -p android

Android Studio の SDK Manager からは対象バージョンをインストールできないため、必ずこのコマンドを使ってください。

Flutter と共存している環境などで SDK パスが通っていない場合があります。

ls ~/Library/Android/sdk

export ANDROID_HOME=~/Library/Android/sdk

export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools

Axmol の Android セットアップは以下の3ステップで完了します。

Google Play 向けには -aab オプションを追加するだけで AAB を生成できます。