提交

QXLive/Manager/QXLogger.h

@@ -0,0 +1,114 @@
+//
+//  QXLogger.h
+//  QXLive
+//
+//  Created by 启星 on 2025/12/18.
+//
+
+#import <Foundation/Foundation.h>
+
+
+NS_ASSUME_NONNULL_BEGIN
+typedef NS_ENUM(NSUInteger, QXLogLevel) {
+    QXLogLevelVerbose = 0,
+    QXLogLevelDebug,
+    QXLogLevelInfo,
+    QXLogLevelWarning,
+    QXLogLevelError,
+    QXLogLevelFatal,
+};
+
+typedef NS_OPTIONS(NSUInteger, QXLogTarget) {
+    QXLogTargetConsole   = 1 << 0,
+    QXLogTargetFile      = 1 << 1,
+    QXLogTargetNetwork   = 1 << 2,
+    QXLogTargetAll       = 0xFF
+};
+
+/**
+ 日志配置
+ */
+@interface QXLogConfig : NSObject
+
+
+
++ (instancetype)sharedConfig;
+
+@property (nonatomic, assign) QXLogLevel minLogLevel;
+@property (nonatomic, assign) QXLogTarget logTarget;
+@property (nonatomic, assign) NSUInteger maxLogFileSize;
+@property (nonatomic, assign) NSUInteger maxLogFileCount;
+@property (nonatomic, assign) NSUInteger logSaveDays;
+@property (nonatomic, assign) BOOL enableNetworkUpload;
+@property (nonatomic, copy, nullable) NSString *uploadURL;
+@property (nonatomic, assign) BOOL enableConsoleColor;
+@property (nonatomic, assign) BOOL addDateToFile;
+@property (nonatomic, copy, nullable) NSString *logPrefix;
+@property (nonatomic, assign) BOOL enableAsync;
+@property (nonatomic, assign) BOOL encryptLogFile;
+
+@end
+
+/**
+ 日志工具类
+ */
+@interface QXLogger : NSObject
+
++ (instancetype)new NS_UNAVAILABLE;
+- (instancetype)init NS_UNAVAILABLE;
+
+#pragma mark - 配置
++ (QXLogConfig *)config;
++ (void)updateConfig:(void (^)(QXLogConfig *config))block;
+
+#pragma mark - 基础日志方法
++ (void)verbose:(NSString *)format, ... NS_FORMAT_FUNCTION(1, 2);
++ (void)verboseWithTag:(NSString *)tag format:(NSString *)format, ... NS_FORMAT_FUNCTION(2, 3);
++ (void)debug:(NSString *)format, ... NS_FORMAT_FUNCTION(1, 2);
++ (void)debugWithTag:(NSString *)tag format:(NSString *)format, ... NS_FORMAT_FUNCTION(2, 3);
++ (void)info:(NSString *)format, ... NS_FORMAT_FUNCTION(1, 2);
++ (void)infoWithTag:(NSString *)tag format:(NSString *)format, ... NS_FORMAT_FUNCTION(2, 3);
++ (void)warning:(NSString *)format, ... NS_FORMAT_FUNCTION(1, 2);
++ (void)warningWithTag:(NSString *)tag format:(NSString *)format, ... NS_FORMAT_FUNCTION(2, 3);
++ (void)error:(NSString *)format, ... NS_FORMAT_FUNCTION(1, 2);
++ (void)errorWithTag:(NSString *)tag format:(NSString *)format, ... NS_FORMAT_FUNCTION(2, 3);
++ (void)fatal:(NSString *)format, ... NS_FORMAT_FUNCTION(1, 2);
++ (void)fatalWithTag:(NSString *)tag format:(NSString *)format, ... NS_FORMAT_FUNCTION(2, 3);
+
+#pragma mark - 特殊日志方法
++ (void)network:(NSString *)method url:(NSString *)url params:(nullable id)params response:(nullable id)response error:(nullable NSError *)error;
++ (void)performance:(NSString *)tag startTime:(CFAbsoluteTime)startTime;
++ (void)userAction:(NSString *)action params:(nullable NSDictionary *)params;
++ (void)crash:(NSException *)exception;
++ (void)memoryWarning;
+
+#pragma mark - 文件操作
++ (NSArray<NSString *> *)getAllLogFilePaths;
++ (nullable NSString *)getLatestLogFilePath;
++ (nullable NSString *)getLogContentFromFile:(NSString *)filePath;
++ (void)cleanExpiredLogs;
++ (void)cleanAllLogFiles;
+
+#pragma mark - 文件大小管理
++ (unsigned long long)getCurrentLogFileSize;
++ (CGFloat)getCurrentLogFileSizeMB;
++ (CGFloat)getTotalLogSizeMB;
++ (NSDictionary *)getLogFileInfo:(NSString *)filePath;
++ (NSArray<NSDictionary *> *)getAllLogFileInfos;
++ (void)checkFileSizeManually;
+
+#pragma mark - 网络上报
++ (void)uploadLogsWithCompletion:(void (^)(BOOL success, NSError * _Nullable error))completion;
++ (void)setUploadHandler:(void (^)(NSArray<NSString *> *logFilePaths, void (^complete)(BOOL success)))handler;
+
+#pragma mark - 调试工具
++ (void)enable:(BOOL)enabled;
++ (BOOL)isEnabled;
++ (void)addCustomLogHandler:(void (^)(QXLogLevel level, NSString *tag, NSString *message))handler;
+
+#pragma mark - 初始化
++ (void)setupLogger;
+
+@end
+
+NS_ASSUME_NONNULL_END