WPF应用自动更新方案咨询：如何基于GitHub预校验版本避免大文件无效下载

核心思路 #

绕开直接下载大文件做版本校验的低效方式，转而先获取极小体积的版本元数据，对比本地版本后再决定是否触发更新下载，从根源上节省时间和带宽。

具体实现方案 #

1. 上传独立的版本信息文件到GitHub

在你的GitHub仓库（或对应Release的附件中）上传一个体积极小的配置文件（比如version.json），内容包含最新版本号、exe的哈希值等关键信息：

{
  "Version": "2.1.0",
  "ExeSha256": "abc123...",
  "ReleaseDate": "2024-05-20"
}

WPF应用启动时，先通过HttpClient下载这个文件：

private async Task<bool> NeedUpdate()
{
    using var client = new HttpClient();
    try
    {
        // 替换为你的version.json实际地址
        var jsonStr = await client.GetStringAsync("https://raw.githubusercontent.com/你的用户名/仓库名/main/version.json");
        var remoteInfo = JsonSerializer.Deserialize<VersionConfig>(jsonStr);
        
        // 获取本地应用版本
        var localVersion = Assembly.GetExecutingAssembly().GetName().Version;
        var remoteVersion = Version.Parse(remoteInfo.Version);
        
        return remoteVersion > localVersion;
    }
    catch (Exception)
    {
        // 网络异常时默认不提示更新，避免干扰用户
        return false;
    }
}

public class VersionConfig
{
    public string Version { get; set; }
    public string ExeSha256 { get; set; }
}

如果对比后发现版本落后，再启动4GB exe的下载流程；版本一致则直接跳过。

2. 直接调用GitHub Release API获取版本信息

如果你的GitHub Release标签严格遵循版本号格式（比如v1.0.0、v2.1.0），可以直接调用GitHub的最新Release API获取版本号，无需额外上传配置文件：

private async Task<bool> CheckReleaseVersion()
{
    using var client = new HttpClient();
    client.DefaultRequestHeaders.UserAgent.TryParseAdd("WpfUpdateChecker"); // 避免API限流
    
    try
    {
        // 替换为你的仓库地址
        var apiUrl = "https://api.github.com/repos/你的用户名/仓库名/releases/latest";
        var response = await client.GetFromJsonAsync<GitHubRelease>(apiUrl);
        
        if (response == null) return false;
        // 去掉标签中的"v"前缀，解析版本号
        var remoteVersionStr = response.TagName.TrimStart('v');
        var remoteVersion = Version.Parse(remoteVersionStr);
        var localVersion = Assembly.GetExecutingAssembly().GetName().Version;
        
        return remoteVersion > localVersion;
    }
    catch (Exception)
    {
        return false;
    }
}

public class GitHubRelease
{
    [JsonPropertyName("tag_name")]
    public string TagName { get; set; }
}

注意：公开仓库的GitHub API有调用次数限制，若用户量较大，建议优先用第一种静态文件的方案。

3. 补充优化：下载时的断点续传与哈希校验

如果确认需要更新，下载4GB文件时建议实现断点续传，避免网络中断后重新下载；同时可以用version.json中的哈希值，在下载完成后校验文件完整性，防止损坏。

内容的提问来源于stack exchange，提问作者Bruse