Варианты установки Firebase в ваше приложение Apple

Менеджер пакетов Swift

Firebase рекомендует Swift Package Manager для новых проектов.

Через Xcode

Для поддержки Swift Package Manager требуется версия 16.2 или выше.

  1. При миграции из проекта на базе CocoaPods выполните команду pod deintegrate , чтобы удалить CocoaPods из проекта Xcode. Файл .xcworkspace , созданный CocoaPods, можно безопасно удалить после миграции. Если вы добавляете Firebase в проект впервые, этот шаг можно пропустить.

  2. В Xcode установите библиотеки Firebase, перейдя в Файл > Добавить пакеты .

  3. В появившемся окне выберите репозиторий Firebase GitHub:

    https://github.com/firebase/firebase-ios-sdk.git

  4. Выберите нужную версию Firebase. Для новых проектов мы рекомендуем использовать последнюю версию Firebase.

  5. Выберите библиотеки Firebase, которые вы хотите включить в свое приложение.

После завершения Xcode начнет разрешать зависимости ваших пакетов и загружать их в фоновом режиме.

Через Package.swift

Чтобы интегрировать Firebase с пакетом Swift через манифест Package.swift , добавьте Firebase в массив dependencies вашего пакета. Подробнее см. в документации по диспетчеру пакетов Swift .

dependencies: [

  .package(name: "Firebase",
           url: "https://github.com/firebase/firebase-ios-sdk.git",
           from: "8.0"),
  // ...

],

Затем в любой цели, которая зависит от продукта Firebase, добавьте ее в массив dependencies этой цели.

.target(
  name: "MyTargetName",
  dependencies: [
    .product(name: "FirebaseAuth", package: "Firebase"),
    // ...
  ]
),

Особенности продукта

Для корректной работы некоторых продуктов Firebase требуются дополнительные шаги по интеграции.

Google Analytics

Google Analytics требует добавления флага компоновщика -ObjC в настройки сборки вашей цели, если он включен транзитивно.

Crashlytics

Crashlytics требует загрузки отладочных символов.

Вы можете использовать этап сборки скрипта запуска для Xcode для автоматической загрузки отладочных символов после сборки. Скрипт запуска можно найти здесь:

${BUILD_DIR%Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run

Другой вариант загрузки символов — использовать скрипт upload-symbols . Поместите скрипт в подкаталог файла проекта (например scripts/upload-symbols ) и убедитесь, что он доступен для исполнения:

chmod +x scripts/upload-symbols

Этот скрипт можно использовать для ручной загрузки dSYM-файлов. Чтобы ознакомиться с рекомендациями по использованию и дополнительными инструкциями, запустите upload-symbols без параметров.

CocoaPods

Firebase поддерживает установку с помощью CocoaPods в дополнение к Swift Package Manager.

Для дистрибутива Firebase CocoaPods требуются Xcode 16.2 и CocoaPods 1.12.0 или выше. Вот как установить Firebase с помощью CocoaPods:

  1. Создайте Podfile, если у вас его ещё нет. В корневом каталоге проекта выполните следующую команду:

    pod init

  2. Добавьте в Podfile модули Firebase, которые вы хотите использовать в своем приложении.

    Вы можете добавить в свое приложение любой из поддерживаемых продуктов Firebase .

    Analytics включена 

    # Add the Firebase pod for Google Analytics
pod 'FirebaseAnalytics'

# For Analytics without IDFA collection capability, use this pod instead
# pod FirebaseAnalytics/Core

# Add the pods for any other Firebase products you want to use in your app
# For example, to use Firebase Authentication and Cloud Firestore
pod 'FirebaseAuth'
pod 'FirebaseFirestore'

    Подробнее об IDFA, рекламном идентификаторе на уровне устройства, можно узнать в документации Apple «Конфиденциальность и использование данных пользователей , а также прозрачность отслеживания приложений» .

    Analytics не включена 

    # Add the pods for the Firebase products you want to use in your app
# For example, to use Firebase Authentication and Cloud Firestore
pod 'FirebaseAuth'
pod 'FirebaseFirestore'

  3. Установите модули, затем откройте файл .xcworkspace , чтобы увидеть проект в Xcode:

    pod install --repo-update
    open your-project.xcworkspace

Особенности продукта

Для корректной работы некоторых продуктов Firebase требуются дополнительные шаги по интеграции.

Crashlytics

Crashlytics требует загрузки отладочных символов.

Вы можете использовать этап сборки скрипта запуска для Xcode для автоматической загрузки отладочных символов после сборки. Скрипт запуска можно найти здесь: 

"${PODS_ROOT}/FirebaseCrashlytics/run"

Карфаген

Поддержка Carthage находится на экспериментальном уровне. Инструкции по включению Firebase в ваше приложение через Carthage см. на GitHub .

Интегрировать вручную

Firebase предоставляет готовый бинарный дистрибутив XCFramework для пользователей, желающих интегрировать Firebase без использования менеджера зависимостей. Чтобы установить Firebase:

  1. Загрузите zip-архив фреймворка SDK . Этот файл содержит фрагменты архитектуры для всех доступных целевых архитектур для всех Firebase SDK, поэтому загрузка может занять некоторое время.

  2. Распакуйте файл, затем просмотрите файл README для фреймворков, которые вы хотите включить в свое приложение.

  3. Добавьте флаг компоновщика -ObjC в Other Linker Settings в настройках сборки вашей целевой платформы.