Установка и усиление; Настройка на платформах Apple

Firebase Realtime Database — это база данных, размещенная в облаке. Данные хранятся в формате JSON и синхронизируются в реальном времени с каждым подключенным клиентом. Когда вы создаете кроссплатформенные приложения с помощью наших SDK для Android, iOS и JavaScript, все ваши клиенты используют один экземпляр Realtime Database и автоматически получают обновления с новейшими данными.

Firebase Realtime Database доступна на всех платформах Apple, включая iOS, macOS, macOS Catalyst, tvOS и watchOS. Он недоступен для клипов приложений. Инструкции по установке на этой странице ссылаются на iOS в конкретных примерах, но являются общими и подходят для любой целевой платформы Apple.

Предварительные условия

  1. Установите Firebase SDK .
  2. Добавьте свое приложение в проект Firebase в консоли Firebase .

Создать базу данных

  1. Перейдите в раздел Realtime Database консоли Firebase . Вам будет предложено выбрать существующий проект Firebase. Следуйте рабочему процессу создания базы данных.

  2. Выберите начальный режим для Firebase Security Rules :

    Тестовый режим

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

    Чтобы начать работу с веб-SDK, Apple или Android SDK, выберите тестовый режим.

    Заблокированный режим

    Запрещает все операции чтения и записи со стороны мобильных и веб-клиентов. Ваши аутентифицированные серверы приложений по-прежнему смогут получить доступ к вашей базе данных.

  3. Выберите место для базы данных.

    В зависимости от расположения базы данных URL-адрес новой базы данных будет иметь одну из следующих форм:

    • DATABASE_NAME .firebaseio.com (для баз данных в us-central1 )

    • DATABASE_NAME . REGION .firebasedatabase.app (для баз данных во всех других местах)

  4. Нажмите Готово .

Когда вы включаете Realtime Database , она также включает API в Cloud API Manager .

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

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

  1. В Xcode, открыв проект приложения, выберите «Файл» > «Добавить пакеты» .
  2. При появлении запроса добавьте репозиторий Firebase SDK для платформ Apple: 
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Выберите библиотеку Realtime Database .
  4. Добавьте флаг -ObjC в раздел «Другие флаги компоновщика» настроек сборки вашей цели.
  5. По завершении Xcode автоматически начнет разрешать и загружать ваши зависимости в фоновом режиме.

Настройка Realtime Database Security Rules

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

Настройка Firebase Realtime Database

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

  1. Импортируйте модуль FirebaseCore в свой UIApplicationDelegate , а также любые другие модули Firebase, которые использует ваш делегат приложения. Например, чтобы использовать Cloud Firestore и Authentication :

    SwiftUI 

    import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Быстрый 

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Цель-C 

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. Настройте общий экземпляр FirebaseApp в методе application(_:didFinishLaunchingWithOptions:) делегата вашего приложения:

    SwiftUI 

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Быстрый 

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Цель-C 

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. Если вы используете SwiftUI, вам необходимо создать делегат приложения и прикрепить его к структуре вашего App через UIApplicationDelegateAdaptor или NSApplicationDelegateAdaptor . Вы также должны отключить переключение делегатов приложений. Дополнительную информацию смотрите в инструкциях SwiftUI .

    SwiftUI 

    @main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}
  4. Создайте ссылку на свою базу данных и укажите место, куда вы хотите записать.

    Быстрый

    Примечание. Этот продукт Firebase недоступен для цели App Clip. 
    var ref: DatabaseReference!

ref = Database.database().reference()

    Цель-C

    Примечание. Этот продукт Firebase недоступен для цели App Clip. 
    @property (strong, nonatomic) FIRDatabaseReference *ref;

self.ref = [[FIRDatabase database] reference];

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