Install Chat SDK for Business Messaging
Sendbird Business Messaging utilizes our core Chat SDKs to implement Business Messaging in a way that is more specific to your application. This guide walks you through the necessary steps required in order to successfully install the SDK for your preferred platform.
- Install Chat SDK for iOS
- Install Chat SDK for Android
- Install Chat SDK for JavaScript
- Install Chat SDK for Flutter
Note: The Sendbird server supports Transport Layer Security (TLS) from version 1.0 up to 1.3. For example, in the server regions where TLS 1.3 isn't available, lower versions, sequentially from 1.2 to 1.0, will be supported for secure data transmission.
Before you start
Before install the Chat SDK of Sendbird Business Messaging, it is assumed you already have the following:
- A Sendbird account on Sendbird Dashboard
- A Sendbird Application in a region that supports Business Messaging
Note: Sendbird Business Messaging are currently only supported in the following regions: Singapore, N. Virginia, Oregon, Frankfurt, Mumbai
iOS
Installing the Chat SDK is simple if you're familiar with using external libraries or SDKs in your projects. Sendbird Chat SDK can be installed through either one of the package managers:
If you don't want to use a package manager, check out the manual installation guide.
Note: The name of the framework and the module is
SendbirdChatSDK
while the main class in the SDK is calledSendbirdChat
.
Requirements
The minimum requirements for the Chat SDK for iOS are the following:
- macOS
- Xcode 15.0 or later
- At least one device running iOS 12.0 or later
- Swift 5.0 and later or Objective-C
Note: Starting on April 29, 2024, you must build and test your app with Xcode 15.0 or later to submit to the App Store. You can use the existing Sendbird SDK versions built with both Xcode 13.x and Xcode 14.x but Sendbird is repackaging Chat for iOS with Xcode 15.0 and minimum iOS version of 12.0 starting on April 29, 2024.
Swift
- Open Xcode, go to your projects General settings tab and select your project under Project in the left column.
- Go to the Swift packages tab and click the + button.
- When a pop-up appears, enter the following github repository address in the search bar:
https://github.com/sendbird/sendbird-chat-sdk-ios
- Set Rules and click Next.
- Check
SendbirdChatSDK
in the Package product column and click Finish. This will establish a Swift Package Dependency menu in Xcode.
CocoaPods
- Open a terminal window, move to your project directory, and then create a
Podfile
by running the following command.
- A
Podfile
will be created in your project folder. Open thePodfile
and modify the file like the following.
- Then install the
SendbirdChatSDK
framework by running the following command in the same terminal window.
- In the folder, you will see a new project file in the
.xcworkspace
format. Now you can build your project with theSendbirdChatSDK
framework in the file.
Carthage
- Open a terminal window and add the following line to create a
Cartfile
in your project folder.
- Move to your project directory, open the
Cartfile
, and add the following line to yourCartfile
.
- Run the carthage update command to download Sendbird Chat SDK for iOS.
- Once the update is complete, go to your Xcode project's General settings tab. Then, open the <YOUR_XCODE_PROJECT_DIRECTORY>/Carthage/Build/iOS in the Finder window and drag and drop the SendbirdChatSDK.xcframework folder to the Frameworks, Libraries, and Embedded section in Xcode.
- Once you're done with package installation, go to the Usage guide and see the implementation process of the SDK.
Android
Requirements
The minimum requirements for Chat SDK for Android are the following.
Android 5.0 (API level 21) or higher
Java 8 or higher
Android Gradle plugin 3.4.2 or higher
Sendbird Chat SDK for Android 4.16.0 and later
Installation
The installation method is determined by your gradle version. If you're utilizing gradle 6.8 or higher, add the following code to your settings.gradle
file. Otherwise, add the following code to your root build.gradle
file. See this release note to learn more about updates to Gradle.
Next, for all Gradle versions, add the dependency to your module build.gradle
file.
Request to access system permissions
The Chat SDK requires system permissions that allow it to communicate with the Sendbird server as well as read and write to and from the user's device's storage. To request the system permissions, add the following line to your AndroidManifest.xml
file:
(Optional) Configure ProGuard
If you're building your APK with minifyEnabled true
, add the following line to the module's ProGuard
rules file:
SDK implementation
Once you're done with package installation, go to the Usage guide and see the implementation process of the SDK.
JavaScript
Installation
When using Sendbird Business Messaging with the JavaScript SDK, it's assumed you're also using a mobile framework such as React Native.
Install the JavaScript SDK via npm or yarn using the following command.
The Chat SDK has type definition files that include third-party library dependencies such as @react-native-async-storage/async-storage
to provide accurate type support.
If you do not use such third-party libraries or prefer not to check the types of the Chat SDK when compiling, enable the skipLibCheck
option in your tsconfig.json
file.
SDK implementation
Once you're done with package installation, go to the Usage guide and see the implementation process of the SDK.
Flutter
Requirements
The minimum requirements for the Chat SDK for Flutter are the following:
- Dart 2.19.0 or later
- Flutter 3.7.0 or later
Installation
Add the Chat SDK to the dependency list of your packages pubspec.yaml
.
Then, install the package from the command line.
SDK implementation
Once you're done with package installation, go to the Usage guide and see the implementation process of the SDK.