Catch up on everthing we announced at this year's Firebase Summit. Learn more

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

Предпосылки

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

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

    • Ваш проект должен быть нацелен на эти версии платформы или более поздние версии:
      • iOS 10
      • macOS 10.12
      • tvOS 12
      • watchOS 6
  • Настройте физическое устройство Apple или используйте симулятор для запуска вашего приложения.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Используйте Swift Package Manager для установки и управления зависимостями Firebase.

  1. В Xcode, с приложением проекта открыто, перейдите в меню Файл> Swift пакеты> Добавить пакет Завис.
  2. При появлении запроса добавьте репозиторий Firebase Apple Platform SDK:
  3.   https://github.com/firebase/firebase-ios-sdk
      
  4. Выберите версию SDK, которую хотите использовать.
  5. Выберите библиотеки Firebase, которые хотите использовать.

    Если Google Analytics включен в вашем проекте Firebase, убедитесь , чтобы добавить FirebaseAnalytics . Для Analytics без возможности сбора IDFA, добавить FirebaseAnalyticsWithoutAdId вместо этого.

По завершении Xcode автоматически начнет разрешение и загрузку ваших зависимостей в фоновом режиме.

Шаг 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 SDK для Google Analytics, вы можете запустить свое приложение, чтобы отправить в консоль Firebase подтверждение того, что вы успешно установили Firebase.

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

Если у вас возникли проблемы при получении настройки, хотя, посетить платформы Apple , для устранения проблем и FAQ .

Доступные библиотеки

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

  • Справочная документация ( Swift | Obj-C )

  • Firebase компании Apple платформы SDK GitHub репо

Услуга или продукт Стручки Библиотеки SwiftPM Добавить аналитику?
AdMob pod 'Google-Mobile-Ads-SDK' N / A
Аналитика pod 'Firebase/Analytics' FirebaseAnalytics
Проверка приложения pod 'Firebase/AppCheck' FirebaseAppCheck
Распространение приложений pod 'Firebase/AppDistribution' FirebaseAppDistribution
Аутентификация pod 'Firebase/Auth' FirebaseAuth
Cloud Firestore pod 'Firebase/Firestore' FirebaseFirestore
Облачные функции для клиентского SDK Firebase pod 'Firebase/Functions' FirebaseFunctions
Обмен сообщениями в облаке pod 'Firebase/Messaging' FirebaseMessaging
Облачное хранилище pod 'Firebase/Storage' FirebaseStorage
Crashlytics pod 'Firebase/Crashlytics' FirebaseCrashlytics
Динамические ссылки pod 'Firebase/DynamicLinks' FirebaseDynamicLinks
Обмен сообщениями в приложении pod 'Firebase/InAppMessaging' FirebaseInAppMessaging
(требуется)
Установки Firebase pod 'Firebase/Installations' FirebaseInstallations
API пользовательских моделей Firebase ML pod 'Firebase/MLModelDownloader' FirebaseMLModelDownloader
Мониторинг производительности pod 'Firebase/Performance' FirebasePerformance
База данных в реальном времени pod 'Firebase/Database' FirebaseDatabase
Удаленная конфигурация pod 'Firebase/RemoteConfig' FirebaseRemoteConfig

Интегрируйте без диспетчера зависимостей

Если вы не хотите использовать Swift Package Manager, вы все равно можете воспользоваться пакетами Firebase SDK, импортировав фреймворки напрямую или используя CocoaPods.

Каркасы

В дополнение к поддержке платформы IOS, почтовый теперь включает .xcframework файлы. Для получения дополнительной информации см платформы Firebase компании Apple SDK README на GitHub .

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

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

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

Какао-стручки

Подробнее об интеграции CocoaPods в нашем руководстве .

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

Узнайте о Firebase:

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