Catch up on highlights from Firebase at Google I/O 2023. Learn more

Установите Firebase в свое приложение Apple

Быстрый менеджер пакетов

Начиная с версии 8.0.0 Firebase Apple SDK, поддержка Firebase Swift Package Manager вышла из бета-версии и обычно доступна для использования. CocoaPods не требуется для пользователей Swift Package Manager.

Для Firebase версии 8 и выше рекомендуется установить Swift Package Manager.

Через Xcode

Для поддержки диспетчера пакетов Swift требуется версия 14.1 или выше.

  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 требует добавления флага компоновщика -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.

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

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

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

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

    Аналитика включена

    # 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 «Конфиденциальность пользователей и использование данных и прозрачность отслеживания приложений ».

    Аналитика не включена

    # 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 является экспериментальной. См. инструкции на GitHub для включения Firebase в ваше приложение через Carthage.

Интегрировать вручную

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

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

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

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