Send your first message
Sendbird UIKit for iOS is a set of prebuilt UI components that allows you to easily craft an in-app chat with all the essential messaging features. Our development kit includes light and dark themes, fonts, colors and more. You can customize these components to create an interactive messaging interface unique to your brand identity.
The minimum requirements for UIKit for iOS are:
iOS 11.0 and later
Xcode 14.1 and later
Sendbird Chat SDK for iOS 4.0.13 and later
Note: Starting on April 25, 2023, you must build and test your app with Xcode 14.1 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.1+ but Sendbird is repackaging Chat UIKit for iOS with Xcode 14.1 and minimum iOS version of 11.0 starting on April 25, 2023.
Before you start
Before installing Sendbird Chat SDK, you need to create a Sendbird application on the Sendbird Dashboard, which comprises everything required in a chat service including users, messages, and channels. You will need the
App ID of your Sendbird application when initializing the Chat SDK.
Note: Each Sendbird application can be integrated with a single client app. Within the same application, users can communicate with each other across all platforms, whether they are on mobile devices or on the web.
You can start building a messaging experience in your app by installing Sendbird UIKit. This developer kit is an add-on feature to Sendbird Chat SDK so installing it will also install the core Chat SDK. The minimum requirement of Chat SDK for iOS is 4.0.13 or later.
Step 1 Create a project
To get started, open
Xcode and create a new project. Sendbird UIKit supports
Step 2 Install UIKit
You can install UIKit for iOS through either Swift Packages, CocoaPods, or Carthage.
In Xcode, select File > Add Packages.
SendbirdUIKit spm repositoryand add it to your
Package repository. You can also choose the
dependency rulethat you want to use in the repository and keep the latest version by selecting the
- When finished, Xcode automatically begins resolving and downloading your dependencies to the repository in the background.
Note: A build error may occur whlie using Swift packages with Xcode due to issues with caching. To resolve this error, try resetting the Xcode package caches. Open the
Filemenu, go to
Packages, and select
Reset Pacakge Caches. This deletes all local package data and redownloads each package from its online source.
Podfilein Xcode as below:
- Install the
- Update the
- Install the
Note: Building or creating the
Carthagecan only be done using the latest
Swift. If your
Swiftis not the most recent version, the framework should be copied into your project manually.
- Go to your Xcode project target's General settings tab in the
Frameworks and Librariessection. Then drag and drop
Note: Errors may occur if you're building your project with Xcode 11.3 or earlier versions. To fix these errors, refer to Handle errors caused by unknown attributes.
Step 3 Initialize with APP_ID
To integrate and run Sendbird UIKit in your app, you need to first initialize the
SendbirdUI instance through
Note: Local caching has now been added so that the client app can locally cache and retrieve channel and message data. The addition of this functionality requires the database to be reset and migrated. As a result of DB migration in the server, the initialization process of the
SendbirdUIinstance is now asynchronous and requires you to receive a callback function before you can move onto the next step. Once the database finishes migrating,
completionHandleris called. If the database fails to migrate, the
completionHandlerblock is called with an error. If the database successfully migrates, there is no error and you can proceed to the next step. Refer to the updated code below.
Until the initialization of Sendbird UIKit is completed, the progress doesn't advance to the next step. We recommend displaying a loading indicator to show the initialization process so that other succeeding steps should wait. The indicator should be displayed when
startHandler is called and hidden when
completionHandler is called.
Step 4 Set current user
User information must be set as
currentUser in the
SBUGlobals prior to launching Sendbird UIKit. This information will be used for various tasks within the kit, and if you don't set
currentUser in advance, there will be restrictions while using the UIKit. The
userID field shown below must be specified. Other fields such as
profileURL are optional, and if not specified, they'll be filled with default values.
currentUser for UIKit through the
AppDelegate as below:
Note: Even if you don't use
AppDelegate, you should still register user information before launching a chat service.
Step 5 Display channel list
SBUGroupChannelListViewController is the starting point for launching UIKit in your app. Implement the code below wherever you would like to start UIKit. You can see a complete list of group channels that you're a member of.
Note: If you are already using a navigation controller, you can use the
Step 6 Send your first message
You can now run the app on a simulator or a plugged-in device. To send a message, you must first create a group channel by tapping the icon in the top-right corner. Then, you can select users you wish to invite as members to your channel. Once the channel has been created, enter your first message and send.
Note: Sendbird UIKit offers features to attach or save files such as photos, videos, and documents in addition to sending text messages. To learn more about using these features, refer to Get attachment permission in the sample app.
You've successfully sent your first message with Sendbird.
Note: If you wish to distribute your application in the App store and remove unnecessary architectures in the application's build phase, go to Distribution settings in the sample app.
Get attachment permission
Sendbird UIKit allows users to attach or save files such as photos, videos, and documents. To use these functionalities, you need to request permission from users using your client apps.
Media attachment permission
Client apps must acquire permission from end users to use their photos or save media to their library. Once the permission is granted, users can send image or video messages and download media assets.
Document attachment permission (optional)
To attach documents from
iCloud to file messages, you need to activate the
iCloud feature. Once activated, users can send file messages containing documents from
iCloud. Go to your Xcode project's Signing & Capabilities, add + Capability, and select iCloud. Check iCloud Documents.
UIKit for iOS manages the lifecycle of its
ViewController along with various views and data from the Chat SDK for iOS. UIKit components are as follows:
List of components
A singleton that manages themes.
A singleton that manages color sets.
A singleton that manages font sets.
A class that contains static functions required when using Sendbird UIKit.
A class that contains static attributes required when using Sendbird UIKit.