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

Предпосылки

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

  • Xcode 12.2 или новее
  • CocoaPods 1.10.0 или новее

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

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

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

  Вы хотите использовать облачные сообщения?

  Для облачного обмена сообщениями на iOS выполните следующие действия:

  • Настройка физического устройства IOS.
  • Получить Push Notification Apple , Authentication Key для вашего счета компании Apple Developer .
  • Включить Push - уведомления в Xcode под App> Возможности.

• Войдите в Firebase , используя учетную запись Google.

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

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

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

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

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

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

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

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

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

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

   Что такое идентификатор пакета и где его найти?

   • Расслоение ID однозначно идентифицирует приложение в экосистеме Apple.

   • Найди расслоение ID: открой IOS проекта в Xcode, выберите приложение верхнего уровня в навигаторе проекта, а затем выберите вкладку Общие.

     Значение поля Пачка идентификатор КСН расслоение ID (например, com.yourcompany.yourproject ).

   • Имейте в виду, что значение идентификатора пакета чувствительно к регистру и не может быть изменено для этого приложения Firebase iOS после его регистрации в вашем проекте Firebase.

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

   Как прозвище App и App Store ID используется в Firebase?

   • App ник: внутренний, удобство идентификатор , который виден только вам в консоли Firebase

   • App Store ID: Используется Firebase Dynamic Ссылка на перенаправление пользователей на страницу App Store и Google Analytics для преобразования импорта событий в Google Ads . Если ваше приложение еще не имеет App Store ID, вы можете добавить идентификатор позже в ваших настройках проекта .

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

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

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

   Что вам нужно знать об этом файле конфигурации?

   • Конфигурационный файл Firebase содержит уникальные, но не секретные идентификаторы вашего проекта. Чтобы узнать больше об этом файле конфигурации, посетите Понимать Firebase проекты .

   • Вы можете загрузить конфигурационный файл Firebase снова в любое время.

   • Убедитесь , что имя файла конфигурации не добавляются с дополнительными символами, например , (2) .

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:

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

• Firebase IOS SDK GitHub репо

Интегрировать без 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 Проекты более узнать о проектах Firebase и передового опыта для проектов.

• Исследуйте примеры приложений Firebase .

• Получить практический опыт работы с Firebase IOS Codelab .

• Исследуйте открытый исходный код в GitHub .

• Подготовьтесь к запуску вашего приложения:

  • Настройка бюджета оповещения для вашего проекта в Google Cloud Console.
  • Мониторинг использования и биллинговую панель в Firebase консоли , чтобы получить общую картину использования вашего проекта через несколько сервисов Firebase.
  • Просмотрите стартовый контрольный Firebase .

• Возникли проблемы с Firebase и вашим проектом iOS? Посетите IOS поиска неисправностей & FAQ .

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

• Получить представление о поведении пользователей с Analytics .

• Настройка аутентификации пользователей с проверкой подлинности .

• Хранить данные, как пользовательской информации, с Cloud Firestore или в реальном времени базы данных .

• Храните файлы, например , фотографии и видео, с Cloud Storage .

• Триггер BACKEND код , который работает в защищенной среде с облачными функциями .

• Отправлять уведомления с Cloud Messaging .

• Узнайте, когда и почему ваше приложение рушится с Crashlytics .