Latest Version version_pod
Mesibo iOS SDK for Chat, Video and Voice Calls, and Conferencing
The Mesibo SDKs for iOS are available via CocoaPods or as standalone frameworks that can be installed manually.
Minimum Requiements
- Latest stable Xcodeopen_in_new version.
- Target iOS 11.0 and above
- Ensure to add
-ObjC
linker flag to your Xcode projectBuild 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
CocoaPodsopen_in_new 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
andMetalKit
frameworks in your project to usemesibo-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 GitHubopen_in_new 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 GitHubopen_in_new 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 neededAdd 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 neededRight-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 neededRight-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 itopen_in_new.
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 appsopen_in_new - 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 documentationopen_in_new on requesting protected resources