SkedGo 的 iOS 版 TripKit
有关文档可在 TripGo 开发者页面 上找到
组件
- Tri Kit (iOS、iOS 扩展、macOS):A-to-B 路线、航点路线、实时更新、交通数据等核心功能的库。
- TripKitUI (iOS):用于在地图上显示旅程以及 TripGo 风格的表格单元格的 UI 元素。
- TripKitBookings (iOS):用户帐户和在应用程序内预订功能。
- TripKitAddOns/InterApp (iOS):用于深度链接到其他应用程序的帮助程序,例如 FlitWays、GoCatch、Ingogo、Lyft、Ola 和 Uber。
- TripKitAddOns/Share (iOS、iOS 扩展、macOS):用于创建可分享的链接到旅程、服务、交通站点和会面位置的帮助程序,这些链接将在 TripGo 的网络应用程序中打开。
安装
Cocoapods (建议)
添加所需的pods
pod 'TripKit', '~> 3.0'
pod 'TripKitUI', '~> 3.0'
pod 'TripKitBookings', '~> 3.0'
pod 'TripKitAddOns/InterApp', '~> 3.0'
pod 'TripKitAddOns/Share', '~> 3.0'
这是一个推荐的方法,因为它允许您挑选所需的组件。如果您使用了TripKit的依赖项,例如 RxSwift,您将只得到该组件的一个副本。
Carthage
通过Carthage也可以获取到包含全部组件的TripKit。注意这表示目前只支持iOS。
将以下内容添加到您的 Cartfile
github "skedgo/tripkit-ios" "v3.0"
然后运行 carthage update
,并按照Carthage文档中描述的方式将框架添加到项目中。
手动
- 将文件拖入您的项目。
- 添加依赖项(详见 TripKit.podspec)
- 将
-DTK_NO_MODULE
添加到目标项目的其他 C 编译器标志
和其他 Swift 编译器标志
- 将
TK_NO_MODULE=1
添加到目标项目的预处理器宏
如果遇到任何问题,请参阅 项目 下的示例。
设置
- 在您的应用代理中,提供您的API密钥并启动一个新会话
func applicationDidFinishLaunching(_ aNotification: Notification) {
TripKit.apiKey = "MY_API_KEY"
TripKit.prepareForNewSession()
// ...
}
- 默认情况下,对SkedGo服务器的调用的标识符将跟踪来自单个安装的会话调用。这种行为是 默认关闭的。您可以通过将
TripKit.allowTracking
设置来重写此行为。