SimpleLogger 1.2

SimpleLogger 1.2

×

测试已测试✓
语言语言 Obj-CObjective C
许可证 MIT
发布上次发布2017年9月

由 Bill Burgess 维护。

SimpleLogger 1.2

  • 由
  • Bill Burgess

SimpleLogger 是一个简单的用于 iOS 的日志文件生成器，可用于上传到 Amazon S3。

CircleCI

要求

SimpleLogger 支持 iOS 8+ 并需要 ARC 来构建。它依赖于以下 Apple 框架，这些框架应已包含在 Xcode 中

  • Foundation.framework
  • AWSS3

将 SimpleLogger 添加到您的项目

源文件

您可以直接将 SimpleLogger 文件夹的内容添加到您的项目中。它包含 SimpleLogger.h/m，以及用于日期辅助的一个类别和一个默认值的头文件。您需要链接到 Amazon 提供的 AWSS3 框架才能使其正常工作。CocoaPods 会自动包含它。

使用说明

本地日志记录

如果您只想将文件本地输出，可以直接使用日志事件方法

[SimpleLogger addLogEvent:@"Log some event to today's file."];

这将创建一个文件，使用默认的日期/时间格式在文档目录中使用当前的日期。
[2017-8-14 10:10:10] 将某些事件记录到今天的文件中。

高级设置

您可以自定义许多日志格式和设置

// number of days of log files are retained by the logger (default 7)
[[SimpleLogger sharedLogger] setRetentionDays:7];

// log event formatter date format
[[[SimpleLogger sharedLogger] logFormatter] setDateFormat:@"yyyy-MM-dd HH:mm:ss"];

// file name date format
// be sure to set this one before writing your first log event to avoid duplicate files for same day
[[SimpleLogger sharedLogger] setFilenameFormatter:yourDateFormatter];

// filename extension
[[SimpleLogger sharedLogger] setFilenameExtension:@"log"];

// folder location inside your AWSS3 bucket
[[SimpleLogger sharedLogger] setFolderLocation:@"Your/Folder/Location"];

上传日志到 Amazon

您需要使用正确的 Amazon AWS S3 凭据和存储桶初始化 SimpleLogger 来上传您的日志文件。如果计划上传，请尽早调用初始化器，以便 Amazon 库可以初始化并准备好上传。我们建议在 AppDelegate 中的应用程序启动时调用。

[SimpleLogger initWithAWSRegion:AWSRegionUSEast1 bucket:@"my-bucket-name" accessToken:@"MYAMAZONACCESSTOKEN" secret:@"MYAMAZONSECRET"];

尽管可以手动设置变量，但您不应该这样做。请使用初始化器方法验证您的值并将它们传递给 AWSS3，以避免应用程序崩溃。

iOS 9 用户需要支持 App Transport Security (ATS)。为防止上传失败，请将以下键添加到您的 Info.plist 中。

<key>NSAppTransportSecurity</key>
    <dict>
            <key>NSExceptionDomains</key>
            <dict>
            <key>amazonaws.com</key>
            <dict>
                    <key>NSThirdPartyExceptionMinimumTLSVersion</key>
                    <string>TLSv1.0</string>
                    <key>NSThirdPartyExceptionRequiresForwardSecrecy</key>
                    <false/>
                    <key>NSIncludesSubdomains</key>
                    <true/>
            </dict>
            <key>amazonaws.com.cn</key>
            <dict>
                    <key>NSThirdPartyExceptionMinimumTLSVersion</key>
                    <string>TLSv1.0</string>
                    <key>NSThirdPartyExceptionRequiresForwardSecrecy</key>
                    <false/>
                    <key>NSIncludesSubdomains</key>
                    <true/>
            </dict>
            </dict>
    </dict>

许可证

此代码在 MIT 许可证 的条款和条件下分发。

作者

此库是由 Bill Burgess 编写的，他是 Simply Made Apps 的联合创始人及 iOS/Mac 开发者。

Android

您可以在 SimpleLogger-Android 中找到 Android 伴侣库。