TSwiftCentrifuge 0.7.1

TSwiftCentrifuge 0.7.1

Shalom Aviv 维护。



  • 编者
  • Shalom Aviv

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'

Swift 包管理器

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

手动

克隆仓库,并将 Sources 文件夹中的文件拖放到您的 Xcode 项目中。

依赖项

此库依赖于 SwiftProtobuf

要求

  • iOS 12.0
  • Xcode 13.0

入门

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

后台使用

当移动应用进入后台时,对已建立的持久连接存在 OS 特定的限制 - 可能在短时间内被静默关闭。因此,在这种情况下,在应用移动到后台时通常需要从服务器断开连接,然后在应用回到前台时重新连接。

使用 URLSessionWebSocketTask

查看客户端的 useNativeWebSocket 选项,该选项允许使用 URLSessionWebSocketTask 而不是我们分支的 Starscream v3。如果成功设置了 centrifuge-swiftURLSessionWebSocketTask,请报告 - 我们最终将其设为默认。

许可

SwiftCentrifuge 在 MIT 许可证下可用。有关详细信息,请参阅 LICENSE。

发布(用于维护人员)

SwiftCentrifuge.podspec 中升级版本

推送到 master 并创建新版本标签。

然后运行

pod trunk push SwiftCentrifuge.podspec