获取季节引擎

三条进来的路：把库装进你自己的项目，克隆仓库读它，或从 Microsoft Store 安装打包的参考应用，在你对任何东西做出承诺之前先看。

库

引擎是一个包，SeasonEngine，目前版本 0.2.0。

dotnet add package SeasonEngine

或者直接引用项目，这在版本号还以零开头时是更好的选项：

<ProjectReference Include="..\Season\Season.csproj" />

目前请优先用项目引用

在 0.2.0，API 仍然在发布之间变动，而项目引用意味着你可以用调试器步入引擎代码、读解释某个值的注释、在本地打补丁而不必等一个包。包的存在是为了等到这不再是明智默认的那一天。

NuGet 包 GitHub 仓库 MIT 许可证

源码

git clone https://github.com/SeasonRealms/SeasonEngine
cd SeasonEngine

# The 2D sample builds from a fresh clone.
dotnet run --project Samples/Creator -f net10.0-windows10.0.19041.0

Season.slnx 打开全部。先看什么取决于你在决定什么：

如果你想评判	读
渲染器	帧看 `Season/Rendering/RenderPass.cs`，然后看 `Effects/` 里的 compute 通道。
你将针对写的 API	`Season/Controls/` — 十六个类，`Control.cs` 定义了更新契约。
跨平台结构	`Season/Basic/DeviceServices.cs`，然后 `Season/Platforms/` 下的一个目录。
应用长什么样	2D 看 `Samples/Creator/App.cs`，3D 看 `Apps/Engine/App.cs`。

Apps/Engine 不能从干净克隆构建

它带着一条对 AI 项目的无条件项目引用，而 AI 项目在本仓库之外。 Samples/Creator 没有外部依赖，是应该先跑的那个。细节在参考应用页。

打包的应用

参考应用作为演示构建在 Microsoft Store 上。在你安装 SDK 之前，这是看渲染器是否长成你想要的样子最快的方式。

Windows

计划中

Windows 构建是 MSIX、自包含，并自带自己的 Windows App SDK，所以它不需要安装运行时，也相应地很大。iOS 和 Android 构建作为目标框架存在，但没有发布到各自的商店。

逐平台说明

平台	目标框架	你需要什么
Windows	`net10.0-windows10.0.19041.0`	.NET 10 SDK 和 Windows App SDK 工作负载。一块支持 Direct3D 12 的 GPU。只在 Windows 上构建时才作为目标框架出现。
Linux	`net10.0`	.NET 10 SDK、Vulkan 驱动和用于窗口的 GTK 3。普通的 `net10.0` 目标就是 Linux 那个。
Android	`net10.0-android`	.NET Android 工作负载；API 33 或更高；一台支持 Vulkan 的设备或模拟器。
iOS	`net10.0-ios`	一台装 Xcode 和 .NET iOS 工作负载的 Mac。参考应用要求 iOS 17 或更高。
macOS	`net10.0-maccatalyst`	Mac Catalyst 工作负载。Metal。
浏览器	`net10.0-browser`	一个支持 WebGPU 的浏览器。作为由 ASP.NET 宿主服务的 Blazor WebAssembly 客户端运行 — 三个项目而不是一个。

完整的版本和工作负载细节在需求与安装，每个后端的诚实状态在跨平台隔离。运行时支持取决于驱动和平台 SDK，就像取决于你选的目标一样。

一个最小应用，完整版

这就是一个可运行程序的全部。没有要生成的项目模板，也没有其他要配置的。

using System.Numerics;
using Season.Basic;

public sealed class MyApp : BaseApp
{
    public MyApp()
    {
        Title = "My Season App";
        DesignResolution = new Vector2(1280, 720);
        BasicResolution = new Vector2(1280, 720);
        BackgroundColor = Colors.White;
    }

    public override void Create()
    {
        base.Create();
    }
}

// Entry point, on Windows:
Season.Platforms.Windows.WindowsApp.Run(new MyApp());

接下来去哪里：入门指南用十三页把它带到一个点亮的 3D 场景，而应用与面板是解释 Create 和 Update 是干什么的那一页。

入门指南 →