react-native-fxview 1.0.2-beta3 → 1.0.2-beta4

package/logger/FXLogger.ts

@@ -0,0 +1,281 @@
+// ========== Logger 类型定义 ==========
+
+/**
+ * 日志级别枚举
+ */
+export enum FXLogLevel {
+  DEBUG = 0, // 调试级别（最详细）
+  INFO = 1, // 信息级别
+  WARN = 2, // 警告级别
+  ERROR = 3, // 错误级别
+  SILENT = 4, // 静默模式（不输出任何日志）
+}
+
+/**
+ * Logger 配置接口
+ */
+export interface FXLoggerConfig {
+  debug: boolean; // 是否启用调试模式
+  level: FXLogLevel; // 日志级别
+  showTimestamp: boolean; // 是否显示时间戳
+  showTags: boolean; // 是否显示标签
+  prefix: string; // 日志前缀
+}
+
+/**
+ * FX Logger - 专为 React Native 项目设计的调试日志系统
+ * 提供丰富的日志功能和灵活的配置选项
+ */
+export class FXLogger {
+  private static instance: FXLogger;
+  private config: FXLoggerConfig;
+
+  /**
+   * 私有构造函数，实现单例模式
+   */
+  private constructor() {
+    // 自动检测环境
+    const isDevelopment = this.isDevelopmentEnvironment();
+
+    // 根据环境设置默认配置
+    this.config = {
+      debug: isDevelopment, // 开发环境启用调试模式，生产环境禁用
+      level: isDevelopment ? FXLogLevel.DEBUG : FXLogLevel.ERROR, // 生产环境只显示错误日志
+      showTimestamp: true,
+      showTags: true,
+      prefix: isDevelopment ? "[FX-DEV]" : "[FX-PROD]", // 不同环境使用不同前缀
+    };
+  }
+
+  /**
+   * 获取单例实例
+   */
+  public static getInstance(): FXLogger {
+    if (!FXLogger.instance) {
+      FXLogger.instance = new FXLogger();
+    }
+    return FXLogger.instance;
+  }
+
+  /**
+   * 检测当前是否为开发环境
+   */
+  private isDevelopmentEnvironment(): boolean {
+    try {
+      // 使用 Function 构造函数来安全地访问全局变量，避免 TypeScript 错误
+      const getGlobal = new Function("return this")();
+
+      // 检测 React Native 的 __DEV__ 变量
+      if (typeof getGlobal.__DEV__ !== "undefined" && getGlobal.__DEV__) {
+        return true;
+      }
+
+      // 检测 Node.js 环境变量
+      if (
+        typeof getGlobal.process !== "undefined" &&
+        getGlobal.process.env &&
+        getGlobal.process.env.NODE_ENV === "development"
+      ) {
+        return true;
+      }
+
+      // 检测 window 对象（浏览器环境）
+      if (typeof getGlobal.window !== "undefined" && getGlobal.window.__DEV__) {
+        return true;
+      }
+
+      // 检测全局对象属性
+      if (getGlobal.NODE_ENV === "development") {
+        return true;
+      }
+    } catch (error) {
+      // 如果检测过程中出错，默认返回 false（生产环境）
+      this.error("FXLogger", "Environment detection failed", error);
+    }
+
+    // 默认返回 false（生产环境）
+    return false;
+  }
+
+  /**
+   * 获取当前配置
+   */
+  public getConfig(): FXLoggerConfig {
+    return { ...this.config };
+  }
+
+  /**
+   * 配置 Logger
+   */
+  public configure(config: Partial<FXLoggerConfig>): void {
+    this.config = { ...this.config, ...config };
+  }
+
+  /**
+   * 启用调试模式
+   */
+  public enableDebug(): void {
+    this.config.debug = true;
+  }
+
+  /**
+   * 禁用调试模式
+   */
+  public disableDebug(): void {
+    this.config.debug = false;
+  }
+
+  /**
+   * 获取时间戳（包含年月日）
+   */
+  private getTimestamp(): string {
+    const now = new Date();
+    const year = now.getFullYear();
+    const month = (now.getMonth() + 1).toString().padStart(2, "0");
+    const day = now.getDate().toString().padStart(2, "0");
+    const hours = now.getHours().toString().padStart(2, "0");
+    const minutes = now.getMinutes().toString().padStart(2, "0");
+    const seconds = now.getSeconds().toString().padStart(2, "0");
+    const milliseconds = now.getMilliseconds().toString().padStart(3, "0");
+    return `${year}-${month}-${day} ${hours}:${minutes}:${seconds}.${milliseconds}`;
+  }
+
+  /**
+   * 检查是否应该记录日志
+   */
+  private shouldLog(level: FXLogLevel): boolean {
+    if (!this.config.debug && level < FXLogLevel.ERROR) {
+      return false;
+    }
+    return level >= this.config.level;
+  }
+
+  /**
+   * 获取日志级别的颜色符号
+   */
+  private getLevelColor(level: FXLogLevel): string {
+    switch (level) {
+      case FXLogLevel.DEBUG:
+        return "🔵"; // 蓝色 - 调试
+      case FXLogLevel.INFO:
+        return "🟢"; // 绿色 - 信息
+      case FXLogLevel.WARN:
+        return "🟡"; // 黄色 - 警告
+      case FXLogLevel.ERROR:
+        return "🔴"; // 红色 - 错误
+      default:
+        return "⚪"; // 默认白色
+    }
+  }
+
+  /**
+   * 格式化日志消息
+   */
+  private formatMessage(level: string, tag: string, message: string): string {
+    const parts: string[] = [];
+
+    if (this.config.prefix) {
+      parts.push(this.config.prefix);
+    }
+
+    if (this.config.showTimestamp) {
+      parts.push(`[${this.getTimestamp()}]`);
+    }
+
+    // 根据日志级别添加颜色符号
+    const levelEnum =
+      FXLogLevel[level.toUpperCase() as keyof typeof FXLogLevel];
+    const colorSymbol = this.getLevelColor(levelEnum);
+    parts.push(`[${colorSymbol}${level.toUpperCase()}]`);
+
+    if (this.config.showTags && tag) {
+      parts.push(`[${tag}]`);
+    }
+
+    return parts.join("") + " " + message;
+  }
+
+  /**
+   * 调试日志
+   */
+  debug(tag: string, message: string, ...args: any[]): void {
+    if (!this.shouldLog(FXLogLevel.DEBUG)) return;
+
+    const formattedMessage = this.formatMessage("debug", tag, message);
+    console.log(formattedMessage, ...args);
+  }
+
+  /**
+   * 信息日志
+   */
+  info(tag: string, message: string, ...args: any[]): void {
+    if (!this.shouldLog(FXLogLevel.INFO)) return;
+
+    const formattedMessage = this.formatMessage("info", tag, message);
+    console.info(formattedMessage, ...args);
+  }
+
+  /**
+   * 警告日志
+   */
+  warn(tag: string, message: string, ...args: any[]): void {
+    if (!this.shouldLog(FXLogLevel.WARN)) return;
+
+    const formattedMessage = this.formatMessage("warn", tag, message);
+    console.warn(formattedMessage, ...args);
+  }
+
+  /**
+   * 错误日志
+   */
+  error(tag: string, message: string, ...args: any[]): void {
+    if (!this.shouldLog(FXLogLevel.ERROR)) return;
+
+    const formattedMessage = this.formatMessage("error", tag, message);
+    console.error(formattedMessage, ...args);
+  }
+
+  /**
+   * 分组日志
+   */
+  group(tag: string, label?: string): void {
+    if (!this.shouldLog(FXLogLevel.DEBUG)) return;
+
+    const groupLabel = label ? `[${tag}] ${label}` : `[${tag}] Group`;
+    console.group(groupLabel);
+  }
+
+  /**
+   * 结束分组日志
+   */
+  groupEnd(): void {
+    if (!this.shouldLog(FXLogLevel.DEBUG)) return;
+
+    console.groupEnd();
+  }
+
+  /**
+   * 表格日志
+   */
+  table(tag: string, data: any): void {
+    if (!this.shouldLog(FXLogLevel.DEBUG)) return;
+
+    console.log(`[${tag}] Table data:`);
+    console.table(data);
+  }
+
+  /**
+   * 追踪日志
+   */
+  trace(tag: string, message: string): void {
+    if (!this.shouldLog(FXLogLevel.DEBUG)) return;
+
+    console.trace(`[${tag}] ${message}`);
+  }
+}
+
+// 创建全局实例
+const logger = FXLogger.getInstance();
+
+// 导出默认实例
+export default logger;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-fxview",
-  "version": "1.0.2-beta3",
+  "version": "1.0.2-beta4",
   "description": "A dynamic view component for React Native that allows runtime UI updates and component management",
   "main": "index.ts",
   "types": "index.d.ts",
@@ -12,6 +12,10 @@
     "queue/**/*.js",
     "queue/**/*.ts",
     "queue/**/*.d.ts",
+    "logger/**/*.js",
+    "logger/**/*.ts",
+    "logger/**/*.d.ts",
+    "logger/**/*.md",
     "README.md",
     "LICENSE"
   ],