feat(UI): 添加界面单实例打开模式

新增 OptionUIAllowMultiInstanceAttribute 属性，允许标记界面支持多实例。
通过 EnableUIFormSingleton 控制默认行为，未标记属性的界面默认单实例打开。

Author: AlianBlank

Runtime/Attribute/OptionUIAllowMultiInstanceAttribute.cs

@@ -0,0 +1,66 @@
+// ==========================================================================================
+//   GameFrameX 组织及其衍生项目的版权、商标、专利及其他相关权利
+//   GameFrameX organization and its derivative projects' copyrights, trademarks, patents, and related rights
+//   均受中华人民共和国及相关国际法律法规保护。
+//   are protected by the laws of the People's Republic of China and relevant international regulations.
+//   使用本项目须严格遵守相应法律法规及开源许可证之规定。
+//   Usage of this project must strictly comply with applicable laws, regulations, and open-source licenses.
+//   本项目采用 MIT 许可证与 Apache License 2.0 双许可证分发，
+//   This project is dual-licensed under the MIT License and Apache License 2.0,
+//   完整许可证文本请参见源代码根目录下的 LICENSE 文件。
+//   please refer to the LICENSE file in the root directory of the source code for the full license text.
+//   禁止利用本项目实施任何危害国家安全、破坏社会秩序、
+//   It is prohibited to use this project to engage in any activities that endanger national security, disrupt social order,
+//   侵犯他人合法权益等法律法规所禁止的行为！
+//   or infringe upon the legitimate rights and interests of others, as prohibited by laws and regulations!
+//   因基于本项目二次开发所产生的一切法律纠纷与责任，
+//   Any legal disputes and liabilities arising from secondary development based on this project
+//   本项目组织与贡献者概不承担。
+//   shall be borne solely by the developer; the project organization and contributors assume no responsibility.
+//   GitHub 仓库：https://github.com/GameFrameX
+//   GitHub Repository: https://github.com/GameFrameX
+//   Gitee  仓库：https://gitee.com/GameFrameX
+//   Gitee Repository:  https://gitee.com/GameFrameX
+//   CNB  仓库：https://cnb.cool/GameFrameX
+//   CNB Repository:  https://cnb.cool/GameFrameX
+//   官方文档：https://gameframex.doc.alianblank.com/
+//   Official Documentation: https://gameframex.doc.alianblank.com/
+//  ==========================================================================================
+
+using System;
+
+namespace GameFrameX.UI.Runtime
+{
+    /// <summary>
+    /// 控制指定界面是否允许多实例打开。
+    /// </summary>
+    /// <remarks>
+    /// Controls whether the specified UI form allows multi-instance opening.
+    /// </remarks>
+    [AttributeUsage(AttributeTargets.Class)]
+    [UnityEngine.Scripting.Preserve]
+    public sealed class OptionUIAllowMultiInstanceAttribute : Attribute
+    {
+        /// <summary>
+        /// 是否允许多实例打开，默认为 false。
+        /// </summary>
+        /// <remarks>
+        /// Whether to allow multi-instance opening. Default is false.
+        /// </remarks>
+        [UnityEngine.Scripting.Preserve]
+        public bool Enable { get; private set; }
+
+        /// <summary>
+        /// 初始化特性实例。
+        /// </summary>
+        /// <remarks>
+        /// Initializes the attribute instance.
+        /// </remarks>
+        /// <param name="enable">是否允许多实例打开。/ Whether to allow multi-instance opening.</param>
+        [UnityEngine.Scripting.Preserve]
+        public OptionUIAllowMultiInstanceAttribute(bool enable = false)
+        {
+            Enable = enable;
+        }
+    }
+}

Runtime/Attribute/OptionUIAllowMultiInstanceAttribute.cs.meta

@@ -27,6 +27,7 @@
 //   Official Documentation: https://gameframex.doc.alianblank.com/
 //  ==========================================================================================
 
+using System;
 using System.Collections.Generic;
 using GameFrameX.Asset.Runtime;
 using GameFrameX.ObjectPool;
@@ -203,6 +204,42 @@ public bool IsEnableUIShowAnimation
             set { m_IsEnableUIShowAnimation = value; }
         }
 
+        [UnityEngine.Scripting.Preserve]
+        private bool m_EnableUIFormSingleton = true;
+
+        /// <summary>
+        /// 获取或设置是否启用界面单实例打开模式。
+        /// </summary>
+        /// <remarks>
+        /// Gets or sets whether singleton mode is enabled when opening UI forms.
+        /// </remarks>
+        [UnityEngine.Scripting.Preserve]
+        public bool EnableUIFormSingleton
+        {
+            get { return m_EnableUIFormSingleton; }
+            set { m_EnableUIFormSingleton = value; }
+        }
+
+        /// <summary>
+        /// 是否对指定界面类型采用单实例打开模式。
+        /// </summary>
+        /// <remarks>
+        /// Determines whether singleton open mode should be used for the specified UI form type.
+        /// </remarks>
+        /// <param name="uiFormType">界面类型。/ The UI form type.</param>
+        /// <returns>是否采用单实例模式。/ Whether singleton mode should be used.</returns>
+        [UnityEngine.Scripting.Preserve]
+        protected bool UseSingletonOpenMode(Type uiFormType)
+        {
+            if (!EnableUIFormSingleton || uiFormType == null)
+            {
+                return false;
+            }
+
+            var allowMultiAttr = Attribute.GetCustomAttribute(uiFormType, typeof(OptionUIAllowMultiInstanceAttribute)) as OptionUIAllowMultiInstanceAttribute;
+            return allowMultiAttr == null || !allowMultiAttr.Enable;
+        }
+
         [UnityEngine.Scripting.Preserve]
         protected IObjectPool<UIFormInstanceObject> m_InstancePool = null;
         [UnityEngine.Scripting.Preserve]

Runtime/BaseUIManager.cs

@@ -85,6 +85,14 @@ public interface IUIManager
         /// </remarks>
         bool IsEnableUIHideAnimation { get; set; }
 
+        /// <summary>
+        /// 获取或设置是否启用界面单实例打开模式。
+        /// </summary>
+        /// <remarks>
+        /// Gets or sets whether singleton mode is enabled when opening UI forms.
+        /// </remarks>
+        bool EnableUIFormSingleton { get; set; }
+
         /// <summary>
         /// 获取或设置界面实例对象池对象过期秒数。
         /// </summary>

Runtime/UI/IUIManager.cs

@@ -103,6 +103,15 @@ public partial class UIComponent : GameFrameworkComponent
         [UnityEngine.Scripting.Preserve]
         [SerializeField] private bool m_IsEnableUIHideAnimation = false;
 
+        /// <summary>
+        /// 是否启用界面单实例打开模式。
+        /// </summary>
+        /// <remarks>
+        /// Whether to enable singleton mode when opening UI forms.
+        /// </remarks>
+        [UnityEngine.Scripting.Preserve]
+        [SerializeField] private bool m_EnableUIFormSingleton = true;
+
         /// <summary>
         /// UI 自动回收间隔时间/秒。
         /// </summary>
@@ -286,6 +295,26 @@ public bool IsEnableUIHideAnimation
             get { return m_UIManager.IsEnableUIHideAnimation; }
         }
 
+        /// <summary>
+        /// 获取或设置是否启用界面单实例打开模式。
+        /// </summary>
+        /// <remarks>
+        /// Gets or sets whether singleton mode is enabled when opening UI forms.
+        /// </remarks>
+        [UnityEngine.Scripting.Preserve]
+        public bool EnableUIFormSingleton
+        {
+            get { return m_EnableUIFormSingleton; }
+            set
+            {
+                m_EnableUIFormSingleton = value;
+                if (m_UIManager != null)
+                {
+                    m_UIManager.EnableUIFormSingleton = value;
+                }
+            }
+        }
+
         /// <summary>
         /// 获取界面组数量。
         /// </summary>
@@ -481,6 +510,7 @@ private void Start()
             m_UIManager.RecycleInterval = m_RecycleInterval;
             m_UIManager.IsEnableUIHideAnimation = m_IsEnableUIHideAnimation;
             m_UIManager.IsEnableUIShowAnimation = m_IsEnableUIShowAnimation;
+            m_UIManager.EnableUIFormSingleton = m_EnableUIFormSingleton;
             // m_UIManager.InstancePriority = m_InstancePriority;
 
             m_CustomUIGroupHelper = Helper.CreateHelper(m_UIGroupHelperTypeName, m_CustomUIGroupHelper);