Swift documentation

[markstreich]

As someone new to iOS development and Swift, I could really use more Swift guidance and/or links to example code in the Readme.md

For example:

• How do I add this to my project?

[vasarhelyia]

@markstreich check out my project using SIOSocket with Swift: https://github.com/brewfactory/BrewMobile

[markstreich]

Thanks @vasarhelyia! I got it working using BrewFactory as an example.

I'll suggest some documentation below based on what I learned.

Adding SIOSocket to a Swift project using CocoaPods

• Close your project in Xcode
• Create a file named Podfile in your project folder with the following contents (replacing the two instances of "AppName" with your actual project name)

source 'https://github.com/CocoaPods/Specs.git'
link_with ['AppName', 'AppNameTests']
pod 'SIOSocket', '~> 0.2.0'

• Open terminal and navigate to your project folder (where you just created the Podfile)
• Install CocoaPods if you don't have it - sudo gem install cocoapods
• Add SIOSocket to your project - pod setup && pod install
• Open the AppName.xcworkspace in Xcode (from now on, always open this instead of the AppName.xcodeproj)
• Add a "Header File" named AppName-Bridging-Header.h in your project folder with the following contents:

#import <SIOSocket/SIOSocket.h>

• Go to Project Settings -> Build Settings. Enable "All" to view all settings, look for the "Swift Compiler - Code Generation" section, add the value AppName-Bridging-Header.h to the "Objective-C Bridging Header" setting

Sample Swift Code

This assumes you have the Socket.io Chat Example Server running on your local machine. It will create a socket.io connection with SIOSocket, login, and emit a message.

In the browser you will see:

Output in Xcode should look something like this:

File contents for: ViewController.swift

import UIKit

let host = "http://localhost:3000/"
let username = "swiftbot"
let message = "Hello World"

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()

        self.connectToHost()
    }

    override func didReceiveMemoryWarning() {
        super.didReceiveMemoryWarning()
        // Dispose of any resources that can be recreated.
    }

    private func connectToHost() {
        SIOSocket.socketWithHost(host, reconnectAutomatically: true, attemptLimit: 0, withDelay: 1, maximumDelay: 5, timeout: 20, response: {socket in
            socket.onConnect = {
                println("Connected to \(host)")
                socket.emit("add user", args: [username])
            }
            socket.on("login", callback: {(AnyObject data) -> Void in
                println(["login": data])
                socket.emit("new message", args: [message])
            })
            socket.onDisconnect = {
                println("Disconnected from \(host)")
            }
        })
    }
}

• Much of this code based on BrewMobile