Как добавить Firebase в проект для Apple

Требования

  • Установите следующие компоненты:

    • Xcode 26.2 или более поздней версии

  • Убедитесь, что ваш проект соответствует следующим требованиям:

    • Проект должен быть предназначен для следующих версий платформы или более поздних:
      • iOS 15
      • macOS 11
      • tvOS 15
      • watchOS 8

  • Настройте физическое устройство Apple или используйте симулятор для запуска приложения.

Если у вас нет проекта Xcode и вы просто хотите попробовать продукт Firebase, скачайте один из наших образцов с быстрым запуском.

Шаг 1. Создайте проект Firebase

Прежде чем добавить Firebase в приложение для Apple, создайте проект Firebase. Подробнее о проектах Firebase…

Шаг 2. Зарегистрируйте приложение в Firebase

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

  1. Откройте консоль Firebase.

  2. На странице Project Overview (Обзор проекта) нажмите на значок iOS+. Будет запущен мастер настройки.

    Если вы уже добавили приложение в проект Firebase, нажмите Добавить приложение, чтобы открыть варианты платформы.

  3. Введите идентификатор пакета приложения в поле bundle ID.

  4. Необязательно. Введите другую информацию о приложении: псевдоним приложения и идентификатор App Store.

  5. Нажмите Register app (Зарегистрировать приложение).

Шаг 3. Добавьте файл конфигурации Firebase

  1. Нажмите Download GoogleService-Info.plist (Скачать GoogleService-Info.plist), чтобы получить файл конфигурации Firebase для приложения (GoogleService-Info.plist).

  2. Переместите файл конфигурации в корневую папку проекта Xcode. Если появится запрос, выберите добавление файла конфигурации во все цели.

Если в вашем проекте несколько идентификаторов пакетов, свяжите каждый из них с зарегистрированным приложением в консоли Firebase, чтобы у каждого приложения был собственный файл GoogleService-Info.plist.

Шаг 4. Добавьте в приложение Firebase SDK

Для установки зависимостей Firebase и управления ими используйте Swift Package Manager.

  1. Откройте проект приложения в Xcode и перейдите в меню File (Файл) > Add Packages (Добавить пакеты).
  2. Когда появится запрос, добавьте хранилище Firebase SDK для платформ Apple:
    3.   https://github.com/firebase/firebase-ios-sdk
  3. Выберите нужную версию SDK.

  4. Выберите библиотеки Firebase, которые хотите использовать.

    Если в вашем проекте Firebase включена функция Google Analytics, добавьте FirebaseAnalytics. Это позволяет использовать все функции аналитики. Вы также можете выбрать отдельные функции. Подробнее о последней организации модулей в Google Analytics для Firebase SDK…

После этого Xcode автоматически начнет распознавать и скачивать зависимости в фоновом режиме.

Шаг 5. Инициализируйте Firebase в приложении

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

  1. Импортируйте модуль FirebaseCore в UIApplicationDelegate, а также любые другие модули Firebase, которые использует делегат вашего приложения. Например, чтобы использовать свойства Cloud Firestore и Authentication, выполните следующие действия:

    SwiftUI

    import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. Настройте общий экземпляр FirebaseApp в методе application(_:didFinishLaunchingWithOptions:) делегата приложения:

    SwiftUI

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Swift

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. Если вы используете SwiftUI, вам нужно создать делегат приложения и прикрепить его к структуре App с помощью UIApplicationDelegateAdaptor или NSApplicationDelegateAdaptor. Также необходимо отключить подмену делегата приложения. Подробнее о SwiftUI…

    SwiftUI

    @main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}
  4. Если вы добавили Firebase SDK для Google Analytics, запустите приложение, чтобы отправить на консоль Firebase подтверждение того, что вы успешно установили Firebase.

Готово! Вы можете сразу перейти к дальнейшим действиям.

Если у вас возникли проблемы с настройкой, ознакомьтесь с часто задаваемыми вопросами и советами по устранению неполадок на платформах Apple.

Доступные библиотеки

В этом разделе перечислены продукты Firebase, поддерживаемые на платформах Apple. Подробнее о библиотеках Firebase для платформ Apple:

Товар или услуга Название библиотеки или фреймворка Как добавить Аналитику
AdMob GoogleMobileAds
Firebase AI Logic 1
 FirebaseAILogic
Analytics FirebaseAnalytics
App Check FirebaseAppCheck
App Distribution FirebaseAppDistribution
Authentication FirebaseAuth
Cloud Firestore FirebaseFirestore
Cloud Functions for Firebase Client SDK FirebaseFunctions
Cloud Messaging FirebaseMessaging
Cloud Storage FirebaseStorage
Crashlytics FirebaseCrashlytics
In-App Messaging FirebaseInAppMessaging (обязательно)
Firebase установок FirebaseInstallations
Performance Monitoring FirebasePerformance
Realtime Database FirebaseDatabase
Remote Config FirebaseRemoteConfig
SQL Connect 2 FirebaseDataConnect
УСТАРЕВШИЕ ИЛИ НЕПОДДЕРЖИВАЕМЫЕ БИБЛИОТЕКИ
Dynamic Links FirebaseDynamicLinks
Firebase ML API пользовательских моделей FirebaseMLModelDownloader

1 Firebase AI Logic (FirebaseAILogic) ранее назывался "Vertex AI в Firebase" и распространялся в составе модуля FirebaseVertexAI. Firebase AI Logic ранее распространялся в рамках модуля FirebaseAI.

2 Firebase SQL Connect ранее назывался "Firebase Data Connect".

Как интегрировать SDK без использования Swift Package Manager

Если вы не хотите использовать Swift Package Manager, вы можете интегрировать Firebase, импортировав предварительно скомпилированные фреймворки.

Компоненты Framework

Теперь в ZIP-архив входят не только файлы для iOS, но и файлы .xcframework. Подробную информацию можно найти в файле README для Firebase SDK для платформ Apple на GitHub.

  1. Скачайте ZIP-архив SDK фреймворка. Размер файла – около 200 МБ, поэтому скачивание может занять некоторое время.

  2. Распакуйте файл и добавьте в приложение нужные фреймворки.

    Инструкции по интеграции можно найти:

    Информацию о версиях фреймворков и зависимостях можно найти в файле METADATA.md в скачанном ZIP-архиве.

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

Дальнейшие действия

Подробнее о Firebase:

Добавьте в приложение сервисы Firebase:

  • Создавайте функции на основе генеративного ИИ с помощью моделей Gemini, используя Firebase AI Logic.

  • Получайте данные о поведении пользователей с помощью Analytics.

  • Настройте аутентификацию пользователей с помощью Authentication.

  • Хранить данные, например информацию о пользователях, с помощью Cloud Firestore или Realtime Database.

  • Храните файлы, например фотографии и видео, в Cloud Storage.

  • Запускать код на сервере в защищенной среде с помощью Cloud Functions.

  • Отправлять уведомления с помощью приложения Cloud Messaging.

  • Узнайте, когда и почему ваше приложение перестает работать, с помощью Crashlytics.