Быстрый менеджер пакетов
Начиная с версии 8.0.0 Firebase Apple SDK, поддержка Firebase Swift Package Manager вышла из бета-версии и обычно доступна для использования. CocoaPods не требуется для пользователей Swift Package Manager.
Для Firebase версии 8 и выше рекомендуется установить Swift Package Manager.
Через Xcode
Для поддержки диспетчера пакетов Swift требуется версия 14.1 или выше.
При миграции из проекта на основе CocoaPods запустите
pod deintegrate
, чтобы удалить CocoaPods из проекта Xcode. Сгенерированный CocoaPods файл.xcworkspace
впоследствии можно безопасно удалить. Если вы впервые добавляете Firebase в проект, этот шаг можно пропустить.В Xcode установите библиотеки Firebase, перейдя в меню «Файл» > «Добавить пакеты».
В появившемся приглашении выберите репозиторий Firebase GitHub:
https://github.com/firebase/firebase-ios-sdk.git
Выберите версию Firebase, которую вы хотите использовать. Для новых проектов мы рекомендуем использовать новейшую версию Firebase.
Выберите библиотеки 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:
Создайте подфайл, если у вас его еще нет. В корне каталога вашего проекта выполните следующую команду:
pod init
В свой подфайл добавьте модули 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'
Установите модули, затем откройте файл
.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:
Скачайте фреймворк SDK в формате zip . Этот файл содержит фрагменты архитектуры для всех доступных целевых архитектур для всех SDK Firebase, поэтому загрузка может занять некоторое время.
Разархивируйте файл, затем просмотрите
README
для фреймворков, которые вы хотите включить в свое приложение.Добавьте флаг компоновщика
-ObjC
вOther Linker Settings
в настройках сборки вашей цели.