Варианты установки 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 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.

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