Firebase Realtime Database — это база данных, размещенная в облаке. Данные хранятся в формате JSON и синхронизируются в реальном времени с каждым подключенным клиентом. Когда вы создаете кроссплатформенные приложения с помощью наших SDK для Android, iOS и JavaScript, все ваши клиенты используют один экземпляр Realtime Database и автоматически получают обновления с новейшими данными.
Firebase Realtime Database доступна на всех платформах Apple, включая iOS, macOS, macOS Catalyst, tvOS и watchOS. Он недоступен для клипов приложений. Инструкции по установке на этой странице ссылаются на iOS в конкретных примерах, но являются общими и подходят для любой целевой платформы Apple.
Предварительные условия
- Установите Firebase SDK .
- Добавьте свое приложение в проект Firebase в консоли Firebase .
Создать базу данных
Перейдите в раздел Realtime Database консоли Firebase . Вам будет предложено выбрать существующий проект Firebase. Следуйте рабочему процессу создания базы данных.
Выберите начальный режим для Firebase Security Rules :
- Тестовый режим
Подходит для начала работы с мобильными и веб-клиентскими библиотеками, но позволяет любому читать и перезаписывать ваши данные. После тестирования обязательно ознакомьтесь с разделом «Понимание правил базы данных Firebase Realtime» .
Чтобы начать работу с веб-SDK, Apple или Android SDK, выберите тестовый режим.
- Заблокированный режим
Запрещает все операции чтения и записи со стороны мобильных и веб-клиентов. Ваши аутентифицированные серверы приложений по-прежнему смогут получить доступ к вашей базе данных.
Выберите место для базы данных.
В зависимости от расположения базы данных URL-адрес новой базы данных будет иметь одну из следующих форм:
DATABASE_NAME .firebaseio.com
(для баз данных вus-central1
)DATABASE_NAME . REGION .firebasedatabase.app
(для баз данных во всех других местах)
Нажмите Готово .
Когда вы включаете Realtime Database , она также включает API в Cloud API Manager .
Добавьте Firebase Realtime Database в свое приложение
Используйте Swift Package Manager для установки зависимостей Firebase и управления ими.
- В Xcode, открыв проект приложения, выберите «Файл» > «Добавить пакеты» .
- При появлении запроса добавьте репозиторий SDK Firebase Apple для платформ:
- Выберите библиотеку Realtime Database .
- Добавьте флаг
-ObjC
в раздел «Другие флаги компоновщика» настроек сборки вашей цели. - По завершении Xcode автоматически начнет разрешать и загружать ваши зависимости в фоновом режиме.
https://github.com/firebase/firebase-ios-sdk.git
Настройка Realtime Database Security Rules
Realtime Database предоставляет язык декларативных правил, который позволяет вам определить, как ваши данные должны быть структурированы, как их следует индексировать и когда ваши данные можно читать и записывать.
Настройка Firebase Realtime Database
Вы должны инициализировать Firebase перед созданием или использованием какой-либо ссылки на приложение Firebase. Если вы уже сделали это для другой функции Firebase, вы можете пропустить этот шаг.
- Импортируйте модуль
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; // ...
- Настройте общий экземпляр
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];
- Если вы используете 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() } } } }
- Создайте ссылку на свою базу данных и укажите место, куда вы хотите записать.
Быстрый
Примечание. Этот продукт Firebase недоступен для цели App Clip.var ref: DatabaseReference! ref = Database.database().reference()
Цель-C
Примечание. Этот продукт Firebase недоступен для цели App Clip.@property (strong, nonatomic) FIRDatabaseReference *ref; self.ref = [[FIRDatabase database] reference];
Следующие шаги
Узнайте, как структурировать данные для Realtime Database .
Масштабируйте свои данные по нескольким экземплярам базы данных.
Подготовьтесь к запуску приложения:
Включите App Check , чтобы гарантировать, что только ваши приложения смогут получить доступ к вашим базам данных.
Настройте оповещения о бюджете для своего проекта в консоли Google Cloud .
Отслеживайте панель «Использование и выставление счетов» в консоли Firebase , чтобы получить общую картину использования вашего проекта в нескольких сервисах Firebase. Вы также можете посетить панель мониторинга использования Realtime Database для получения более подробной информации об использовании.
Ознакомьтесь с контрольным списком запуска Firebase .