Эта страница была переведа с помощью Cloud Translation API.
Switch to English

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

Предпосылки

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

    • Xcode 11.0 или новее
    • CocoaPods 1.4.0 или новее

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

    • Ваш проект должен быть нацелен на iOS 8 или новее.

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

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

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

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

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

После того, как у вас есть проект Firebase, вы можете добавить в него свое приложение для iOS.

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

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

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

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

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

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

  5. Щелкните Зарегистрировать приложение .

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

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

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

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

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

Мы рекомендуем использовать CocoaPods для установки библиотек Firebase. Однако, если вы не хотите использовать CocoaPods, вы можете напрямую интегрировать фреймворки SDK или использовать Swift Package Manager (бета) .

Вы используете один из примеров быстрого запуска ? Проект Xcode и Podfile (с модулями) уже присутствуют, но вам все равно нужно добавить файл конфигурации Firebase и установить модули.

  1. Создайте подфайл, если у вас его еще нет: 

    cd your-project-directory
    pod init

  2. В свой Podfile добавьте модули Firebase, которые вы хотите использовать в своем приложении.

    Вы можете добавить любой из поддерживаемых продуктов Firebase в свое приложение для iOS.

    Аналитика включена 

    # Add the Firebase pod for Google Analytics
pod 'Firebase/Analytics'
    
# Add the pods for any other Firebase products you want to use in your app
# For example, to use Firebase Authentication and Cloud Firestore
pod 'Firebase/Auth'
pod 'Firebase/Firestore'

    Аналитика не включена 

    # Add the pods for the Firebase products you want to use in your app
# For example, to use Firebase Authentication and Cloud Firestore
pod 'Firebase/Auth'
pod 'Firebase/Firestore'

  3. Установите .xcworkspace , затем откройте файл .xcworkspace чтобы увидеть проект в Xcode: 

    pod install
    open your-project.xcworkspace

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

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

  1. Импортируйте модуль Firebase в свой UIApplicationDelegate :

    Swift 

    import Firebase

    Цель-C 

    @import Firebase;
  2. Настройте общий экземпляр FirebaseApp , как правило, в методе application:didFinishLaunchingWithOptions: вашего приложения:

    Swift 

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Цель-C 

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. Если вы включили Firebase Analytics, вы можете запустить свое приложение, чтобы отправить в консоль Firebase подтверждение, что вы успешно установили Firebase.

Это оно! Вы можете перейти к следующим шагам .

Доступные капсулы

В этом разделе перечислены продукты Firebase, поддерживаемые для iOS и их модулей. Узнайте больше об этих библиотеках Firebase iOS:

  • Справочная документация ( Swift | Obj-C )

  • Репозиторий Firebase iOS SDK на GitHub

Услуга или продукт Стручки Добавить аналитику?
AdMob pod 'Google-Mobile-Ads-SDK'
Аналитика pod 'Firebase/Analytics'
Распространение приложений pod 'Firebase/AppDistribution'
Аутентификация pod 'Firebase/Auth'
Cloud Firestore pod 'Firebase/Firestore'
Облачные функции для Firebase Client SDK pod 'Firebase/Functions'
Обмен сообщениями в облаке pod 'Firebase/Messaging'
Облачное хранилище pod 'Firebase/Storage'
Firebase Crashlytics pod 'Firebase/Crashlytics'
Динамические ссылки pod 'Firebase/DynamicLinks'
Обмен сообщениями в приложении pod 'Firebase/InAppMessaging'
(обязательный)
API-интерфейсы Firebase ML Vision pod 'Firebase/MLVision'
API пользовательских моделей Firebase ML pod 'Firebase/MLModelInterpreter'
Мониторинг производительности pod 'Firebase/Performance'
База данных в реальном времени pod 'Firebase/Database'
Удаленная конфигурация pod 'Firebase/RemoteConfig'

Не рекомендуется:

Услуга или продукт Стручки подробности
ML Kit для Firebase: модель маркировки изображений pod 'Firebase/MLVisionLabelModel' Руководство по миграции
ML Kit для Firebase: модель сканирования штрих-кода pod 'Firebase/MLVisionBarcodeModel' Руководство по миграции
ML Kit для Firebase: модель распознавания текста pod 'Firebase/MLVisionTextModel' Руководство по миграции
Комплект ML для Firebase: модель распознавания лиц pod 'Firebase/MLVisionFaceModel' Руководство по миграции
ML Kit для Firebase: модель обнаружения и отслеживания объектов pod 'Firebase/MLVisionObjectDetection' Руководство по миграции
ML Kit для Firebase: API естественного языка pod 'Firebase/MLNaturalLanguage' Руководство по миграции
ML Kit для Firebase: модель идентификации языка pod 'Firebase/MLNLLanguageID' Руководство по миграции
ML Kit для Firebase: перевод модели pod 'Firebase/MLNLTranslate' Руководство по миграции
ML Kit для Firebase: модель умного ответа pod 'Firebase/MLNLSmartReply' Руководство по миграции
Комплект ML для Firebase: API AutoML Vision Edge pod 'Firebase/MLVisionAutoML' Руководство по миграции

Интегрировать без CocoaPods

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

Каркасы

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

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

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

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

Быстрый менеджер пакетов

Поддержка Swift Package Manager в настоящее время находится на стадии бета-тестирования. Следуйте документации на GitHub и отправляйте любые отзывы в систему отслеживания проблем GitHub .

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

Узнайте о Firebase:

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