Installation

The SDK is distributed as an xcframework.

Minimum requirements

• iOS 14.0+
• Xcode 16+
• Swift 5

Installation methods

Manual installation

1. Download the framework: 5.9.0.

2. Open the archive and copy ChatCenterUI.xcframework to your project directory.

3. Drag ChatCenterUI.xcframework into the Frameworks and Libraries section on the General tab of your target settings. Select Embed & Sign for the framework.

Installation via CocoaPods

1. Open the Podfile and add the line:

pod 'ChatCenterUI', '5.9.0'

2. Run the pod install command and wait for the framework to finish downloading.

3. Open the project (the .xcworkspace file) in Xcode.

Installation via Swift Package Manager (SPM)

1. Open the project in Xcode.

2. Navigate to:

File → Add Package Dependencies...

3. Paste the repository URL:

https://github.com/edna-ru/chatcenterui-ios

4. Click Next and select a version. Up to Next Major delivers updates within the current major version.

5. Add the package to the required project targets.

6. Click Finish. Xcode will automatically download the dependencies.

After installation, import the module:

import ChatCenterUI

Info.plist settings

Add all three usage descriptions to Info.plist. The SDK uses the camera, photo library and microphone for sending attachments and voice messages. Without the corresponding key, iOS will terminate the app on the first access request.

Key	Purpose	Example description (EN)
NSPhotoLibraryAddUsageDescription	Saving/attaching photos. The SDK requests only .addOnly, so a separate NSPhotoLibraryUsageDescription is not needed	"Photo library access is needed to attach images to chat messages"
NSCameraUsageDescription	Taking photos for sending to the chat	"Camera access is needed to take photos for sending to the chat"
NSMicrophoneUsageDescription	Recording voice messages	"Microphone access is needed to record voice messages"

Privacy Manifest

The SDK contains an embedded PrivacyInfo.xcprivacy. Apple will merge it with the app manifest automatically — nothing needs to be added separately.

In the manifest and App Privacy nutrition labels of your app, declare the data you pass to the SDK via ChatUser (identifier, optional name, arbitrary data: [String: String] fields), as well as reason codes for your own Required Reason APIs. See Apple docs.

What's next

• SDK initialization — creating an instance, providerUid and appMarker
• Quick start — first chat on the screen