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

Swift Package Manager

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

Через Xcode

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

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

  2. В Xcode установите библиотеки Firebase, перейдя в меню File > Add Packages .

  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 Package Manager .

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

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

Для работы дистрибутива 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. Загрузите архив SDK фреймворка . Этот файл содержит архитектурные фрагменты для всех доступных целевых архитектур для всех SDK Firebase, поэтому его загрузка может занять некоторое время.

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

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