Avalonia怎么实现程序的自动更新功能 Avalonia应用更新方案

26次阅读

Avalonia需借助第三方库实现自动更新:windows推荐Squirrel.windows(支持增量更新、回滚与静默安装,禁用单文件发布);跨平台可选gitHub Releases+自定义更新器(需自行处理下载、校验、解压与重启),关键在于异步执行、版本比对、哈希校验及备份恢复。

Avalonia怎么实现程序的自动更新功能 Avalonia应用更新方案

Avalonia 本身不内置自动更新机制,需结合第三方库或自研逻辑实现。主流且稳定的方式是使用 Squirrel.Windows(仅限 Windows)或跨平台方案如 github Releases + 自定义更新器。关键在于资源打包、版本比对、静默下载与原子化替换。

Windows 平台推荐:Squirrel.Windows 集成

Squirrel 是为 .NET 桌面应用设计的成熟更新框架,与 Avalonia 兼容良好,支持增量更新、回滚、静默安装和后台服务。

  • 使用 SquirrelAwareapp.HandleEvents() 在程序启动时注册更新逻辑(如检查更新、应用更新)
  • 将 Avalonia 打包为 Release 文件夹(非单文件),用 squirrel --releasify 生成 nupkg 和 RELEASES 文件
  • 更新服务器只需托管 RELEASES 和各版本 .nupkg,客户端调用 UpdateManager.UpdateApp() 即可
  • 注意:禁用 Avalonia 的单文件发布(SingleFile = false),否则 Squirrel 无法正确提取和替换文件

跨平台通用方案:基于 GitHub Releases 的轻量更新器

适用于 macOS/linux/Windows,适合中小项目,控制力强但需自行处理下载、校验、解压和重启逻辑。

Avalonia怎么实现程序的自动更新功能 Avalonia应用更新方案

网趣购物系统加强升级版

新版本程序更新主要体现在:完美整合BBS论坛程序,用户只须注册一个帐号,即可全站通用!采用目前流行的Flash滚动切换广告 变换形式多样,受人喜爱!在原有提供的5种在线支付基础上增加北京云网支付!对留言本重新进行编排,加入留言验证码,后台有留言审核开关对购物系统的前台进行了一处安全更新。在原有文字友情链接基础上,增加LOGO友情链接功能强大的6种在线支付方式可选,自由切换。对新闻列表进行了调整,

Avalonia怎么实现程序的自动更新功能 Avalonia应用更新方案 0

查看详情 Avalonia怎么实现程序的自动更新功能 Avalonia应用更新方案

  • 在 GitHub Release 中上传带版本号的压缩包(如 MyApp-1.2.0-linux-x64.tar.gz),附带 SHA256 校验值
  • 运行时用 HttpClient 请求 https://api.github.com/repos/{user}/{repo}/releases/latest 获取最新 tag 和 assets
  • 比对本地 AssemblyInformationVersion 或读取内置 version.json,决定是否下载
  • 下载后校验哈希,解压到临时目录,用进程替换方式(如 Windows 上用批处理、macos/Linux 用 shell 脚本)切换主程序并重启

关键细节与避坑提醒

无论选哪种方案,以下几点直接影响更新成功率和用户体验:

  • 不要在主 UI 线程阻塞更新流程 —— 下载和解压必须异步,避免界面卡死;可用 Task.RunIProgress<double></double> 报告进度
  • 更新前备份原程序目录(尤其 Squirrel 未启用回滚时),至少保留上一版文件夹,便于崩溃后手动恢复
  • 区分“检查更新”和“立即更新” —— 建议默认只检查并提示用户,高级选项中提供“后台自动下载”开关
  • 签名与校验不可省略 —— 防止中间人篡改更新包,GitHub Releases 天然可信,私有服务器务必加 HTTPS + 文件哈希验证

基本上就这些。Squirrel 适合专注 Windows 的快速落地,GitHub 方案更适合多平台或需要定制策略的场景。核心逻辑其实不复杂,但容易忽略权限、路径、进程占用等细节,测试时务必覆盖首次安装、小版本热更、大版本覆盖、断网重试等典型用例。

text=ZqhQzanResources