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 将 SwiftCentrifuge 集成到您的 Xcode 项目中,请在您的 Podfile
中指定它
pod 'SwiftCentrifuge'
SwiftCentrifuge 与 SPM 兼容。如果您收到关于缺少 pc 文件的警告,您可能需要安装 pkg-config
。在 macOS 上,可以使用 brew install pkg-config
实现。
克隆仓库,并将 Sources
文件夹中的文件拖放到您的 Xcode 项目中。
此库依赖于 SwiftProtobuf
- iOS 12.0
- Xcode 13.0
包含了一个 示例应用程序,展示基本客户端功能。
当移动应用进入后台时,对已建立的持久连接存在 OS 特定的限制 - 可能在短时间内被静默关闭。因此,在这种情况下,在应用移动到后台时通常需要从服务器断开连接,然后在应用回到前台时重新连接。
查看客户端的 useNativeWebSocket
选项,该选项允许使用 URLSessionWebSocketTask
而不是我们分支的 Starscream v3。如果成功设置了 centrifuge-swift
与 URLSessionWebSocketTask
,请报告 - 我们最终将其设为默认。
SwiftCentrifuge 在 MIT 许可证下可用。有关详细信息,请参阅 LICENSE。
在 SwiftCentrifuge.podspec
中升级版本
推送到 master 并创建新版本标签。
然后运行
pod trunk push SwiftCentrifuge.podspec