Google 致力于为黑人社区推动种族平等。查看具体举措。
Эта страница переведена с помощью Cloud Translation API.
Switch to English

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

Предпосылки

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

    • Xcode 12.0 или новее
    • CocoaPods 1.9.0 или новее

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

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

  • Настройте физическое устройство 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.

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

    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'

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

    pod install
    open your-project.xcworkspace

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

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

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

    Быстрый

    import Firebase

    Цель-C

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

    Быстрый

    // 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 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 .

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

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

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

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

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

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

Узнайте о Firebase:

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