はじめに
Axmol Engine は、Cocos2d-x v4.0 からフォークされたオープンソースの C++ マルチプラットフォームゲームエンジンです。iOS / Android / Windows / macOS / WebAssembly / Xbox など幅広いプラットフォームに対応しています。
本記事では Android向けの開発環境セットアップ に絞って手順を紹介します。
環境
- macOS（Apple Silicon / Intel どちらでも可）
- Android Studio
- PowerShell 7（macOS では bash モードで動作可）
1. 事前準備
- brewがインストールされていることが前提です
PowerShell 7 のインストール
Axmol のセットアップスクリプトは PowerShell で書かれています。macOS / Linux では bash モードでも動作します。
brew install powershell
Android Studio のインストール
brew install --cask android-studio
または 公式サイト からダウンロードしてインストールします。
起動後、セットアップウィザードに従って以下をインストールしてください。
- Android SDK
- Android SDK Platform
- Android Virtual Device（エミュレーターを使う場合）
2. Axmol のインストール
リポジトリのクローン
git clone https://github.com/axmolengine/axmol.git
cd axmol
セットアップスクリプトの実行（Android 向け）
-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
3. プロジェクトの作成
axmol new -p com.yourname.hellocpp -d ./projects -l cpp HelloCpp
cd ./projects/HelloCpp
| オプション | 説明 |
|---|---|
-p |
Bundle Identifier（パッケージ名） |
-d |
プロジェクトの出力先ディレクトリ |
-l |
言語（cpp または lua） |
--portrait |
ポートレートモードのプロジェクトを生成（オプション） |
4. Android Studio で開く
IDE から開発・デバッグしたい場合は -c オプションでプロジェクトファイルを生成します。
axmol -p android -c
生成された proj.android フォルダを Android Studio で開きます。
File → Open → ./projects/HelloCpp/proj.android
5. よくあるエラーと対処法
No installed ndk found, required 23.3.*
NDK のバージョンが合っていない場合に発生します。Axmol ルートフォルダで以下を実行します。
./setup.ps1 -p android
Android Studio の SDK Manager からは対象バージョンをインストールできないため、必ずこのコマンドを使ってください。
Android SDK が見つからない
Flutter と共存している環境などで SDK パスが通っていない場合があります。
SDK の場所を確認
ls ~/Library/Android/sdk
環境変数を設定
export ANDROID_HOME=~/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools
まとめ
Axmol の Android セットアップは以下の3ステップで完了します。
-
./setup.ps1 -p androidで NDK を含む依存ツールを自動インストール -
axmol newでプロジェクト作成 -
axmol -p android -a arm64でビルド
Google Play 向けには -aab オプションを追加するだけで AAB を生成できます。