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

Предпосылки

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

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

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

    • Ваш проект должен быть ориентирован на эти или более поздние версии платформы:
      • iOS13
      • macOS 10.15
      • tvOS 13
      • watchOS 7

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

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

Шаг 1 : Создание проекта Firebase

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Если Google Analytics включен в вашем проекте Firebase, обязательно добавьте FirebaseAnalytics . Для Analytics без возможности сбора IDFA добавьте вместо этого FirebaseAnalyticsWithoutAdId .

По завершении 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 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 . Вы также должны отключить swizzling делегата приложения. Для получения дополнительной информации см. инструкции 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 Логика 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 в Firebase » с pod 'FirebaseVertexAI' и библиотекой SwiftPM FirebaseVertexAI .

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

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

CocoaPods

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

Фреймворки

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

  1. Загрузите zip-архив framework 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 .