undefined

iOS Getting Started

ConnectyCube helps you implement real-time chat, video chat, push notifications and user authorization to any app with ease - no server side implementation required. You can concentrate fully on your mobile app development. Our iOS SDK provides you with many helpful methods to build the chat and video chat from the client side.

This page presents a quick overview of the SDK’s functionalities and logic, then let you go through the easy steps of implementing ConnectyCube in your own app.

ConnectyCube iOS SDK can be used with the following languages and platforms:

  • iOS (iPhone/iPad) Objective-C
  • iOS (iPhone/iPad) Swift

Minimum iOS version supported is iOS 8.

Create ConnectyCube app

Register a FREE ConnectyCube account at https://connectycube.com/signup, then create your 1st app and obtain an app credentials. These credentials will be used to identify your app.

All users within the same ConnectyCube app can communicate by chat or video chat with each other, across all platforms - iOS, Android, Web, etc.

When building a new app

If you are just starting your app and developing it from scratch, we recommend to use our Code Samples projects.

Download Code Samples

These code samples are ready-to-go apps with an appropriate functionality and simple enough that even novice developers will be able to understand them.

When integrating SDK into existing app

If you already have an app, do the following for integration.

Connect SDK

We recommend using CocoaPods as the most advanced way of managing iOS project dependencies.

To connect ConnectyCube to your iOS app just add it into your Podfile:

platform :ios, '8.0'
use_frameworks!

target 'MyApp' do
  pod 'ConnectyCube'
end

Now you can install the dependencies in your project:

pod install

Make sure to always open the Xcode workspace instead of the project file when building your project:

open MyApp.xcworkspace

Now you can import your dependencies e.g.:

#import <ConnectyCube/ConnectyCube.h>

or if you use Swift:

import ConnectyCube

Run script phase for archiving

Add a "Run Script Phase" to build phases of your project. Paste the following snippet into the script:

bash "${BUILT_PRODUCTS_DIR}/${FRAMEWORKS_FOLDER_PATH}/ConnectyCube.framework/strip-framework.sh"

This fixes the known Apple bug, that does not allow to publish archives to the App store with dynamic frameworks that contain simulator platforms. Script is designed to work only for archiving.

Initialize

Initialize framework with your ConnectyCube application credentials. Usually it's done in AppDelegate class:

CYBSettings.applicationID = 21;
CYBSettings.authKey = @"hhf87hfushuiwef";
CYBSettings.authSecret = "jjsdf898hfsdfk";
CYBSettings.accountKey = @"sdfhdfy2329763buiyi";
Settings.applicationID = 21
Settings.authKey = "hhf87hfushuiwef"
Settings.authSecret = "jjsdf898hfsdfk"
Settings.accountKey = "sdfhdfy2329763buiyi"

You can access your application credentials in ConnectyCube Dashboard.

Configuration

An additional set of configs can be configured via CYBSettings class:

CYBSettings.logLevel = CYBLogLevelDebug;
Settings.logLevel = .debug

Now integrate messaging & calling capabilities

Follow the API guides on how to integrate chat and calling features into your app:

SDK Changelog

The complete SDK changelog is available on ConnectyCube iOS GitHub page

The complete VideoChat SDK changelog is available on ConnectyCube VideoChat iOS GitHub page