Как добавить 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. В центре обзорной страницы проекта нажмите на значок iOS+, чтобы запустить мастер настройки.

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

  3. В поле Идентификатор пакета укажите идентификатор пакета приложения.

  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
API пользовательских моделей Firebase ML FirebaseMLModelDownloader

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

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

Как выполнить интеграцию без Swift Package Manager

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

Фреймворки

Помимо поддержки платформы iOS, ZIP-архив теперь включает файлы .xcframework. Подробную информацию можно найти в файле README для Firebase Apple platforms SDK на 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.