如何在开发环境中使用 .NET Aspire 的最新每日构建版本

如何在开发环境中使用 .NET Aspire 的最新每日构建版本

aspire An opinionated, cloud ready stack for building observable, production ready, distributed applications in .NET 项目地址: https://gitcode.com/gh_mirrors/as/aspire

前言

对于大多数开发者来说，官方发布的 .NET Aspire 稳定版本已经足够使用。但如果你希望体验最新的功能改进，或者需要测试尚未正式发布的特性，使用每日构建(Daily Build)版本是一个不错的选择。本文将详细介绍如何配置开发环境以使用 .NET Aspire 的最新每日构建版本。

准备工作

在开始之前，请确保你的开发环境满足以下要求：

1. 已安装最新版本的 .NET SDK
2. 已安装 Docker Desktop 并确保其正常运行
3. 确保开发机器具备足够的资源运行容器化应用

配置本地 NuGet 源

为了避免影响其他项目的构建，建议为 Aspire 项目创建独立的 NuGet 配置文件：

dotnet new nugetconfig

这将在当前目录下创建一个 nuget.config 文件，用于管理项目特定的 NuGet 包源。

添加每日构建源

.NET Aspire 的每日构建版本发布在特定的 NuGet 源上，需要手动添加：

dotnet nuget add source --name dotnet9 https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet9/nuget/v3/index.json

如果你使用了包源映射(Package Source Mapping)功能，还需要在 nuget.config 中添加以下配置：

<packageSourceMapping>
  <packageSource key="dotnet9">
    <package pattern="Aspire.*" />
    <package pattern="Microsoft.Extensions.ServiceDiscovery*" />
    <package pattern="Microsoft.Extensions.Http.Resilience" />
  </packageSource>
</packageSourceMapping>

这样可以确保相关包只从指定的源获取，避免潜在的包冲突问题。

安装最新 CLI 工具

.NET Aspire 提供了专门的命令行工具来简化开发流程。安装最新每日构建版本的 CLI 工具：

dotnet tool install --global aspire.cli --prerelease --source https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet9/nuget/v3/index.json

安装完成后，aspire 命令将全局可用，你可以通过它执行各种 Aspire 相关操作。

创建新项目

使用以下命令创建一个全新的 .NET Aspire 项目：

aspire new

这个命令会自动更新 Aspire 项目模板，之后这些模板也会出现在 Visual Studio 和 dotnet new 命令中。

项目创建完成后，你会看到一个解决方案文件(.slnx)和至少两个项目文件。解决方案文件使用了新的扩展名以支持 Aspire 的特定功能。

运行项目

确保 Docker Desktop 正在运行，然后执行：

aspire run

这个命令会自动构建并启动你的 Aspire 应用程序及其所有依赖服务。

常见问题提示：如果遇到运行错误，可能是项目中的 Aspire 包版本需要更新。作为备用方案，你可以直接在应用宿主项目(*.AppHost)上使用 dotnet run 命令启动应用。

注意事项

1. 每日构建版本是未经过完整测试的预览版本，可能存在不稳定因素
2. 不建议在生产环境中使用每日构建版本
3. 使用过程中如发现问题，建议及时反馈给开发团队
4. 定期更新到最新每日构建版本以获取最新修复和改进

通过以上步骤，你就可以在开发环境中体验 .NET Aspire 的最新功能和改进了。记得定期检查更新，因为每日构建版本会频繁发布新内容。

aspire An opinionated, cloud ready stack for building observable, production ready, distributed applications in .NET 项目地址: https://gitcode.com/gh_mirrors/as/aspire