Catch up on everthing we announced at this year's Firebase Summit. Learn more

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

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

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

Для версий Xcode 12.5 и выше рекомендуется использовать Swift Package Manager.

Через Xcode

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

  1. Если перенастройка из проекта CocoaPods основы, запустить pod deintegrate удалить CocoaPods из вашего проекта Xcode. CocoaPods-сгенерированные .xcworkspace файл может быть безопасно удалены после этого. Если вы добавляете Firebase в проект впервые, этот шаг можно проигнорировать.

  2. В Xcode, установите Firebase библиотеки, перейдя в Файл> Пакеты Swift> Добавить пакет Завис ...

  3. В появившейся подсказке выберите репозиторий Firebase GitHub:

    https://github.com/firebase/firebase-ios-sdk.git
    
  4. Выберите версию Firebase, которую хотите использовать. Для новых проектов мы рекомендуем использовать последнюю версию Firebase.

  5. Выберите библиотеки Firebase, которые хотите включить в свое приложение.

Как только вы закончите, Xcode начнет разрешать зависимости вашего пакета и загружать их в фоновом режиме.

Via 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 без каких - либо параметров.

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

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

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

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

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

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

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

    # Add the Firebase pod for Google Analytics
    pod 'Firebase/Analytics'
    
    # 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 'Firebase/Auth'
    pod 'Firebase/Firestore'

    Узнайте больше о 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 'Firebase/Auth'
    pod 'Firebase/Firestore'
  3. Установите стручки, затем откройте .xcworkspace файл , чтобы увидеть проект в Xcode:

    pod install --repo-update
    open your-project.xcworkspace

Особенности продукта

Некоторые продукты Firebase требуют дополнительных шагов интеграции для правильной работы.

Crashlytics

Crashlytics требует, чтобы вы загрузили символы отладки.

Вы можете использовать этап сборки сценария запуска для Xcode, чтобы автоматически загружать символы отладки после сборки. Найдите сценарий запуска здесь:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Карфаген

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

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

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

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

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

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