CATLog

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

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

2.Install KZLinkedConsole by Alcatraz

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

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

新特性

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

效果

Requirements

iOS6或以上

特性

CATLog 使用简单:

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

CATLog 功能强大:

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

将CATLog加入工程

使用Pod

pod 'CATLog'

使用源码

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

使用说明

1.先通过Alcatraz安装Xcodecolors

2.再安装 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

添加基本工程