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

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

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

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

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

Создайте базу данных

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

  2. Выберите режим запуска для ваших Firebase Security Rules :

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

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

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

    Режим блокировки

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

  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, открыв проект приложения, перейдите в меню File > Add Packages .
  2. При появлении запроса добавьте репозиторий Firebase Apple Platforms SDK: 
    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
// ...

    Objective-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()

    Objective-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()

    Objective-C

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

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

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