APIUpdateManager.cs

浏览该文件的文档.

using System.Text.Json;
using System.Text.Json.Serialization;
using System.Text.RegularExpressions;
 
namespace Game {
    public static class APIUpdateManager {
        public static bool? IsNeedUpdate {
            get;
            // ReSharper disable UnusedAutoPropertyAccessor.Local
            private set;
            // ReSharper restore UnusedAutoPropertyAccessor.Local
        }

        public static string CurrentVersion => ModsManager.APIVersionString;

        public static string LatestVersion { get; private set; }
 
        public static void Initialize() {
#if !DEBUG
            Task.Run(async () => { IsNeedUpdate = await GetIsNeedUpdate(); });
#endif
        }

        public static async Task<bool> GetIsNeedUpdate() {
            LatestVersion = await GetLatestVersion(true);
            string currentVersion = ModsManager.APIVersionString;
            return CompareVersion(currentVersion, LatestVersion) == -1;
        }

        public static async Task<JsonDocument> GetLatestAPIJsonDocument() =>
            await OnlineJsonReader.GetJsonFromUrlAsync(ModsManager.APILatestReleaseLink_API);

        public static async Task<JsonDocument> GetAPIReleasesJsonDocument() =>
            await OnlineJsonReader.GetJsonFromUrlAsync(ModsManager.APIReleasesLink_API);

        public static Regex VersionRegex = new(@"(\d+)\.?(\d+)?\.?(\d+)?\.?(\d+)?");

        public static uint ParseVersionFromString(string version) {
            Match match = VersionRegex.Match(version);
            if (match.Success) {
                uint result = 0;
                for (int i = 1; i < Math.Min(5, match.Groups.Count); i++) {
                    Group group = match.Groups[i];
                    if (group.Success) {
                        if (byte.TryParse(group.Value, out byte value)) {
                            result |= (uint)value << (8 * (4 - i));
                        }
                        else {
                            throw new FormatException($"Invalid version format: {version}");
                        }
                    }
                }
                return result;
            }
            throw new FormatException($"Invalid version format: {version}");
        }

        //当 direct 为真，将获取的 json 直接当做数组中的一个元素
        //常用于链接自带 latest 标识的情况
        public static async Task<string> GetLatestVersion(bool direct) {
            using (JsonDocument remoteDoc = await GetLatestAPIJsonDocument()) {
                JsonElement root = remoteDoc.RootElement;
                // 假设 API 返回的版本信息在第一个 release 的 tag_name 字段
                string input = direct
                    ? root.GetProperty("tag_name").GetString()
                    : root[root.GetArrayLength() - 1].GetProperty("tag_name").GetString();
                return input;
            }
        }

        public static int CompareVersion(string current, string target) {
            if (target == "API_OLD") {
                return current == "API_OLD" ? 0 : 1;
            }
            if (current == "API_OLD") {
                return -1;
            }
            uint currentVersion = ParseVersionFromString(current);
            uint targetVersion = ParseVersionFromString(target);
            return currentVersion.CompareTo(targetVersion);
        }
    }
 
    /*
     这里面的字段名称由于涉及到反序列化解析千万不能改！！
     这里面的字段名称由于涉及到反序列化解析千万不能改！！
     这里面的字段名称由于涉及到反序列化解析千万不能改！！
    */
    public class ReleaseInfo {
        public long id { get; set; }
        public string tag_name { get; set; }
        public string target_commitish { get; set; }
        public bool prerelease { get; set; }
        public string name { get; set; }
        public string body { get; set; }
        public Author author { get; set; }
        public string created_at { get; set; }
        public List<Asset> assets { get; set; }
    }
 
    /*
     这里面的字段名称由于涉及到反序列化解析千万不能改！！
     这里面的字段名称由于涉及到反序列化解析千万不能改！！
     这里面的字段名称由于涉及到反序列化解析千万不能改！！
    */
    public class Author {
        public long id { get; set; }
        public string login { get; set; }
        public string name { get; set; }
        public string avatar_url { get; set; }
        public string url { get; set; }
        public string html_url { get; set; }
        public string remark { get; set; }
        public string followers_url { get; set; }
        public string following_url { get; set; }
        public string gists_url { get; set; }
        public string starred_url { get; set; }
        public string subscriptions_url { get; set; }
        public string organizations_url { get; set; }
        public string repos_url { get; set; }
        public string events_url { get; set; }
        public string received_events_url { get; set; }
        public string type { get; set; }
    }
 
    /*
     这里面的字段名称由于涉及到反序列化解析千万不能改！！
     这里面的字段名称由于涉及到反序列化解析千万不能改！！
     这里面的字段名称由于涉及到反序列化解析千万不能改！！
    */
    public class Asset {
        public string browser_download_url { get; set; }
        public string name { get; set; }
    }
 
    [JsonSourceGenerationOptions(
        PropertyNamingPolicy = JsonKnownNamingPolicy.SnakeCaseLower
    )]
    [JsonSerializable(typeof(List<ReleaseInfo>))]
    [JsonSerializable(typeof(ReleaseInfo))]
    [JsonSerializable(typeof(Author))]
    [JsonSerializable(typeof(List<Asset>))]
    [JsonSerializable(typeof(Asset))]
    public partial class GiteeReleaseInfoJsonContext : JsonSerializerContext
    {
    }
}