Как установить Firebase в приложение для Apple

Swift Package Manager

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

Через Xcode

Для поддержки Swift Package Manager требуется версия 26.2 или более поздняя.

  1. Если вы переходите с проекта на основе CocoaPods, запустите pod deintegrate, чтобы удалить CocoaPods из проекта Xcode. После этого вы можете удалить файл .xcworkspace, созданный CocoaPods. Если вы впервые добавляете 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"),
  // ...

],

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

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

Для распространения CocoaPods через Firebase требуется Xcode 26.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 User Privacy and Data Use (Конфиденциальность пользователей и использование данных) и App Tracking Transparency (Прозрачность отслеживания приложений).

    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. Установите pods, а затем откройте файл .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 в настройках сборки целевого объекта.