手把手教你使用CocoaAsyncSocket在iOS上搭建so

前言

一般iOS开发对TCP连接了解不多，平时项目用不到的话，也不会去研究。突然有这方面的需求后，会觉得无从下手。今天我就讲解一下怎么使用CocoaAsyncSocket框架来搭建socket连接的客户端。

CocoaAsyncSocket框架是方便iOS开发者在开发时建立TCP/UDP连接的框架，在github有将近10k的star。一般开发时都会用这个框架。

我已经写了 SocketClientDemo上传到github上了。本文中的代码也来自这个demo，star不重要，开心最重要。哈哈。

客户端创建好之后，就可以与服务器端进行连接。这里的服务器端可以是同样用CocoaAsyncSocket创建的（点我查看服务器端配置），也可以是同一局域网内的智能硬件。

安装CocoaAsyncSocket

CocoaAsyncSocket在github上已经介绍了安装方法，Objective-C和Swift都可以使用。我使用的是CocoaPods的方式。（不会用CocoaPods?点我查看使用方法）

初始化

1. 引入框架
   import CocoaAsyncSocket
2. 定义客户端socket成员变量
   var clientSocket: GCDAsyncSocket! // 客户端socket
3. 初始化clientSocket
   在viewDidLoad方法中进行初始化工作
   clientSocket = GCDAsyncSocket(delegate: self, delegateQueue: DispatchQueue.main)

开始连接

在获得服务器端的IP地址和端口号后，即可开始建立连接。（IP地址和端口号是让用户在界面上输入的，详细例子可查看我写的demo）

func startConnect(){
        
    view.endEditing(true)
        
    do {
        try clientSocket.connect(toHost: addressTF.text!, onPort: UInt16(portF.text!)!, withTimeout: -1)
        showMessage("连接成功")
    } catch {
        showMessage("连接失败")
    }
}

断开连接

断开连接时，调用disconnect方法。代码如下：

func stopConnect() {
        
    clientSocket.disconnect()
    showMessage("断开连接")
}

发消息

连接成功后，即可给服务器发送消息。示例代码如下：

func sendMessage() {
        
    view.endEditing(true)
        
    let data = messageTF.text?.data(using: .utf8)
        
    // timeout -1: 无穷大，一直等
    // tag: 消息标记
    clientSocket.write(data!, withTimeout: -1, tag: 0)
}

回调-连接成功

与服务器连接成功之后，可以在连接成功的回调方法中获得服务器的相关信息。示例代码如下：

func socket(_ sock: GCDAsyncSocket, didConnectToHost host: String, port: UInt16) {
        
    showMessage("连接成功")
        
    let address = "服务器IP：" + "\(host)"
        
    showMessage(address)
        
    clientSocket.readData(withTimeout: -1, tag: 0)
}

回调-接收到消息

接收到服务器发来的消息后，可以在接收消息的回调方法中进行处理。示例代码如下：

// 接收到消息
func socket(_ sock: GCDAsyncSocket, didRead data: Data, withTag tag: Int) {
            
    let text = String(data: data, encoding: .utf8)
            
    showMessage(text!)
            
    clientSocket.readData(withTimeout: -1, tag: 0)
}

回调-断开连接

当服务器断开了与客户端的连接，可以在断开连接的回调方法中进行处理。示例代码如下：

func socketDidDisconnect(_ sock: GCDAsyncSocket, withError err: Error?) {
        
    showMessage("已断开连接-----")
}

效果

可运行demo查看效果。