Skip to content

chat21/ios-sdk

Repository files navigation

Chat21 SDK

Chat21 SDK adds Instant Messaging features to your app.

Features

Chat21 is a multi platform SDK that adds Instant Messaging to your iOS, Android and Web applications. You can find more information on http://www.chat21.org.

Chat21's backend actually relies on Firebase. Please refer to the Get Started for iOS tutorial to correctly address the setup of a Firebase account and APIs integration.

Chat21 iOS SDK provides the following features:

  • Direct messages
  • Group messages
  • Recent conversations' list
  • Offline messages' history
  • Received receipts
  • Presence Manager with online/offline and inactivity period indicator
  • Signup/Login with email and password and other auth methods
  • Synchronized contacts (with offline search and selection)
  • Extension points

Install Chat21 SDK using CocoaPods

Chat21 is distributed via CocoaPods. You can install the CocoaPods tool on OS X by running the following command from the terminal. Detailed information is available in the Getting Started guide.

$ sudo gem install cocoapods

Note that Chat21 SDK require a Firebase Project to work. More information about the creation of a Firebase project is available at https://firebase.google.com/docs/.

Add Chat21 SDK to your iOS app

CocoaPods is used to install and manage dependencies in existing Xcode projects.

  1. Create an Xcode project, and save it to your local machine.
  2. Create a file named Podfile in your project directory. This file defines your project's dependencies, and is commonly referred to as a Podspec.
  3. Open Podfile, and add your dependencies. A simple Podspec is shown here:
platform :ios, '10.0'
use_frameworks!

target 'YOUR-TARGET-NAME' do
  pod 'Chat21'
end
  1. Save the file.

  2. Open a terminal and cd to the directory containing the Podfile.

    $ cd <path-to-project>
    
  3. Run the pod install command. This will install the SDKs specified in the Podspec, along with any dependencies they may have.

    $ pod install
    
  4. Open your app's .xcworkspace file to launch Xcode. Use this file for all development on your app.