ProwlEngine/Prowl - 快速上手

由于 trendforge.devlive.top 访问受限，请切换到 trendforge.devlive.org 域名

项目介绍快速开始学习路径贡献者 23 增长趋势 Commit 历史代码统计生态关系项目时间线项目竞品上榜历史

Prowl Engine 5分钟快速开始

快速安装并运行MIT许可的C# 3D游戏引擎Prowl，体验类Unity的开发流程。

环境要求

支持的操作系统

macOS Windows Linux

运行环境

.NET 10 10.0 必需

所需工具

Git

克隆项目源代码

必需

IDE (Visual Studio, VSCode, Rider等)

打开解决方案文件并编译运行

必需

操作步骤

克隆项目仓库

使用Git将Prowl引擎源代码克隆到本地。

克隆Prowl引擎仓库

git clone https://github.com/ProwlEngine/Prowl.git

预期结果：：创建了一个名为'Prowl'的新目录，其中包含项目文件。

确保Git已正确安装并添加到系统路径。

安装.NET 10运行时

下载并安装.NET 10软件开发工具包(SDK)或运行时。

在Windows上使用winget安装.NET 10 SDK (其他系统请从官网下载)

winget install Microsoft.DotNet.SDK.10

验证.NET 10 SDK是否已安装

dotnet --list-sdks

预期结果：：输出的SDK列表中包含'10.0.x'版本。

请从微软官网下载最新.NET 10 SDK或运行时。

打开并编译项目

在您的IDE中打开Prowl.sln解决方案文件，然后编译并运行编辑器项目。

进入克隆的项目目录

cd Prowl

用默认IDE打开解决方案文件

start Prowl.sln (Windows) 或 open Prowl.sln (macOS) 或 使用IDE打开Prowl.sln

预期结果：：IDE成功加载了解决方案，并显示多个项目（如Prowl.Editor, Prowl.Runtime）。

建议使用Visual Studio 17.8.0+、VSCode或Rider。

运行编辑器

在IDE中设置'Prowl.Editor'为启动项目，然后运行它。

预期结果：：Prowl编辑器窗口成功启动，您可以看到一个类似Unity的界面，包含场景视图、层级窗口和检查器等面板。

首次启动可能需要一些时间来编译着色器和加载资源。

创建并测试一个简单场景

在编辑器中新建一个场景，添加一个3D对象并运行游戏测试。

预期结果：：在游戏视图中看到一个立方体（或您添加的任何对象），并且可以使用WASD键在场景视图中移动相机进行观察。

尝试使用顶部工具栏的'移动'、'旋转'、'缩放'工具来操作对象。

验证安装成功

确认Prowl编辑器已成功启动并能正常运行一个基础场景。

编辑器主窗口成功打开，界面元素显示正常

可以在场景视图中创建一个新的3D对象（如立方体）

点击'播放'按钮后，游戏视图开始渲染场景

编辑器控制台没有红色错误信息

快速提示

上手提示

Prowl的API和工作流程与Unity非常相似，Unity开发者可以快速上手。

开发效率

编辑器支持热重载脚本，修改C#代码后无需完全重启编辑器。

项目管理

项目使用.gitignore，构建输出和临时文件不会被提交。

调试

遇到问题时，可以检查编辑器的控制台窗口获取错误信息。

常见问题

编译时出现'找不到.NET 10'或类似的SDK错误。

请确保已安装.NET 10 SDK，并通过'dotnet --list-sdks'命令验证。

编辑器启动后界面显示异常或黑屏。

请确保您的显卡驱动程序是最新的。Prowl支持OpenGL、Vulkan和DirectX，请检查项目设置或系统兼容性。

游戏运行时没有声音。

检查系统音频设备是否正常工作，并在编辑器设置中确认音频已启用。

克隆仓库后，在IDE中打开解决方案文件报错。

尝试运行'dotnet restore'命令恢复项目依赖项，或者在IDE中右键解决方案选择'还原NuGet包'。

下一步

探索示例项目

在'Prowl.Samples'项目或社区分享的示例中学习更多功能。

阅读文档

访问官方文档或社区维基，深入了解引擎的各个模块。

加入社区

加入Discord服务器与其他开发者和贡献者交流。

创建自己的游戏

参考Unity的开发经验，开始构建您的第一个Prowl项目。