Добавьте 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. При появлении запроса выберите этот вариант, чтобы добавить файл конфигурации ко всем целям.

If you have multiple bundle IDs in your project, you must associate each bundle ID with a registered app in the Firebase console so that each app can have its own GoogleService-Info.plist file.

Шаг 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, которые вы хотите использовать.

    If Google Analytics is enabled in your Firebase project, make sure to add FirebaseAnalytics . This provides all analytics features. You can also select individual features; for more information, see the FAQ for the latest organization of modules in the Google Analytics for Firebase SDK .

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

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

The final step is to add initialization code to your application. You may have already done this as part of adding Firebase to your app. If you're using a quickstart sample project , this has been done for you.

  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. If you're using SwiftUI, you must create an application delegate and attach it to your App struct via UIApplicationDelegateAdaptor or NSApplicationDelegateAdaptor . You must also disable app delegate swizzling. For more information, see the SwiftUI instructions .

    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
In-App Messaging pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(необходимый)
Установка Firebase pod 'FirebaseInstallations' FirebaseInstallations
Performance Monitoring pod 'FirebasePerformance' FirebasePerformance
Realtime Database pod 'FirebaseDatabase' FirebaseDatabase
Remote Config pod 'FirebaseRemoteConfig' FirebaseRemoteConfig
SQL Connect 2 Н/Д FirebaseDataConnect
УСТАРЕВШИЕ ИЛИ НЕ ПОДДЕРЖИВАЕМЫЕ БИБЛИОТЕКИ
Dynamic Links pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
API для пользовательских моделей Firebase ML pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader

1 Firebase AI Logic ( FirebaseAILogic ) was formerly called "Vertex AI in Firebase" and distributed under the FirebaseVertexAI module. Firebase AI Logic was also formerly distributed under the FirebaseAI module.

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

Интеграция без использования 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 , используя Firebase AI Logic .

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

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

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

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

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

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

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