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

Менеджер пакетов Swift

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

Через Xcode

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

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

Какао-стручки

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

Для дистрибутива Firebase CocoaPods требуются Xcode 15.2 и CocoaPods 1.12.0 или выше. Вот как установить Firebase с помощью CocoaPods:

  1. Создайте подфайл, если у вас его еще нет. В корне каталога вашего проекта выполните следующую команду:

    pod init
  2. В свой подфайл добавьте модули Firebase, которые вы хотите использовать в своем приложении.

    Вы можете добавить в свое приложение любой из поддерживаемых продуктов Firebase .

    Analytics включена

    # Add the Firebase pod for Google Analytics
    pod 'FirebaseAnalytics'
    
    # For Analytics without IDFA collection capability, use this pod instead
    # pod ‘Firebase/AnalyticsWithoutAdIdSupport’
    
    # 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"

Карфаген

Поддержка Карфагена является экспериментальной. См. инструкции на GitHub по включению Firebase в ваше приложение через Carthage.

Интегрируйте вручную

Firebase предоставляет готовый двоичный дистрибутив XCFramework для пользователей, которые хотят интегрировать Firebase без использования менеджера зависимостей. Чтобы установить Firebase:

  1. Загрузите zip-архив SDK фреймворка . Этот файл содержит фрагменты архитектуры для всех доступных целевых архитектур для всех Firebase SDK, поэтому загрузка может занять некоторое время.

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

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