LibComponentLogging-LogFile 1.2.2

LibComponentLogging-LogFile 1.2.2

×

测试已测试✗
语言语言 Obj-CObjective C
许可证 MIT
发布日期最后发布2014年12月

Maintained by Arne Harren.

LibComponentLogging-LogFile 1.2.2

  • By
  • Arne Harren

http://0xc0.de/LibComponentLogging
http://github.com/aharren/LibComponentLogging-LogFile

概述

LibComponentLogging-LogFile 是一个 Objective-C (Mac OS X 和 iPhone OS) 的文件日志类，它将日志消息写入一个特定于应用程序的日志文件。

当需要向日志文件写入第一个日志消息时，会自动打开应用程序的日志文件。如果日志文件达到配置的最大大小，则它会被轮换，并将所有之前的消息移动到备份日志文件中。备份日志文件会保留到下一次轮换。

该日志类可以用作 LibComponentLogging 的日志后端，但也可以作为不包含 LibComponentLogging 核心文件的自独立日志器使用。

LogFile 日志器使用以下格式

<date> <time> <pid>:<tid> <level> <component>:<file>:<line>:<function> <message>

其中文件名、行号和函数名是可选的。

示例

2009-02-01 12:38:32.796 4964:10b D component1:main.m:28:-[Class method] Message
2009-02-01 12:38:32.798 4964:10b D component2:main.m:32:-[Class method] Message
2009-02-01 12:38:32.799 4964:10b D component3:main.m:36:-[Class method] Message

用法

在开始之前，将 LCLLogFile.h 和 .m 文件复制到您的项目中，并创建一个 LCLLogFileConfig.h 配置文件（基于包装的模板文件）。配置文件定义了日志文件的名称、最大日志文件大小、是否在启动时将新的日志消息附加到现有的日志文件，以及更多。

然后，将 LCLLogFile.h 导入到您的源文件中或在前缀头文件中，如果您使用 LCLLogFile 作为独立日志类，或者将导入添加到您的 lcl_config_logger.h 文件中，如果您将该类用作 LibComponentLogging 的日志后端。

如果您在使用 LibComponentLogging 中的 LCLLogFile 类，您可以通过使用来自 LibComponentLogging 的标准日志宏简单地开始向日志文件记录，例如：

lcl_log(lcl_cMyComponent, lcl_vError, @"message ...");

如果您将该类作为独立日志器使用，您可以简单地调用 LCLLogFile 类中的一个 log... 方法，例如：

[LCLLogFile logWithIdentifier:"MyComponent" level:1 ... format:@"message ...", ...];

或者，您可以将这些调用封装到您自己的日志宏中。

在这两种情况下，日志文件都将为您自动打开。

存储库分支

Git 存储库包含以下分支

  • master: 包含标记有版本号的稳定构建的主日志代码的 master 分支。

  • devel: devel 分支是日志代码的开发分支，其中包含一个带依赖于其他代码的 Xcode 项目，例如 LibComponentLogging 的核心文件，以及单元测试。这个分支中的代码并不稳定。

相关仓库

以下 Git 仓库与此仓库相关

版权和许可

版权所有 (c) 2008-2013 Arne Harren [email protected]

兹允许任何获得此软件及其相关文档文件的副本（以下简称“软件”）的人，在不受限制的情况下处理该软件，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或出售软件副本，并允许获得软件的人进行此类操作，但前提是遵守以下条件

上述版权声明和本许可声明应包含在所有副本或软件主要部分的副本中。

软件按“现状”提供，不提供任何明示或暗示的保证，包括但不限于适销性、适用于特定目的和侵犯专利权。在任何事件中，作者或版权持有人不对任何索赔、损害或其他责任负责，无论是在合同、侵权或其他法律行为，无论源于、产生于或与该软件或对该软件的使用或其他操作有关。