Как установить 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"),
  // ...

],

Затем в любой цели, которая зависит от продукта 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.

Для дистрибутива 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. Установите pod-файлы и откройте файл .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 в настройках сборки целевого объекта.