
Trekker
一个包装器,可以轻松地切换不同的分析服务或同时支持多个分析服务。Trekker 与基于事件的跟踪分析服务,如 Mixpanel、Amplitude、Firebase、Crashlytics 的 Answers 等一起工作时效果最佳。
简介
你好,我们是 Awkward。我们为 iOS 的 Reddit 客户端 Beam 使用了很多不同的分析服务。我们并不确定想使用哪个服务,所以我们希望能够轻松地实现它们,并能够在服务之间快速切换。于是,Trekker 诞生了。我们欢迎您在自己的项目中使用 Trekker。
功能
- 事件跟踪
- 配置文件跟踪
- 定时事件跟踪(有持续时间的跟踪)
- 事件超级属性
- 推送通知注册
入门
作为子模块
- 将 Trekker 添加为 git 项目中的子模块
- 将
Trekker.xcodeproj
拖动到项目导航器中 - 转到项目设置并选择你想添加 Trekker 的目标设置
- 在“嵌入式二进制文件”下点击加号并选择Trekker项目中的
Trekker
框架 - 按照以下步骤添加分析服务(
TrekkerService
)
手动操作
- 将Trekker目录下的所有Swift文件复制到您的导航器中的项目
- 按照以下步骤添加分析服务(
TrekkerService
)
添加TrekkerService
TrekkerService是为输入到Trekker的每个分析服务实现的协议。
添加Trekker很简单。首先将分析服务的框架添加到您的应用程序中。对于某些服务,有一些现成的实现,请参阅示例服务文件夹。
如果该服务没有现成的实现,应该制作一个新的NSObject子类。它应该实现TrekkerService协议。这需要实现以下属性
var serviceName: String // The name of the analytics service
var versionString: String // The version of the SDK of the analytics service
现在您可以实现以下协议,以支持分析服务支持的功能
TrekkerEventAnalytics
用于简单的事件基础分析TrekkerTimedEventAnalytics
用于时间事件分析,这些事件通常有一个额外的duration
属性TrekkerPushNotificationAnalytics
用于允许发送推送通知消息的服务TrekkerUserProfileAnalytics
用于支持用户配置文件的服务TrekkerEventSuperPropertiesAnalytics
用于支持超属性的服务。每个事件都包含这些属性
文档
我们正在努力保持文档的最新性。在这里您可以找到有关Trekker的更多信息。
许可证
Trekker遵照MIT许可证提供。有关更多信息,请参阅LICENSE文件。