借助网络配置,控制Modbus工具的日志显示,避免卡死界面
智能大石头 authored at 2021-12-11 22:09:19
7.81 KiB
XCoder
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;
    }
}