PPLogger 0.1.0

PPLogger 0.1.0

测试已测试
语言语言 Obj-CObjective C
许可证 MIT
发布上次发布2014年12月

未指名的维护。



PPLogger 0.1.0

  • Peter Wong

一个从URL异步加载图片的UIImageView子类,顶部有活动指示器。

安装

手工

只需将/PPLogger目录下的所有类复制到您的项目中,然后添加以下导入项

#inport "PPLogger.h"

设置和用法

导入

您可能想在AppName-Prefix.pch中添加导入语句,以便PPLogger宏PPLogPPLog...对所有类可用。

此外,如果您已经使用了很多NSLog,并且不想更改,您可以在导入PPLogger.h之前定义PPLOGGER_SWIZZLE_NSLOG常量。

#define PPLOGGER_SWIZZLE_NSLOG
import "PPLogger.h"

配置

PPLogPPLog...宏都使用[PPLogger sharedInstance]的实例方法。您可以在应用委托(或日志之前的地方)配置共享实例。

[PPLogger sharedInstance]通过其configuration属性提供了一套默认配置。它应该适合默认使用,即

  • 开发中(使用了DEBUG常量)
    • PPLog记录到DEBUG严重性级别。
    • 显示的最小严重性是DEBUG级别。
    • PPLog以详细级别记录。
  • 除了开发之外(没有DEBUG常量,例如Release)
    • PPLog记录到DEBUG严重性级别。
    • 显示的最小严重性是INFO级别。(这意味着PPLog消息不会被记录)
    • PPLog以plain级别记录。

如果您使用其他方式确定环境(例如Develop、Staging和Production),您可以根据需要配置配置

PPLoggerConfiguration *configuration = [[PPLogger sharedInstance] configuration];
[configuration setDefaultSeverity:PPLoggerSeverityDebug];
#ifdef DEVELOP
    [configuration setMinimumSeverity:PPLoggerSeverityDebug];
    [configuration setDefaultVerbosity:PPLoggerVerbosityDetailed];
#endif
#ifdef STAGING
    [configuration setMinimumSeverity:PPLoggerSeverityInfo];
    [configuration setDefaultVerbosity:PPLoggerVerbosityDetailed];
#endif
#ifdef PRODUCTION
    [configuration setMinimumSeverity:PPLoggerSeverityInfo];
    [configuration setDefaultVerbosity:PPLoggerVerbosityPlain];
#endif

使用

不建议向用户展示所有日志。因为可能存在一些敏感数据不应该被记录,或者太多细节是用户不需要知道的。

因此,PPLog宏默认配置记录到DEBUG级别,当发布时会被忽略。

因此,您可以使用PPLog(或者如果定义了PPLOGGER_SWIZZLE_NSLOG常量,则是NSLog)来为开发目的记录调试信息。

然而,有时您真的想在生产发布中留下一些日志。例如,一些操作失败的原因,或在开发过程中不可预期的事情。

在这种情况下,您可以使用宏PPLogDebugPPLogInfoPPLogWarnPPLogErrorPPLogFatal,以明确地将日志记录到所需级别。

所有这些宏使用PPLoggerVerbosityUNSET,这将以配置的调试详细程度表示。

还有一个宏PPLogBase,是以上所有宏的基础方法。您可以显式设置严重性和详细程度。然而,上面的宏已经足够用了,在大多数情况下您不需要使用这个宏(实际上也不建议使用PPLogBase)。

贡献

  • 进行分叉,更新并发送拉取请求。
  • 问题处留下任何评论、改进、建议、想法等。

许可证

PPLogger在MIT许可证下提供。

The MIT License (MIT)

Copyright (c) 2014 Peter Wong

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.