GZUpdate.Client.Win 26.101.1004

GZUpdate.Client.Win

GZUpdate.Client.Win 是 GZUpdate.Client 的 WinForms 开箱即用集成包。业务项目只需要设置一次升级参数，再调用检查升级方法即可。

安装

<PackageReference Include="GZUpdate.Client.Win" Version="26.1.1002" />

启动时自动检查并升级

using GZUpdate.Client;
using GZUpdate.Client.Win;

[STAThread]
static void Main()
{
    // .NET Framework 项目可替换为 Application.EnableVisualStyles()
    // 和 Application.SetCompatibleTextRenderingDefault(false)。
    ApplicationConfiguration.Initialize();

    WinUpdateClient.Configure(
        server: "https://update.infnitee.com/",
        productId: "YourProductId",
        versionType: EnumVersionType.release,
        upgradeExecutorDllPath: "__upgrade_executor_dll");

    var result = WinUpdateClient.CheckAndUpdate();
    if (result.ShouldExitApplication)
        return;

    Application.Run(new MainForm());
}

启动模式下，如果发现新版本，包会显示默认升级进度弹窗；升级成功后会自动启动新实例，调用方根据 ShouldExitApplication 停止继续打开主窗体。

手动检查更新

主窗体中可以这样绑定“检查更新”按钮：

void BtnCheckUpdate_Click(object sender, EventArgs e)
{
    WinUpdateClient.CheckAndUpdate(this, WinUpdateMode.Manual);
}

手动模式下，发现新版本会先询问用户是否升级；升级完成后默认保留弹窗上的“重启”按钮，由用户手动重启。

可选配置

如果需要更多控制，可以使用 WinUpdateOptions：

WinUpdateClient.Configure(new WinUpdateOptions
{
    Server = "https://update.infnitee.com/",
    ProductId = "YourProductId",
    VersionType = EnumVersionType.release,
    UpgradeExecutorDllPath = "__upgrade_executor_dll",
    RestartAfterStartupUpdate = true,
    RestartAfterManualUpdate = false,
    PromptBeforeManualUpdate = true,
    ShowNoUpdateMessage = true
});

自定义升级弹窗

实现 IWinUpdateProgressDialogFactory 和 IWinUpdateProgressDialog，再通过 Configure 注入：

WinUpdateClient.Configure(
    server: "https://update.infnitee.com/",
    productId: "YourProductId",
    versionType: EnumVersionType.release,
    upgradeExecutorDllPath: "__upgrade_executor_dll",
    progressDialogFactory: new YourUpdateDialogFactory());

自定义弹窗需要处理这些方法：

• SetMessage：显示当前升级消息。
• SetDownloadProgress：显示下载进度。
• SetPackageProgress：显示升级包数量进度。
• SetComplete：显示升级完成状态。
• SetFailure：显示升级失败状态。
• EnableClose / RequestClose：控制弹窗关闭。

返回结果

CheckAndUpdate 返回 WinUpdateResult：

• Status：本次检查/升级状态。
• IsUpdated：是否已完成升级。
• ShouldExitApplication：是否应停止当前启动流程。
• LatestVersion：检测到的最新版本。
• CurrentVersion：升级后写入的当前版本。
• Error：失败异常。