Merge pull request 'newgame' (#2) from newgame into master

Reviewed-on: #2

Assets/DemoGame/GameScript/Hotfix/GFLog.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: 62447c4f1289487baf38165183f5ea3b
+timeCreated: 1731487450

Assets/DemoGame/GameScript/Hotfix/GFLog/GameFrameworkLog.cs

@@ -0,0 +1,202 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace ZFramework
+{
+    public static partial class GameFrameworkLog
+    {
+        private static ILogHelper s_LogHelper = null;
+
+        /// <summary>
+        /// 设置框架日志辅助器
+        /// </summary>
+        /// <param name="logHelper"></param>
+        public static void SetLogHelper(ILogHelper logHelper)
+        {
+            s_LogHelper = logHelper;
+        }
+
+        /// <summary>
+        /// 打印调试级别日志，用于记录调试类日志信息。
+        /// </summary>
+        /// <param name="message">日志内容。</param>
+        public static void Debug(object message)
+        {
+            if (s_LogHelper == null)
+            {
+                return;
+            }
+            s_LogHelper.Log(GameFrameworkLogLevel.Debug, message);
+        }
+
+        /// <summary>
+        /// 打印调试级别日志，用于记录调试类日志信息。
+        /// </summary>
+        /// <param name="message">日志内容。</param>
+        public static void Debug(string message)
+        {
+            if (s_LogHelper == null)
+            {
+                return;
+            }
+            s_LogHelper.Log(GameFrameworkLogLevel.Debug, message);
+        }
+
+        //暂时保留，有需要再来缝补
+        //public static void Debug<T>(string format,T arg)
+        //{
+        //    if (s_LogHelper==null)
+        //    {
+        //        return;
+        //    }
+        //    s_LogHelper.Log(GameFrameworkLogLevel.Debug, Utility.Text.Format(format, arg));
+        //}
+
+
+
+        /// <summary>
+        /// 打印信息级别日志，用于记录程序正常运行日志信息。
+        /// </summary>
+        /// <param name="message">日志内容。</param>
+        public static void Info(object message)
+        {
+            if (s_LogHelper == null)
+            {
+                return;
+            }
+            s_LogHelper.Log(GameFrameworkLogLevel.Info, message);
+        }
+
+        /// <summary>
+        /// 打印信息级别日志，用于记录程序正常运行日志信息。
+        /// </summary>
+        /// <param name="message">日志内容。</param>
+        public static void Info(string message)
+        {
+            if (s_LogHelper == null)
+            {
+                return;
+            }
+
+            s_LogHelper.Log(GameFrameworkLogLevel.Info, message);
+        }
+
+        //暂时保留，有需要再来缝补
+        ///// <summary>
+        ///// 打印信息级别日志，用于记录程序正常运行日志信息。
+        ///// </summary>
+        ///// <typeparam name="T">日志参数的类型。</typeparam>
+        ///// <param name="format">日志格式。</param>
+        ///// <param name="arg">日志参数。</param>
+        //public static void Info<T>(string format, T arg)
+        //{
+        //    if (s_LogHelper == null)
+        //    {
+        //        return;
+        //    }
+
+        //    s_LogHelper.Log(GameFrameworkLogLevel.Info, Utility.Text.Format(format, arg));
+        //}
+
+
+
+
+
+        /// <summary>
+        /// 打印警告级别日志，建议在发生局部功能逻辑错误，但尚不会导致游戏崩溃或异常时使用。
+        /// </summary>
+        /// <param name="message"></param>
+        public static void Warning(object message)
+        {
+            if (s_LogHelper == null)
+            {
+                return;
+            }
+            s_LogHelper.Log(GameFrameworkLogLevel.Info, message);
+        }
+
+        /// <summary>
+        /// 打印警告级别日志，建议在发生局部功能逻辑错误，但尚不会导致游戏崩溃或异常时使用。
+        /// </summary>
+        /// <param name="message">日志内容。</param>
+        public static void Warning(string message)
+        {
+            if (s_LogHelper == null)
+            {
+                return;
+            }
+
+            s_LogHelper.Log(GameFrameworkLogLevel.Warning, message);
+        }
+
+
+
+
+
+
+        /// <summary>
+        /// 打印错误级别日志，建议在发生功能逻辑错误，但尚不会导致游戏崩溃或异常时使用。
+        /// </summary>
+        /// <param name="message">日志内容。</param>
+        public static void Error(object message)
+        {
+            if (s_LogHelper == null)
+            {
+                return;
+            }
+
+            s_LogHelper.Log(GameFrameworkLogLevel.Error, message);
+        }
+        /// <summary>
+        /// 打印错误级别日志，建议在发生功能逻辑错误，但尚不会导致游戏崩溃或异常时使用。
+        /// </summary>
+        /// <param name="message">日志内容。</param>
+        public static void Error(string message)
+        {
+            if (s_LogHelper == null)
+            {
+                return;
+            }
+
+            s_LogHelper.Log(GameFrameworkLogLevel.Error, message);
+        }
+
+
+
+
+
+
+
+        /// <summary>
+        /// 打印严重错误级别日志，建议在发生严重错误，可能导致游戏崩溃或异常时使用，此时应尝试重启进程或重建游戏框架。
+        /// </summary>
+        /// <param name="message">日志内容。</param>
+        public static void Fatal(object message)
+        {
+            if (s_LogHelper == null)
+            {
+                return;
+            }
+
+            s_LogHelper.Log(GameFrameworkLogLevel.Fatal, message);
+        }
+
+        /// <summary>
+        /// 打印严重错误级别日志，建议在发生严重错误，可能导致游戏崩溃或异常时使用，此时应尝试重启进程或重建游戏框架。
+        /// </summary>
+        /// <param name="message">日志内容。</param>
+        public static void Fatal(string message)
+        {
+            if (s_LogHelper == null)
+            {
+                return;
+            }
+
+            s_LogHelper.Log(GameFrameworkLogLevel.Fatal, message);
+        }
+
+    }
+}

Assets/DemoGame/GameScript/Hotfix/GFLog/GameFrameworkLog.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 50be90d24e7e7e44c8bed52815de32e1
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

Assets/DemoGame/GameScript/Hotfix/GFLog/GameFrameworkLogLevel.cs

@@ -0,0 +1,36 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace ZFramework
+{
+    public enum GameFrameworkLogLevel : byte
+    {
+        /// <summary>
+        /// 调试。
+        /// </summary>
+        Debug = 0,
+
+        /// <summary>
+        /// 信息。
+        /// </summary>
+        Info,
+
+        /// <summary>
+        /// 警告。
+        /// </summary>
+        Warning,
+
+        /// <summary>
+        /// 错误。
+        /// </summary>
+        Error,
+
+        /// <summary>
+        /// 严重错误。
+        /// </summary>
+        Fatal
+    }
+}

Assets/DemoGame/GameScript/Hotfix/GFLog/GameFrameworkLogLevel.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: dac4ce4d055272846a55b555e1d66530
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

Assets/DemoGame/GameScript/Hotfix/GFLog/ILogHelper.cs

@@ -0,0 +1,24 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace ZFramework
+{
+    public static partial class GameFrameworkLog
+    {
+        /// <summary>
+        /// 框架日志辅助器接口。
+        /// </summary>
+        public interface ILogHelper
+        {
+            /// <summary>
+            /// 记录日志。
+            /// </summary>
+            /// <param name="level">游戏框架日志等级。</param>
+            /// <param name="message">日志内容。</param>
+            void Log(GameFrameworkLogLevel level, object message);
+        }
+    }
+}

Assets/DemoGame/GameScript/Hotfix/GFLog/ILogHelper.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 973fffb170e74df418838cc2b5543f25
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

Assets/DemoGame/GameScript/Hotfix/GFLog/Log.cs

@@ -0,0 +1,174 @@
+using System;
+using System.Diagnostics;
+
+namespace ZFramework.Runtime
+{
+    public static class Log
+    {
+        /// <summary>
+        /// 打印调试级别日志，用于记录调试类日志信息。
+        /// </summary>
+        /// <param name="message">日志内容。</param>
+        /// <remarks>仅在带有 ENABLE_LOG、ENABLE_DEBUG_LOG 或 ENABLE_DEBUG_AND_ABOVE_LOG 预编译选项时生效。</remarks>
+        [Conditional("ENABLE_LOG")]
+        [Conditional("ENABLE_DEBUG_LOG")]
+        [Conditional("ENABLE_DEBUG_AND_ABOVE_LOG")]
+        public static void Debug(object message)
+        {
+            GameFrameworkLog.Debug(message);
+        }
+
+        /// <summary>
+        /// 打印调试级别日志，用于记录调试类日志信息。
+        /// </summary>
+        /// <param name="message">日志内容。</param>
+        /// <remarks>仅在带有 ENABLE_LOG、ENABLE_DEBUG_LOG 或 ENABLE_DEBUG_AND_ABOVE_LOG 预编译选项时生效。</remarks>
+        [Conditional("ENABLE_LOG")]
+        [Conditional("ENABLE_DEBUG_LOG")]
+        [Conditional("ENABLE_DEBUG_AND_ABOVE_LOG")]
+        public static void Debug(string message)
+        {
+            GameFrameworkLog.Debug(message);
+        }
+
+
+
+
+
+        /// <summary>
+        /// 打印信息级别日志，用于记录程序正常运行日志信息。
+        /// </summary>
+        /// <param name="message">日志内容。</param>
+        /// <remarks>仅在带有 ENABLE_LOG、ENABLE_INFO_LOG、ENABLE_DEBUG_AND_ABOVE_LOG 或 ENABLE_INFO_AND_ABOVE_LOG 预编译选项时生效。</remarks>
+        [Conditional("ENABLE_LOG")]
+        [Conditional("ENABLE_INFO_LOG")]
+        [Conditional("ENABLE_DEBUG_AND_ABOVE_LOG")]
+        [Conditional("ENABLE_INFO_AND_ABOVE_LOG")]
+        public static void Info(object message)
+        {
+            GameFrameworkLog.Info(message);
+        }
+
+        /// <summary>
+        /// 打印信息级别日志，用于记录程序正常运行日志信息。
+        /// </summary>
+        /// <param name="message">日志内容。</param>
+        /// <remarks>仅在带有 ENABLE_LOG、ENABLE_INFO_LOG、ENABLE_DEBUG_AND_ABOVE_LOG 或 ENABLE_INFO_AND_ABOVE_LOG 预编译选项时生效。</remarks>
+        [Conditional("ENABLE_LOG")]
+        [Conditional("ENABLE_INFO_LOG")]
+        [Conditional("ENABLE_DEBUG_AND_ABOVE_LOG")]
+        [Conditional("ENABLE_INFO_AND_ABOVE_LOG")]
+        public static void Info(string message)
+        {
+            GameFrameworkLog.Info(message);
+        }
+
+
+
+
+
+        /// <summary>
+        /// 打印警告级别日志，建议在发生局部功能逻辑错误，但尚不会导致游戏崩溃或异常时使用。
+        /// </summary>
+        /// <param name="message">日志内容。</param>
+        /// <remarks>仅在带有 ENABLE_LOG、ENABLE_WARNING_LOG、ENABLE_DEBUG_AND_ABOVE_LOG、ENABLE_INFO_AND_ABOVE_LOG 或 ENABLE_WARNING_AND_ABOVE_LOG 预编译选项时生效。</remarks>
+        [Conditional("ENABLE_LOG")]
+        [Conditional("ENABLE_WARNING_LOG")]
+        [Conditional("ENABLE_DEBUG_AND_ABOVE_LOG")]
+        [Conditional("ENABLE_INFO_AND_ABOVE_LOG")]
+        [Conditional("ENABLE_WARNING_AND_ABOVE_LOG")]
+        public static void Warning(object message)
+        {
+            GameFrameworkLog.Warning(message);
+        }
+
+        /// <summary>
+        /// 打印警告级别日志，建议在发生局部功能逻辑错误，但尚不会导致游戏崩溃或异常时使用。
+        /// </summary>
+        /// <param name="message">日志内容。</param>
+        /// <remarks>仅在带有 ENABLE_LOG、ENABLE_WARNING_LOG、ENABLE_DEBUG_AND_ABOVE_LOG、ENABLE_INFO_AND_ABOVE_LOG 或 ENABLE_WARNING_AND_ABOVE_LOG 预编译选项时生效。</remarks>
+        [Conditional("ENABLE_LOG")]
+        [Conditional("ENABLE_WARNING_LOG")]
+        [Conditional("ENABLE_DEBUG_AND_ABOVE_LOG")]
+        [Conditional("ENABLE_INFO_AND_ABOVE_LOG")]
+        [Conditional("ENABLE_WARNING_AND_ABOVE_LOG")]
+        public static void Warning(string message)
+        {
+            GameFrameworkLog.Warning(message);
+        }
+
+
+
+
+
+        /// <summary>
+        /// 打印错误级别日志，建议在发生功能逻辑错误，但尚不会导致游戏崩溃或异常时使用。
+        /// </summary>
+        /// <param name="message">日志内容。</param>
+        /// <remarks>仅在带有 ENABLE_LOG、ENABLE_ERROR_LOG、ENABLE_DEBUG_AND_ABOVE_LOG、ENABLE_INFO_AND_ABOVE_LOG、ENABLE_WARNING_AND_ABOVE_LOG 或 ENABLE_ERROR_AND_ABOVE_LOG 预编译选项时生效。</remarks>
+        [Conditional("ENABLE_LOG")]
+        [Conditional("ENABLE_ERROR_LOG")]
+        [Conditional("ENABLE_DEBUG_AND_ABOVE_LOG")]
+        [Conditional("ENABLE_INFO_AND_ABOVE_LOG")]
+        [Conditional("ENABLE_WARNING_AND_ABOVE_LOG")]
+        [Conditional("ENABLE_ERROR_AND_ABOVE_LOG")]
+        public static void Error(object message)
+        {
+            GameFrameworkLog.Error(message);
+        }
+
+        /// <summary>
+        /// 打印错误级别日志，建议在发生功能逻辑错误，但尚不会导致游戏崩溃或异常时使用。
+        /// </summary>
+        /// <param name="message">日志内容。</param>
+        /// <remarks>仅在带有 ENABLE_LOG、ENABLE_ERROR_LOG、ENABLE_DEBUG_AND_ABOVE_LOG、ENABLE_INFO_AND_ABOVE_LOG、ENABLE_WARNING_AND_ABOVE_LOG 或 ENABLE_ERROR_AND_ABOVE_LOG 预编译选项时生效。</remarks>
+        [Conditional("ENABLE_LOG")]
+        [Conditional("ENABLE_ERROR_LOG")]
+        [Conditional("ENABLE_DEBUG_AND_ABOVE_LOG")]
+        [Conditional("ENABLE_INFO_AND_ABOVE_LOG")]
+        [Conditional("ENABLE_WARNING_AND_ABOVE_LOG")]
+        [Conditional("ENABLE_ERROR_AND_ABOVE_LOG")]
+        public static void Error(string message)
+        {
+            GameFrameworkLog.Error(message);
+        }
+
+
+
+
+
+        /// <summary>
+        /// 打印严重错误级别日志，建议在发生严重错误，可能导致游戏崩溃或异常时使用，此时应尝试重启进程或重建游戏框架。
+        /// </summary>
+        /// <param name="message">日志内容。</param>
+        /// <remarks>仅在带有 ENABLE_LOG、ENABLE_FATAL_LOG、ENABLE_DEBUG_AND_ABOVE_LOG、ENABLE_INFO_AND_ABOVE_LOG、ENABLE_WARNING_AND_ABOVE_LOG、ENABLE_ERROR_AND_ABOVE_LOG 或 ENABLE_FATAL_AND_ABOVE_LOG 预编译选项时生效。</remarks>
+        [Conditional("ENABLE_LOG")]
+        [Conditional("ENABLE_FATAL_LOG")]
+        [Conditional("ENABLE_DEBUG_AND_ABOVE_LOG")]
+        [Conditional("ENABLE_INFO_AND_ABOVE_LOG")]
+        [Conditional("ENABLE_WARNING_AND_ABOVE_LOG")]
+        [Conditional("ENABLE_ERROR_AND_ABOVE_LOG")]
+        [Conditional("ENABLE_FATAL_AND_ABOVE_LOG")]
+        public static void Fatal(object message)
+        {
+            GameFrameworkLog.Fatal(message);
+        }
+
+        /// <summary>
+        /// 打印严重错误级别日志，建议在发生严重错误，可能导致游戏崩溃或异常时使用，此时应尝试重启进程或重建游戏框架。
+        /// </summary>
+        /// <param name="message">日志内容。</param>
+        /// <remarks>仅在带有 ENABLE_LOG、ENABLE_FATAL_LOG、ENABLE_DEBUG_AND_ABOVE_LOG、ENABLE_INFO_AND_ABOVE_LOG、ENABLE_WARNING_AND_ABOVE_LOG、ENABLE_ERROR_AND_ABOVE_LOG 或 ENABLE_FATAL_AND_ABOVE_LOG 预编译选项时生效。</remarks>
+        [Conditional("ENABLE_LOG")]
+        [Conditional("ENABLE_FATAL_LOG")]
+        [Conditional("ENABLE_DEBUG_AND_ABOVE_LOG")]
+        [Conditional("ENABLE_INFO_AND_ABOVE_LOG")]
+        [Conditional("ENABLE_WARNING_AND_ABOVE_LOG")]
+        [Conditional("ENABLE_ERROR_AND_ABOVE_LOG")]
+        [Conditional("ENABLE_FATAL_AND_ABOVE_LOG")]
+        public static void Fatal(string message)
+        {
+            GameFrameworkLog.Fatal(message);
+        }
+    }
+}

Assets/DemoGame/GameScript/Hotfix/GFLog/Log.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: fc22ee3dac7343c4b930dd13598d98de
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: