Skip to content
This repository has been archived by the owner on Aug 18, 2020. It is now read-only.

pusher/chatkit-swift

Repository files navigation

Chatkit Retirement Announcement

We are sorry to say that as of April 23 2020, we will be fully retiring our Chatkit product. We understand that this will be disappointing to customers who have come to rely on the service, and are very sorry for the disruption that this will cause for them. Our sales and customer support teams are available at this time to handle enquiries and will support existing Chatkit customers as far as they can with transition. All Chatkit billing has now ceased , and customers will pay no more up to or beyond their usage for the remainder of the service. You can read more about our decision to retire Chatkit here: https://blog.pusher.com/narrowing-our-product-focus. If you are interested in learning about how you can build chat with Pusher Channels, check out our tutorials.

PusherChatkit (chatkit-swift)

Build Status Read the docs Twitter Carthage CocoaPods GitHub license

Find out more about Chatkit here.

Building and Running

Minimum Requirements

  • Xcode - The easiest way to get Xcode is from the App Store, but you can also download it from developer.apple.com if you have an AppleID registered with an Apple Developer account.

  • Swift version 4.1 and above

  • iOS version 10.0

Before building & running in Xcode, install all of the required dependencies with Carthage or CocoaPods.

Installation

CocoaPods

CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:

$ gem install cocoapods

To integrate Chatkit into your Xcode project using CocoaPods, specify it in your Podfile:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '11.0'
use_frameworks!

# Replace `<Your Target Name>` with your app's target name.
target '<Your Target Name>' do
  pod 'PusherChatkit'
end

Then, run the following command:

$ pod install

You might need to use the --repo-update flag to ensure the specs repository is aware of the latest version of PusherChatkit.

Carthage

Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.

You can install Carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

To integrate Chatkit into your Xcode project using Carthage, specify it in your Cartfile:

github "pusher/chatkit-swift"

Run carthage update to build the framework and drag the built PusherChatkit.framework, PusherPlatform.framework and PushNotifications.framework into your Xcode project.

Deprecated versions

Versions of the library below 1.0.0 are deprecated and support for them will soon be dropped.

It is highly recommended that you upgrade to the latest version if you're on an older version. To view a list of changes, please refer to the CHANGELOG.

Getting started

Head over to our documentation.

Running tests

Some of the tests require a valid Chatkit instance locator, key, and token provider URL.

To set this up, run the following command:

cp Tests/Config/TestConfigExample.swift Tests/Config/TestConfig.swift

Then edit Tests/Config/TestConfig.swift to include a valid Chatkit instance locator, key, and token provider URL.

Communication

  • Found a bug? Please open an issue.
  • Have a feature request. Please open an issue.
  • If you want to contribute, please submit a pull request (preferrably with some tests 🙂 ).

Credits

PusherChatkit is owned and maintained by Pusher.

License

PusherChatkit is released under the MIT license. See LICENSE for details.