该技能名为 dotnet,来自 stuartf303/vandaemon,用于配置 .NET 10 项目、执行构建并管理 C# 运行时。其适用场景包括构建与运行解决方案、新增项目、管理 NuGet 包以及进行相关配置。
目标框架与项目结构
VanDaemon 的所有项目均面向 .NET 10。解决方案采用 Clean Architecture 布局,为 API、Application、Core、Infrastructure、Plugins 以及前端(Blazor WASM)分别建立独立项目。所有项目共享一致的约定:启用可空引用类型、JSON 枚举序列化与结构化日志模式。
快速开始:构建与运行
构建整个解决方案:
dotnet build VanDaemon.sln
运行 API(终端 1):
cd src/Backend/VanDaemon.Api && dotnet run
运行 Blazor 前端(终端 2):
cd src/Frontend/VanDaemon.Web && dotnet run
运行测试:
dotnet test VanDaemon.sln
创建新项目
在 plugins 目录中创建类库:
dotnet new classlib -n VanDaemon.Plugins.NewPlugin -o src/Backend/VanDaemon.Plugins/NewPlugin
将项目加入解决方案:
dotnet sln VanDaemon.sln add src/Backend/VanDaemon.Plugins/NewPlugin/VanDaemon.Plugins.NewPlugin.csproj
添加项目引用:
dotnet add src/Backend/VanDaemon.Api/VanDaemon.Api.csproj reference src/Backend/VanDaemon.Plugins/NewPlugin/VanDaemon.Plugins.NewPlugin.csproj
关键概念
- 目标框架:所有项目使用 net10.0,配置为
<TargetFramework>net10.0</TargetFramework>。 - 可空类型:全局启用,配置为
<Nullable>enable</Nullable>。 - 隐式 using:启用后代码更简洁,配置为
<ImplicitUsings>enable</ImplicitUsings>。 - JSON 枚举:通过序列化器选项中的
JsonStringEnumConverter使用字符串形式。 - CancellationToken:所有异步方法接受可选 token,例如
Task<T> GetAsync(CancellationToken ct = default)。
项目引用链
VanDaemon.Api
├── VanDaemon.Application
│ └── VanDaemon.Core
├── VanDaemon.Plugins.Abstractions
└── VanDaemon.Plugins.* (each plugin)
└── VanDaemon.Plugins.Abstractions
NuGet 包管理
向特定项目添加包:
dotnet add src/Backend/VanDaemon.Api/VanDaemon.Api.csproj package Serilog.AspNetCore
更新解决方案中的所有包:
dotnet outdated --upgrade
配置绑定
以 appsettings.json 中某节为例:
builder.Services.Configure<MqttLedDimmerOptions>(
builder.Configuration.GetSection("MqttLedDimmer"));
参见
- patterns:项目结构、依赖注入与构建模式。
- workflows:构建、测试与部署工作流。
相关技能
- csharp 技能:语言模式与编码约定。
- aspnet-core 技能:API 配置与中间件。
- blazor 技能:前端项目设置。
- docker 技能:容器化。
- xunit 技能:测试项目配置。
限制
关于收费、价格、平台限制、具体效果等信息,资料暂未提供。