提供人们喜欢接受的自定义自动通信。
Customer.io iOS SDK
这是iOS官方的Customer.io SDK。
您可以在https://customer.io/docs/sdk/ios找到我们的完整SDK文档。此README仅包含帮助您安装和初始化SDK的基本信息。
SDK已在iOS设备上进行了测试。它可能在其他Apple设备(macOS、tvOS和watchOS)上工作,但未经官方测试,也不提供官方支持。
正在使用我们SDK的1.0版本吗?
建议升级到使用iOS SDK 2.0版本。查看我们的迁移文档了解如何更新您的应用程序。
摘要
要开始,您需要在项目中安装并初始化相关的SDK软件包。
我们已将 SDK 分解成多个包,以最小化对您的应用大小的冲击。您只需安装您项目所需包即可。
包 | 是否必需? | 描述 |
---|---|---|
跟踪 | 是 | 识别人/设备并发送事件(触发活动、跟踪指标等)。 |
消息推送:APN | 否 | 使用 Apple 的推送通知服务 (APNs) 的 推送和丰富推送通知。 |
消息推送:FCM | 否 | 使用 Firebase Cloud Messaging (FCM) 的 推送和丰富推送通知。 |
提示:请查看我们的示例 iOS 应用,Remote Habits,了解使用我们 SDK 的实际应用场景。
安装 SDK
按照 Apple 的说明,将 https://github.com/customerio/customerio-ios.git
添加为您项目中 Xcode 的依赖,并选择您想要安装的个别 包产品。
我们建议您将 依赖规则 设置为 至下一个主要版本。虽然我们鼓励您使用最新 SDK 保持应用更新,但主要版本可能包含需要您注意的破坏性更改或新功能。
初始化 SDK
在使用 Customer.io SDK 之前,您需要将其初始化。初始化 SDK 之前对 SDK 的任何调用都将被忽略。
要开始,在 AppDelegate
中的 application(_ application: didFinishLaunchingWithOptions)
函数初始化 SDK
import CioTracking
class AppDelegate: NSObject, UIApplicationDelegate {
func application(
_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil
) -> Bool {
CustomerIO.initialize(siteId: "YOUR SITE ID", apiKey: "YOUR API KEY", region: Region.EU) { config in
// optionally, configure the SDK for your app's needs
}
return true
}
}
然后,当您想使用 SDK 的任何功能时,使用该类的共享实例
CustomerIO.shared.track(...)
MessagingPush.shared.application(...)
更多信息
请参阅我们完整的SDK文档,链接为:https://customer.io/docs/sdk/ios/
贡献
感谢您对我们项目的兴趣!我们欢迎您的贡献。请查看我们的开发说明以设置您的环境并开始贡献。
注意:我们珍视本项目的一个开放、欢迎、多元、包容和健康的社区。我们期望所有贡献者都遵循我们的行为准则。