CustomerIOMessagingPush 3.3.3

CustomerIOMessagingPush 3.3.3

CustomerIO Engineering维护。



  • CustomerIO团队

提供人们喜欢接受的自定义自动通信。

min swift version is 5.3 min ios version is 13 Contributor Covenant codecov

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 保持应用更新,但主要版本可能包含需要您注意的破坏性更改或新功能。

in XCode select up to next major version when installing the 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/

贡献

感谢您对我们项目的兴趣!我们欢迎您的贡献。请查看我们的开发说明以设置您的环境并开始贡献。

注意:我们珍视本项目的一个开放、欢迎、多元、包容和健康的社区。我们期望所有贡献者都遵循我们的行为准则

许可证

MIT