SwiftCentrifuge

用于 Centrifugo 服务器和 Centrifuge 库的 Websocket 客户端。

此库尚未发布 v1 版本 - API 仍在演变。目前，补丁版本更新仅包含向后兼容更改，次要版本更新可能包含向后不兼容的 API 更改。

查看 客户端 SDK API 规范 以了解此 SDK 的工作方式。建议在开始使用此 SDK 之前阅读该规范，因为它涵盖了常见的 SDK 行为 - 描述客户端和订阅状态转换、主要选项和方法。还可以查看示例文件夹。

此 SDK 实现的功能可以在 SDK 功能矩阵 中找到。

最新的 centrifuge-swift 兼容 Centrifugo 服务器 v5 和 v4 以及 Centrifuge >= 0.25.0。对于 Centrifugo v2、Centrifugo v3 以及 Centrifuge < 0.25.0，您应使用 centrifuge-swift v0.4.6。

安装

有几种方便的方法。

CocoaPods

要使用 CocoaPods 将 SwiftCentrifuge 集成到您的 Xcode 项目中，请在 Podfile 中指定它

pod 'SwiftCentrifuge'

Carthage

在您的 Cartfile 中添加 github "centrifugal/centrifuge-swift" 行。然后运行 carthage update。

Swift Package Manager

SwiftCentrifuge 与 SPM 完全兼容。如果您收到关于缺少 pc 文件的警告，您可能需要安装 pkg-config。在 macOS 上，可以通过 brew install pkg-config 来实现。

手动

克隆存储库并将文件从 Sources 文件夹拖放到您的 Xcode 项目中。

依赖项

此库依赖于 SwiftProtobuf

软件要求

• iOS 12.0
• Xcode 13.0

入门指南

包括了一个展示基本客户端功能的 示例应用程序。

后台使用情况

当移动应用程序进入后台时，对已建立的持久连接存在操作系统特定的限制 - 这些连接可能会被静默关闭。因此，在大多数情况下，当应用程序移动到后台时，您需要从服务器断开连接，并在应用程序返回前台时再次连接。

许可证

SwiftCentrifuge遵循MIT许可证。请参阅LICENSE获取详细信息。

发布（维护者使用）

在SwiftCentrifuge.podspec中提升版本。

将代码推送到master分支并创建新版本标签。

然后运行

pod trunk push SwiftCentrifuge.podspec