Предпосылки
Установите следующее:
- Xcode 12.2 или новее
- CocoaPods 1.10.0 или новее
Убедитесь, что ваш проект соответствует этим требованиям:
- Ваш проект должен быть нацелен на iOS 10 или новее.
Настройте физическое устройство 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, в том числе о том, как обрабатывать несколько вариантов сборки.
Зайдите в консоль Firebase .
В центре страницы обзора проекта щелкните значок iOS (
), чтобы запустить рабочий процесс настройки.Если вы уже добавили приложение в свой проект Firebase, нажмите « Добавить приложение», чтобы отобразить параметры платформы.
Введите идентификатор пакета вашего приложения в поле идентификатора пакета iOS .
Идентификатор пакета однозначно идентифицирует приложение в экосистеме Apple.
Найдите свой идентификатор пакета: откройте свой проект iOS в Xcode, выберите приложение верхнего уровня в навигаторе проекта, затем выберите вкладку Общие .
Значением поля Идентификатор пакета является идентификатор пакета iOS (например,
com.yourcompany.yourproject
).Имейте в виду, что значение идентификатора пакета чувствительно к регистру и не может быть изменено для этого приложения Firebase iOS после его регистрации в вашем проекте Firebase.
(Необязательно) Введите другую информацию о приложении: псевдоним приложения и идентификатор в магазине приложений .
Псевдоним приложения : внутренний удобный идентификатор, который виден только вам в консоли Firebase.
Идентификатор магазина приложений : используется Firebase Dynamic Links для перенаправления пользователей на страницу вашего магазина приложений и Google Analytics для импорта событий конверсии в Google Рекламу . Если у вашего приложения еще нет идентификатора App Store ID, вы можете добавить его позже в настройках вашего проекта .
Щелкните Зарегистрировать приложение .
Шаг 3. Добавьте файл конфигурации Firebase
Нажмите Загрузить GoogleService-Info.plist, чтобы получить файл конфигурации Firebase iOS (
GoogleService-Info.plist
).Конфигурационный файл Firebase содержит уникальные, но не секретные идентификаторы вашего проекта. Чтобы узнать больше об этом файле конфигурации, посетите Understand Firebase Projects .
Вы можете снова загрузить файл конфигурации Firebase в любое время.
Убедитесь, что к имени файла конфигурации не добавлены дополнительные символы, например
(2)
.
Переместите файл конфигурации в корень вашего проекта Xcode. При появлении запроса выберите добавление файла конфигурации ко всем целевым объектам.
Если у вас есть несколько идентификаторов пакетов в вашем проекте, вы должны связать каждый идентификатор пакета с зарегистрированным приложением в консоли Firebase, чтобы каждое приложение могло иметь свой собственный GoogleService-Info.plist
.
Шаг 4. Добавьте SDK Firebase в свое приложение
Мы рекомендуем использовать CocoaPods для установки библиотек Firebase. Однако, если вы не хотите использовать CocoaPods, вы можете напрямую интегрировать фреймворки SDK или использовать Swift Package Manager (бета) .
Вы используете один из примеров быстрого запуска ? Проект Xcode и Podfile (с модулями) уже присутствуют, но вам все равно нужно добавить файл конфигурации Firebase и установить модули.
Создайте подфайл, если у вас его еще нет:
cd your-project-directory
pod init
В свой Podfile добавьте модули Firebase, которые вы хотите использовать в своем приложении.
Вы можете добавить любой из поддерживаемых продуктов Firebase в свое приложение для iOS.
Аналитика включена
platform :ios, ‘10.0’
# 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'Аналитика не включена
platform :ios, ‘10.0’
# 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'Установите
.xcworkspace
, затем откройте файл.xcworkspace
чтобы увидеть проект в Xcode:pod install
open your-project.xcworkspace
Шаг 5. Инициализируйте Firebase в своем приложении
Последний шаг - добавить код инициализации в ваше приложение. Возможно, вы уже сделали это в рамках добавления Firebase в свое приложение. Если вы используете образец проекта быстрого запуска , это было сделано за вас.
- Импортируйте модуль Firebase в свой
UIApplicationDelegate
:Быстрый
import Firebase
Цель-C
@import Firebase;
- Настройте общий экземпляр
FirebaseApp
, как правило, в методеapplication:didFinishLaunchingWithOptions:
вашего приложения:Быстрый
// Use Firebase library to configure APIs FirebaseApp.configure()
Цель-C
// Use Firebase library to configure APIs [FIRApp configure];
- Если вы включили Firebase Analytics, вы можете запустить свое приложение, чтобы отправить в консоль Firebase подтверждение, что вы успешно установили Firebase.
Вот и все! Вы можете перейти к следующим шагам .
Доступные капсулы
В этом разделе перечислены продукты Firebase, поддерживаемые для iOS и их модулей. Узнайте больше об этих библиотеках Firebase iOS:
Услуга или продукт | Стручки | Добавить аналитику? |
---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' | |
Аналитика | pod 'Firebase/Analytics' | |
Распространение приложений | pod 'Firebase/AppDistribution' | |
Аутентификация | pod 'Firebase/Auth' | |
Cloud Firestore | pod 'Firebase/Firestore' | |
Облачные функции для клиентского SDK Firebase | pod 'Firebase/Functions' | |
Обмен сообщениями в облаке | pod 'Firebase/Messaging' | |
Облачное хранилище | pod 'Firebase/Storage' | |
Firebase Crashlytics | pod 'Firebase/Crashlytics' | |
Динамические ссылки | pod 'Firebase/DynamicLinks' | |
Обмен сообщениями в приложении | pod 'Firebase/InAppMessaging' | (требуется) |
API пользовательских моделей Firebase ML | pod 'Firebase/MLModelDownloader' | |
Мониторинг производительности | pod 'Firebase/Performance' | |
База данных в реальном времени | pod 'Firebase/Database' | |
Удаленная конфигурация | pod 'Firebase/RemoteConfig' |
Интегрировать без CocoaPods
Если вы не хотите использовать Cocoapods, вы все равно можете воспользоваться SDK Firebase, импортировав фреймворки напрямую или используя Swift Package Manager.
Каркасы
Помимо поддержки платформы iOS, zip-архив теперь включает файлы .xcframework, которые добавляют поддержку Catalyst от сообщества. Подробнее см. README для Firebase iOS SDK на GitHub .
Загрузите zip-пакет SDK framework . Это файл размером ~ 200 МБ, и его загрузка может занять некоторое время.
Разархивируйте файл, затем просмотрите
README
для платформ, которые вы хотите включить в свое приложение.Добавьте
ObjC
компоновщикаObjC
вOther Linker Settings
целевой сборки.
Быстрый менеджер пакетов
Поддержка Swift Package Manager в настоящее время находится на стадии бета-тестирования. Следуйте документации на GitHub и отправляйте любые отзывы в систему отслеживания проблем GitHub .
Следующие шаги
Узнайте о Firebase:
Посетите страницу Understand Firebase Projects, чтобы узнать больше о проектах Firebase и лучших методах работы с ними.
Ознакомьтесь с примерами приложений Firebase .
Получите практический опыт работы с Firebase iOS Codelab .
Изучите открытый исходный код на GitHub .
Подготовьтесь к запуску своего приложения:
- Настройте оповещения о бюджете для своего проекта в Google Cloud Console.
- Следите за панелью использования и выставления счетов в консоли Firebase, чтобы получить общую картину использования вашего проекта в нескольких службах Firebase.
- Ознакомьтесь с контрольным списком запуска Firebase .
Добавьте сервисы Firebase в свое приложение:
Узнавайте о поведении пользователей с помощью Google Analytics .
Настройте аутентификацию пользователя с помощью аутентификации .
Храните данные, например информацию о пользователях, в Cloud Firestore или Realtime Database .
Храните файлы, например фотографии и видео, в облачном хранилище .
Запускайте бэкэнд-код, который работает в безопасной среде с облачными функциями .
Отправляйте уведомления с помощью Cloud Messaging .
Узнайте, когда и почему ваше приложение дает сбой, с помощью Crashlytics .