Axmol Engine のインストールとビルド（Windows 上）

前準備

Python 3.12 のインストール

Pythonのインストールを行い、Pythonのプログラムを実行する環境を整える。扱う環境は、Windows搭載パソコンである。金子研究室では、Python 3.12.10を推奨する。

REM Python 3.12 をシステム領域にインストール
winget install --id Python.Python.3.12 -e --scope machine --silent --accept-source-agreements --accept-package-agreements --override "/quiet InstallAllUsers=1 PrependPath=1 Include_test=0 Include_pip=1 Include_launcher=1 InstallLauncherAllUsers=1 TargetDir=\"C:\Program Files\Python312\""

REM Python と Scripts を PATH 先頭に追加
powershell -NoProfile -Command "$p='C:\Program Files\Python312'; $s=\"$p\Scripts\"; $c=[Environment]::GetEnvironmentVariable('Path','Machine'); if((Test-Path $p) -and (';'+$c+';' -notlike \"*;$p;*\") -and (';'+$c+';' -notlike \"*;$s;*\")){[Environment]::SetEnvironmentVariable('Path',\"$p;$s;$c\",'Machine')}"

python --version

Axmol Engine のビルドスクリプトは Python 2 系・3 系のいずれでも動作する。このページでは Python 3.12 を用いる。Python 公式サイトから Windows 用のインストーラをダウンロードし，インストールする。インストール時に「Add python.exe to PATH」を有効にすること。

PowerShell 7 のインストール

Axmol Engine のセットアップスクリプトは PowerShell で実行する。Windows 10 以降には PowerShell 5.x が標準で入っており，これでも動作するが，PowerShell 7 の使用が推奨されている（特に Android 向けビルドで，コマンドラインツールの zip 展開に PowerShell 5 では失敗する場合があるため）。PowerShell 7 の配布ページから Windows 用のインストーラをダウンロードし，インストールする。

Visual Studio 2022 以降のインストール（Windows 上）

Axmol Engine の Windows 上でのビルドには，Visual Studio 2022（バージョン17.9以上）または Visual Studio 2026 が必要である。MSVC のツールセットは v14.39 以上が必要である。Visual Studio Installer で「C++ によるデスクトップ開発」ワークロードを選択してインストールする。UWP（Xbox 向けを含む）開発を行う場合は，「WinUI アプリケーション開発ツール」ワークロードと，オプション コンポーネントの「C++ Universal Windows Platform tools」も追加する。

Visual Studio の完全な IDE を導入せず，Build Tools for Visual Studio だけを使ってビルドすることもできる。ただし，開発のしやすさの点から Visual Studio の IDE を導入することが推奨されている。

Android 向けにビルドする場合

Axmol Engine では，Android Studio や Android NDK を個別にインストールする必要はない。後述のセットアップスクリプトに -p android を付けて実行すると，必要な NDK（2026年時点の Axmol v2 系では r23d 以上）が自動的にダウンロードされ，環境変数も自動的に設定される。Android Studio でプロジェクトを開いて開発したい場合は，別途 Android Studio をインストールしておく。

ダウンロードと展開，ビルド

1. Axmol Engine の GitHub リポジトリのリリースページを開く

   https://github.com/axmolengine/axmol/releases

   ZIP ファイルからインストールすると，Windows の制限によって PowerShell スクリプトの実行がブロックされる場合がある。この問題を避けるため，Git を使って次のようにリポジトリを複製（clone）する方法が推奨されている。

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

2. PowerShell を開き，スクリプトの実行を許可するポリシーを設定する（複製したリポジトリを使う場合）。

   Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force

3. 複製したディレクトリで，セットアップスクリプトを実行する。依存関係のインストールと，環境変数の設定が行われる。

   ./setup.ps1

   Android 向けのビルドも行いたい場合は，次のように -p android を付けて実行する。この場合，Android SDK・NDK が自動的にダウンロードされる。

   ./setup.ps1 -p android

4. スクリプトの実行が終わったら，ターミナルを再起動する。環境変数の設定を反映させるためである。
5. 新しく PowerShell を開き，axmol コマンドが使えることを確認する。

   axmol --version

   エラーメッセージが出ていないことを確認する。

Axmol Engine でプロジェクトの作成

ここでの設定は，プロジェクト名を hoge00，パッケージ名を hoge.hoge.com とする。

1. PowerShell を開く。
2. プロジェクトを作成したいディレクトリに移動し，次のコマンドでプロジェクトを新規作成する。-l には cpp（C++）または lua（Lua）を指定できる。ここでは C++ を選ぶ。

   axmol new -p hoge.hoge.com -d .\ -l cpp hoge00
   cd hoge00

3. 結果を確認する。エラーメッセージが出ていないこと，プロジェクトのディレクトリと必要なファイルが作成されていることを確認する。
4. Windows（win32）向けに，Visual Studio のソリューションファイルを生成する。-c オプションを付けると，IDE 用のプロジェクトファイル（Visual Studio のソリューション）が生成される。

   axmol -p win32 -c

5. 生成された build ディレクトリの下にあるソリューションファイルを開く。Visual Studio 2022 を使う場合は拡張子が .sln，Visual Studio 2026 を使う場合は .slnx のファイルである。
6. Visual Studio が起動するので，確認する。
7. 「ソリューション」を右クリックし，「ビルド」→「ソリューションのビルド」と操作してビルドする。
8. ビルドの終了を確認する。エラーメッセージが出ていないこと。
9. 「デバッグ」→「デバッグなしで開始」と操作して，実行してみる。
10. Hello World の画面が開くことを確認する。
11. ソースコードやリソース（画像・音声など）を追加したときは，Visual Studio のプロジェクトファイルを作り直す必要がある。その場合は，ソリューションを閉じてから，手順４のコマンドをもう一度実行する。