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

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,适合中小项目,控制力强但需自行处理下载、校验、解压和重启逻辑。
新版本程序更新主要体现在:完美整合BBS论坛程序,用户只须注册一个帐号,即可全站通用!采用目前流行的Flash滚动切换广告 变换形式多样,受人喜爱!在原有提供的5种在线支付基础上增加北京云网支付!对留言本重新进行编排,加入留言验证码,后台有留言审核开关对购物系统的前台进行了一处安全更新。在原有文字友情链接基础上,增加LOGO友情链接功能强大的6种在线支付方式可选,自由切换。对新闻列表进行了调整,
- 在 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.Run或IProgress报告进度 - 更新前备份原程序目录(尤其 Squirrel 未启用回滚时),至少保留上一版文件夹,便于崩溃后手动恢复
- 区分“检查更新”和“立即更新” —— 建议默认只检查并提示用户,高级选项中提供“后台自动下载”开关
- 签名与校验不可省略 —— 防止中间人篡改更新包,GitHub Releases 天然可信,私有服务器务必加 HTTPS + 文件哈希验证
基本上就这些。Squirrel 适合专注 Windows 的快速落地,GitHub 方案更适合多平台或需要定制策略的场景。核心逻辑其实不复杂,但容易忽略权限、路径、进程占用等细节,测试时务必覆盖首次安装、小版本热更、大版本覆盖、断网重试等典型用例。









