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

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

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

    • Xcode 16.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:

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

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

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

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

CocoaPods

Подробнее об интеграции CocoaPods вы можете узнать в нашем руководстве .

Фреймворки

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

  1. Скачайте архив SDK фреймворка в формате ZIP . Это файл размером около 200 МБ, и его загрузка может занять некоторое время.

  2. Распакуйте файл, а затем интегрируйте фреймворки, которые вы хотите включить в свое приложение.

    Инструкции по интеграции можно найти в одном из следующих мест:

    Для получения информации о версиях фреймворка или зависимостях обратитесь к файлу METADATA.md , находящемуся в загруженном ZIP-архиве.

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

Следующие шаги

Узнайте больше о Firebase:

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

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

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

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

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

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

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

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

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