mesibo SDK for iOS

Latest Version version_pod

The Mesibo SDKs for iOS are available via CocoaPods or as standalone frameworks that can be installed manually.

Minimum Requiements

Latest stable Xcode version.
Target iOS 11.0 and above
Ensure to add -ObjC linker flag to your Xcode project Build Settings -> Linking -> Other Linker Flags

You can install mesibo into your Xcode project by using CocoaPods or manually downloading mesibo frameworks from GitHub and adding them to your project.

Install Using CocoaPods

CocoaPods is an open source dependency manager for Swift and Objective-C Cocoa projects, which automates the process of using 3rd-party libraries like mesibo in your projects.

If you already have the CocoaPods tool, skip to Step 2.

Step 1: Install CocoaPods

You can install CocoaPods by running the following commands in Terminal.app:

$ sudo gem install cocoapods
$ pod setup

Depending on your Ruby installation, you may not have to run as sudo to install the cocoapods gem.

Step 2: Create a Podfile

Project dependencies to be managed by CocoaPods are specified in a file name Podfile. Create this file in the same directory as your Xcode project (.xcodeproj) file and Copy and paste the following lines into it:

target "YourTargetName" do
    source 'https://github.com/CocoaPods/Specs.git'
    pod 'mesibo'
end

This will install mesibo core SDK into your project.

Step 3: Install Mesibo Core SDK Framework

Now you can install or update to the latest mesibo frameworks in your project:

$ pod install
$ pod update

From now on, be sure to always open the generated Xcode workspace (.xcworkspace) instead of the project file when building your project:

$ open <YourProjectName>.xcworkspace

You can always update to the latest version by running above commands.

Step 4: Install Mesibo Calls & Conferencing and Messaging UI Framework

Similarly, you can also install mesibo-calls and mesibo-ui framework as following:

target "YourTargetName" do
    source 'https://github.com/CocoaPods/Specs.git'
    pod 'mesibo-ui'
    pod 'mesibo-calls'
end

You also need to add Metal and MetalKit frameworks in your project to use mesibo-call framework.

Pod Troubleshooting

In case pod is not able to sync all the frameworks, following can help

rm -rf ~/Library/Developer/Xcode/DerivedData
rm -rf Pods
rm Podfile.lock
pod cache clean --all
pod install --repo-update

Disable bitcode and use a physical device if you are using Calls framework.

Install Manually

You can add mesibo frameworks manually to your project.

You can download all the Mesibo frameworks for iOS from GitHub OR by by running the following commands in Terminal.app:

$ git clone https://github.com/mesibo/mesiboframeworks.git

If you are using, Mesibo Call framework, you also need to download Mesibo WebRTC framework by downloading from GitHub OR by by running the following commands in Terminal.app:

$ git clone https://github.com/mesibo/mesibowebrtcframework.git

Mesibo Core API Framework

Drag mesibo.framework to your xcode project. Xcode will prompt you for various options - make sure to select Copy items if needed
Add following iOS frameworks to your project - ‘Photos’, ‘AddressBook’, ‘CoreMedia’, ‘AVFoundation’, ‘AssetsLibrary’, ‘SystemConfiguration’, ‘MobileCoreServices’, ‘CoreTelephony’

Mesibo Voice and Video Call & Conferencing Framework

Drag mesibocall.framework to your xcode project. Xcode will prompt you for various options - make sure to select Copy items if needed
Right-click mesibocall.framework in your project, and select “Show In Finder”.
Drag the MesiboCallBundle.bundle from the Resources folder into your project. When prompted, ensure that Copy items into destination group’s folder is NOT selected.

Mesibo UI Framework

Drag messaging.framework to your xcode project. Xcode will prompt you for various options - make sure to select Copy items if needed
Right-click messaging.framework in your project, and select “Show In Finder”.
Drag the messagingui.bundle from the Resources folder into your project. When prompted, ensure that Copy items into destination group’s folder is NOT selected.

Mesibo UI SDK uses google map and place API to send location. Hence, in order to use this feature, you must be having Google map and place framework and also your Google API key in the info.plist - refer how to get your google map api key and install it.

Import Frameworks into your project

At this point, everything’s in place for you to start using mesibo. Just import frameoworks and start coding!

import mesibo
import MesiboUI
import MesiboCall

#import <Mesibo/Mesibo.h>
#import <MesiboUI/MesiboUI.h>
#import <MesiboCall/MesiboCall.h>

You can now begin developing features with mesibo. Be sure you update these frameworks each time mesibo is updated.

Configuring iOS Permissions

While mesibo APIs abstract away permission handling across platforms, iOS requires some additional configuration. Apps need to provide usage descriptions for sensitive resources like contacts, camera, microphone etc.

These usage strings are defined in the app’s Info.plist file. For convenience, you can copy the Info.plist from mesibo’s sample apps - it contains the necessary keys prepopulated. Simply update the permission messages to match your app branding and use cases.

For more details, refer Apple’s documentation on requesting protected resources