Добавьте Firebase в свой проект Apple

Предварительные требования

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

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

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

    • Ваш проект должен быть ориентирован на следующие версии платформы или более поздние:
      • iOS 15
      • macOS 10.15
      • tvOS 15
      • watchOS 7

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

Если у вас ещё нет проекта Xcode и вы просто хотите попробовать продукт Firebase, вы можете скачать один из наших примеров для быстрого старта .

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

Прежде чем добавить Firebase в ваше приложение Apple, вам необходимо создать проект Firebase для подключения к вашему приложению. Подробнее о проектах Firebase можно узнать в разделе «Понимание проектов Firebase».

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

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

  1. Перейдите в консоль Firebase .

  2. В центре страницы обзора проекта нажмите значок iOS+ , чтобы запустить процесс настройки.

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

  3. Введите идентификатор пакета вашего приложения в поле «Идентификатор пакета» .

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

  5. Нажмите «Зарегистрировать приложение» .

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

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

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

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

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

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

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

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

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

После завершения Xcode автоматически начнет разрешение и загрузку ваших зависимостей в фоновом режиме.

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

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

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

    SwiftUI 

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

    Быстрый 

    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()

    Быстрый 

    // 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 in Firebase" и распространялся в составе модуля FirebaseVertexAI . Firebase AI Logic также ранее распространялся в составе модуля FirebaseAI .

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

Интеграция без использования Swift Package Manager.

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

Фреймворки

В дополнение к поддержке платформы iOS, архив теперь включает файлы .xcframework . Подробности см. в файле README SDK Firebase Apple Platforms на GitHub .

  1. Скачайте архив SDK фреймворка в формате ZIP . Это файл размером около 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 .