能否使用Visual Studio内置安装扩展制作.Net 5 BackgroundService的MSI安装包

以下是可落地的完整操作方案：

前置准备 #

• 确认已安装对应Visual Studio版本的「Microsoft Visual Studio Installer Projects」官方扩展，该扩展兼容VS2019及以上版本，可直接在Visual Studio扩展管理界面搜索安装
• 你的.NET 5 BackgroundService项目需提前确认运行依赖：要么发布为自包含部署包，要么确保目标机器提前安装好匹配的.NET 5桌面运行时

安装项目配置步骤 #

1. 在当前解决方案中新增「Setup Project」类型的安装项目
2. 右键安装项目，依次选择「添加→项目输出」，选中你的BackgroundService项目，勾选「主输出」后确认
3. 右键安装项目，依次选择「视图→自定义操作」，分别在「安装」「提交」「卸载」三个节点下，添加刚才导入的项目主输出
4. 为自定义操作配置传参：分别右键三个节点下新增的「主输出来自xxx(活动)」项，打开属性面板，在CustomActionData字段填入对应参数：
   • 安装、提交节点填：/assemblypath="[TARGETDIR]你的服务程序名称.exe"
   • 卸载节点填：/u /assemblypath="[TARGETDIR]你的服务程序名称.exe"

服务项目适配改造 #

你需要给BackgroundService项目补充命令行参数识别逻辑，用来对接MSI的自定义操作，实现自动安装/卸载服务：

1. 首先安装NuGet包：System.ServiceProcess.ServiceController
2. 在Program.cs的Host构建逻辑前，添加参数判断代码：

using System.ServiceProcess;
using System.Diagnostics;

var serviceName = "你自定义的服务名称";
var exePath = Path.Combine(AppContext.BaseDirectory, "你的服务程序名称.exe");

// 处理安装/卸载参数
if (args.Length > 0)
{
    if (args[0] == "/u")
    {
        // 卸载服务逻辑
        ExecuteCmd("sc", $"stop {serviceName}");
        ExecuteCmd("sc", $"delete {serviceName}");
        return;
    }
    
    // 安装并启动服务逻辑
    ExecuteCmd("sc", $"create {serviceName} binPath= \"{exePath}\" start= auto DisplayName= \"{serviceName}\"");
    ExecuteCmd("sc", $"description {serviceName} \"你自定义的服务描述\"");
    ExecuteCmd("sc", $"start {serviceName}");
    return;
}

// 原有BackgroundService启动逻辑
IHost host = Host.CreateDefaultBuilder(args)
    .UseWindowsService(options =>
    {
        options.ServiceName = serviceName;
    })
    .ConfigureServices(services =>
    {
        services.AddHostedService<你的后台服务类名>();
    })
    .Build();

await host.RunAsync();

// 封装的cmd执行方法
static void ExecuteCmd(string cmd, string args)
{
    var process = new ProcessStartInfo(cmd, args)
    {
        CreateNoWindow = true,
        UseShellExecute = false,
        RedirectStandardError = true,
        RedirectStandardOutput = true
    };
    using var p = Process.Start(process);
    p.WaitForExit();
}

注意事项 #

• 生成MSI安装包后，需右键选择「以管理员身份运行」安装，避免权限不足导致服务注册失败
• 若安装后服务无法启动，可先到目标机器的「事件查看器→Windows日志→应用程序」中查看具体报错信息，优先排查运行时缺失、路径权限问题

内容的提问来源于stack exchange，提问作者Michael Bedford