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

Предпосылки

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

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

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

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

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

  Вы хотите использовать облачные сообщения?

  Для облачного обмена сообщениями на iOS выполните следующие действия:

  • Настройте физическое устройство iOS .
  • Получите ключ аутентификации Apple Push Notification для своей учетной записи Apple Developer .
  • Включите push-уведомления в Xcode в разделе « Приложение»> «Возможности» .

• Войдите в Firebase, используя свою учетную запись Google.

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

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

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

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

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

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

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

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

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

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

   Что такое идентификатор пакета и где его найти?

   • Идентификатор пакета однозначно определяет приложение в экосистеме Apple.

   • Найдите свой идентификатор пакета: откройте свой проект iOS в Xcode, выберите приложение верхнего уровня в навигаторе проекта, затем выберите вкладку Общие .

     Значением поля Идентификатор пакета является идентификатор пакета iOS (например, com.yourcompany.yourproject ).

   • Имейте в виду, что значение идентификатора пакета чувствительно к регистру и его нельзя изменить для этого приложения Firebase iOS после его регистрации в вашем проекте Firebase.

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

   Как псевдоним приложения и идентификатор магазина приложений используются в Firebase?

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

   • Идентификатор App Store : используется Firebase Dynamic Links для перенаправления пользователей на страницу вашего App Store и Google Analytics для импорта событий конверсии в Google Ads . Если у вашего приложения еще нет идентификатора App Store ID, вы можете добавить его позже в настройках вашего проекта .

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

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

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

   Что вам нужно знать об этом файле конфигурации?

   • Файл конфигурации Firebase содержит уникальные, но не секретные идентификаторы вашего проекта. Чтобы узнать больше об этом файле конфигурации, посетите Understand Firebase Projects .

   • Вы можете повторно загрузить файл конфигурации Firebase в любое время.

   • Убедитесь, что к имени файла конфигурации не добавлены дополнительные символы, например (2) .

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

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

Интегрировать без 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:

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

• Ознакомьтесь с примерами приложений Firebase .

• Получите практический опыт работы с Firebase iOS Codelab .

• Изучите открытый исходный код на GitHub .

• Подготовьтесь к запуску вашего приложения:

  • Настройте оповещения о бюджете для своего проекта в консоли GCP.
  • Следите за своей панелью использования и выставления счетов в консоли Firebase.
  • Ознакомьтесь с контрольным списком запуска Firebase .

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

• Узнайте о поведении пользователей с помощью Google Analytics .

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

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

• Храните файлы, например фотографии и видео, в облачном хранилище .

• Запускайте бэкэнд-код, который работает в безопасной среде с облачными функциями .

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

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