Skip to content

An iOS log system,contains many excellent features,based on Xcodecolors and KZLinkedConsole.

License

Notifications You must be signed in to change notification settings

CatchZeng/CATLog

Repository files navigation

CATLog

Pod Version

An iOS log system,contains many excellent features,based on Xcodecolors and KZLinkedConsole.

New Feature

  • Add log review and email the log files in the App

  • Add mac client to help you debug without the data line.(mac client called CATLogServer.zip is included in the project file)

  • Add custom background color for log

中文请下翻

Effect

effect

alllog

preview

email

Requirements

This library requires a deployment target of iOS 6.0 or greater.

Features

CATLog is Simple:

It takes as little as a single line of code to configure CATLog when your application launches.Then replace your NSLog statements with CLog[X] statements and that's about it.

CATLog is Powerful:

  • Log level
  • Log file
  • Log crash
  • Auto delete old log file
  • Custom log macro easily
  • Colorizing debugger console output
  • Clickable links in your Xcode console, so you never wonder which class logged the message.
  • Remote log to mac client (debug without the data line)
  • Log review and email the log files

Adding CATLog to your project

Pod

pod 'CATLog'

Source files

Alternatively you can directly add the CATLog.h& CATLog.m source files to your project.

Usage

1.Install Xcodecolors by Alcatraz

Xcodecolors

KZLinkedConsole

3.Code

Init log && Set exceptionHandler
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    //Set ExceptionHandler
    NSSetUncaughtExceptionHandler(&uncaughtExceptionHandler);
    //Init log
	[CATLog initWithNumberOfDaysToDelete:3];
}

void uncaughtExceptionHandler(NSException *exception){
   [CATLog logCrash:exception];
}
Set log level
[CATLog setLogLevel:CATLevelE];
If you do not like default log color,you can set color for each level.
[CATLog setR:200 G:200 B:200 forLevel:CATLevelE];
If you do not like use CLog,you can custom log macro you need.
#define YouLogI(fmt, ...) [CATLog logI:[NSString stringWithFormat:@"[%@:%d] %s %@",[NSString stringWithFormat:@"%s",__FILE__].lastPathComponent,__LINE__,__func__,fmt],##__VA_ARGS__,@""];
YouLogI(@"ReDefine Log by yourself");
Show Log review
[CATLog shwoAllLogFile];
[CATLog showTodayLogFile];

Change Log

V1.1.0

1.Fix numberOfDaysToDelete bug

2.Add log review and email the log files in the App

V1.0.2

1.Fix pod bug

2.Add mac client

V1.0.0

Add project


CATLog

Pod Version

一个基于XcodecolorsKZLinkedConsole,拥有许多优良特性的iOS开源日志工具。

新特性

  • 增加日志的预览和邮件发送日志功能
  • 增加mac客户端,让你可以无需连接数据线调试。(mac客户端在本工程的CATLogServer.zip文件中)
  • 增加自定义log输出背景颜色功能

效果

effect

alllog

preview

email

Requirements

iOS6或以上

特性

CATLog 使用简单:

只需加入几行代码就可配置完毕。然后将NSLog换成CLog[X] 就可以了。

CATLog 功能强大:

  • 支持设置日志级别
  • 支持日志输出到文件
  • 支持日志记录Crash信息
  • 自动删除旧的日志文件
  • 方便地自定义日志宏
  • 支持颜色打印日志
  • 支持点击日志信息跳转到代码中,方便定位错误信息。
  • 远程输出到mac客户端(无需连接数据线调试)
  • 日志的预览和邮件发送日志功能

将CATLog加入工程

使用Pod

pod 'CATLog'

使用源码

直接拖拽 CATLog.h& CATLog.m 到工程中即可。

使用说明

1.先通过Alcatraz安装Xcodecolors

Xcodecolors

2.再安装 KZLinkedConsole

KZLinkedConsole

3.编码

初始化 && 设置异常捕获
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    //Set ExceptionHandler
    NSSetUncaughtExceptionHandler(&uncaughtExceptionHandler);
    //Init log
	[CATLog initWithNumberOfDaysToDelete:3];
}

void uncaughtExceptionHandler(NSException *exception){
   [CATLog logCrash:exception];
}
设置日志级别
[CATLog setLogLevel:CATLevelE];
设置删除几天前的日志文件
[CATLog setNumberOfDaysToDelete:3];
如果不喜欢默认的日志输出颜色,可以为每个级别设置自定义的颜色
[CATLog setR:200 G:200 B:200 forLevel:CATLevelE];
如果不喜欢用CLog作为日志宏,可以自定义
#define YouLogI(fmt, ...) [CATLog logI:[NSString stringWithFormat:@"[%@:%d] %s %@",[NSString stringWithFormat:@"%s",__FILE__].lastPathComponent,__LINE__,__func__,fmt],##__VA_ARGS__,@""];               
YouLogI(@"ReDefine Log by yourself");
显示log预览界面
[CATLog shwoAllLogFile];
[CATLog showTodayLogFile];

版本信息

V1.1.0

1.修复了设置删除日志文件天数的bug

2.增加日志的预览和邮件发送日志功能

V1.0.2

1.修复pod问题

2.增加mac客户端

V1.0.0

添加基本工程

About

An iOS log system,contains many excellent features,based on Xcodecolors and KZLinkedConsole.

Resources

License

Stars

Watchers

Forks

Packages

No packages published