🔄 GeneralUpdate 迁移指南
帮助开发者从旧版本 GeneralUpdate 迁移到最新稳定版 API(v10.5.0-beta.7)。
⚠️ 目标版本:NuGet v10.5.0-beta.7 开发分支(v10.5.0-beta.x)API 与稳定版有根本性差异。
📋 迁移前需求提取
### 当前状态
- 当前 GeneralUpdate 版本: ______(v9.x / v10.0-10.3 / v10.5.0-beta.x / 不确定)
- 当前 .NET 版本: ______
- UI 框架: ______
- 是否使用了 Bowl: ______(是/否)
- 是否使用了 Differential: ______(是/否)
### 迁移后目标
- 目标版本: ______(v10.5.0-beta.7 / 继续用开发分支)
- 是否需要新的功能(Bowl/IPC 替换/AOT): ______
迁移路径
路径 A:v9.x → v10.5.0-beta.7
这是最大的跳跃。v9.x 和 v10 的架构完全不同。
v9.x (单进程, HttpClient 直连)
↓
Breaking Changes:
├── 单进程 → 双进程架构(Client + Upgrade)
├── HttpClient 直连 → GeneralSpacestation 服务端
├── 无 IPC → AES 加密 IPC 文件
├── 无 manifest.json → 必须携带 manifest
└── API 命名空间全部重命名
↓
v10.5.0-beta.7 (双进程, UpdateRequest + Bootstrap)
迁移步骤:
// ❌ v9.x 写法(不复存在)
// var updater = new GeneralUpdater("https://api/method");
// updater.Start();
// ✅ v10.5.0-beta.7 写法
await new GeneralUpdateBootstrap()
.SetConfig(new UpdateRequest
{
UpdateUrl = "https://your-server.com/Upgrade/Verification",
AppSecretKey = "your-secret-key",
MainAppName = "MyApp.exe",
ClientVersion = "1.0.0.0",
ProductId = "my-product-001",
InstallPath = "."
})
.LaunchAsync();
| v9.x API | v10.5.0-beta.7 对应 | 说明 |
|---|---|---|
GeneralUpdater | GeneralUpdateBootstrap | 完全重命名 |
SetApiUrl() / SetMethod() | UpdateRequest.UpdateUrl | 统一到 UpdateRequest |
CheckUpdateAsync() | .LaunchAsync() | 异步改为返回 Bootstrap 实例 |
| 单进程直接更新 | Client + Upgrade 双进程 | 必须创建独立 Upgrade 项目 |
| N/A | generalupdate.manifest.json | 必须随首发版本发布 |
路径 B:v10.5.0-beta.x (开发分支) → v10.5.0-beta.7
| 开发分支 API (v10.5.0-beta.x) | 稳定版替代 (v10.5.0-beta.7) | 处理方式 |
| 开发分支 API (v10.5.0-beta.x) | 稳定版替代 (v10.5.0-beta.7) | 处理方式 |
|---|---|---|
new Option() / SetOption() | 存在且兼容 | 直接使用,命名空间有调整 |
.Hooks<T>() / IUpdateHooks | 存在且兼容 | 直接使用 |
.Strategy<T>() / IStrategy | 存在且兼容 | 直接使用 |
SilentPollOrchestrator | 存在 | Option.Silent + SetOption() |
ISslValidationPolicy | 存在 | 直接使用 |
Configinfo | 已移除 | 改用 UpdateRequest |
OssClient (AppType=3,4) | 存在 | 使用 AppType.OssClient 和 AppType.OssUpgrade |
| 硬编码版本号 | UpdateRequest.ClientVersion | 建议使用 Assembly.GetEntryAssembly()?.GetName()?.Version |