Варианты установки 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 в параметрах сборки вашей целевой системы.