一种简单快捷的方式将消息记录到您的 iPhone 或 iPad 应用程序上的磁盘。
将 QuickELogger 添加到您的项目中
CocoaPods
CocoaPods 是将 QuickELogger 添加到您的项目的推荐方式。
- 将 QuickELogger 添加到您的 Podfile 中
pod 'QuickELogger'
。 - 通过运行
pod install
命令安装 pod(s)。 - 通过
import QuickELogger
将 QuickELogger 添加到您的文件中。
从GitHub克隆
- 从GitHub克隆仓库并将文件直接复制,或者将其添加为git子模块。
- 将源目录下的所有文件添加到您的项目中。
如何操作
- Swift -> 创建一个
QuickELogger
实例,然后只需调用log(:message:type)
即可。 - Objective-C -> 创建一个
QuickELoggerObjC
实例,然后调用logWithMessage:type:
- 此记录仪具有以下(相当标准的)日志类型:
verbose, info, debug, warn, error
。
注意:默认情况下,文件保存在 /Library/Application Support/QuickELogger/
目录中,文件名为 QuickELogger.json
。
其他配置选项
可以使用 init(filename:)
初始化器根据喜好自定义文件名。
可以使用 init(directory:)
初始化器自定义目录结构,以适应以下标准iOS目录
/Documents
/tmp
/Library
/Library/Caches
/Library/Application Support
。此外,除了能够指定不同的系统目录外,您还可以使用 Directory
枚举中的可选路径在该系统目录内指定路径。
您还可以使用 init(filename:directory:)
初始化器来自定义它们。
示例用法
Swift
import QuickELogger
let logger = QuickELogger()
logger(message: "Pinto beans > Black beans", type: .info)
Objective-C
@import QuickELogger;
QuickELoggerObjC *logger = [[QuickELoggerObjC alloc] init];
[logger logWithMessage:@"Pinto beans > Black beans" type:ObjCLogTypeInfo];
在 /Library/Application Support/QuickELogger/QuickELogger.json
发生的事情:
[
{
"timeStamp" : "2019-10-27T02:32:57Z",
"id" : "41593EA2-9D4D-4406-839B-2298AD7FA2E3",
"message" : "Pinto beans > Black beans",
"type" : "info"
}
]
其他信息
注意事项
此日志记录器不是以传统方式向日志文件中追加内容。它先从当前日志(如果存在)中读取,然后用更新后的日志覆盖该日志。这个框架是出于必要而创建的,为了轻松地将日志写入磁盘,无需加载庞大的日志框架,并且不应用于超重日志。
正在评估使其更“适用于企业”的计划。
优点
本库包含了可以在您的应用程序中使用的协议,针对喜爱测试软件的您。这允许您将应用程序编程到这个“接口”,然后可以使用您的自己的虚假实现进行单元测试
public protocol QuickELoggerProtocol {
func log(message: String, type: LogType)
}
测试
该项目已设置使用fastlane运行规格。
在项目目录中运行以下命令安装必要的gem包和Cocoapods
$ bundle
$ bundle exec pod install
使用fastlane在命令行中运行所有规格
$ bundle exec fastlane run_all_specs
版本历史
版本历史可在发布页面找到。
建议、请求和反馈
感谢您查看QuickELogger以满足您的日志记录需求。任何反馈都可以发送至:[email protected]。