using System;
using System.Collections.Generic;
using System.IO;
using System.Net.Http;
using System.Text.Json;
using System.Threading;
using System.Threading.Tasks;
using NewLife;
namespace NewLife.XCoder.Services;
/// <summary>更新清单</summary>
/// <param name="Version">最新版本号,如 8.2.2026.1111</param>
/// <param name="Url">下载地址</param>
/// <param name="Notes">更新说明</param>
/// <param name="Force">是否强制更新</param>
public sealed record UpdateManifest(String Version, String Url, String Notes = "", Boolean Force = false);
/// <summary>在线更新检查:解析清单、比较版本、拉取清单;失败不阻断使用</summary>
public static class UpdateChecker
{
/// <summary>默认更新清单地址</summary>
public const String DefaultUrl = "https://xcoder.newlifex.com/update.json";
/// <summary>解析更新清单,支持 JSON 与「版本 地址 说明」纯文本</summary>
/// <param name="text">清单内容</param>
/// <returns>清单;无法识别返回 null</returns>
public static UpdateManifest? Parse(String? text)
{
if (String.IsNullOrWhiteSpace(text)) return null;
var content = text!.Trim().Trim('\uFEFF').Trim();
if (content.Length == 0) return null;
if (content.StartsWith("{", StringComparison.Ordinal))
{
try
{
using var doc = JsonDocument.Parse(content);
var root = doc.RootElement;
if (root.ValueKind != JsonValueKind.Object) return null;
var version = GetString(root, "version");
if (version.IsNullOrEmpty()) return null;
var url = GetString(root, "url") ?? "";
var notes = GetString(root, "notes") ?? GetString(root, "description") ?? "";
var force = false;
if (root.TryGetProperty("force", out var forceEl) && forceEl.ValueKind == JsonValueKind.True) force = true;
return new UpdateManifest(version!.Trim(), url.Trim(), notes.Trim(), force);
}
catch (JsonException)
{
return null;
}
}
// 纯文本首行:版本 地址 说明
foreach (var raw in content.Split('\n'))
{
var line = raw.Trim();
if (line.Length == 0 || line.StartsWith("#", StringComparison.Ordinal)) continue;
var parts = line.Split([' ', '\t'], 3, StringSplitOptions.RemoveEmptyEntries);
if (parts.Length == 0) continue;
var url = parts.Length > 1 ? parts[1] : "";
var notes = parts.Length > 2 ? parts[2].Trim() : "";
return new UpdateManifest(parts[0].Trim(), url, notes, false);
}
return null;
}
/// <summary>比较版本号,判断是否存在更新</summary>
/// <param name="current">当前版本</param>
/// <param name="latest">最新版本</param>
/// <returns>最新版本更高返回 true</returns>
public static Boolean IsNewer(String? current, String? latest)
{
if (latest.IsNullOrWhiteSpace()) return false;
if (current.IsNullOrWhiteSpace()) return true;
if (Version.TryParse(Normalize(current!), out var cur) && Version.TryParse(Normalize(latest!), out var lat)) return lat > cur;
return !String.Equals(current!.Trim(), latest!.Trim(), StringComparison.OrdinalIgnoreCase);
}
/// <summary>拉取并解析更新清单</summary>
/// <param name="url">清单地址,为空使用默认地址</param>
/// <param name="timeoutSeconds">超时秒数</param>
/// <param name="token">取消</param>
/// <returns>清单;网络或格式异常返回 null,不抛给界面</returns>
public static async Task<UpdateManifest?> FetchAsync(String? url = null, Int32 timeoutSeconds = 10, CancellationToken token = default)
{
var address = url.IsNullOrWhiteSpace() ? DefaultUrl : url!.Trim();
try
{
using var client = new HttpClient { Timeout = TimeSpan.FromSeconds(timeoutSeconds) };
var text = await client.GetStringAsync(address, token).ConfigureAwait(false);
return Parse(text);
}
catch (Exception)
{
// 在线更新失败不阻断使用
return null;
}
}
/// <summary>下载更新包到缓存目录</summary>
/// <param name="url">下载地址</param>
/// <param name="fileName">保存文件名;为空时从地址末段推导</param>
/// <param name="targetDirectory">目标目录;为空时用缓存目录下的 update</param>
/// <param name="timeoutSeconds">超时秒数</param>
/// <param name="token">取消</param>
/// <returns>已下载文件的完整路径</returns>
public static async Task<String> DownloadAsync(String url, String? fileName = null, String? targetDirectory = null, Int32 timeoutSeconds = 120, CancellationToken token = default)
{
if (url.IsNullOrWhiteSpace()) throw new ArgumentException("下载地址不能为空", nameof(url));
var dir = targetDirectory.IsNullOrEmpty() ? Path.Combine(AppPaths.CacheDirectory, "update") : targetDirectory!;
Directory.CreateDirectory(dir);
var name = fileName;
if (name.IsNullOrEmpty())
{
var index = url!.LastIndexOfAny(['/', '\\']);
name = index >= 0 && index < url.Length - 1 ? url[(index + 1)..] : "XCoder-update.zip";
}
var path = Path.Combine(dir, name!);
if (File.Exists(path)) File.Delete(path);
using var client = new HttpClient { Timeout = TimeSpan.FromSeconds(timeoutSeconds) };
using var response = await client.GetAsync(url, HttpCompletionOption.ResponseHeadersRead, token).ConfigureAwait(false);
response.EnsureSuccessStatusCode();
await using var stream = await response.Content.ReadAsStreamAsync(token).ConfigureAwait(false);
await using var file = File.Create(path);
await stream.CopyToAsync(file, token).ConfigureAwait(false);
return path;
}
/// <summary>判断下载的更新包是否可直接运行安装(exe / msi)</summary>
/// <param name="path">文件路径</param>
/// <returns>可直接运行返回 true;压缩包等返回 false</returns>
public static Boolean IsInstallerFile(String? path)
{
if (path.IsNullOrWhiteSpace()) return false;
if (!File.Exists(path)) return false;
var ext = Path.GetExtension(path!).ToLowerInvariant();
return ext is ".exe" or ".msi";
}
/// <summary>把版本号规范成 System.Version 可解析的形式(去掉日期里的非数字分隔与短横线后缀)</summary>
/// <param name="version">版本文本</param>
/// <returns>规范后的版本文本</returns>
public static String Normalize(String version)
{
var text = version.Trim();
var index = text.IndexOf('-');
if (index > 0) text = text[..index];
var parts = new List<String>();
foreach (var item in text.Split('.'))
{
if (item.Length == 0) continue;
var digits = new System.Text.StringBuilder();
foreach (var ch in item)
{
if (ch >= '0' && ch <= '9') digits.Append(ch);
}
parts.Add(digits.Length == 0 ? "0" : digits.ToString());
}
while (parts.Count < 2) parts.Add("0");
return String.Join('.', parts);
}
private static String? GetString(JsonElement root, String name)
{
if (root.TryGetProperty(name, out var value) && value.ValueKind == JsonValueKind.String) return value.GetString();
foreach (var item in root.EnumerateObject())
{
if (item.Name.EqualIgnoreCase(name) && item.Value.ValueKind == JsonValueKind.String) return item.Value.GetString();
}
return null;
}
}
|