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

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

Предпосылки

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

    • Xcode 12.2 или новее
    • CocoaPods 1.10.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.

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

Однако, если у вас возникли проблемы с настройкой, посетите раздел Устранение неполадок и часто задаваемые вопросы iOS .

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

В этом разделе перечислены продукты 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'
Облачные функции для клиентского 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 .

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

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

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

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

Узнайте больше об интеграции Swift Package Manager в нашем руководстве .

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

Узнайте о Firebase:

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