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

Предпосылки

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

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

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

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

Шаг 1: Создание проекта Firebase

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

Шаг 2: Регистрация приложения с Firebase

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

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

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

  2. В центре главной страницы проекта, нажмите на значок IOS ( ) , чтобы запустить рабочий процесс установки.

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

  3. Введите расслоение идентификатор приложения в прошивкой пачке ID поля.

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

  5. Выберите Зарегистрировать приложение.

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

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

  2. Переместите файл конфигурации в корень вашего проекта Xcode. При появлении запроса выберите добавление файла конфигурации ко всем целевым объектам.

Если у вас есть несколько идентификаторов в пачке вашего проекта, вы должны связать каждый пучок ID с зарегистрированным приложением в консоли Firebase так , что каждое приложение может иметь свой собственный GoogleService-Info.plist файл.

Шаг 4: Добавить Firebase SDKs в приложении

Мы рекомендуем использовать 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' # For Analytics without IDFA collection capability, use this pod instead # pod ‘Firebase/AnalyticsWithoutAdIdSupport’ # 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'

    Узнайте больше о IDFA, рекламного идентификатора устройства уровня, в компании Apple пользователей Конфиденциальность и использование данных и приложений отслеживания прозрачности документации.

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

    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 файл , чтобы увидеть проект в Xcode:

    pod install
    open your-project.xcworkspace

Шаг 5: Инициализировать Firebase в вашем приложении

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

  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 поиск неисправности & FAQ .

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

В этом разделе перечислены продукты Firebase, поддерживаемые для iOS и их модулей. Узнайте больше об этих библиотеках Firebase iOS:

Услуга или продукт Стручки Добавить аналитику?
AdMob pod 'Google-Mobile-Ads-SDK'
Аналитика pod 'Firebase/Analytics'
Проверка приложений pod 'Firebase/AppCheck'
Распространение приложений pod 'Firebase/AppDistribution'
Аутентификация pod 'Firebase/Auth'
Cloud Firestore pod 'Firebase/Firestore'
Облачные функции для клиентского SDK Firebase pod 'Firebase/Functions'
Обмен сообщениями в облаке pod 'Firebase/Messaging'
Облачное хранилище pod 'Firebase/Storage'
Crashlytics pod 'Firebase/Crashlytics'
Динамические ссылки pod 'Firebase/DynamicLinks'
Обмен сообщениями в приложении pod 'Firebase/InAppMessaging'
(обязательный)
Установки Firebase pod 'Firebase/Installations'
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 от сообщества. Более подробную информацию см в Firebase IOS SDK README на GitHub .

  1. Скачать рамки SDK почтовый индекс . Это файл размером ~ 200 МБ, и его загрузка может занять некоторое время.

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

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

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

Подробнее об интеграции Swift Package Manager , в нашем руководстве .

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

Узнайте о Firebase:

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