SwiftLog 1.0.0

SwiftLog 1.0.0

测试已测试
语言语言 SwiftSwift
许可证 Apache 2
发布最新发布2018年3月
SwiftSwift版本4.0
SPM支持SPM

Dalton Cherry 维护。



SwiftLog 1.0.0

Swift 中简单易用的记录日志。

特点

  • 非常简单。只有一个方法可以记录。
  • 卷动日志。
  • 简洁的代码库,仅约 200 行 LOC。

首先需要导入框架。请参阅安装说明,了解如何将框架添加到您的项目中。

//iOS
import SwiftLog
//OS X
import SwiftLogOSX

示例

SwiftLog 可以直接使用,无需配置,只需调用记录函数。

logw("write to the log!")

这将创建一个在 macOS 和 iOS 上的正确目录中的日志文件。

macOS 日志文件将在 macOS 日志目录中创建(位于:/Library/Logs)。iOS 日志文件将在您的应用的文档目录中创建一个名为 Logs 的文件夹中。

配置

SwiftLog 中有一些可配置的选项。

//This writes to the log
logw("write to the log!")

//Set the name of the log files
Log.logger.name = "test" //default is "logwile"

//Set the max size of each log file. Value is in KB
Log.logger.maxFileSize = 2048 //default is 1024

//Set the max number of logs files that will be kept
Log.logger.name = 8 //default is 4

//Set the directory in which the logs files will be written
Log.logger.directory = "/Library/somefolder" //default is the standard logging directory for each platform.

安装

更新 Cocoapod

您可以使用以下方式验证 SwiftLog.podspec

pod spec lint SwiftLog.podspec

在发布前,应在示例项目中测试。可以通过向 Podfile 中添加以下行来完成此操作

pod 'SwiftLog', :git => 'https://github.com/username/SwiftLog.git'

然后运行

pod install

如果一切顺利,即可发布。首先,创建一个标签并推送。

git tag 'version'
git push --tags

标签可用后,您可以将库发送到 Specs 仓库。为此,您需要遵循在 Trunk 中设置中的说明。

pod trunk push SwiftLog.podspec

Rogue

首先查阅 安装文档,了解如何安装 Rogue。

要安装 SwiftLog,在创建了 rogue 文件的目录中运行以下命令。

rogue add https://github.com/daltoniam/SwiftLog

接下来,打开 libs 文件夹,并将 SwiftLog.xcodeproj 添加到您的 Xcode 项目中。完成此操作后,在您的 "Build Phases" 中将 SwiftLog.framework 添加到 "Link Binary with Libraries" 阶段。确保将 libs 文件夹添加到您的 .gitignore 文件中。

其他

只需获取框架(通过 git submodule 或其他包管理器)。

SwiftLog.xcodeproj 添加到您的 Xcode 项目中。完成后,在“构建阶段”,将 SwiftLog.framework 添加到“链接二进制库”阶段。

添加复制框架阶段

如果您在运行 OS X 应用或物理 iOS 设备上运行此代码,确保将 SwiftLog.frameworkSwiftLogOSX.framework 添加到您的应用包中。为此,在 Xcode 中,通过单击蓝色项目图标打开目标配置窗口,然后选择侧边栏中的“目标”部分下的应用目标。在该窗口顶部的标签栏中,打开“构建阶段”面板。展开“链接二进制库”组,并根据您是在构建 iOS 或 OS X 应用添加 SwiftLog.frameworkSwiftLogOSX.framework。单击面板左上角的加号按钮并选择“新建复制文件阶段”。将此新阶段重命名为“复制框架”,将“目标”设置为“框架”,并分别添加 SwiftLog.frameworkSwiftLogOSX.framework

待办事项

  • [ ] 完成文档
  • [ ] 添加单元测试

许可证

SwiftLog 在 MIT 许可下发布。

联系方式

Dalton Cherry