告别手动更新！WinForm 应用轻松集成自动升级功能 (HHUpdateApp)

合集 - .NET 开源工具(25)

1..NET 开源快捷的数据库文档查询和生成工具2024-07-312..NET 结果与错误处理利器 FluentResults2024-08-013..NET+WPF 桌面快速启动工具 GeekDesk2024-08-194.Gradio.NET 支持 .NET 8 简化 Web 应用开发2024-08-265..NET 开源实时监控系统 - WatchDog2024-08-276.实用接地气的 .NET 微服务框架2024-08-287..NET 开源报表神器 Seal-Report2024-08-308..NET 最好用的验证组件 FluentValidation2024-09-039..NET 8.0 文档管理系统网盘功能的实现2024-09-0410..NET 8 + WPF 企业级工作流系统2024-09-0511..NET 多版本兼容的精美 WinForm UI控件库2024-09-0612.超轻量级、支持插件的 .NET 网络通信框架2024-09-0913..NET 8 微软免费开源的 Blazor UI 组件库2024-09-1014..NET 多版本 WinForm 开源控件库 SunnyUI2024-09-1215.C# 开源教程带你轻松掌握数据结构与算法2024-09-1316..NET 开源的功能强大的人脸识别 API2024-09-1417.C# + WPF 音频播放器界面优雅，体验良好2024-09-1918.C# 开源浏览器性能提升，体验Chrome级速度2024-09-2519..NET 8.0 酒店管理系统设计与实现2024-10-0820..NET 工具库高效生成 PDF 文档2024-09-2621..NET 开源高性能 MQTT 类库2024-09-2722..NET 开源 EF Core 批处理扩展工具，真好用2024-09-3023..NET 平台 WPF 通用权限开发框架 (ABP)2024-11-0124..NET 开发的分流抢票软件，不做广告、不收集隐私01-13

25.告别手动更新！WinForm 应用轻松集成自动升级功能 (HHUpdateApp)08-14

阅读目录

前言
项目介绍
项目功能
项目说明
项目使用
程序示例
项目源码
总结
关键词
最后

前言

在桌面应用开发领域，版本更新始终是影响用户体验的关键环节。传统的更新方式不仅操作繁琐，还常伴随兼容性风险。对于桌面应用程序而言，实现一个高效且用户友好的自动更新机制尤为重要。

今天推荐一款专为 .NET 经典桌面应用设计的轻量级工具，以极简配置实现无缝更新，让大家告别复杂的脚本编写，专注于核心业务逻辑。

项目介绍

HHUpdateApp 是一个基于 .NET 框架的桌面应用程序，专为简化传统桌面应用的自动更新流程而设计。通过 HHUpdateApp，开发可以轻松为其现有的应用程序添加自动更新特性，无需深入研究复杂的脚本工具或部署策略。

只需简单的配置和集成，就能让大家的应用程序具备自我更新的能力，显著提升用户体验和满意度。

项目功能

HHUpdateApp 的核心功能在于其能够自动化处理从服务器获取最新版本信息到下载并安装更新包的整个过程。

首先，它会检查指定的 JSON 文件（HHversions.json），该文件包含了最新的版本信息和下载链接。如果发现新版本，HHUpdateApp 会提示用户进行更新，并在用户同意后自动下载并解压更新包，替换旧版文件。

另外，还支持静默更新模式，允许更新过程在后台进行，不打扰用户的正常使用。

项目说明

下载Releases中最新安装包，即刻体验全部功能，无需涉足各种脚本工具，只需面对你所需要升级的程序本身，让应用程序轻松获得自动升级的特性。

在上手前，有些名词是需要我们了解的。

升级程序：HHUpdateApp.exe是一个可执行程序，她提供了升级支持。下面文档中的【升级程序】代指HHUpdateApp.

业务程序：是指你自己的程序，例如你有一个LOLClient.exe程序，我们称它为业务程序.

HHUpdateApp.exe.config：升级程序的参数配置，里面包含【升级程序】工作时所需要的一些参数，祥见开发者使用

HHversions.json：升级版本信息文件，这个文件包含了【业务程序】的升级信息，它是json格式的文件，放置在远端电脑或服务器上，【升级程序】升级时，会请求该文件，以获得升级信息.

项目使用

升级程序原理

【升级程序】从您的服务器下载包含更新信息的JSON文件(HHversions.json)。它使用此JSON文件来获取需要检测更新的PC上【业务程序】有关最新版本的信息。

如果服务器上该【业务程序】的最新版本大于在用户PC上的当前版本，则HHUpdateApp将向用户显示更新对话框。

如果用户按下更新按钮来更新软件，则它将从【HHversions.json)】文件中提供的URL下载更新文件（zip文件）。

之后执行更新是安装程序的工作，HHUpdateApp会将zip文件的内容提取到应用程序目录中替换升级原应用程序文件。

直接点击【HHUpdateApp.exe】，只需要填写【业务应用程序名称】（例如LOLClient）即可体验的为你的LOLClient.exe应用程序检查更新。

开发使用

1、配置HHUpdateApp.exe.config

配置升级程序，此处是HHUpdateApp.exe运行是需要的一些参数，可以手动配置好。

如果没有配置，更新程序运行时，会进入配置页，要求配置。

两种方式均可以。

<HHUpdateApp.Properties.Settings><!--业务应用程序名称：根据这个值，找到业务应用程序，并为它赋予自动更新的功能--><setting name="LaunchAppName" serializeAs="String"><value /></setting><!--服务地址：HHUpdateApp.exe将下载此处提供的HHversions.json文件（包含版本更新信息的JSON文件）--><setting name="ServerUpdateUrl" serializeAs="String"><value>http://localhost:8020/HHversions.json</value></setting><!--非必要参数，用于记录忽略的一个版本号：检查更新时会忽略这个版本的更新--><setting name="LocalIgnoreVer" serializeAs="String"><value /></setting><!--非必要参数，是否静悄悄升级：true,更新过程中不显示界面；false,显示更新界面--><setting name="SilentUpdate" serializeAs="String"><value>False</value></setting>
</HHUpdateApp.Properties.Settings>

2、在【应用程序】中添加代码以使其对HHUpdateApp发起调用

添加调用检测升级更新的方法，以WinForm程序为例，在应用程序中添加｛检查更新｝按钮，该检查更新按钮，代码如下

参数	类型	说明
FileName	string	【升级程序】HHUpdateApp.exe程序所在路径
Arguments	string[]	参数数组：Arguments[0]：发起更新的应用名称（例如，LOLClient）；Arguments[1]：检查模式：0 表示定时检查（自动更新），1 表示手动检查

/// <summary>
/// 检查更新按钮
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void button1_Click(object sender, EventArgs e)
{ProcessStartInfo processStartInfo = new ProcessStartInfo(){FileName = "~\HHUpdateApp.exe",//参数:【升级程序】HHUpdateApp.exe程序所在路径Arguments = "LOLClient 1"//参数1:【应用程序】的名词，例如：LOLClient；参数1:检查更新模式;Process proc = Process.Start(processStartInfo);if (proc != null){proc.WaitForExit();}
}

3、HHversions.json

发布版本信息HHversions.json。将HHversions.json文件放在【升级程序】可访问的服务器或远程电脑上。升级版本信息文件，这个文件包含了【业务程序】的升级信息，它有固定的格式，如下所示.注意：HHversions.json必须是UTF8格式

{"ApplicationStart": "更新工作结束后启动的业务程序名，多个启动用 # 号分割","ReleaseDate": "发布时间","ReleaseUrl": "zip更新包发布地址","ReleaseVersion": "发布版本号","UpdateMode": "更新方式：Cover表示覆盖原文件更新，NewInstall表示删除源文件全新安装","VersionDesc": "更新描述说明","IgnoreFile": "更新过程中忽略的文件，多个文件用 # 号分割"
}

程序示例

更新弹窗

上面示例中使用的代码片段

/// <summary>
/// 检查更新按钮
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void button1_Click(object sender, EventArgs e)
{string _updateAppPath = textBox1.Text;//输入升级程序所在目录if (File.Exists(_updateAppPath))//升级程序是否存在{ProcessStartInfo processStartInfo = new ProcessStartInfo(){FileName = _updateAppPath,//路径Arguments = "LOLClient 1"//此需要升级的应用程序名};Process proc = Process.Start(processStartInfo);if (proc != null){proc.WaitForExit();}}
}

上面示例中使用的HHversions.JSON文件

{"ApplicationStart": "HHUpdate.Test.exe","ReleaseDate": "2020520","ReleaseUrl": "http://localhost:8085/UpdateDemo/Debug.zip","ReleaseVersion": "1.0.0.1","UpdateMode": "Cover","VersionDesc": "一个有趣的故事，当我们最初准备重做乐芙兰时已经准备好了这个BUG的修复，但最后并没有实装，因为这个技能被取代了。\r\n1，修复了一个BUG，【被动 - 镜花水月】所召唤的分身在普攻命中前阵亡，那么她所进行的普攻会造成伤害。\r\n2，新增：【恶意魔印】将为目标施加一个印记。\r\n3，乐芙兰重做后的大招理应让她能够选择复制哪个技能来做出更有趣的连招。","IgnoreFile": ""
}