pubnub/swift

This is the official PubNub Swift SDK repository.

Requirements

iOS 12.0+ / macOS 10.15+ / tvOS 12.0+ / watchOS 4.0+ / visionOS 1.0+
Xcode 15+
Swift 5+

The PubNub Swift SDK doesn't contain any external dependencies.

Get keys

You will need the publish and subscribe keys to authenticate your app. Get your keys from the Admin Portal.

Set up your project

You have several options to set up your project. We provide instructions here for Swift Package Manager, CocoaPods, and Carthage.

Swift Package Manager

Create or open your project inside of Xcode
Navigate to File > Add Package Dependencies...
Enter the package URL: https://github.com/pubnub/swift.git
Use the Up to Next Major Version rule spanning from 10.0.0 < 11.0.0
Click Add Package
From the list of package products, assign PubNubSDK to your target application

For more information see Apple's guide on Adding Package Dependencies to Your App

CocoaPods

# Podfile
use_frameworks!

target 'YOUR_TARGET_NAME' do
  pod 'PubNubSwift', '~> 10.0'
end

Note: Replace YOUR_TARGET_NAME with your target's name.

In the directory containing your Podfile execute the following:

pod install

Carthage

Officially supported: Carthage 0.39.1 and up.

Add the following to Cartfile:

github "pubnub/swift" ~> 10.0

Then in the directory containing your Cartfile, execute the following:

carthage update --use-xcframeworks

Configure PubNub

Import the module named PubNub inside your AppDelegate:

``swift import UIKit import PubNubSDK // <- Here is our PubNub module import. ``

Create and configure a PubNub object:

``swift let config = PubNubConfiguration( publishKey: "myPublishKey", subscribeKey: "mySubscribeKey", userId: "myUniqueUserId" ) let pubnub = PubNub(configuration: config) ``

Add event listeners

// Create a new listener instance
let subscription = pubnub.channel("channelName").subscription()

// Add listener event callbacks
subscription.onEvent = { event in
  switch event {
  case .messageReceived(let message):
    print("Message Received: \(message) Publisher: \(message.publisher ?? "defaultUserID")")
  case .presenceChanged(let presenceChange):
    print("Presence Received: \(presenceChange)")
  case .appContextChanged(let appContextEvent):
    print("App Context Event: \(appContextEvent)")
  case .messageActionChanged(let messageActionEvent):
    print("Message Action Event: \(messageActionEvent)")
  case .fileChanged(let fileEvent):
    print("File Event: \(fileEvent)")
  case .signalReceived(let message):
    print("Signal Received: \(message) Publisher: \(message.publisher ?? "defaultUserID")")
  }
}

// Start receiving subscription events
subscription.subscribe()

NOTE: You can check the UUID of the publisher of a particular message by checking the message.publisher property in the subscription listener. You must also provide a default value for publisher, as the UUID parameter is optional.

Publish and subscribe

pubnub.publish(channel: "my_channel", message: "Test Message!") { result in
  switch result {
  case let .success(timetoken):
    print("The message was successfully published at: \(timetoken)")
  case let .failure(error):
    print("Handle response error: \(error.localizedDescription)")
  }
}

pubnub.subscribe(to: ["my_channel"])

Documentation

Support

If you need help or have a general question, contact <support@pubnub.com>.

License

The PubNub Swift SDK is released under the PubNub Software Development Kit License.

See LICENSE for details.

Package Metadata

Repository: pubnub/swift

Default branch: master

README: README.md