Socket.IO-Client-Swift 从 v15 升级到 v16 完全指南

原创于 2025-06-08 09:04:16 发布

· 231 阅读

8 ·

版权

Socket.IO-Client-Swift 从 v15 升级到 v16 完全指南

socket.io-client-swift 项目地址: https://gitcode.com/gh_mirrors/so/socket.io-client-swift

前言

Socket.IO-Client-Swift 是一个用于 iOS/macOS 等平台的 Socket.IO 客户端库。在版本 16 中，该库进行了一些重大变更，本文将详细介绍这些变更内容以及如何平滑地进行版本升级。

重大变更概述

1. 放弃 Objective-C 支持

从 v16 开始，该库完全转向 Swift 语言生态，不再支持 Objective-C 项目。这意味着：

纯 Objective-C 项目将无法直接使用 v16 及以上版本
混合项目需要确保所有相关代码已迁移到 Swift
Swift 项目可以享受更纯粹的 Swift 实现带来的性能优化

2. 多版本 Socket.IO 服务器支持

v16 客户端新增了对 Socket.IO 3.x/4.x 服务器的支持，同时保持对 2.x 服务器的兼容性。这一变化带来了以下特性：

默认情况下客户端会尝试使用最新协议版本连接
如果需要连接旧版服务器（2.x），需要显式指定协议版本

详细升级步骤

1. 服务器端准备

首先需要将 Socket.IO 服务器升级到 v4 并启用兼容模式：

const io = require("socket.io")({
  allowEIO3: true // 启用 v3 协议兼容模式
});

2. 客户端升级

在 Swift 项目中更新 Socket.IO-Client-Swift 到 v16 版本后，根据服务器版本进行相应配置：

连接 Socket.IO 2.x 服务器

let manager = SocketManager(
    socketURL: URL(string: "http://localhost:8087/")!, 
    config: [.version(.two)]
)
let socket = manager.defaultSocket

连接 Socket.IO 3.x/4.x 服务器

let manager = SocketManager(
    socketURL: URL(string: "http://localhost:8087/")!, 
    config: [.version(.three)] // 或省略，因为默认就是 .three
)
let socket = manager.defaultSocket

3. 最终迁移

当所有客户端都升级到 v16 后，可以安全地关闭服务器端的兼容模式：

const io = require("socket.io")({
  allowEIO3: false // 禁用 v3 协议兼容模式
});

协议版本检测

服务器端可以检测客户端使用的协议版本：

io.on("connection", (socket) => {
  const version = socket.conn.protocol;
  // version 可能的值：
  // 3 - 使用 Socket.IO v2 协议
  // 4 - 使用 Socket.IO v3/v4 协议
});