SuperAPI AI 工具集

dotnet

编程与开发

查看项目

更新于 10-16 10:59

技能介绍

该技能名为 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 技能:测试项目配置。

限制

关于收费、价格、平台限制、具体效果等信息,资料暂未提供。