Подключение

SDK поставляется как xcframework.

Минимальные требования

• iOS 14.0+
• Xcode 16+
• Swift 5

Способы подключения

Ручное подключение

1. Скачайте фреймворк: 5.9.0.

2. Откройте архив и скопируйте ChatCenterUI.xcframework в директорию вашего проекта.

3. Перетащите ChatCenterUI.xcframework в секцию Frameworks and Libraries на вкладке General в настройках таргета. Для фреймворка выберите режим Embed & Sign.

Подключение через CocoaPods

1. Откройте Podfile и добавьте строку:

pod 'ChatCenterUI', '5.9.0'

2. Запустите команду pod install и дождитесь окончания скачивания фреймворка.

3. Откройте проект (файл .xcworkspace) в Xcode.

Подключение через Swift Package Manager (SPM)

1. Откройте проект в Xcode.

2. Перейдите:

File → Add Package Dependencies...

3. Вставьте URL репозитория:

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

4. Нажмите Next и выберите версию. Up to Next Major даёт обновления в пределах текущего мажора.

5. Добавьте пакет в нужные таргеты проекта.

6. Нажмите Finish. Xcode автоматически загрузит зависимости.

После подключения импортируйте модуль:

import ChatCenterUI

Настройки Info.plist

Добавьте в Info.plist все три usage-описания. SDK использует камеру, галерею и микрофон для отправки вложений и голосовых сообщений. Без соответствующего ключа iOS завершит приложение при первом запросе доступа.

Ключ	Назначение	Пример описания (RU)
NSPhotoLibraryAddUsageDescription	Сохранение/прикрепление фото. SDK запрашивает только .addOnly, отдельный NSPhotoLibraryUsageDescription не нужен	"Доступ к фото нужен, чтобы прикреплять снимки к сообщениям в чате"
NSCameraUsageDescription	Съёмка фото для отправки в чат	"Доступ к камере нужен, чтобы делать фото для отправки в чат"
NSMicrophoneUsageDescription	Запись голосовых сообщений	"Доступ к микрофону нужен для записи голосовых сообщений"

Privacy Manifest

SDK содержит встроенный PrivacyInfo.xcprivacy. Apple объединит его с манифестом приложения автоматически, отдельно ничего добавлять не нужно.

В манифесте и App Privacy nutrition labels вашего приложения укажите данные, которые передаёте в SDK через ChatUser (identifier, опциональный name, произвольные поля data: [String: String]), и reason-коды для собственных Required Reason API. См. Apple docs.

Что дальше

• Инициализация SDK — создание экземпляра, providerUid и appMarker
• Быстрый старт — первый чат на экране