Менеджер пакетов Swift
Firebase рекомендует Swift Package Manager для новых проектов.
Через Xcode
Для поддержки Swift Package Manager требуется версия 15.2 или выше.
При миграции из проекта на основе 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
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:
Создайте подфайл, если у вас его еще нет. В корне каталога вашего проекта выполните следующую команду:
pod init
В свой подфайл добавьте модули 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'
Установите модули, затем откройте файл
.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:
Загрузите zip-архив SDK фреймворка . Этот файл содержит фрагменты архитектуры для всех доступных целевых архитектур для всех Firebase SDK, поэтому загрузка может занять некоторое время.
Разархивируйте файл, затем просмотрите
README
платформ, которые вы хотите включить в свое приложение.Добавьте флаг компоновщика
-ObjC
в разделеOther Linker Settings
в настройках сборки вашей цели.