Instalação e configuração no Android

Conectar seu app ao Firebase

Adicione o Firebase ao projeto para Android, caso ainda não tenha feito isso.

No arquivo build.gradle no nível do projeto, inclua o repositório Maven do Google nas seções buildscript e allprojects.

Criar um banco de dados

  1. Crie um projeto do Firebase, caso ainda não tenha feito isso: no Console do Firebase, clique em Adicionar projeto e siga as instruções exibidas na tela para criar um projeto ou adicionar serviços do Firebase a um projeto atual do GCP.

  2. Acesse a seção Database do Console do Firebase. Aparecerá uma solicitação para selecionar um projeto atual do Firebase. Siga o fluxo de trabalho de criação do banco de dados.

  3. Selecione um modo inicial para suas regras de segurança do Firebase:

    Modo de teste

    Ideal para dar os primeiros passos com as bibliotecas de cliente de dispositivos móveis e Web. No entanto, esse modo permite que qualquer pessoa leia e modifique os dados. Após o teste, revise a seção Noções básicas das regras do Firebase Realtime Database.

    Selecione o modo de teste para começar a usar o SDK para Android, iOS ou da Web.

    Modo bloqueado

    Nega todas as leituras e gravações de clientes de dispositivos móveis e Web. Seus servidores de aplicativos autenticados ainda podem acessar seu banco de dados.

  4. Clique em Concluído.

Ao ativar o Realtime Database, também é ativada a API no Cloud API Manager.

Adicionar o SDK do Realtime Database ao seu app

Adicione a dependência da biblioteca Android do Realtime Database ao seu arquivo Gradle do módulo (nível do app) (geralmente app/build.gradle):

Java

implementation 'com.google.firebase:firebase-database:19.3.1'

Kotlin+KTX

implementation 'com.google.firebase:firebase-database-ktx:19.3.1'

Configurar as regras do Realtime Database

O Realtime Database oferece uma linguagem de regras declarativas para que você defina como os dados devem ser estruturados e indexados, e quando podem ser lidos e gravados.

Por padrão, o acesso de leitura e gravação ao seu banco de dados é restrito. Por isso, apenas usuários autenticados podem ler ou gravar dados. Para iniciar sem configurar o Authentication, defina as regras para acesso público. Isso faz com que o banco de dados fique disponível para qualquer pessoa, mesmo para quem não utiliza seu app. Por isso, restrinja o banco de dados novamente quando configurar a autenticação.

Gravar no seu banco de dados

Recupere uma instância do banco de dados usando getInstance() e faça referência ao local onde você quer gravar.

Java

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

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

Kotlin+KTX

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

myRef.setValue("Hello, World!")

É possível salvar diversos tipos de dados no banco de dados dessa maneira, incluindo objetos Java. Ao salvar um objeto, as respostas de qualquer coletor serão salvas como filhos do local.

Ler no seu banco de dados

Para que os dados do app sejam atualizados em tempo real, adicione um ValueEventListener à referência que você acabou de criar.

O método onDataChange() será acionado uma vez quando o listener for anexado, e sempre que houver alteração nos dados, inclusive nos filhos.

Java

// Read from the database
myRef.addValueEventListener(new ValueEventListener() {
    @Override
    public void onDataChange(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(DatabaseError error) {
        // Failed to read value
        Log.w(TAG, "Failed to read value.", error.toException());
    }
});

Kotlin+KTX

// 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())
    }
})

Opcional: configurar o ProGuard

Ao usar o Firebase Realtime Database e o ProGuard no seu app, pense em como os objetos do modelo serão serializados e desserializados após a ofuscação. Se você usar <DataSnapshot.getValue(Class) ou DatabaseReference.setValue(Object) para ler e gravar dados, será preciso adicionar regras ao arquivo 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 to fit the structure
    # of your app.
    -keepclassmembers class com.yourcompany.models.** {
      *;
    }

Preparar para lançamento

Antes de lançar o app, recomendamos revisar nossa lista de verificação de lançamento para garantir que o app esteja pronto.

Próximas etapas