17370845950

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，适合中小项目，控制力强但需自行处理下载、校验、解压和重启逻辑。

• 在 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 方案更适合多平台或需要定制策略的场景。核心逻辑其实不复杂，但容易忽略权限、路径、进程占用等细节，测试时务必覆盖首次安装、小版本热更、大版本覆盖、断网重试等典型用例。