AZDebugUtil 0.1.1

AZDebugUtil 0.1.1

测试已测试
Lang语言 Obj-CObjective C
许可 MIT
Released最后发布2015年9月

Albert ZhangAlbert Zhang维护。



  • 作者
  • Albert Zhang

AZDebugUtil 是一款用于 iOS 开发的调试日志到控制台/UI/文件的工具。使用 NSLog 的替代品,可以很容易地通过预处理器管理日志语句。您还可以轻松地将日志保存到文件中。

使用方法

要运行示例项目,克隆仓库,首先从 Example 目录运行 pod install

AZDebugUtil 通过 CocoaPods 提供。要安装它,只需在 Podfile 中添加以下行

pod "AZDebugUtil"
  • 在 prefix header 文件中添加 #import "Debug.h"。如果不存在,可以创建一个,然后更新 Build Settings > Apple LLVM - Language > Prefix Header 中的设置
  • Debug.h 将预编译定义复制到 prefix header 文件中,并根据需要取消注释它们
  • UIApplicationDelegateapplication:didFinishLaunchingWithOptions: 中调用 [DebugLogView sharedView] 以初始化日志 UI,如果需要在 UI 上查看日志
  • 然后您可以使用 DebugLogDebugLogErrorFileLogger 等等

示例

DebugLog(@"we got here: %d", theId);
DebugLogWarning(@"the name is nil for people: %@", people.uid);
DebugLogError(@"should never get here");

[FileLogger log:@"we got %d peoples here", peoples.count];

[DebugTip show:@"Hello!"];

[UIAlertView showWithTitle:@"Hi" message:@"show the value?" onDismiss:
    ^(UIAlertView *alertView, NSInteger buttonIndex) {
        if(buttonIndex != alertView.cancelButtonIndex){
            [self showDebugValue];
        }
    } cancelButtonTitle:@"No" otherButtonTitles:@"Yes", nil];

Debug.h 中的特殊预处理器

  • DEBUG_LOG_ENABLED 日志功能的总开关。评论掉将关闭所有日志。当构建发布版本时,您可以这样做。
  • DEBUG_LOG_TO_CONSOLE 评论掉将关闭将日志输出到控制台。
  • DEBUG_LOG_TO_UI 评论掉将关闭将日志输出到 UI(DebugLogView)。请注意,出于性能考虑,DebugLogView 默认是禁用的。当您开启它时,窗口上会有一个小按钮 "[D]",点击它将打开视图。在视图中有一个开关来启用日志。
  • DEBUG_LOG_EW_TO_FILE 自动将错误和警告日志输出到日志文件。日志文件存储在应用的数据目录中,命名为 log_001.txt

在发布之前,应取消定义(或简单地评论)上述所有预处理器。