社区工具包

更新: 2026-10-16 15:20:09   字数: 0 字   时长: 0 分钟

官方集成覆盖了主流技术栈，但生态里的数据库、消息中间件、工具成千上万。Community Toolkit 就是为这些场景准备的。

Community Toolkit 是什么

Community Toolkit 是一组由社区维护的 Aspire 集成，托管在 CommunityToolkit.Aspire.Hosting.* 命名空间下。它提供官方仓库中没有覆盖的资源类型，例如一些小众数据库、开发工具与框架。

安装方式与官方集成相同：

aspire add <integration-name>

或直接引用 NuGet 包：

<PackageReference Include="CommunityToolkit.Aspire.Hosting.Xxxx" Version="x.y.z" />

使用上的差异

维度	官方集成	Community Toolkit
维护者	Microsoft / Aspire 团队	社区
支持级别	有明确的官方支持策略	尽力而为，版本节奏可能不同
包名	Aspire.Hosting.*	CommunityToolkit.Aspire.Hosting.*
升级节奏	跟随 Aspire 发布节奏	可能滞后于 Aspire 主版本

生产使用前请评估

引入社区集成前建议确认：维护活跃度、最近的发布日期、是否支持您使用的 Aspire 主版本，以及是否有 Issue 长期未处理。

何时自己写一个

以下情况更适合自己编写集成（见编写自定义集成）：

• 内部私有组件，只在本组织使用。
• 对稳定性有强要求，不希望跟随社区节奏。
• 资源定义比较简单，几十行扩展方法即可完成。

查找集成

• 官方集成画廊：https://aspire.dev/integrations/ —— 支持按名称、标签、类别筛选。
• 也可以在终端中检索：

aspire add --help

• 或用 aspire docs search 在文档中搜索相关主题。

下一步

• 编写自定义集成
• 集成简介