GeneralUpdate .Net5 WPF、Winfrom、控制台应用自动更新组件

https://www.bilibili.com/video/BV1aX4y137dd/?vd_source=43d3e66cc2ad46bac54dfb0c6a3a0a23

GeneralUpdate教程2022.4.23

 https://www.bilibili.com/video/BV1FT4y1Y7hV/?vd_source=43d3e66cc2ad46bac54dfb0c6a3a0a23

 

https://mp.weixin.qq.com/s/pRKPFe3eC0NSqv9ixXEiTg

如何使用GeneralUpdte构建客户端自动升级功能

 juster.zhu JusterZhu 2022-04-03 18:47

一、概要

本篇文章将向各位小伙伴介绍GeneralUpdate组件的使用，帮助第一次接触开发者快速上手应用在自己或企业项目中。如果本篇文章对您有帮助，希望帮忙点一下star。感谢各位开发者的支持。

帮助文档

• 讲解视频：https://www.bilibili.com/video/BV1aX4y137dd

• 官方网站：http://justerzhu.cn/

• 相关工具：GeneralUpdate.PacketTool （该工具使用avalonia编写，可在linux、windows、mac操作系统使用）

• github release: https://github.com/WELL-E/AutoUpdater/releases/tag/GeneralUpdateTool

  gitee release: https://gitee.com/Juster-zhu/GeneralUpdate/releases/GeneralupdateTool

• Nuget版本管理参考标准：https://docs.microsoft.com/zh-cn/nuget/concepts/package-versioning

• 应用程序集版本管理参考标准：https://docs.microsoft.com/zh-cn/dotnet/standard/assembly/versioning （被组件更新的客户端程序，说通俗点就是你公司的产品；组件的操作将按照这个标准执行。）

开源地址

• https://github.com/WELL-E/AutoUpdater

• https://gitee.com/Juster-zhu/GeneralUpdate

Q&A

（1）主程序和升级程序之间是否支持相互升级？

答：支持。

（2）是否需要开发者写代码关闭进程的时机或者其他代码？

答：不需要，组件已经将整个更新流程考虑到了。所以除了组件代码以外，不需要开发者额外多写任何辅助代码。

（3）更新程序是否需要和主程序放在同一个目录下？

答：是的，需要。但一定要保持升级程序不能引用主程序的里的任何代码。否则会更新失败。

（4）更新完成之后会删除更新包的补丁文件吗？

答：会的，组件更新完成之后会保证文件列表干净，不会出现冗余文件污染、磁盘空间占用的情况。

（5）可以运用在服务端吗？就是服务与服务之间的升级。

答：理论上支持的，作者没有实际这么使用过。据反馈有的小伙伴已经这么干了。本次分享是针对C/S架构的场景。

（6）怎么获取更新包的MD5码？

答：使用项目源码里的，AutoUpdate.MD5工程。

（7）怎么制作一个更新包？

答：使用GeneralUpdate.PacketTool工具生成即可。在源码仓库的release中可以看到打包好的安装程序。

（8）关于组件的其他内容如何了解到？

答：可以通过官方网站、或者相关Q群、以及我gitee或github的issue中与我交流。

（9）下载包解压在C盘下Program Files (x86)时，没有权限操作怎么处理？

答：https://gitee.com/Juster-zhu/GeneralUpdate/issues/I4ZKQ4

（10）更新文件较小时，下载速度显示为：0B/S 。

答：https://gitee.com/Juster-zhu/GeneralUpdate/issues/I3POMG

二、详细内容

在开始讲解使用之前，我们先需要搞明白GeneralUpdate更新体系中的一些基础概念、名词。

（1）名词解释

• client：是指你的主应用程序，是被更新的客户端。也就是你公司的产品（假设项目结构如上）。它将需要在nuget平台安装GeneralUpdate.ClientCore。

• upgrade：是指升级程序，它是一个独立的进程。需要和clinet放在同一个目录下，在使用的过程中不可以和任何业务关联、必须保持独立引用（项目结构如上）。有人会问我不保持会怎么样？会因为其他组件引用、文件占用更新失败。它将需要在nuget平台安装GeneralUpdate.Core。

• server：是指服务端应用（asp.net）将提供版本更新信息、版本验证信息用来判断是否需要更新以及更新包下载地址。它将需要在nuget平台安装GeneralUpdate.AspNetCore。

CREATE TABLE `updateversioninfo` (
 `MD5` varchar(32) NOT NULL DEFAULT 'update packet md5',
 `PubTime` int DEFAULT '0',
 `Name` varchar(64) NOT NULL DEFAULT 'version name',
 `Url` varchar(255) NOT NULL DEFAULT 'update url',
 `Version` varchar(20) NOT NULL DEFAULT 'last version number',
 `ClientType` int NOT NULL DEFAULT '1',
 PRIMARY KEY (`MD5`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;

• SQL：关于server端需要用的sql表的脚本（mysql）已经写好了，运行以上脚本即可创建表。

字段名称	字段类型	C#类型	备注
md5	varchar	string	更新包的MD5码，也是唯一标识
pubtime	int	int	更新包发布时间戳（10位）
name	varchar	string	更新包名称
url	varchar	string	下载地址
version	varchar	string	版本号（1.0.0.0）
clienttype	int	int	1：客户端 2：升级程序

（2）更新流程

基于以上的了解，我们再来看更新流程将会很清晰，思路清晰有助于我们使用。

• 第一步

client启动后将会向服务器发送http请求，确认upgrade是否需要更新。

• 第二步

如果upgrade需要更新将会下载upgrade的更新包并更新。

• 第三步

如果client发现upgrade不需要更新或者upgrade更新完毕之后，那么将会直接通过进程启动upgrade独立进程的应用程序。（也就是上面为什么需要保持引用独立）

• 第四步

upgrade被启动之后，会自动去请求client的更新包。用于更新client的内容；

• 第五步

在client、upgrade请求更新期间，server将会起到关键作用。提供版本更新信息、版本验证信息用来判断是否需要更新以及更新包下载地址。

• 第六步

server响应upgrade的请求后，upgrade将执行更新client的操作。

• 第七步

更新完成之后upgrade通过进程启动client。

• 第八步

client被启动之后，完成更新。（流程结束）

三、编码

应用GeneralUpdate组件总共分为，三个部分Client 、Upgrade、Server。

1.1 Client的应用

安装完成之后，将会在nuget包引用中看到这些内容。

接下来就可以写代码了,在最新版本中简化了启动配置。（如果需要自定义配置则参考：https://gitee.com/Juster-zhu/GeneralUpdate/blob/master/src/AutoUpdate.ClientCore/MainWindow.xaml.cs）

   public class MainViewModel
  {
       private const string baseUrl = @"http://127.0.0.1:5001";

       public MainViewModel()
      {
           Upgrade();
      }

       private void Upgrade()
      {
           Task.Run(async () =>
          {
               var generalClientBootstrap = new GeneralClientBootstrap();
               generalClientBootstrap.MutiDownloadProgressChanged += OnMutiDownloadProgressChanged;
               generalClientBootstrap.MutiDownloadStatistics += OnMutiDownloadStatistics;
               generalClientBootstrap.MutiDownloadCompleted += OnMutiDownloadCompleted;
               generalClientBootstrap.MutiAllDownloadCompleted += OnMutiAllDownloadCompleted;
               generalClientBootstrap.MutiDownloadError += OnMutiDownloadError;
               generalClientBootstrap.Exception += OnException;
               generalClientBootstrap.Config(baseUrl).
               Option(UpdateOption.DownloadTimeOut, 60).
               Option(UpdateOption.Encoding, Encoding.Default).
               Option(UpdateOption.Format, "zip").
               Strategy<ClientStrategy>();
               await generalClientBootstrap.LaunchTaskAsync();
          });
      }

       private void OnMutiDownloadStatistics(object sender, MutiDownloadStatisticsEventArgs e)
      {
           //e.Remaining 剩余下载时间
           //e.Speed 下载速度
           //e.Version 当前下载的版本信息
      }

       private void OnMutiDownloadProgressChanged(object sender, MutiDownloadProgressChangedEventArgs e)
      {
           //e.TotalBytesToReceive 当前更新包需要下载的总大小
           //e.ProgressValue 当前进度值
           //e.ProgressPercentage 当前进度的百分比
           //e.Version 当前下载的版本信息
           //e.Type 当前正在执行的操作 1.ProgressType.Check 检查版本信息中 2.ProgressType.Donwload 正在下载当前版本 3. ProgressType.Updatefile 更新当前版本 4. ProgressType.Done更新完成 5.ProgressType.Fail 更新失败
           //e.BytesReceived 已下载大小
      }

       private void OnException(object sender, ExceptionEventArgs e)
      {
           Debug.WriteLine(e.Exception.Message);
      }

       private void OnMutiAllDownloadCompleted(object sender, MutiAllDownloadCompletedEventArgs e)
      {
           //e.FailedVersions; 如果出现下载失败则会把下载错误的版本、错误原因统计到该集合当中。
           Debug.WriteLine($"Is all download completed { e.IsAllDownloadCompleted }.");
      }

       private void OnMutiDownloadCompleted(object sender, MutiDownloadCompletedEventArgs e)
      {
           //Debug.WriteLine($"{ e.Version.Name } download completed.");
      }

       private void OnMutiDownloadError(object sender, MutiDownloadErrorEventArgs e)
      {
           //Debug.WriteLine($"{ e.Version.Name } error!");
      }
  }

到这里基础的功能代码已完成，剩下的事件回传的内容根据需要使用即可。推荐用法为：将事件回传参数在客户端中用独立遮罩层类似于“转圈圈的”界面显示升级进度信息，或者用日志记录下来。

1.2Client的应用（非必要）

订阅接收，Server端的最新版本推送。

       private const string baseUrl = @"http://127.0.0.1:5001",hubName = "versionhub";

       public MainViewModel()
      {
           InitializeComponent();
           InitVersionHub();
      }

       #region VersionHub

       /// <summary>
       /// Subscription server push version message.
       /// </summary>
       private void InitVersionHub()
      {
           VersionHub<string>.Instance.Subscribe($"{ baseUrl }/{ hubName }", "TESTNAME", new Action<string>(GetMessage));
      }

       private void GetMessage(string msg)
      {
           TxtMessage.Text = msg;//这里接收推送的内容跟服务端约定好能解析即可，也可以在这里启动更新。
      }

       #endregion VersionHub

到这里为止，clinet的应用分享已完成。

---

2.1 Upgrade的应用

安装完成之后，将会在nuget包引用中看到这些内容。

接下来就可以写代码了，和ClientCore不同的是它不在需要配置url等内容将从进程传参中拿到RemoteAddressBase64的内容（内容是自动生成好的不需要关心）。

首先需要找到app.cs文件：

然后修改代码如下，这里是为了拿到client端进程传递过来的配置参数：

   public partial class App : Application
  {
       protected override void OnStartup(StartupEventArgs e)
      {
           MainWindow window = new MainWindow(e.Args[0]);
           window.ShowDialog();
           base.OnStartup(e);
      }
  }

拿到的base64的示例内容如下：

eyJBcHBUeXBlIjoxLCJBcHBOYW1lIjoiQXV0b1VwZGF0ZS5DbGllbnRDb3JlIiwiTWFpbkFwcE5hbWUiOm51bGwsIkluc3RhbGxQYXRoIjoiRDpcXFVwZGF0ZXRlc3RfaHViXFxSdW5fYXBwIiwiQ2xpZW50VmVyc2lvbiI6IjEuMS4xIiwiTGFzdFZlcnNpb24iOiI5LjEuMy4wIiwiVXBkYXRlTG9nVXJsIjpudWxsLCJJc1VwZGF0ZSI6ZmFsc2UsIlVwZGF0ZVVybCI6bnVsbCwiVmFsaWRhdGVVcmwiOm51bGwsIk1haW5VcGRhdGVVcmwiOiJodHRwOi8vMTI3LjAuMC4xOjUwMDEvdmVyc2lvbnMvMS8xLjEuMS4xIiwiTWFpblZhbGlkYXRlVXJsIjoiaHR0cDovLzEyNy4wLjAuMTo1MDAxL3ZhbGlkYXRlLzEvMS4xLjEuMSIsIkNvbXByZXNzRW5jb2RpbmciOjcsIkNvbXByZXNzRm9ybWF0IjoiLnppcCIsIkRvd25sb2FkVGltZU91dCI6NjAsIlVwZGF0ZVZlcnNpb25zIjpbeyJQdWJUaW1lIjoxNjI2NzExNzYwLCJOYW1lIjpudWxsLCJNRDUiOiI1ZmI3NWU0NGQ3YzQ1ZTNmYzlkNmFhNDdjMDVhMGU5YSIsIlZlcnNpb24iOiI5LjEuMy4wIiwiVXJsIjpudWxsLCJJc1VuWmlwIjpmYWxzZX1dfQ==

MainViewModel.cs代码：

   internal class MainViewModel : BaseViewModel
  {
       private string _tips1, _tips2, _tips3, _tips4, _tips5, _tips6;
       private double _progressVal, _progressMin, _progressMax;

       public MainViewModel(string args)
      {
           ProgressMin = 0;
           Task.Run(async () =>
          {
               var bootStrap = new GeneralUpdateBootstrap();
               bootStrap.MutiAllDownloadCompleted += OnMutiAllDownloadCompleted;
               bootStrap.MutiDownloadCompleted += OnMutiDownloadCompleted;
               bootStrap.MutiDownloadError += OnMutiDownloadError;
               bootStrap.MutiDownloadProgressChanged += OnMutiDownloadProgressChanged;
               bootStrap.MutiDownloadStatistics += OnMutiDownloadStatistics;
               bootStrap.Exception += OnException;
               bootStrap.Strategy<DefaultStrategy>().
               Option(UpdateOption.Encoding, Encoding.Default).
               Option(UpdateOption.DownloadTimeOut, 60).
               Option(UpdateOption.Format, "zip").
               RemoteAddressBase64(args);
               await bootStrap.LaunchTaskAsync();
          });
      }

       public string Tips1 { get => _tips1; set => SetProperty(ref _tips1, value); }
       public string Tips2 { get => _tips2; set => SetProperty(ref _tips2, value); }
       public string Tips3 { get => _tips3; set => SetProperty(ref _tips3, value); }
       public string Tips4 { get => _tips4; set => SetProperty(ref _tips4, value); }
       public string Tips5 { get => _tips5; set => SetProperty(ref _tips5, value); }
       public string Tips6 { get => _tips6; set => SetProperty(ref _tips6, value); }
       public double ProgressVal { get => _progressVal; set => SetProperty(ref _progressVal, value); }
       public double ProgressMin { get => _progressMin; set => SetProperty(ref _progressMin, value); }
       public double ProgressMax { get => _progressMax; set => SetProperty(ref _progressMax, value); }

       private void OnMutiDownloadStatistics(object sender, GeneralUpdate.Core.Update.MutiDownloadStatisticsEventArgs e)
      {
           Tips1 = $" { e.Speed } , { e.Remaining.ToShortTimeString() }";
      }

       private void OnMutiDownloadProgressChanged(object sender, GeneralUpdate.Core.Update.MutiDownloadProgressChangedEventArgs e)
      {
           switch (e.Type)
          {
               case ProgressType.Check:
                   break;

               case ProgressType.Donwload:
                   ProgressVal = e.BytesReceived;
                   if (ProgressMax != e.TotalBytesToReceive)
                  {
                       ProgressMax = e.TotalBytesToReceive;
                  }
                   Tips2 = $" { Math.Round(e.ProgressValue * 100, 2) }% ， Receivedbyte：{ e.BytesReceived }M ，Totalbyte：{ e.TotalBytesToReceive }M";
                   break;

               case ProgressType.Updatefile:
                   break;

               case ProgressType.Done:
                   break;

               case ProgressType.Fail:
                   break;

               default:
                   break;
          }
      }

       private void OnMutiDownloadCompleted(object sender, GeneralUpdate.Core.Update.MutiDownloadCompletedEventArgs e)
      {
           //Tips3 = $"{ e.Version.Name } download completed.";
      }

       private void OnMutiAllDownloadCompleted(object sender, GeneralUpdate.Core.Update.MutiAllDownloadCompletedEventArgs e)
      {
           if (e.IsAllDownloadCompleted)
          {
               Tips4 = "AllDownloadCompleted";
          }
           else
          {
               //foreach (var version in e.FailedVersions)
               //{
               //   Debug.Write($"{ version.Item1.Name }");
               //}
          }
      }

       private void OnMutiDownloadError(object sender, GeneralUpdate.Core.Update.MutiDownloadErrorEventArgs e)
      {
           //Tips5 = $"{ e.Version.Name },{ e.Exception.Message }.";
      }

       private void OnException(object sender, GeneralUpdate.Core.Update.ExceptionEventArgs e)
      {
           Tips6 = $"{ e.Exception.Message }";
      }
  }

到这里为止，upgrade的应用分享已完成。

---

3.1 Server的应用

这里使用新推出的Minimal api演示，其他的api的模板也同样适用。

创建完成之后项目结构如下：

这个时候我们再安装nuget。

安装完成之后的目录。

接下来我们再写代码。

using GeneralUpdate.AspNetCore.Services;
using GeneralUpdate.Core.DTOs;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddSingleton<IUpdateService, GeneralUpdateService>();//必须再这里添加这段代码
var app = builder.Build();

app.MapGet("/versions/{clientType}/{clientVersion}", async (int clientType, string clientVersion, IUpdateService updateService) =>
{
   return await updateService.UpdateVersionsTaskAsync(clientType, clientVersion, UpdateVersions);
});

app.MapGet("/validate/{clientType}/{clientVersion}", async (int clientType, string clientVersion, IUpdateService updateService) =>
{
   return await updateService.UpdateValidateTaskAsync(clientType, clientVersion, GetLastVersion(), true, GetValidateInfos);
});
app.Run();

async Task<List<UpdateVersionDTO>> UpdateVersions(int clientType, string clientVersion)
{
   //这里需连接数据库查询对应内容，我这里用假数据辅助调试而已。
   //TODO:Link database query information.Different version information can be returned according to the 'clientType' of request.
   var results = new List<UpdateVersionDTO>();
   results.Add(new UpdateVersionDTO("5001fd3732b91dfe46196ceb0a5bc4b2", 1626711760, "9.1.3.0",
   "http://192.168.50.170/patchs.zip",
   "updatepacket1"));
   //results.Add(new UpdateVersionDTO("d9a3785f08ed3dd92872bd807ebfb917", 1626711820, "9.1.4.0",
   //"http://192.168.50.170/Update2.zip",
   //"updatepacket2"));
   //results.Add(new UpdateVersionDTO("224da586553d60315c55e689a789b7bd", 1626711880, "9.1.5.0",
   //"http://192.168.50.170/Update3.zip",
   //"updatepacket3"));
   return await Task.FromResult(results);
}

async Task<List<UpdateVersionDTO>> GetValidateInfos(int clientType, string clientVersion)
{
   //这里需连接数据库查询对应内容，我这里用假数据辅助调试而已。
   //TODO:Link database query information.Different version information can be returned according to the 'clientType' of request.
   var results = new List<UpdateVersionDTO>();
   results.Add(new UpdateVersionDTO("5001fd3732b91dfe46196ceb0a5bc4b2", 1626711760, "9.1.3.0", null, null));
   //results.Add(new UpdateVersionDTO("d9a3785f08ed3dd92872bd807ebfb917", 1626711820, "9.1.4.0", null, null));
   //results.Add(new UpdateVersionDTO("224da586553d60315c55e689a789b7bd", 1626711880, "9.1.5.0", null, null));
   return await Task.FromResult(results);
}

string GetLastVersion()
{
   //这里需连接数据库查询对应内容，我这里用假数据辅助调试而已。这里需查询出最新发布日期的版本信息。
   //TODO:Link database query information.
   return "1.1.5";
}

3.2 Server的应用（非必要）

这里分享的是最新版本推送的功能，基于singal R来实现的。需要对singal r有一定了解。代码如下：

using GeneralUpdate.AspNetCore.Hubs;
using GeneralUpdate.AspNetCore.Services;
using GeneralUpdate.Core.DTOs;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddSingleton<IUpdateService, GeneralUpdateService>();
builder.Services.AddSignalR();
var app = builder.Build();

app.MapHub<VersionHub>("/versionhub");

app.Use(async (context, next) =>
{
   var hubContext = context.RequestServices.GetRequiredService<IHubContext<VersionHub>>();
   await CommonHubContextMethod((IHubContext)hubContext);
   if (next != null)
  {
       await next.Invoke();
  }
});

async Task CommonHubContextMethod(IHubContext context)
{
   await context.Clients.All.SendAsync("clientMethod", "");
}

到这里为止，server的应用分享已完成。

---

开源不易希望大家能多多支持。可能或多或少会有些bug希望大家多多反馈，感谢各位的支持。

关键词：C/S、WPF、MAUI、Winfrom、Avalonia、Console App、UWP、WinUI、Linux、Windows、MacOS、自动更新、自动升级、更新、推送。

GeneralUpdate17

GeneralUpdate · 目录

上一篇GeneralUpdate20220323里程碑版本发布下一篇GeneralUpdate开源项目直播预告2022.10.15晚9点