Подключите свое приложение к Firebase

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

1. Перейдите в раздел Realtime Databaseконсоли Firebase . Вам будет предложено выбрать существующий проект Firebase. Следуйте рабочему процессу создания базы данных.
2. Выберите начальный режим для Firebase Security Rules : Тестовый режим Подходит для начала работы с мобильными и веб-клиентскими библиотеками, но позволяет любому читать и перезаписывать ваши данные. После тестирования обязательно ознакомьтесь с разделом «Понимание правил базы данных Firebase Realtime» .Примечание. Если вы создадите базу данных в тестовом режиме и не внесете никаких изменений в Rules доступные для чтения и записи по умолчанию, в течение пробного периода, вы получите предупреждение по электронной почте, а затем правила вашей базы данных будут отклонять все запросы. Обратите внимание на дату истечения срока действия во время настройки консоли Firebase . Чтобы начать работу с веб-SDK, Apple или Android SDK, выберите тестовый режим. Заблокированный режим Запрещает все операции чтения и записи со стороны мобильных и веб-клиентов. Ваши аутентифицированные серверы приложений по-прежнему смогут получить доступ к вашей базе данных.
3. Выберите место для базы данных. В зависимости от расположения базы данных URL-адрес новой базы данных будет иметь одну из следующих форм:
   • DATABASE_NAME .firebaseio.com (для баз данных в us-central1 )
   • DATABASE_NAME . REGION .firebasedatabase.app (для баз данных во всех других местах)
4. Нажмите Готово .

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

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

В файле Gradle вашего модуля (на уровне приложения) (обычно //build.gradle.kts или //build.gradle ) добавьте зависимость для Realtime Database библиотека для Android. Мы рекомендуем использовать Firebase Android BoM для управления версиями библиотеки.

dependencies  // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.2.0")) // Add the dependency for the Realtime Database library // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-database") >

Используя Firebase Android BoM , ваше приложение всегда будет использовать совместимые версии библиотек Firebase Android.

(Альтернатива) Добавить зависимости библиотеки Firebase без использования BoM

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

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

dependencies  // Add the dependency for the Realtime Database library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-database:21.0.0") >

Ищете библиотечный модуль, специфичный для Kotlin? Начиная с октября 2023 года ( Firebase BoM 32.5.0) от основного модуля библиотеки могут зависеть как разработчики Kotlin, так и Java (подробнее см. FAQ по этой инициативе ).

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

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

Примечание. По умолчанию доступ к базе данных для чтения и записи ограничен, поэтому только прошедшие проверку подлинности пользователи могут читать и записывать данные. Чтобы начать работу без настройки Authentication , вы можете настроить свои правила для публичного доступа . Это делает вашу базу данных открытой для всех, даже для людей, не использующих ваше приложение, поэтому обязательно снова ограничьте свою базу данных при настройке аутентификации.

Напишите в свою базу данных

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

Важно ! Чтобы получить ссылку на базу данных, отличную от базы данных us-central1 по умолчанию, вы должны передать URL-адрес базы данных в getInstance() (или для database() ). Для базы данных по умолчанию us-central1 вы можете вызвать getInstance() (или database ) без аргументов.

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

• https:// DATABASE_NAME .firebaseio.com (для баз данных в us-central1 )
• https:// DATABASE_NAME . REGION .firebasedatabase.app (для баз данных во всех других местах)

Kotlin+KTX

Java

Таким образом вы можете сохранить в базе данных различные типы данных, включая объекты Java. Когда вы сохраняете объект, ответы от любых геттеров будут сохранены как дочерние элементы этого местоположения.

Чтение из вашей базы данных

Чтобы данные вашего приложения обновлялись в реальном времени, вам следует добавить ValueEventListener к только что созданной ссылке. Метод onDataChange() в этом классе запускается один раз при подключении прослушивателя и снова при каждом изменении данных, включая дочерние элементы.

Kotlin+KTX

Java

Необязательно: Настройте ProGuard

При использовании Firebase Realtime Database в вашем приложении вместе с ProGuard вам необходимо учитывать, как объекты вашей модели будут сериализоваться и десериализоваться после обфускации. Если вы используете DataSnapshot.getValue(Class) или DatabaseReference.setValue(Object) для чтения и записи данных, вам нужно будет добавить правила в файл proguard-rules.pro :

 # Add this global rule -keepattributes Signature # This rule will properly ProGuard all the model classes in # the package com.yourcompany.models. # Modify this rule to fit the structure of your app. -keepclassmembers class com.yourcompany.models.**  *; > 

Чтобы получить помощь по вопросам или проблемам, связанным с ProGuard, посетите форумы сообщества Guardsquare и получите помощь от эксперта.

Подготовьтесь к запуску

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

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

• Узнайте, как структурировать данные для Realtime Database
• Масштабируйте данные по нескольким экземплярам базы данных .
• Чтение и запись данных .
• Просмотрите свою базу данных в консоли Firebase .

Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.

Последнее обновление: 2024-09-12 UTC.