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

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

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

Предпосылки

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

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

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

  2. Выберите начальный режим для ваших правил безопасности Firebase:

    Режим тестирования

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

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

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

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

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

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

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

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

  4. Щелкните Готово .

Когда вы включаете базу данных в реальном времени, она также включает API в Cloud API Manager .

Добавьте базу данных Firebase Realtime в свое приложение

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

  1. В Xcode при открытом проекте приложения перейдите в File > Add Packages .
  2. При появлении запроса добавьте репозиторий SDK Firebase для платформ Apple:
    3.   https://github.com/firebase/firebase-ios-sdk
  3. Выберите библиотеку базы данных реального времени.
  4. Когда закончите, Xcode автоматически начнет разрешать и загружать ваши зависимости в фоновом режиме.

Настройка правил безопасности базы данных в реальном времени

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

Настроить базу данных Firebase в реальном времени

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

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

    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 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 . Вы также должны отключить swizzling делегата приложения. Дополнительные сведения см. в инструкциях 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];

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