refactor(launcher): 迁移应用层启动流程到 Startup 包架构

将启动流程从旧的 Procedure/PatchUpdater 体系切换到
com.gameframex.unity.startup 包：
- 删除 Procedure/PatchUpdater/* 等老启动状态文件
- 新增 Startup/ApplicationStartupEntry MonoBehaviour 入口
- 新增 ApplicationStartupUIHandler、ApplicationHotfixLauncher 适配器
- 改造 HotfixHelper、LauncherUIHandler 适配新接口
- 更新 Launcher 场景绑定新启动入口

Author: AlianBlank

Assets/Scenes/Launcher.unity

@@ -6,8 +6,14 @@
 using System.Collections.Generic;
 using UnityEngine;
 
-namespace Unity.Startup.Procedure
+namespace GameFrameX.Startup.Application
 {
+    /// <summary>
+    /// FairyGUI 扩展加载器，用于加载网络图片、包内资源或本地文件的图片纹理。
+    /// </summary>
+    /// <remarks>
+    /// FairyGUI extension loader used to load texture from network URL, package asset, or local file.
+    /// </remarks>
     public sealed class FairyGuiExtensionLoader : GLoader
     {
         private static ImageCacheComponent _imageCacheComponent;
@@ -28,6 +34,13 @@ public LoaderItem(string key, NTexture texture, AssetHandle assetHandle = defaul
 
         private readonly Dictionary<string, LoaderItem> _cache = new Dictionary<string, LoaderItem>();
 
+        /// <summary>
+        /// 释放外部加载的纹理资源。
+        /// </summary>
+        /// <remarks>
+        /// Release the externally loaded texture resource.
+        /// </remarks>
+        /// <param name="nTexture">要释放的纹理对象 / The texture object to release</param>
         protected override void FreeExternal(NTexture nTexture)
         {
             foreach (var loaderItem in _cache)
@@ -44,6 +57,12 @@ protected override void FreeExternal(NTexture nTexture)
             base.FreeExternal(nTexture);
         }
 
+        /// <summary>
+        /// 异步加载外部纹理资源。
+        /// </summary>
+        /// <remarks>
+        /// Asynchronously load an external texture resource.
+        /// </remarks>
         protected override async void LoadExternal()
         {
             if (url.IsNullOrWhiteSpace())

Assets/Scripts/Framework/FairyGuiExtensionLoader.cs

@@ -0,0 +1,27 @@
+using Cysharp.Threading.Tasks;
+using GameFrameX.Startup.Runtime;
+
+namespace GameFrameX.Startup.Application
+{
+    /// <summary>
+    /// 应用层热更启动器，将 <see cref="HotfixHelper"/> 适配到 <see cref="IHotfixLauncher"/> 接口。
+    /// </summary>
+    /// <remarks>
+    /// Application hotfix launcher that adapts <see cref="HotfixHelper"/> to the <see cref="IHotfixLauncher"/> interface.
+    /// </remarks>
+    public sealed class ApplicationHotfixLauncher : IHotfixLauncher
+    {
+        /// <summary>
+        /// 异步启动热更程序集。
+        /// </summary>
+        /// <remarks>
+        /// Asynchronously start the hotfix assembly.
+        /// </remarks>
+        /// <param name="options">启动选项 / Startup options</param>
+        /// <returns>包含启动结果的 <see cref="HotfixLaunchResult"/> / The <see cref="HotfixLaunchResult"/> containing the startup result</returns>
+        public UniTask<HotfixLaunchResult> StartAsync(StartupOptions options)
+        {
+            return HotfixHelper.StartHotfixAsync(options);
+        }
+    }
+}

Assets/Scripts/Framework/Procedure/ApplicationHotfixLauncher.cs

@@ -0,0 +1,87 @@
+using Cysharp.Threading.Tasks;
+using GameFrameX.Startup.Runtime;
+
+namespace GameFrameX.Startup.Application
+{
+    /// <summary>
+    /// 应用层启动 UI 处理实现，将 <see cref="LauncherUIHandler"/> 适配到 <see cref="IStartupUIHandler"/> 接口。
+    /// </summary>
+    /// <remarks>
+    /// Application startup UI handler that adapts <see cref="LauncherUIHandler"/> to the <see cref="IStartupUIHandler"/> interface.
+    /// </remarks>
+    public sealed class ApplicationStartupUIHandler : IStartupUIHandler
+    {
+        /// <summary>
+        /// 异步打开启动 UI。
+        /// </summary>
+        /// <remarks>
+        /// Asynchronously open the startup UI.
+        /// </remarks>
+        /// <param name="uiResName">启动 UI 资源名称 / Startup UI asset name</param>
+        /// <returns>异步任务 / The async task</returns>
+        public UniTask StartAsync(string uiResName)
+        {
+            return LauncherUIHandler.StartAsync(uiResName);
+        }
+
+        /// <summary>
+        /// 设置提示文本。
+        /// </summary>
+        /// <remarks>
+        /// Set the tip text.
+        /// </remarks>
+        /// <param name="text">要显示的提示文本 / The tip text to display</param>
+        public void SetTipText(string text)
+        {
+            LauncherUIHandler.SetTipText(text);
+        }
+
+        /// <summary>
+        /// 设置下载进度。
+        /// </summary>
+        /// <remarks>
+        /// Set the download progress.
+        /// </remarks>
+        /// <param name="progress">下载进度，取值范围 [0, 1] / Download progress in range [0, 1]</param>
+        /// <param name="sizeInfo">已下载与总大小信息字符串 / Downloaded size and total size info string</param>
+        public void SetProgress(float progress, string sizeInfo)
+        {
+            LauncherUIHandler.SetProgress(progress, sizeInfo);
+        }
+
+        /// <summary>
+        /// 标记下载流程完成。
+        /// </summary>
+        /// <remarks>
+        /// Mark the download process as finished.
+        /// </remarks>
+        public void SetProgressUpdateFinish()
+        {
+            LauncherUIHandler.SetProgressUpdateFinish();
+        }
+
+        /// <summary>
+        /// 异步显示强制或可选更新提示。
+        /// </summary>
+        /// <remarks>
+        /// Asynchronously show the force or optional update prompt.
+        /// </remarks>
+        /// <param name="upgradeInfo">启动器更新信息 / The launcher upgrade info</param>
+        /// <returns>异步任务，返回用户是否继续 / The async task returning whether the user continues</returns>
+        public UniTask<bool> ShowUpgradeAsync(StartupUpgradeInfo upgradeInfo)
+        {
+            return LauncherUIHandler.ShowUpgradeAsync(upgradeInfo);
+        }
+
+        /// <summary>
+        /// 关闭启动 UI 并释放资源。
+        /// </summary>
+        /// <remarks>
+        /// Close the startup UI and release resources.
+        /// </remarks>
+        public void Dispose()
+        {
+            LauncherUIHandler.Dispose();
+        }
+    }
+}

Assets/Scripts/Framework/Procedure/ApplicationHotfixLauncher.cs.meta

@@ -1,33 +1,83 @@
-using GameFrameX.Runtime;
+using System;
+using GameFrameX.Runtime;
+using Cysharp.Threading.Tasks;
+using GameFrameX.Startup.Runtime;
 #if ENABLE_GAME_FRAME_X_HYBRID_CLR && !DISABLE_HYBRIDCLR
-using System;
 using System.Reflection;
 using System.Linq;
 using HybridCLR;
 #endif
 
-namespace Unity.Startup.Procedure
+namespace GameFrameX.Startup.Application
 {
+    /// <summary>
+    /// 热更启动辅助类，负责加载 AOT DLL 与热更程序集，并调用其入口方法。
+    /// </summary>
+    /// <remarks>
+    /// Hotfix startup helper responsible for loading AOT DLLs and the hotfix assembly, then invoking its entry method.
+    /// </remarks>
     public static class HotfixHelper
     {
-#if (ENABLE_GAME_FRAME_X_HYBRID_CLR && !DISABLE_HYBRIDCLR)
-        const string HotfixName = "Unity.Hotfix";
-#endif
-        public static
+        /// <summary>
+        /// 以默认选项启动热更程序集。
+        /// </summary>
+        /// <remarks>
+        /// Start the hotfix assembly with default options.
+        /// </remarks>
+        public static async void StartHotfix()
+        {
+            await StartHotfixAsync(null);
+        }
+
+        /// <summary>
+        /// 异步加载并启动热更程序集。
+        /// </summary>
+        /// <remarks>
+        /// Asynchronously load and start the hotfix assembly.
+        /// </remarks>
+        /// <param name="options">启动选项；为 null 时使用默认配置 / Startup options; default configuration is used when null</param>
+        /// <returns>包含启动结果与错误信息的 <see cref="HotfixLaunchResult"/> / The <see cref="HotfixLaunchResult"/> containing startup result and error info</returns>
+        public static async UniTask<HotfixLaunchResult> StartHotfixAsync(StartupOptions options)
+        {
+            try
+            {
+                await StartHotfixInternalAsync(options);
+                return HotfixLaunchResult.Succeed();
+            }
+            catch (Exception e)
+            {
+                Log.Error(e);
+                return HotfixLaunchResult.Fail(e.Message);
+            }
+        }
+
+        private static
 #if ENABLE_GAME_FRAME_X_HYBRID_CLR && !DISABLE_HYBRIDCLR
-            async
+            async UniTask
+#else
+            UniTask
 #endif
-            void StartHotfix()
+            StartHotfixInternalAsync(StartupOptions options)
         {
+            var assemblyName = options == null || string.IsNullOrEmpty(options.HotfixAssemblyName)
+                ? "Unity.Hotfix"
+                : options.HotfixAssemblyName;
+            var entryTypeName = options == null || string.IsNullOrEmpty(options.HotfixEntryTypeName)
+                ? "Hotfix.HotfixLauncher"
+                : options.HotfixEntryTypeName;
+            var entryMethodName = options == null || string.IsNullOrEmpty(options.HotfixEntryMethodName)
+                ? "Main"
+                : options.HotfixEntryMethodName;
+
 #if ENABLE_GAME_FRAME_X_HYBRID_CLR && !DISABLE_HYBRIDCLR
             if (ApplicationHelper.IsEditor)
             {
                 var assemblies = Utility.Assembly.GetAssemblies();
                 foreach (var assembly in assemblies)
                 {
-                    if (assembly.GetName().Name.Equals(HotfixName, StringComparison.OrdinalIgnoreCase))
+                    if (assembly.GetName().Name.Equals(assemblyName, StringComparison.OrdinalIgnoreCase))
                     {
-                        Run(assembly);
+                        Run(assembly, entryTypeName, entryMethodName);
                         break;
                     }
                 }
@@ -46,37 +96,38 @@ void StartHotfix()
             }
 
             Log.Info("结束加载AOT DLL");
-            Log.Info("开始加载Unity.Hotfix.dll");
-            var assetHotfixDllPath = Utility.Asset.Path.GetCodePath(HotfixName + Utility.Const.FileNameSuffix.DLL);
+            Log.Info("开始加载" + assemblyName + ".dll");
+            var assetHotfixDllPath = Utility.Asset.Path.GetCodePath(assemblyName + Utility.Const.FileNameSuffix.DLL);
             var assetHotfixDllOperationHandle = await GameApp.Asset.LoadAssetAsync<UnityEngine.Object>(assetHotfixDllPath);
             var assemblyDataHotfixDll = assetHotfixDllOperationHandle.GetAssetObject<UnityEngine.TextAsset>().bytes;
             Log.Info("开始加载程序集Hotfix");
             var hotfixAssembly = Assembly.Load(assemblyDataHotfixDll, null);
-            Run(hotfixAssembly);
+            Run(hotfixAssembly, entryTypeName, entryMethodName);
 
 #else
-            RunNative();
+            RunNative(entryTypeName, entryMethodName);
+            return UniTask.CompletedTask;
 #endif
         }
 #if ENABLE_GAME_FRAME_X_HYBRID_CLR && !DISABLE_HYBRIDCLR
-        private static void Run(Assembly assembly)
+        private static void Run(Assembly assembly, string entryTypeName, string entryMethodName)
         {
             Log.Info("加载程序集Hotfix 结束 Assembly " + assembly.FullName);
-            var entryType = assembly.GetType("Hotfix.HotfixLauncher");
+            var entryType = assembly.GetType(entryTypeName);
             Log.Info("加载程序集Hotfix 结束 EntryType " + entryType.FullName);
-            var method = entryType.GetMethod("Main");
+            var method = entryType.GetMethod(entryMethodName);
             Log.Info("加载程序集Hotfix 结束 EntryType=>method " + method?.Name);
             method?.Invoke(null, null);
         }
 #else
-        private static void RunNative()
+        private static void RunNative(string entryTypeName, string entryMethodName)
         {
-            var entryType = Utility.Assembly.GetType("Hotfix.HotfixLauncher");
+            var entryType = Utility.Assembly.GetType(entryTypeName);
             Log.Info("加载程序集Hotfix 结束 EntryType " + entryType.FullName);
-            var method = entryType.GetMethod("Main");
+            var method = entryType.GetMethod(entryMethodName);
             Log.Info("加载程序集Hotfix 结束 EntryType=>method " + method?.Name);
             method?.Invoke(null, null);
         }
 #endif
     }
-}
+}