Elsa NuGet 包

Elsa 工作流是模块化的,并通过多个 NuGet 包分发。这使您可以选择所需的组件,确保轻量级集成到您的项目中。

核心 Elsa 包

开始使用 Elsa 时,您主要需要的是 Elsa 包。它是一个捆绑包,包含以下基本包:

  • Elsa.Api.Common
  • Elsa.Mediator
  • Elsa.Workflows.Core
  • Elsa.Workflows.Management
  • Elsa.Workflows.Runtime

要安装核心 Elsa 包,请使用 dotnet 命令行工具:

dotnet add package Elsa

尽管核心包提供了坚实的基础,但 Elsa 还为特殊场景提供额外的包。

Elsa 包源

Elsa 工作流包根据其稳定性和发布阶段通过各种源分发:

类型 URL
正式版 NuGet https://api.nuget.org/v3/index.json
发布候选版 (RC) NuGet https://api.nuget.org/v3/index.json
预览版 Feedz https://f.feedz.io/elsa-workflows/elsa-3/nuget/index.json

正式版

Elsa 的稳定版本通过 NuGet.org 分发。

发布候选版 (RC)

RC 包也通过 NuGet.org 提供。它们提供了即将发布功能的预览,允许用户在最终发布前进行测试和反馈。虽然 RC 包通常是稳定的,但在最终发布之前仍可能发生变化。

预览版

预览版本代表了 Elsa 最前沿的发展。当更改推送到 v3 分支时,它们会自动构建并部署到 Feedz 上的公共源。虽然它们提供了最新的特性和修复,但也可能引入破坏性变更。

要访问预览包,在使用 dotnet CLI 时包含源 URL 或将其添加到您的 NuGet.config

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <clear />
    <add key="NuGet official package source" value="https://api.nuget.org/v3/index.json" />
    <add key="Elsa 3 preview" value="https://f.feedz.io/elsa-workflows/elsa-3/nuget/index.json" />
  </packageSources>
</configuration>

版本策略

Elsa 遵循清晰的版本策略:

  • 已发布包:主版本.次版本.修订号(例如,3.0.1
  • 发布候选包:主版本.次版本.修订号-预览.X(例如,3.0.2-preview.64
  • 预览包:主版本.次版本.修订号-预览.X(例如,3.0.2-preview.128

除非发生重大变化,否则主版本保持一致。新功能会增加次版本号,而修复或小改进会提升修订号。

在本文档中