git clone --depth=1 https://github.com/leancloud/ChatKit-OC

├── ChatKit  # Основная библиотека
│   ├── LCChatKit.h  # Это входная точка всего модуля, центр управления, аналогичный "Mediator" в "компонентной схеме".
│   ├── LCChatKit.m
│   └── Class
│       ├── Model
│       ├── Module
│       │   ├── Base
│       │   ├── Conversation
│       │   │   ├── Controller
│       │   │   ├── Model
│       │   │   ├── Tool
│       │   │   └── View
│       │   └── ConversationList
│       │       ├── Controller
│       │       ├── Model
│       │       └── View
│       ├── Resources  # Ресурсы, такие как изображения, аудио и т.д.
│       ├── Tool
│       │   ├── Service
│       │   └── Vendor
│       └── View
└── ChatKit-OC  # Пример использования
    ├── ChatKit-OC.xcodeproj
    └── Example
        └── LCChatKitExample.h  # Это входной класс для примера использования, в котором представлены многие связующие функции, необходимые для базовой интеграции.
        └── LCChatKitExample.m
            ├── Model
            ├── Module
            │   ├── ContactList
            │   │   ├── Controller
            │   │   ├── Tool
            │   │   └── View
            │   ├── Login
            │   │   ├── Controller
            │   │   ├── Model
            │   │   └── View
            │   ├── Main
            │   │   ├── Controller
            │   │   └── View
            │   └── Other

   sudo gem install cocoapods

   gem sources --add https://ruby.taobao.org/ --remove https://rubygems.org/
   sudo gem install cocoapods

Обратите внимание, что эта команда ищет последнюю версию на вашем компьютере, а не в интернете. Если команда не находит последнюю версию, вы можете обновить список источников CocoaPods, выполнив следующую команду:

```shell
   pod repo update

   pod init

   gem install cocoapods

   pod 'ChatKit', '0.8.5'

   pod install

   # Отключает обновление репозитория CocoaPods, чтобы избежать зависания на этапе анализа зависимостей
   pod update --verbose --no-repo-update

**Использование CocoaPods**

**Указание версии SDK**

В CocoaPods есть несколько способов указания версии SDK. Например:

`>= 0.8.5` импортирует SDK версии OnClickListener 0.8.5 или выше, в зависимости от списка источников CocoaPods на вашем устройстве.
`~> 0.8.5` импортирует SDK версии 0.7.X до 0.8.5, в зависимости от списка источников CocoaPods на вашем устройстве.
Мы рекомендуем указывать конкретную версию для удобства работы команды. Например, указать версию 0.8.5.

```shell
pod 'ChatKit', '0.8.5'

pod repo update

pod update

   #import <ChatKit/LCChatKit.h>

pod 'ChatKit', '0.8.5'

pod repo update

pod update

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    . . .
    // Если приложение используется за пределами Китая, активируйте североамериканский узел.
    // Этот вызов должен быть сделан до инициализации AppId, иначе будет использоваться китайский узел.
    // [AVOSCloud setServiceRegion:AVServiceRegionUS];
    [LCChatKit setAppId:LCCKAPPID appKey:LCCKAPPKEY];
    // Включить уведомления о непрочитанных сообщениях
    [AVIMClient setUnreadNotificationEnabled:YES];
}

// Добавьте плагины для нижней части поля ввода, если требуется изменить иконки или заголовки, создайте подкласс, а затем вызовите `+registerSubclass`
[LCCKInputViewPluginTakePhoto registerSubclass];
[LCCKInputViewPluginPickImage registerSubclass];
[LCCKInputViewPluginLocation registerSubclass];
  . . .
}

[[LCChatKit sharedInstance] setFetchProfilesBlock:^(NSArray<NSString *> *userIds,
LCCKFetchProfilesCompletionHandler completionHandler) {
if (userIds.count == 0) {
NSInteger code = 0;
NSString *errorReasonText = @"User ids is nil";
NSDictionary *errorInfo = @{
@"code":@(code),
NSLocalizedDescriptionKey : errorReasonText,
};
NSError *error = [NSError errorWithDomain:NSStringFromClass([self class])
code:code
userInfo:errorInfo];
!completionHandler ?: completionHandler(nil, error);
return;
}
NSMutableArray *users = [NSMutableArray arrayWithCapacity:userIds.count];
[userIds enumerateObjectsUsingBlock:^(NSString *clientId, NSUInteger idx,
BOOL *stop) {
NSPredicate *predicate = [NSPredicate predicateWithFormat:@"peerId like %@", clientId];
// LCCKContactProfiles и LCCKProfileKeyPeerId — это предварительно определенные макросы
NSArray *searchedUsers = [LCCKContactProfiles filteredArrayUsingPredicate:predicate];
if (searchedUsers.count > 0) {
NSDictionary *user = searchedUsers[0];
NSURL *avatarURL = [NSURL URLWithString:user[LCCKProfileKeyAvatarURL]];
LCCKUser *user_ = [LCCKUser userWithUserId:user[LCCKProfileKeyPeerId]
name:user[LCCKProfileKeyName]
avatarURL:avatarURL
clientId:clientId];
[users addObject:user_];
} else {
LCCKUser *user_ = [LCCKUser userWithClientId:clientId];
[users addObject:user_];
}
}];
!completionHandler ?: completionHandler([users copy], nil);
}];
```### Автоматическое добавление подписиЕсли вы реализуете метод `-[[LCChatKit sharedInstance] setGenerateSignatureBlock:]`, то ChatKit автоматически добавит подпись для следующих действий: `open` (открытие чата), `start` (начало диалога), `kick` (выгоняет пользователя), `invite` (приглашает пользователя). В противном случае, подпись не будет добавлена.

### Открытие IM-сервиса

Вызов метода `-[[LCChatKit sharedInstance] openWithClientId:callback:]` для открытия IM-сервиса LeanCloud LeanMessage и начала чата. Убедитесь, что вы реализовали метод `-[[LCChatKit sharedInstance] setFetchProfilesBlock:]` до вызова `open`, иначе ChatKit выбросит исключение.

### Закрытие IM-сервиса

Вызов метода `-[[LCChatKit sharedInstance] closeWithCallback:]` для закрытия IM-сервиса LeanCloud и завершения чата.

### Страница списка диалогов

Основные социальные чат-приложения, такие как WeChat и QQ, используют страницу недавних диалогов как главную страницу после входа. Поэтому в ChatKit также предоставляется страница списка диалогов `LCIMConversationListController`. Метод инициализации очень прост:

```Objective-C
LCCKConversationListViewController *firstViewController = [[LCCKConversationListViewController alloc] init];

// Для личного чата, по умолчанию создается уникальный диалог, содержащий двух участников (если такой диалог уже существует, то он будет использован, а не создан заново)
LCCKConversationViewController *conversationViewController = [[LCCKConversationViewController alloc] initWithPeerId:peerId];

// Для личного или группового чата, используется при наличии базовой информации о диалоге.
LCCKConversationViewController *conversationViewController = [[LCCKConversationViewController alloc] initWithConversationId:conversationId];

[[LCChatKit sharedInstance] setDidSelectConversationsListCellBlock:^(NSIndexPath *indexPath, AVIMConversation *conversation, LCCKConversationListViewController *controller) {
    NSLog(@"conversation selected");
    LCCKConversationViewController *conversationVC = [[LCCKConversationViewController alloc] initWithConversationId:conversation.conversationId];
    [controller.navigationController pushViewController:conversationVC animated:YES];
}];

/*!
 *  Коллбэк после выбора определённого чата (обычно требуется)
 *  @param conversation выбранный чат
 */
typedef void(^LCCKConversationsListDidSelectItemBlock)(NSIndexPath *indexPath, AVIMConversation *conversation, LCCKConversationListViewController *controller);
/*!
 *  Установка коллбэка после выбора определённого чата
 */
- (void)setDidSelectConversationsListCellBlock:(LCCKConversationsListDidSelectItemBlock)didSelectItemBlock;
``````markdown
/*!
 * Коллбэк после удаления определенного чата (обычно не требуется)
 * @param conversation удаленный чат
 */
typedef void(^LCCKConversationsListDidDeleteItemBlock)(NSIndexPath *indexPath, AVIMConversation *conversation, LCCKConversationListViewController *controller);
/*!
 * Установка коллбэка после удаления определенного чата
 */
- (void)setDidDeleteConversationsListCellBlock:(LCCKConversationsListDidDeleteItemBlock)didDeleteItemBlock;

/*!
 * Настройка блока для левого свайпа в диалоге (на странице с недавними контактами, где есть сложные жесты, можно расширить функциональность через этот блок)
 * @return Массив меню, который нужно отобразить
 * @param conversation, диалог
 * @param editActions, массив по умолчанию, элементы которого типа UITableViewRowAction
 */
typedef NSArray *(^LCCKConversationEditActionsBlock)(NSIndexPath *indexPath, NSArray<UITableViewRowAction *> *editActions, AVIMConversation *conversation, LCCKConversationListViewController *controller);
/*!
 * С помощью этого блока можно настроить левое меню для каждого диалога в списке диалогов. Это синхронный вызов, поэтому необходимо быстро вернуться, иначе UI будет заблокирован.
 */
- (void)setConversationEditActionBlock:(LCCKConversationEditActionsBlock)conversationEditActionBlock;
```
```### Обработка нескольких типов действий в интерфейсе чата
```С помощью ChatKit инициализация и отображение интерфейса чата становятся очень простыми, но для взаимодействия с ним требуются дополнительные настройки.

- Внутренние ошибки при создании диалога

Если при открытии диалога по `peerId` или `conversationId` возникают сетевые проблемы или переданные параметры некорректны, диалог может не создаться. В этом случае можно использовать метод `conversationHandler` класса `LCCKConversationViewController` для обработки ошибок. Пример кода:

```objective-c
[[LCChatKit sharedInstance] setFetchConversationHandler:^(
                                                              AVIMConversation *conversation,
                                                              LCCKConversationViewController *aConversationController) {
    if (!conversation) {
        // Отображение сообщения об ошибке
        [conversationController alert:@"Не удалось создать/загрузить диалог."];
    } else {
        // Обработка без ошибок
    }
}];
```

Важно отметить, что метод `-setFetchConversationHandler:` не требует повторной настройки для каждого нового объекта `LCCKConversationViewController`. Необходимо настроить его только один раз, и все последующие объекты будут использовать эту настройку.

- Отображение подробной информации о диалогеВ приложениях для чата, таких как QQ или WeChat, в правом верхнем углу интерфейса чата есть кнопка для отображения подробной информации о диалоге. При нажатии на эту кнопку открывается страница с подробной информацией, где можно переименовать диалог, добавить участников, исключить участников, включить или выключить уведомления и т. д. В классе `LCCKConversationViewController` эта функциональность также поддерживается следующими API:```objective-c
typedef void(^LCCKBarButtonItemActionBlock)(void);

typedef NS_ENUM(NSInteger, LCCKBarButtonItemStyle) {
    LCCKBarButtonItemStyleSetting =  Метод,
    LCCKBarButtonItemStyleMore,
    LCCKBarButtonItemStyleAdd,
    LCCKBarButtonItemStyleAddFriends,
    LCCKBarButtonItemStyleShare,
    LCCKBarButtonItemStyleSingleProfile,
    LCCKBarButtonItemStyleGroupProfile,
};

- (void)configureBarButtonItemStyle:(LCCKBarButtonItemStyle)style action:(LCCKBarButtonItemActionBlock)action;
```

Пример кода:

```objective-c
[self configureBarButtonItemStyle:LCCKBarButtonItemStyleSetting action:^{
    // Действия при нажатии на кнопку настроек
}];
```

```objective-c
[aConversationController configureBarButtonItemStyle:LCCKBarButtonItemStyleGroupProfile
                                                          action:^(UIBarButtonItem *sender, UIEvent *event) {
    ConversationDetailViewController *detailVC = [[ConversationDetailViewController alloc] init]; // Конкретная реализация страницы с деталями диалога
    detailVC.conversation = conversation;
    [conversationController.navigationController pushViewController:detailVC animated:YES];
}];
```

### Ручная интеграция

Если вы не хотите использовать CocoaPods для интеграции, вы также можете выбрать интеграцию с использованием исходного кода. Шаги следующие:

Первый шаг:

Перетащите папку "core library" ChatKit, упомянутую в [структуре проекта](https://github.com/leancloud/ChatKit-OC#project-structure), в ваш проект.

Второй шаг:

Добавьте зависимости ChatKit от сторонних библиотек и соответствующие версии:

- [AVOSCloud](https://github.com/leancloud/objc-sdk) v3.6.1
- [AVOSCloudIM](https://github.com/leancloud/objc-sdk) v3.6.1
- [MJRefresh](https://github.com/CoderMJLee/MJRefresh) 3.1.9
- [Masonry](https://github.com/SnapKit/Masonry) v1.0.1 
- [SDWebImage](https://github.com/rs/SDWebImage) v3.8.0
- [FMDB](https://github.com/ccgus/fmdb) 2.6.2 
- [UITableView+FDTemplateLayoutCell](https://github.com/forkingdog/UITableView-FDTemplateLayoutCell) 1.5.betaДля более точной информации обратитесь к [этому](https://github.com/leancloud/ChatKit-OC/blob/master/ChatKit.podspec) файлу.

## Часто задаваемые вопросы

**Должен ли я платить за компоненты ChatKit?**<br/>
ChatKit является полностью открытым и бесплатным для использования разработчиками. Стоимость использования чата указана [здесь](https://leancloud.cn/pricing.html).

**Какие преимущества предоставляет ChatKit?**<br/>
Он снижает затраты на исследование в начале разработки приложения или нового функционала, позволяя сразу использовать готовое решение. ChatKit предоставляет полное решение для чата, начиная от базового уровня и заканчивая пользовательским интерфейсом.

**Как сделать приложение совместимым с iOS7?**<br/>
Поскольку ChatKit использует контроллер UITableViewRowAction из iOS8, для совместимости с iOS7 вам нужно добавить библиотеку в ваше приложение:

```Objective-C
pod "CYLTableViewRowAction", "1.0.0"
```

В демонстрационном приложении используется этот способ для совместимости с iOS7.

Если вы не используете Pod, вы можете скачать [CYLTableViewRowAction](https://github.com/ChenYilong/CYLTableViewRowAction) и перетащить папки из этого архива в ваш проект, что решит проблему совместимости с iOS7.

**Почему я не получаю уведомления?**<br/>
Описание проблемы: сертификаты для уведомлений настроены, тестирование уведомлений в консоли проходит успешно, но уведомления от другого пользователя не приходят.В этом случае, сначала обратитесь к [руководству по разработке уведомлений для iOS](https://leancloud.cn/docs/ios_push_guide.html). Если настройки выполнены правильно, проверьте, правильно ли настроены следующие параметры:

Например, вы можете настроить следующим образом:

```Objective-C
{"alert":"У вас есть новые сообщения","badge":"Increment"}
```

![](http://ww2.sinaimg.cn/large/7853084cjw1f7y0ltdaprj20r20fiacf.jpg)

Если вы хотите получить содержимое уведомлений, можно ознакомиться с [статьей «iOS уведомления: как получить уведомления при нажатии на иконку приложения leanCloud»](http://blog.csdn.net/zain_/article/details/50440096)

При возникновении любых вопросов во время использования, вы можете задать их на [официальном форуме](https://forum.leancloud.cn/c/jing-xuan-faq), где вам ответит профессиональный инженер. Среднее время ответа составляет 24 часа.