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

Предпосылки

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

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

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

    • Ваш проект должен быть ориентирован на эти версии платформ или более поздние:
      • iOS 13
      • macOS 10.15
      • tvOS 13
      • 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. При появлении запроса выберите добавление файла конфигурации во все целевые объекты.

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

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

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

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

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

    Если в вашем проекте Firebase включена Google Analytics , обязательно добавьте FirebaseAnalytics . Это обеспечит доступ ко всем аналитическим функциям. Вы также можете выбрать отдельные функции; см. раздел часто задаваемых вопросов о последней организации модулей в 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 'FirebaseAI' FirebaseAI
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
Dynamic Links pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
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

1 Firebase AI Logic ранее назывался « Vertex AI in Firebase » с pod 'FirebaseVertexAI' и библиотекой SwiftPM FirebaseVertexAI .

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

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

CocoaPods

Подробнее об интеграции CocoaPods читайте в нашем руководстве .

Фреймворки

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

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

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

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

    Информацию о версиях фреймворка или зависимостях можно найти в файле METADATA.md в загруженном zip-дистрибутиве.

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

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

Узнайте о Firebase:

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

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

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

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

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

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

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

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

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