Open 3D Engine のインストール(Windows 上)
o3de の URL: https://github.com/o3de/o3de
前準備
Build Tools for Visual Studio 2026 のインストール(Windows 上) [クリックして展開]
Build Tools for Visual Studio は,Visual Studio の IDE を含まない C/C++ コンパイラ,ライブラリ,ビルドツール等のコマンドライン向け開発ツールセットである。インストール済みの場合、この手順は不要である。
管理者権限のコマンドプロンプトで以下を実行する。管理者権限のコマンドプロンプトを起動するには、Windows キーまたはスタートメニューから「cmd」と入力し、表示された「コマンドプロンプト」を右クリックして「管理者として実行」を選択する。
REM VC++ ランタイム
winget install --scope machine --id Microsoft.VCRedist.2015+.x64 -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --override "/quiet /norestart"
REM Build Tools + Desktop development with C++(VCTools)+ 追加コンポーネント(一括)
winget install --scope machine --id Microsoft.VisualStudio.BuildTools -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --override "--quiet --wait --norestart --nocache --add Microsoft.VisualStudio.Workload.VCTools --includeRecommended --add Microsoft.VisualStudio.Workload.MSBuildTools --add Microsoft.VisualStudio.Component.VC.CMake.Project --add Microsoft.VisualStudio.Component.VC.Llvm.Clang --add Microsoft.VisualStudio.Component.VC.Llvm.ClangToolset --add Microsoft.VisualStudio.Component.Windows11SDK.26100"
--add で追加されるコンポーネント
上記のコマンドでは,まず Build Tools 本体と Visual C++ 再頒布可能パッケージをインストールし,次に setup.exe を用いて以下のコンポーネントを追加している。
VCTools:C++ デスクトップ開発ワークロード(--includeRecommendedにより、MSVC コンパイラ、C++ AddressSanitizer、vcpkg、CMake ツール、Windows 11 SDK 等の推奨コンポーネントが含まれる)VC.Llvm.Clang:Windows 向け C++ Clang コンパイラClangCL:clang-cl ツールセットを含むコンポーネントグループ(MSBuild から Clang を使用するために必要)VC.CMake.Project:Windows 向け C++ CMake ツールWindows11SDK.26100:Windows 11 SDK(ビルド 10.0.26100)
インストール完了の確認
winget list Microsoft.VisualStudio.BuildTools
上記以外の追加のコンポーネントが必要になった場合は Visual Studio Installer で個別にインストールできる。
Visual Studio の機能を必要とする場合は、追加インストールできる。
Python 3.12 のインストール(Windows 上) [クリックして展開]
以下のいずれかの方法で Python 3.12 をインストールする。Python がインストール済みの場合、この手順は不要である。
方法1:winget によるインストール
管理者権限のコマンドプロンプトで以下を実行する。管理者権限のコマンドプロンプトを起動するには、Windows キーまたはスタートメニューから「cmd」と入力し、表示された「コマンドプロンプト」を右クリックして「管理者として実行」を選択する。
winget install --scope machine --id Python.Python.3.12 -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --override "/quiet InstallAllUsers=1 PrependPath=1 Include_pip=1 Include_test=0 Include_launcher=1 InstallLauncherAllUsers=1"
--scope machine を指定することで、システム全体(全ユーザー向け)にインストールされる。このオプションの実行には管理者権限が必要である。インストール完了後、コマンドプロンプトを再起動すると PATH が自動的に設定される。
方法2:インストーラーによるインストール
- Python 公式サイト(https://www.python.org/downloads/)にアクセスし、「Download Python 3.x.x」ボタンから Windows 用インストーラーをダウンロードする。
- ダウンロードしたインストーラーを実行する。
- 初期画面の下部に表示される「Add python.exe to PATH」に必ずチェックを入れてから「Customize installation」を選択する。このチェックを入れ忘れると、コマンドプロンプトから
pythonコマンドを実行できない。 - 「Install Python 3.xx for all users」にチェックを入れ、「Install」をクリックする。
インストールの確認
コマンドプロンプトで以下を実行する。
python --version
バージョン番号(例:Python 3.12.x)が表示されればインストール成功である。「'python' は、内部コマンドまたは外部コマンドとして認識されていません。」と表示される場合は、インストールが正常に完了していない。
Git のインストール(Windows 上) [クリックして展開]
管理者権限のコマンドプロンプトで以下を実行する.管理者権限は,winget の --scope machine オプションでシステム全体にインストールするために必要となる.
REM Git をシステム領域にインストール
winget install --scope machine --id Git.Git -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --override "/VERYSILENT /NORESTART /NOCANCEL /SP- /CLOSEAPPLICATIONS /RESTARTAPPLICATIONS /COMPONENTS=""icons,ext\reg\shellhere,assoc,assoc_sh"" /o:PathOption=Cmd /o:CRLFOption=CRLFCommitAsIs /o:BashTerminalOption=MinTTY /o:DefaultBranchOption=main /o:EditorOption=VIM /o:SSHOption=OpenSSH /o:UseCredentialManager=Enabled /o:PerformanceTweaksFSCache=Enabled /o:EnableSymlinks=Disabled /o:EnableFSMonitor=Disabled"
CMakeのインストール(Windows 上) [クリックして展開]
管理者権限のコマンドプロンプトで以下を実行する。管理者権限のコマンドプロンプトを起動するには、Windows キーまたはスタートメニューから「cmd」と入力し、表示された「コマンドプロンプト」を右クリックして「管理者として実行」を選択する。
REM CMake をシステム領域にインストール
winget install --scope machine --id Kitware.CMake -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --override "/qn /norestart ADD_CMAKE_TO_PATH=System"
Git LFS のダウンロード,インストール
- Git Large File Storage (Git LFS) のページを開く
- 「Download」をクリック
- 「Download」をクリック
- ライセンス条項の確認
- インストールディレクトリの設定
既定(デフォルト)のままでよい.「Next」をクリック.
- インストール終了の確認
- git フックのインストール
Windows では,コマンドプロンプトを管理者として実行し, 次のコマンドを実行する.
git lfs install
Git のパーソナルアクセストークンの発行
- GitHub のページを開く
- サインインする
GitHub に未登録のときは,サインインの前に GitHub への登録を行う. - 電子メールアドレスのベリファイをまだ行っていない場合には,
次の手順で,
電子メールアドレスのベリファイを行う.
- メニューで「Settings」を選ぶ.
- 「Developer settings」をクリック
- 「Personal access tokens」をクリック
- 「Generate new token」をクリック
- Note のところに記入する
- 範囲を選ぶ
ここでは,「repo」にチェックしている.
- 「Generate token」をクリック
- トークンが表示される.手元に保存する.これを再びオンラインで表示などはできない.これは自分で管理するもの(自分で管理し公開などはしない)
- メニューで「Settings」を選ぶ.
Git クリデンシャル・マネージャのインストール
- 次のページを開く
- Windows のところのリンクをクリック.
- Windows 版を選ぶ
- ダウンロードしたファイルを用いて,インストールを行う.
Open 3D Engine のビルド
- 以下の手順を管理者権限のコマンドプロンプトで実行する
(手順:Windowsキーまたはスタートメニュー →
cmdと入力 → 右クリック → 「管理者として実行」)。 - レポジトリのクローン
mkdir c:\tools cd c:\tools git clone https://github.com/o3de/o3de.git
- Python ランタイムのインストール
cd c:\tools cd o3de python\get_python.bat
- cmake の実行
Qt-5.15.2 などがダウンロードされる.
mkdir c:\tools\o3de\3rdparty mkdir build cd build cmake .. -A x64 -T host=x64 -DLY_3RDPARTY_PATH=c:/tools/o3de/3rdparty -DLY_UNITY_BUILD=ON -DLY_PROJECTS=AutomatedTesting
- エディタとアセットビルダのビルド
cmake --build . --target AutomatedTesting.GameLauncher AssetProcessor Editor --config profile -- /m
- 終了の確認
エラーメッセージが出ていないこと
新しいプロジェクトの作成
- いまビルドしたエンジンを登録する操作
cd c:\tools cd o3de scripts\o3de.bat register --this-engine
- 新しいプロジェクトのセットアップ,プロジェクトへのエンジンの登録
「c:\tools\o3de-peoject」のところには,プロジェクトのパスを指定.
cd c:\tools cd o3de scripts\o3de.bat create-project --project-path c:\tools\o3de-project cd c:\tools\o3de-project c:\tools\o3de\scripts\o3de.bat register --project-path c:\tools\o3de-project
- プロジェクトのビルド
先ほどの cmake と同じオプションで実行する.
mkdir build cd build cmake .. -A x64 -T host=x64 -DLY_3RDPARTY_PATH=c:/tools/o3de/3rdparty cmake --build . --target AssetProcessor Editor --config profile -- /m