Предпосылки
Установите следующее:
- Xcode 12.0 или новее
- CocoaPods 1.9.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.
Идентификатор App Store : используется Firebase Dynamic Links для перенаправления пользователей на страницу вашего App Store и Google Analytics для импорта событий конверсии в Google Ads . Если у вашего приложения еще нет идентификатора 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' | |
Облачные функции для 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 | 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 в свое приложение:
Узнайте о поведении пользователей с помощью Google Analytics .
Настройте аутентификацию пользователя с помощью аутентификации .
Храните данные, например информацию о пользователях, в Cloud Firestore или Realtime Database .
Храните файлы, например фотографии и видео, в облачном хранилище .
Запускайте бэкэнд-код, который работает в безопасной среде с облачными функциями .
Отправляйте уведомления с помощью Cloud Messaging .
Узнайте, когда и почему ваше приложение дает сбой, с помощью Crashlytics .