要构建 Piccolo,您必须首先安装以下工具。
Visual Studio 2019(或更高版本)
CMake 3.19(或更高版本)
Git 2.1(或更新版本)
Xcode 12.3(或更高版本)
CMake 3.19(或更高版本)
Git 2.1(或更新版本)
apt安装以下软件包
sudo apt install libxrandr-dev sudo apt install libxrender-dev sudo apt install libxinerama-dev sudo apt install libxcursor-dev sudo apt install libxi-dev sudo apt install libglvnd-dev sudo apt install libvulkan-dev sudo apt install cmake sudo apt install clang sudo apt install libc++-dev sudo apt install libglew-dev sudo apt install libglfw3-dev sudo apt install vulkan-validationlayers sudo apt install mesa-vulkan-drivers
NVIDIA 驱动程序(AMD 和 Intel 驱动程序是开源的,因此由 mesa-vulkan-drivers 自动安装)
您可以执行build_windows.bat 。该批处理文件将生成项目,并自动构建Piccolo 引擎的发布配置。构建成功后,您可以在bin目录中找到PiccoloEditor.exe。
或者您可以使用以下命令先生成Visual Studio项目,然后在构建目录中打开解决方案并手动构建。
cmake -S . -B build
以下构建指令仅在 x86_64 的特定硬件上进行测试,不支持 M1 芯片。对于M1兼容,我们将稍后发布。
要编译 Piccolo,您必须安装最新版本的 Xcode。然后从项目根目录运行“cmake”,生成Xcode项目。
cmake -S . -B build -G "Xcode"
你可以用以下命令构建项目
cmake --build build --config Release
或者您可以执行build_macos.sh来构建二进制文件。
您可以执行build_linux.sh来构建二进制文件。
有关文档,请参阅 Wiki 部分。
我们注意到一些 Windows 上的开发者在调试时遇到 PiccoloEditor.exe 可以正常运行,但报出异常 Vulkan Validation Layer: Validation Error。您可以通过安装Vulkan SDK来解决这个问题(官方最新版本即可)。
当Unix Makefiles
生成器可用时,您可以使用以下命令构建compile_commands.json
。 compile_commands.json
是clangd
语言服务器所需的文件,它是 Emacs 中 cpp lsp-mode 的后端。
对于 Windows:
cmake -DCMAKE_TRY_COMPILE_TARGET_TYPE="STATIC_LIBRARY" -DCMAKE_EXPORT_COMPILE_COMMANDS=ON -S 。 -Bcompile_db_temp -G“Unix Makefiles”复制compile_db_tempcompile_commands.json。
目前物理调试渲染器仅在 Windows 上可用。您可以使用以下命令通过调试器项目生成解决方案。
cmake -S 。 -B 构建 -DENABLE_PHYSICS_DEBUG_RENDERER=ON
笔记:
请在重新生成解决方案之前清理构建目录。我们在直接使用以前的 CMakeCache 重新生成时遇到了构建问题。
当您启动 PiccoloEditor 时,物理调试渲染器将运行。我们已经同步了两个场景之间的摄像机位置。但物理调试渲染器中的初始相机模式是错误的。向下滚动鼠标滚轮一次会将物理调试渲染器的相机更改为正确的模式。
构建Linux | |
构建 macOS |