WPF 启动器 + 动态加载,让分级客户端更新静悄悄

38 阅读5分钟

前言

在开发企业级桌面应用时,我们常常面临两个现实问题:一是程序更新频繁,每次替换可执行文件都会被杀毒软件当作"新程序"拦截;二是主程序一旦打包成 .exe,就很难做到热替换或模块化加载。

本文将推荐一种"启动器 + 动态加载主逻辑"的架构——用一个极简的 WPF Launcher 去运行时加载真正的业务程序(以 .dll 形式存在)。这样,Launcher 本身几乎不变,而主功能可以随时更新,既避免重复加白名单,又提升了部署灵活性。

项目介绍

项目是一个用于内容分级管理的客户端,核心业务逻辑封装在一个独立的 WPF 类库中,而入口程序是一个轻量级的 Launcher

Launcher 不包含任何业务代码,只负责初始化日志、显示加载界面、创建隔离的 AssemblyLoadContext,然后从指定目录(如 ./main)加载所有 DLL,并调用其中预设的 Main 方法。

主程序则完全解耦,可独立编译、测试和发布。整个流程对用户透明,却极大简化了运维成本。

项目功能

1、动态加载主程序

启动时从 TargetDirectory 目录加载所有 .dll 到独立的 AssemblyLoadContext 中,实现与宿主的隔离。

2、依赖自动解析

通过注册 Resolving 事件,运行时能按需加载缺失的依赖项,避免"找不到程序集"错误。

3、无感更新支持

主程序以类库形式存在,更新只需替换 DLL 文件,无需重新安装或修改启动器,有效规避安全软件误报。

4、结构化日志系统

集成 Serilog,按天滚动写入日志,区分 Debug/Release 级别,便于排查启动失败原因。

5、完整的 WPF 主程序体验

主程序使用 HandyControl、依赖注入、MVVM 模式构建,包含用户认证、托盘最小化、子窗口管理、超时登出等完整功能。

项目特点

这套方案最大的优势在于"稳定壳 + 可变核"。Launcher 体积小、逻辑固定,一次签名长期可用;

主程序完全独立,支持快速迭代。更重要的是,由于主程序不是 .exe,很多杀毒软件不会将其视为高风险对象,大幅减少用户干扰。

同时,利用 .NET 的 collectible AssemblyLoadContext,程序退出时能主动卸载上下文,释放内存,避免资源泄露。

主程序还实现了严格的认证机制——未登录无法关闭程序,超时自动降权,保障数据安全。

项目技术

1、基于 .NET 8 开发,UI 层采用 WPFHandyControl 提升界面体验。

2、启动器使用 AssemblyLoadContext 实现程序集隔离加载,日志系统选用 Serilog,支持文件滚动与结构化输出。

3、主程序采用标准 MVVM 架构,配合 Microsoft.Extensions.DependencyInjection 实现依赖注入,ViewModel 与 View 解耦清晰。

4、关键交互如用户认证、托盘控制、子窗口管理均通过事件驱动和命令绑定完成,代码可维护性强。

项目代码

设置应用开机自启

/// <summary>
/// 设置应用开机自启
/// </summary>
/// <param name="appName">注册表项名称</param>
/// <param name="exePath">可执行文件完整路径</param>
public static void SetAutoStart(string appName, string exePath)
{
    if (string.IsNullOrWhiteSpace(appName) || string.IsNullOrWhiteSpace(exePath))
    {
        throw new ArgumentException("参数不能为空");
    }

    // 标准化路径(处理空格和路径格式)
    var normalizedPath = Path.GetFullPath(exePath.Trim()).TrimEnd('\\');

    // 检查是否需要更新
    if (NeedUpdateAutoStart(appName, normalizedPath))
    {
        UpdateAutoStartRegistry(appName, normalizedPath);
    }
}

/// <summary>
/// 检查是否需要更新注册表项
/// </summary>
private static bool NeedUpdateAutoStart(string appName, string exePath)
{
    try
    {
        using var key = Registry.CurrentUser.OpenSubKey(RunKeyPath);
        if (key == null) return true;

        var currentValue = key.GetValue(appName) as string;
        return currentValue == null ||
               !string.Equals(currentValue, exePath, StringComparison.OrdinalIgnoreCase);
    }
    catch (Exception ex)
    {
        Debug.WriteLine($"检查注册表失败: {ex.Message}");
        return true; // 出错时强制更新
    }
}

/// <summary>
/// 更新注册表项(安全方式)
/// </summary>
private static void UpdateAutoStartRegistry(string appName, string exePath)
{
    try
    {
        // 方法1:直接使用Registry API(推荐)
        using var key = Registry.CurrentUser.CreateSubKey(RunKeyPath);
        key?.SetValue(appName, exePath, RegistryValueKind.String);

        Debug.WriteLine($"已更新开机启动项: {appName} = {exePath}");
    }
    catch (Exception ex)
    {
        Debug.WriteLine($"更新注册表失败: {ex.Message}");

        // 方法2:备用方案(使用reg.exe)
        TryUpdateWithRegExe(appName, exePath);
    }
}

项目效果

更新流程从"下载安装包 → 关闭程序 → 安装 → 重启"简化为"后台静默替换 DLL → 下次启动生效"。用户不再收到重复的安全警告,IT 支持压力显著下降。主程序的认证机制也有效防止了未授权操作——比如试图直接关闭窗口会被拦截,必须先登录。

489b0823aaedef458771de5decdefced_640_wx_fmt=png&from=appmsg&watermark=1&tp=webp&wxfrom=5&wx_lazy=1#imgIndex=0.png

8ad0a0650ff911a04dfe76f3260022b7_640_wx_fmt=png&from=appmsg&watermark=1&tp=webp&wxfrom=5&wx_lazy=1#imgIndex=1.png

项目源码

源码分为两部分:Launcher 项目(含 BaseLauncher 抽象类和具体实现)和主程序类库(WpfApp)。Launcher 负责加载逻辑,主程序包含 MainWindow、UserManager、GlobalIdentity 等完整业务模块。只需继承 BaseLauncher,配置好 TargetDirectory、MainAssemblyName 等属性,即可复用整套加载机制。项目已内置 Serilog 配置、HandyControl 样式和 DI 容器初始化,克隆后用 Visual Studio 2022 打开即可调试运行。

gitee.com/flying-eye/…

总结

分级客户端启动器看似只是一个"壳",但它解决了一个非常实际的问题:如何让桌面应用更新变得安静、可靠、无打扰。它没有追求炫技,而是用 .NET 原生能力做了一件"脏活"——把变化的部分藏起来,把稳定的留给用户。如果大家也在维护一个需要频繁更新的 WPF 应用,这种"启动器 + 动态加载"的模式值得尝试。

关键词

WPF、Launcher、AssemblyLoadContext、动态加载、Serilog、HandyControl、MVVM、自动更新、程序集隔离、用户认证

最后

如果你觉得这篇文章对你有帮助,不妨点个赞支持一下!你的支持是我继续分享知识的动力。如果有任何疑问或需要进一步的帮助,欢迎随时留言。

也可以加入微信公众号 [DotNet技术匠] 社区,与其他热爱技术的同行一起交流心得,共同成长!

优秀是一种习惯,欢迎大家留言学习!