O3DE是一款具备实时渲染能力的3D引擎,由Linux基金会管理,项目主页见链接,项目源码托管在github。
O3DE目前支持多个平台,如下:
本文介绍构建方法。
下载代码
代码仓库中使用lfs来管理二进制文件,因此安装git时需要注意是否同步安装了lfs。
检查并初始化git lfs
。
git lfs --version
git lfs install
下载源码。
git clone https://github.com/o3de/o3de.git
准备构建工具
进入项目路径
假设o3de的源码下载至C:\o3de\
,在Windows平台的CMD可执行如下命令。
cd C:\o3de\
后续操作,如无特别说明,均在源码路径下。
配置项目
在CMD中执行如下命令:
cmake -B C:\o3de\build\windows ^
-S C:\o3de ^
-G "Visual Studio 16" ^
-DLY_UNITY_BUILD=ON ^
-DCMAKE_SYSTEM_VERSION=10.0 ^
-DLY_DISABLE_TEST_MODULES=ON ^
-DLY_3RDPARTY_PATH=C:\o3de-packages
执行本命令时,构建脚本会自动下载构建时依赖的其它开源软件,同时安装Python的三方软件,因此需要保持网络畅通。
假如执行命令过程中由于网络原因导致失败,则可以反复尝试几次。
部分选项的说明:
LY_UNITY_BUILD
,指定为ON
或者TRUE
,即开启CMake提供的Unity Build特性。
LY_DISABLE_TEST_MODULES
,指定为ON
或者TRUE
,即不生成UT代码的工程。
注册路径
在CMD中执行如下命令:
call .\scripts\o3de.bat register --this-engine
启动编译
在CMD中执行如下命令:
cmake --build C:\o3de\build\windows --target Editor AssetProcessor --config profile -- /m
按照CMake的文档,--
后的选型将直接传递给平台自身的构建系统,以前述配置,即MSBuild
,官方指导的链接。
依据官方文档,可知/m
选项用于控制构建时的并发度,按照1C2G的经验值,结合CPU和内存的数量来评估具体的参数值。
考虑到O3DE项目的源码量比较大,在百万级别,因此在构建时注意不要把CPU或者内存占满:
/m:6
。/m:3
。同样可以使用Visual Studio
的IDE来构建。在C:\o3de\build\windows
下可以找到O3DE.sln
,使用Visual Studio
打开,找到Editor
,指定为启动项目,然后即可开始编译。
在构建过程中,机器的CPU、内存、硬盘都被编译器占满,此时视机器的性能,安心等待1小时左右。假如机器配置低的话,构建时间会相应延长。
另外O3DE项目允许开发者使用Clang来完成构建,操作文档见链接。