Связывание библиотек

Не каждое приложение использует все возможности платформы, и включение кода для поддержки всех этих функций повлияет на размер двоичного файла... Но мы всё равно хотим поддерживать добавление этих функций по мере необходимости.

С учётом этого, многие из этих функций были вынесены в виде независимых статических библиотек.

Для большинства библиотек достаточно перетащить два файла, иногда потребуется третий шаг, но не больше.

Все библиотеки, поставляемые с React Native, находятся в папке Libraries в корне репозитория. Некоторые из них написаны на чистом JavaScript, и вам нужно только require их. Другие библиотеки также зависят от некоторого нативного кода, в этом случае вам нужно добавить эти файлы в ваше приложение, иначе приложение выдаст ошибку, как только вы попытаетесь использовать библиотеку.

Вот несколько шагов по подключению библиотек, содержащих нативный код

Автоматическое связывание

Установите библиотеку с нативными зависимостями:

npm install <library-with-native-dependencies> --save

Флаг --save или --save-dev очень важен на этом шаге. React Native свяжет ваши библиотеки на основе dependencies и devDependencies в файле package.json.

Всё! При следующем построении приложения нативный код будет подключен благодаря механизму автоподключения.

Ручное связывание

Шаг 1

Если библиотека содержит нативный код, в её папке должен быть файл .xcodeproj. Перетащите этот файл в свой проект в Xcode (обычно в группе Libraries в Xcode).

Шаг 2

Нажмите на главный файл проекта (тот, который представляет .xcodeproj), выберите Build Phases и перетащите статическую библиотеку из папки Products в импортируемую библиотеку в Link Binary With Libraries.

Шаг 3

Не каждой библиотеке потребуется этот шаг. Что нужно учитывать:

Нужно ли знать содержимое библиотеки на этапе компиляции?

Это означает, используете ли вы эту библиотеку на нативной стороне или только в JavaScript? Если вы используете её только в JavaScript, то всё готово!

Если вам нужно вызывать её из нативного кода, нам нужно знать заголовки библиотеки. Для этого перейдите в файл проекта, выберите Build Settings и найдите Header Search Paths. Там вы должны указать путь к своей библиотеке. (В этой документации раньше рекомендовалось использовать recursive, но сейчас это не рекомендуется, так как это может привести к скрытым ошибкам сборки, особенно с CocoaPods.)