Skip to content

generalupdate-strategy.md

Latest commit

 

History

History
106 lines (79 loc) · 3.16 KB

generalupdate-strategy.md

File metadata and controls

106 lines (79 loc) · 3.16 KB
Raw
sidebar_position 4
sidebar_label ⚙️ 策略指南
title ⚙️ generalupdate-strategy — 更新策略指南

⚙️ GeneralUpdate 更新策略完全指南

⚠️ 针对 NuGet v10.4.6 稳定版。该版本使用 Configinfo 配置，无可编程 Option 系统。

策略决策树

你的应用有后端服务吗？
├── 有
│   ├── 需要服务端主动推送更新？ → SignalR 推送
│   └── 否 → 标准客户端-服务端
│
└── 没有（只有对象存储 S3/MinIO/OSS）
    └── OSS 标准

6 种策略详细对比

策略 服务端 说明
① 标准客户端-服务端 ✅ GeneralSpacestation 有后端的中大型应用（推荐入门）
② OSS 对象存储 ❌ 仅 S3/MinIO 无后端，最低成本
③ 静默更新 ✅ 同①或② 后台无声升级
④ 差分更新 ✅ 需差分构建 增量补丁节省带宽
⑤ 跨版本 CVP ✅ 需 CVP 构建 跳过中间版本直跳
⑥ SignalR 推送 ✅ 需 SignalR Hub 服务端主动推送

集成代码

所有策略使用相同的 Configinfo 配置模式：

using GeneralUpdate.Core;
using GeneralUpdate.Common.Shared.Object;

var config = new Configinfo
{
    UpdateUrl = "https://your-server.com/api",
    AppSecretKey = "your-secret-key",
    AppName = "MyApp.exe",
    MainAppName = "MyApp.exe",
    ClientVersion = "1.0.0.0",
    ProductId = "my-product-001",
    InstallPath = ".",
};

await new GeneralUpdateBootstrap()
    .SetConfig(config)
    .AddListener*(...)
    .LaunchAsync();

具体示例参见 examples/ 目录下的策略文件。

混合组合策略

组合 典型场景
OSS + Silent 游戏启动器 / kiosk — 从 CDN 拉取，无需用户交互
Standard + Differential 首次全量下载，后续差分补丁
CVP + Differential 跨版本跳跃 + 单一差分补丁
Standard + Push 后端推送通知，用户点击下载

平台特定差异

平台 特性
Windows 完整功能。使用 Bowl 崩溃守护（在未处理异常时重启应用总线）。完全文件系统访问。
Linux / macOS ⚠️ v10.4.6 无 UnixPermissionHooks，需手动 chmod +x。目标框架建议 .NET 8+。

已知问题

# 问题 规避方案
1 OSS 模式不区分 Main/Upgrade 更新 接受此行为
2 UpgradeApp.exe 必须放在 update/ 子目录 按规范部署
3 NuGet 版本冲突导致 "Method not found" Client 和 Upgrade 使用相同版本号
4 无限升级循环 确保 manifest.json 版本号正确
5 SignalR HubConnection Dispose 后重连崩溃 Dispose 时将连接置 null

相关技能