Webtrekk Tracking Library
Webtrekk SDK 允许您跟踪应用的用户活动、屏幕流向和媒体使用情况。所有数据都会发送到 Webtrekk 跟踪系统进行进一步分析。
需求
平台 | 版本 |
---|---|
iOS |
8.0+ |
tvOS |
9.0+ |
watchOS |
2.0+ |
低于或等于4.0.1版本的Xcode 7.3+和Swift 2.2
从4.1.0版本开始,Xcode 8.0+和Swift 3.0
从4.5.1版本开始,Xcode 8.3+和Swift 3.1
从4.7.0版本开始,可以使用Xcode 9.0 beta6包含和编译库。
从4.8.0版本开始,Xcode 9.0+和Swift 4.0
从4.11.0版本开始,Xcode 9.3+和Swift 4.1
从4.12.1版本开始,Xcode 10+和Swift 4.2(使用旧构建系统
)
从4.13.2版本开始,Xcode 10.2+和Swift 4.2(使用旧构建系统
)
从4.14.0版本开始,Xcode 10.2+和Swift 5(使用新构建系统
)
Cocoapod Swift 4.2 问题 (小于 4.14.0)
当您无法使用 Cocoapods 进行 lint 时,使用
pod spec lint --allow-warnings
对于构建使用旧版构建系统(< 4.14.0)
- 文件
- 项目/工作区设置
- 共享工作区设置
- 构建系统 ->
旧版构建系统
- 构建系统 ->
- 共享工作区设置
- 项目/工作区设置
在 Swift 4.2 的新 API 中有一些警告,所有这些都将仍然工作。这只是警告,我们将在新的 Swift 版本发布时努力让它们消失。
从版本 4.2.0 开始支持 tvOS,但以下有一些限制:不支持屏幕分辨率和自动网络状态跟踪。
从版本 4.3.0 开始支持 watchOS,以下有一些限制
- 不支持屏幕分辨率和自动网络状态跟踪。
- 不支持深度链接和活动支持。
从版本 4.6.0 开始支持 Carthage。
安装
CocoaPods(《Podfile》)
pod 'Webtrekk'
Carthage(《Cartfile》)
github "Webtrekk/webtrekk-ios-sdk"
SwiftLint
我们使用来自Realm的Swiftlint对我的代码进行lint。SwiftLint需要在您的设备上安装。更多信息可以在SwiftLint上找到。此项目的特定设置详细信息可在.swiftlint.yml
文件中找到。
Travis CI
我们使用Travis CI来检查代码的不一致性并运行lint和测试。关于此项目的特定设置的详细信息,您可以在.travis.yml
文件中找到。
从Webtrekk SDK V3迁移
Webtrekk SDK V4提供将一些存储信息迁移到新SDK的可能性。此选项默认启用,但如果需要忽略并删除旧数据,需要在创建第一个跟踪器之前将migratesFromLibraryV3
变量的值设置为false
。下面的代码片段展示了这种情况。
WebtrekkTracking.migratesFromLibraryV3 = false
以下属性包括在迁移中。
选项 | 说明 |
---|---|
everId |
为用户生成的以前构建的everId |
appVersion |
之前存储的appVersion,用于检测应用程序更新 |
optedOut |
之前存储的状态。如果之前未设置,则进行迁移 |
samplingState |
之前存储的samplingState |
unsentRequests |
之前保存的未发送请求 |
SSL
从iOS 9开始,苹果公司更加严格地执行网络连接中使用SSL的规定。Webtrekk强烈建议并提供了支持SSL的服务器URL的使用。如果需要规避这一规定,应用程序需要在Info.plist
中添加异常条目。苹果公司关于这一规定的文档可以在iOS开发者库中找到。
具有功能的示例应用程序
有关此 SDK 中功能示例应用程序,请参阅: https://github.com/Webtrekk/iOS-SDK-Example-App
许可协议
见许可协议文件(MIT)以了解许可权和限制。