Smart.Console.Template 4.0.3

Smart.Console.Template

基于 .NET 通用主机（IHost）的控制台应用快速开发框架，集成依赖注入、配置管理和后台服务支持。

功能特性

1. 现代化控制台架构

• 基于 Microsoft.Extensions.Hosting 构建
• 支持后台服务（IHostedService）
• 内置优雅停机（Ctrl+C 中断处理）

2. 开箱即用的组件

• 配置系统

csharp
.AddJsonFile("appsettings.json")
.AddEnvironmentVariables()
.AddUserSecrets<Program>()

• 依赖注入

csharp
services.ScanCustomizedServices(); // 自动扫描注册服务

3. 关键设计

csharp
// 中文编码支持（GBK/GB2312）
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

// 后台服务异常处理
services.Configure<HostOptions>(options =>
{
  options.BackgroundServiceExceptionBehavior = BackgroundServiceExceptionBehavior.Ignore;
});

快速开始

安装

bash
dotnet new install Smart.Console.Template

创建项目

bash
dotnet new smart.console -n MyDemo

添加服务

csharp
// 实现 IHostedService
public class DemoService : BackgroundService
{
  protected override Task ExecuteAsync(CancellationToken stoppingToken)
  {
    // 你的业务逻辑
  }
}

// 通过特性自动注册
[Service(ServiceLifetime.Singleton, InjectScheme.OnlySelf)]
public class DataService
{
  // 你的业务逻辑
}

部署要求

必须使用「依赖框架」部署模式
项目发布时请使用以下命令配置（目标框架由您指定，此处为net8.0）：

bash
dotnet publish -c Release --self-contained false -f net8.0

推荐搭配 .NET 运行时安装脚本 部署

开发建议

服务注册约定

用户需要了解Smart.Inject框架的用法，访问Smart.Inject。

Developed by zenglei