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

Если вы еще этого не сделали, добавьте Firebase в свой проект Android .

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

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

2. Выберите режим запуска для правил безопасности Firebase:

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

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

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

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

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

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

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

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

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

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

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

Добавьте SDK базы данных реального времени в свое приложение.

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:32.6.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")
}

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:20.3.0")
}

// Write a message to the database
val database = Firebase.database
val myRef = database.getReference("message")

myRef.setValue("Hello, World!")
MainActivity.kt

// Write a message to the database
FirebaseDatabase database = FirebaseDatabase.getInstance();
DatabaseReference myRef = database.getReference("message");

myRef.setValue("Hello, World!");
MainActivity.java

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

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

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

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

// Read from the database
myRef.addValueEventListener(object : ValueEventListener {
    override fun onDataChange(dataSnapshot: DataSnapshot) {
        // This method is called once with the initial value and again
        // whenever data at this location is updated.
        val value = dataSnapshot.getValue<String>()
        Log.d(TAG, "Value is: $value")
    }

    override fun onCancelled(error: DatabaseError) {
        // Failed to read value
        Log.w(TAG, "Failed to read value.", error.toException())
    }
})
MainActivity.kt

// Read from the database
myRef.addValueEventListener(new ValueEventListener() {
    @Override
    public void onDataChange(@NonNull DataSnapshot dataSnapshot) {
        // This method is called once with the initial value and again
        // whenever data at this location is updated.
        String value = dataSnapshot.getValue(String.class);
        Log.d(TAG, "Value is: " + value);
    }

    @Override
    public void onCancelled(@NonNull DatabaseError error) {
        // Failed to read value
        Log.w(TAG, "Failed to read value.", error.toException());
    }
});
MainActivity.java

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

При использовании базы данных Firebase Realtime в вашем приложении вместе с 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 и получите помощь от эксперта.

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

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

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

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

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