Интеграция библиотеки ZGRImSDK в мобильное приложение, основанное на фреймворке React Native#

Интеграция в ручном режиме#

Необходимо убедиться в наличии всех необходимых файлов от ZGR:

  • ZGRConfig.json (файл конфигурации);

  • ZGRImSDK.xcframework (динамическая универсальная библиотека).

Далее открыть Xcode и установить фреймворк в приложение:

  1. Перетянуть полученный от ZGR конфигурационный файл ZGRConfig.json в корневой каталог в иерархии файлов проекта (левая панель в Xcode).

../../_images/rn_1.png
  1. Активировать чек-бокс “Copy items if needed”.

  2. Перетянуть файл ZGRImSDK.xcframework в каталог “Frameworks” (левая панель в Xcode). В случае, если в проекте отсутствует папка “Frameworks”, перетянуть файл ZGRImSDK.xcframework в раздел “Frameworks, Libraries, and Embedded Content” на центральном экране основного таргета приложения.

../../_images/rn_2.png
  1. Активировать чек-бокс “Copy items if needed”.

  2. Перейти в основные настройки таргета приложения (первая вкладка) к разделу “Frameworks, Libraries and Embedded Content”, нажать <+>.

  3. В открывшемся меню выбрать библиотеку ZGRImSDK.xcframework, нажать <Add>.

../../_images/rn_3.png
  1. Убедиться, что библиотека будет встроена в приложение посредством установки пункта “Embed & Sign”.

../../_images/rn_4.png
  1. Проверить интеграцию приложения и SDK. Открыть файл AppDelegate и выполнить команду import ZGRImSDK. Библиотека должна быть доступна для импорта.

../../_images/rn_5.png

Интеграция c помощью менеджера пакетов CocoaPods#

Необходимо открыть Xcode и установить фреймворк в приложение:

  1. Перетянуть полученный от ZGR конфигурационный файл ZGRConfig.json в иерархию файлов проекта (левая панель в Xcode).

../../_images/rn_1.png
  1. Активировать чек-бокс “Copy items if needed”.

  2. Создать podfile и отредактировать таким образом, чтобы библиотека ZGRImSDK.xcframework устанавливалась и в основное приложение и в расширения.

../../_images/rn_6.png
  1. Выполнить команду pod install. Убедиться, что необходимые библиотеки интегрированы в проект.

../../_images/rn_7.png
  1. Перейти в основные настройки таргета приложения (первая вкладка) к разделу “Frameworks, Libraries and Embedded Content”, нажать <+>.

  2. В открывшемся меню выбрать библиотеку ZGRImSDK.xcframework, нажать <Add>.

../../_images/rn_8.png
  1. Убедиться, что pod c библиотекой будет встроен в приложение посредством установки пункта “Embed & Sign”.

../../_images/rn_9.png
  1. Проверить интеграцию приложения и SDK. Открыть файл AppDelegate и выполнить команду import ZGRImSDK. Библиотека должна быть доступна для импорта.

../../_images/rn_10.png

Дальнейшие шаги по интеграции библиотеки в части создания и настройки расширений, а также настройки App Group идентичны описанным в статье Интеграция библиотеки ZGRImSDK в мобильное приложение в ручном режиме, начиная с раздела Создание и настройка расширений приложения.