Firebase Android Codelab - Crie um bate-papo amigável

1. Visão Geral

captura de tela

Imagem: aplicativo de bate-papo amigável de trabalho.

Bem-vindo ao codelab do Friendly Chat. Neste codelab, você aprenderá a usar a plataforma Firebase para criar um app de chat no Android.

O que você aprenderá

  • Como usar o Firebase Authentication para permitir que os usuários façam login.
  • Como sincronizar dados usando o Firebase Realtime Database.
  • Como armazenar arquivos binários no Cloud Storage para Firebase.
  • Como usar o Firebase Local Emulator Suite para desenvolver um aplicativo Android com o Firebase.

O que você precisará

  • Última versão do Android Studio .
  • Um emulador Android com Android 5.0+.
  • Node.js versão 10 ou superior (para usar o Emulator Suite).
  • Java 8 ou superior. Para instalar o Java, use estas instruções ; para verificar sua versão, execute java -version .
  • Familiaridade com a linguagem de programação Kotlin.

2. Obtenha o código de amostra

Clonar o repositório

Clone o repositório GitHub na linha de comando:

$ git clone https://github.com/firebase/codelab-friendlychat-android

Importar para o Android Studio

No Android Studio, selecione Arquivo > Abrir e selecione o diretório build-android-start ( android_studio_folder ) do diretório onde você baixou o código de exemplo.

Agora você deve ter o projeto build-android-start aberto no Android Studio. Se você vir um aviso sobre a falta de um arquivo google-services.json , não se preocupe. Ele será adicionado em uma etapa posterior.

Verifique as dependências

Neste codelab, todas as dependências necessárias já foram adicionadas, mas é importante entender como adicionar o Firebase SDK ao seu app:

build.gradle.kts

plugins {
    id("com.android.application") version "8.0.0" apply false
    id("com.android.library") version "8.0.0" apply false
    id("org.jetbrains.kotlin.android") version "1.8.20" apply false

    // The google-services plugin is required to parse the google-services.json file
    id("com.google.gms.google-services") version "4.3.15" apply false
}

app/build.gradle.kts

plugins {
    id("com.android.application")
    id("kotlin-android")
    id("com.google.gms.google-services")
}

android {
    // ...
}

dependencies {
    // ...

    // Google Sign In SDK
    implementation("com.google.android.gms:play-services-auth:20.5.0")

    // Firebase SDK
    implementation(platform("com.google.firebase:firebase-bom:32.0.0"))
    implementation("com.google.firebase:firebase-database-ktx")
    implementation("com.google.firebase:firebase-storage-ktx")
    implementation("com.google.firebase:firebase-auth-ktx")

    // Firebase UI Library
    implementation("com.firebaseui:firebase-ui-auth:8.0.2")
    implementation("com.firebaseui:firebase-ui-database:8.0.2")
}

3. Instale o Firebase CLI

Neste codelab, você usará o Firebase Emulator Suite para emular localmente o Firebase Auth, o Realtime Database e o Cloud Storage. Isso fornece um ambiente de desenvolvimento local seguro, rápido e gratuito para criar seu aplicativo.

Instale a CLI do Firebase

Primeiro você precisará instalar o Firebase CLI . Se você estiver usando macOS ou Linux, poderá executar o seguinte comando cURL:

curl -sL https://firebase.tools | bash

Se você estiver usando o Windows, leia as instruções de instalação para obter um binário autônomo ou para instalar via npm .

Depois de instalar a CLI, executar firebase --version deve relatar uma versão de 9.0.0 ou superior:

$ firebase --version
9.0.0

Conecte-se

Execute firebase login para conectar a CLI à sua conta do Google. Isso abrirá uma nova janela do navegador para concluir o processo de login. Certifique-se de escolher a mesma conta que você usou ao criar seu projeto do Firebase anteriormente.

4. Conecte-se ao Firebase Emulator Suite

Iniciar os emuladores

Em seu terminal, execute o seguinte comando na raiz do diretório codelab-friendlychat-android local:

firebase emulators:start --project=demo-friendlychat-android

Você deve ver alguns logs como este. Os valores de porta foram definidos no arquivo firebase.json , que foi incluído no código de exemplo clonado.

$ firebase emulators:start --project=demo-friendlychat-android
i  emulators: Starting emulators: auth, database, storage
i  emulators: Detected demo project ID "demo-friendlychat-android", emulated services will use a demo configuration and attempts to access non-emulated services for this project will fail.
i  database: Database Emulator logging to database-debug.log
i  ui: Emulator UI logging to ui-debug.log

┌─────────────────────────────────────────────────────────────┐
│ ✔  All emulators ready! It is now safe to connect your app. │
│ i  View Emulator UI at http://localhost:4000                │
└─────────────────────────────────────────────────────────────┘

┌────────────────┬────────────────┬────────────────────────────────┐
│ Emulator       │ Host:Port      │ View in Emulator UI            │
├────────────────┼────────────────┼────────────────────────────────┤
│ Authentication │ localhost:9099 │ http://localhost:4000/auth     │
├────────────────┼────────────────┼────────────────────────────────┤
│ Database       │ localhost:9000 │ http://localhost:4000/database │
├────────────────┼────────────────┼────────────────────────────────┤
│ Storage        │ localhost:9199 │ http://localhost:4000/storage  │
└────────────────┴────────────────┴────────────────────────────────┘
  Emulator Hub running at localhost:4400
  Other reserved ports: 4500

Issues? Report them at https://github.com/firebase/firebase-tools/issues and attach the *-debug.log files.

Navegue até http://localhost:4000 em seu navegador da Web para visualizar a interface do usuário do Firebase Emulator Suite:

Página inicial da interface do usuário do emulador Suite

Deixe o emulators:start em execução pelo restante do codelab.

Conecte seu aplicativo

No Android Studio, abra MainActivity.kt e adicione o seguinte código dentro do método onCreate :

// When running in debug mode, connect to the Firebase Emulator Suite.
// "10.0.2.2" is a special IP address which allows the Android Emulator
// to connect to "localhost" on the host computer. The port values (9xxx)
// must match the values defined in the firebase.json file.
if (BuildConfig.DEBUG) {
    Firebase.database.useEmulator("10.0.2.2", 9000)
    Firebase.auth.useEmulator("10.0.2.2", 9099)
    Firebase.storage.useEmulator("10.0.2.2", 9199)
}

5. Execute o aplicativo inicial

Adicionar google-services.json

Para que seu aplicativo Android se conecte ao Firebase, você deve adicionar um arquivo google-services.json dentro da pasta app do seu projeto Android. Para este codelab, fornecemos um arquivo JSON fictício que permitirá que você se conecte ao Firebase Emulator Suite.

Copie o arquivo mock-google-services.json para a pasta build-android-start/app como google-services.json :

cp mock-google-services.json build-android-start/app/google-services.json

Na etapa final deste codelab, você aprenderá a criar um projeto Firebase real e um aplicativo Android Firebase para substituir esse arquivo JSON fictício por sua própria configuração.

Execute o aplicativo

Agora que você importou o projeto para o Android Studio e adicionou um arquivo JSON de configuração do Firebase, está pronto para executar o aplicativo pela primeira vez.

  1. Inicie seu emulador Android.
  2. No Android Studio, clique em Executar ( executar ) na barra de ferramentas.

O aplicativo deve ser iniciado em seu emulador Android. Neste ponto, você deve ver uma lista de mensagens vazia e enviar e receber mensagens não funcionará. Na próxima etapa deste codelab, você autenticará os usuários para que eles possam usar o Friendly Chat.

6. Habilite a Autenticação

Este aplicativo usará o Firebase Realtime Database para armazenar todas as mensagens de bate-papo. Antes de adicionar dados, no entanto, devemos garantir que o aplicativo seja seguro e que apenas usuários autenticados possam postar mensagens. Nesta etapa, habilitaremos o Firebase Authentication e configuraremos as regras de segurança do Realtime Database.

Adicionar funcionalidade básica de login

Em seguida, adicionaremos um código básico do Firebase Authentication ao aplicativo para detectar usuários e implementar uma tela de login.

Verifique o usuário atual

Primeiro adicione a seguinte variável de instância à classe MainActivity.kt :

MainActivity.kt

// Firebase instance variables
private lateinit var auth: FirebaseAuth

Agora vamos modificar MainActivity para enviar o usuário para a tela de login sempre que ele abrir o aplicativo e não estiver autenticado. Adicione o seguinte ao método onCreate() depois que a binding for anexada à exibição:

MainActivity.kt

// Initialize Firebase Auth and check if the user is signed in
auth = Firebase.auth
if (auth.currentUser == null) {
    // Not signed in, launch the Sign In activity
    startActivity(Intent(this, SignInActivity::class.java))
    finish()
    return
}

Também queremos verificar se o usuário está conectado durante onStart() :

MainActivity.kt

public override fun onStart() {
    super.onStart()
    // Check if user is signed in.
    if (auth.currentUser == null) {
        // Not signed in, launch the Sign In activity
        startActivity(Intent(this, SignInActivity::class.java))
        finish()
        return
    }
}

Em seguida, implemente os métodos getUserPhotoUrl() e getUserName() para retornar as informações apropriadas sobre o usuário do Firebase autenticado no momento:

MainActivity.kt

private fun getPhotoUrl(): String? {
    val user = auth.currentUser
    return user?.photoUrl?.toString()
}

private fun getUserName(): String? {
    val user = auth.currentUser
    return if (user != null) {
        user.displayName
    } else ANONYMOUS
}

Em seguida, implemente o método signOut() para lidar com o botão sair:

MainActivity.kt

private fun signOut() {
    AuthUI.getInstance().signOut()
    startActivity(Intent(this, SignInActivity::class.java))
    finish()
}

Agora temos toda a lógica para enviar o usuário para a tela de login quando necessário. Em seguida, precisamos implementar a tela de login para autenticar os usuários corretamente.

Implementar a tela de login

Abra o arquivo SignInActivity.kt . Aqui, um simples botão de login é usado para iniciar a autenticação. Nesta seção, você usará FirebaseUI para implementar a lógica de login.

Adicione uma variável de instância Auth na classe SignInActivity sob o comentário // Firebase instance variables :

SignInActivity.kt

// Firebase instance variables
private lateinit var auth: FirebaseAuth

Em seguida, edite o método onCreate() para inicializar o Firebase da mesma forma que você fez em MainActivity :

SignInActivity.kt

// Initialize FirebaseAuth
auth = Firebase.auth

Adicione um campo ActivityResultLauncher a SignInActivity :

SignInActivity.kt

// ADD THIS
private val signIn: ActivityResultLauncher<Intent> =
        registerForActivityResult(FirebaseAuthUIActivityResultContract(), this::onSignInResult)

override fun onCreate(savedInstanceState: Bundle?) {
    // ...
}

Em seguida, edite o método onStart() para iniciar o fluxo de login do FirebaseUI:

SignInActivity.kt

public override fun onStart() {
    super.onStart()

    // If there is no signed in user, launch FirebaseUI
    // Otherwise head to MainActivity
    if (Firebase.auth.currentUser == null) {
        // Sign in with FirebaseUI, see docs for more details:
        // https://firebase.google.com/docs/auth/android/firebaseui
        val signInIntent = AuthUI.getInstance()
                .createSignInIntentBuilder()
                .setLogo(R.mipmap.ic_launcher)
                .setAvailableProviders(listOf(
                        AuthUI.IdpConfig.EmailBuilder().build(),
                        AuthUI.IdpConfig.GoogleBuilder().build(),
                ))
                .build()

        signIn.launch(signInIntent)
    } else {
        goToMainActivity()
    }
}

Em seguida, implemente o método onSignInResult para lidar com o resultado do login. Se o resultado do login for bem-sucedido, continue em MainActivity :

SignInActivity.kt

private fun onSignInResult(result: FirebaseAuthUIAuthenticationResult) {
    if (result.resultCode == RESULT_OK) {
        Log.d(TAG, "Sign in successful!")
        goToMainActivity()
    } else {
        Toast.makeText(
                this,
                "There was an error signing in",
                Toast.LENGTH_LONG).show()

        val response = result.idpResponse
        if (response == null) {
            Log.w(TAG, "Sign in canceled")
        } else {
            Log.w(TAG, "Sign in error", response.error)
        }
    }
}

É isso! Você implementou a autenticação com FirebaseUI em apenas algumas chamadas de método e sem precisar gerenciar nenhuma configuração do lado do servidor.

Teste seu trabalho

Execute o aplicativo em seu emulador Android. Você deve ser enviado imediatamente para a tela de login. Toque no botão Entrar com e-mail e crie uma conta. Se tudo for implementado corretamente, você deve ser enviado para a tela de mensagens.

Depois de fazer login, abra a interface do usuário do Firebase Emulator Suite em seu navegador e clique na guia Authentication para ver a primeira conta de usuário conectada.

7. Leia as mensagens

Nesta etapa, adicionaremos funcionalidade para ler e exibir mensagens armazenadas no Realtime Database.

Importar mensagens de amostra

  1. Na interface do usuário do Firebase Emulator Suite, selecione a guia Realtime Database .
  2. Arraste e solte o arquivo initial_messages.json de sua cópia local do repositório codelab no visualizador de dados.

Agora você deve ter algumas mensagens sob o nó messages do banco de dados.

Ler dados

Sincronizar mensagens

Nesta seção, adicionamos o código que sincroniza as mensagens recém-adicionadas à interface do usuário do aplicativo:

  • Inicializando o Firebase Realtime Database e adicionando um ouvinte para lidar com as alterações feitas nos dados.
  • Atualizando o adaptador RecyclerView para que novas mensagens sejam mostradas.
  • Adicionando as variáveis ​​de instância do banco de dados com suas outras variáveis ​​de instância do Firebase na classe MainActivity :

MainActivity.kt

// Firebase instance variables
// ...
private lateinit var db: FirebaseDatabase
private lateinit var adapter: FriendlyMessageAdapter

Modifique o método onCreate() de sua MainActivity no comentário // Initialize Realtime Database and FirebaseRecyclerAdapter com o código definido abaixo. Esse código adiciona todas as mensagens existentes do Realtime Database e, em seguida, escuta as novas entradas filhas no caminho messages em seu Firebase Realtime Database. Ele adiciona um novo elemento à interface do usuário para cada mensagem:

MainActivity.kt

// Initialize Realtime Database
db = Firebase.database
val messagesRef = db.reference.child(MESSAGES_CHILD)

// The FirebaseRecyclerAdapter class and options come from the FirebaseUI library
// See: https://github.com/firebase/FirebaseUI-Android
val options = FirebaseRecyclerOptions.Builder<FriendlyMessage>()
    .setQuery(messagesRef, FriendlyMessage::class.java)
    .build()
adapter = FriendlyMessageAdapter(options, getUserName())
binding.progressBar.visibility = ProgressBar.INVISIBLE
manager = LinearLayoutManager(this)
manager.stackFromEnd = true
binding.messageRecyclerView.layoutManager = manager
binding.messageRecyclerView.adapter = adapter

// Scroll down when a new message arrives
// See MyScrollToBottomObserver for details
adapter.registerAdapterDataObserver(
    MyScrollToBottomObserver(binding.messageRecyclerView, adapter, manager)
)

Em seguida, na classe FriendlyMessageAdapter.kt , implemente o método bind() dentro da classe interna MessageViewHolder() :

FriendlyMessageAdapter.kt

inner class MessageViewHolder(private val binding: MessageBinding) : ViewHolder(binding.root) {
    fun bind(item: FriendlyMessage) {
        binding.messageTextView.text = item.text
        setTextColor(item.name, binding.messageTextView)

        binding.messengerTextView.text = if (item.name == null) ANONYMOUS else item.name
        if (item.photoUrl != null) {
            loadImageIntoView(binding.messengerImageView, item.photoUrl!!)
        } else {
            binding.messengerImageView.setImageResource(R.drawable.ic_account_circle_black_36dp)
        }
    }
    ...
}

Também precisamos exibir mensagens que são imagens, então também implemente o método bind() dentro da classe interna ImageMessageViewHolder() :

FriendlyMessageAdapter.kt

inner class ImageMessageViewHolder(private val binding: ImageMessageBinding) :
    ViewHolder(binding.root) {
    fun bind(item: FriendlyMessage) {
        loadImageIntoView(binding.messageImageView, item.imageUrl!!)

        binding.messengerTextView.text = if (item.name == null) ANONYMOUS else item.name
        if (item.photoUrl != null) {
            loadImageIntoView(binding.messengerImageView, item.photoUrl!!)
        } else {
            binding.messengerImageView.setImageResource(R.drawable.ic_account_circle_black_36dp)
        }
    }
}

Por fim, de volta a MainActivity , comece e pare de ouvir as atualizações do Firebase Realtime Database. Atualize os métodos onPause() e onResume() em MainActivity conforme mostrado abaixo:

MainActivity.kt

public override fun onPause() {
    adapter.stopListening()
    super.onPause()
}

public override fun onResume() {
    super.onResume()
    adapter.startListening()
}

Testar sincronização de mensagens

  1. Clique em Executar ( executar ).
  2. Na IU do Emulator Suite, retorne à guia Realtime Database e adicione manualmente uma nova mensagem. Confirme se a mensagem aparece no seu aplicativo Android:

Parabéns, você acabou de adicionar um banco de dados em tempo real ao seu aplicativo!

8. Enviar mensagens

Implemente o envio de mensagens de texto

Nesta seção, você adicionará a capacidade de os usuários do aplicativo enviarem mensagens de texto. O trecho de código abaixo escuta os eventos de clique no botão enviar, cria um novo objeto FriendlyMessage com o conteúdo do campo de mensagem e envia a mensagem para o banco de dados. O método push() adiciona um ID gerado automaticamente ao caminho do objeto enviado. Esses IDs são sequenciais, o que garante que as novas mensagens sejam adicionadas ao final da lista.

Atualize o ouvinte de clique do botão enviar no método onCreate() na classe MainActivity . Este código já está na parte inferior do método onCreate() . Atualize o corpo onClick() para corresponder ao código abaixo:

MainActivity.kt

// Disable the send button when there's no text in the input field
// See MyButtonObserver for details
binding.messageEditText.addTextChangedListener(MyButtonObserver(binding.sendButton))

// When the send button is clicked, send a text message
binding.sendButton.setOnClickListener {
    val friendlyMessage = FriendlyMessage(
        binding.messageEditText.text.toString(),
        getUserName(),
        getPhotoUrl(),
        null /* no image */
    )
    db.reference.child(MESSAGES_CHILD).push().setValue(friendlyMessage)
    binding.messageEditText.setText("")
}

Implementar o envio de mensagem de imagem

Nesta seção, você adicionará a capacidade de os usuários do aplicativo enviarem mensagens de imagem. A criação de uma mensagem de imagem é feita com estas etapas:

  • Selecione a imagem
  • Lidar com a seleção de imagens
  • Gravar mensagem de imagem temporária no Realtime Database
  • Comece a enviar a imagem selecionada
  • Atualize o URL da mensagem de imagem para o da imagem carregada, assim que o upload for concluído

Selecione a imagem

Para adicionar imagens, este codelab usa o Cloud Storage para Firebase. Cloud Storage é um bom lugar para armazenar os dados binários do seu aplicativo.

Lidar com a seleção de imagens e escrever uma mensagem temporária

Depois que o usuário seleciona uma imagem, a Intent de seleção de imagem é iniciada. Isso já está implementado no código no final do método onCreate() . Ao terminar, ele chama o método onImageSelected() de MainActivity . Usando o trecho de código abaixo, você escreverá uma mensagem com um URL de imagem temporária no banco de dados indicando que a imagem está sendo carregada.

MainActivity.kt

private fun onImageSelected(uri: Uri) {
    Log.d(TAG, "Uri: $uri")
    val user = auth.currentUser
    val tempMessage = FriendlyMessage(null, getUserName(), getPhotoUrl(), LOADING_IMAGE_URL)
    db.reference
            .child(MESSAGES_CHILD)
            .push()
            .setValue(
                    tempMessage,
                    DatabaseReference.CompletionListener { databaseError, databaseReference ->
                        if (databaseError != null) {
                            Log.w(
                                    TAG, "Unable to write message to database.",
                                    databaseError.toException()
                            )
                            return@CompletionListener
                        }

                        // Build a StorageReference and then upload the file
                        val key = databaseReference.key
                        val storageReference = Firebase.storage
                                .getReference(user!!.uid)
                                .child(key!!)
                                .child(uri.lastPathSegment!!)
                        putImageInStorage(storageReference, uri, key)
                    })
}

Carregar imagem e atualizar mensagem

Adicione o método putImageInStorage() a MainActivity . É chamado em onImageSelected() para iniciar o upload da imagem selecionada. Assim que o upload for concluído, você atualizará a mensagem para usar a imagem apropriada.

MainActivity.kt

private fun putImageInStorage(storageReference: StorageReference, uri: Uri, key: String?) {
    // First upload the image to Cloud Storage
    storageReference.putFile(uri)
        .addOnSuccessListener(
            this
        ) { taskSnapshot -> // After the image loads, get a public downloadUrl for the image
            // and add it to the message.
            taskSnapshot.metadata!!.reference!!.downloadUrl
                .addOnSuccessListener { uri ->
                    val friendlyMessage =
                        FriendlyMessage(null, getUserName(), getPhotoUrl(), uri.toString())
                    db.reference
                        .child(MESSAGES_CHILD)
                        .child(key!!)
                        .setValue(friendlyMessage)
                }
        }
        .addOnFailureListener(this) { e ->
            Log.w(
                TAG,
                "Image upload task was unsuccessful.",
                e
            )
        }
}

Teste o envio de mensagens

  1. No Android Studio, clique no botão executar botão Executar .
  2. No emulador do Android, digite uma mensagem e toque no botão enviar. A nova mensagem deve estar visível na IU do aplicativo e na IU do Firebase Emulator Suite.
  3. No Android Emulator, toque na imagem "+" para selecionar uma imagem do seu dispositivo. A nova mensagem deve ser visível primeiro com uma imagem de espaço reservado e, em seguida, com a imagem selecionada após a conclusão do upload da imagem. A nova mensagem também deve estar visível na interface do usuário do Emulator Suite, especificamente como um objeto na guia Realtime Database e como um blob na guia Storage.

9. Parabéns!

Você acabou de criar um aplicativo de bate-papo em tempo real usando o Firebase!

O que você aprendeu

  • Autenticação do Firebase
  • Banco de dados em tempo real do Firebase
  • Armazenamento em nuvem para Firebase

Em seguida, tente usar o que você aprendeu neste codelab para adicionar o Firebase ao seu próprio app Android. Para saber mais sobre o Firebase, visite firebase.google.com .

Se você quiser aprender como configurar um projeto real do Firebase e usar recursos reais do Firebase (em vez de um projeto de demonstração e apenas recursos emulados), continue na próxima etapa.

Nota: Mesmo depois de configurar um projeto real do Firebase e especialmente quando você começar a criar um aplicativo real, recomendamos usar o Firebase Local Emulator Suite para desenvolvimento e teste.

10. Opcional: crie e configure um projeto do Firebase

Nesta etapa, você criará um projeto Firebase real e um aplicativo Android Firebase para usar com este codelab. Você também adicionará a configuração do Firebase específica do aplicativo ao seu aplicativo. E, finalmente, você configurará recursos reais do Firebase para usar com seu aplicativo.

Criar um projeto do Firebase

  1. No seu navegador, acesse o console do Firebase .
  2. Selecione Adicionar projeto .
  3. Selecione ou insira um nome de projeto. Você pode usar o nome que quiser.
  4. Você não precisa do Google Analytics para este codelab, portanto, pode pular a ativação para seu projeto.
  5. Clique em Criar projeto . Quando seu projeto estiver pronto, clique em Continuar .

Adicione o Firebase ao seu projeto Android

Antes de iniciar esta etapa, obtenha o hash SHA1 do seu aplicativo. Execute o seguinte comando no diretório build-android-start local para determinar o SHA1 da chave de depuração:

./gradlew signingReport

Store: /Users/<username>/.android/debug.keystore
Alias: AndroidDebugKey
MD5: A5:88:41:04:8F:06:59:6A:AE:33:76:87:AA:AD:19:23
SHA1: A7:89:F5:06:A8:07:A1:22:EC:90:6A:A6:EA:C3:D4:8B:3A:30:AB:18
SHA-256: 05:A2:2A:35:EE:F2:51:23:72:4D:72:67:A5:6A:8A:58:22:2C:00:A6:AB:F6:45:D5:A1:82:D8:90:A4:69:C8:FE
Valid until: Wednesday, August 10, 2044

Você deve ver alguma saída como a acima. A linha importante é o hash SHA1 . Se você não conseguir encontrar seu hash SHA1, consulte esta página para obter mais informações.

Volte para o console do Firebase e siga estas etapas para registrar seu projeto Android com seu projeto Firebase:

  1. Na tela de visão geral do seu novo projeto, clique no ícone do Android para iniciar o fluxo de trabalho de configuração: adicionar aplicativo android
  2. Na próxima tela, insira com.google.firebase.codelab.friendlychat como o nome do pacote para seu aplicativo.
  3. Clique em Registrar aplicativo e, em seguida, clique em Baixar google-services.json para baixar o arquivo de configuração do Firebase.
  4. Copie o arquivo google-services.json para o diretório app do seu projeto Android.
  5. Ignore as próximas etapas mostradas no fluxo de trabalho de configuração do console (elas já foram feitas para você no projeto build-android-start ).
  6. Certifique-se de que todas as dependências estejam disponíveis para seu aplicativo sincronizando seu projeto com arquivos Gradle. Na barra de ferramentas do Android Studio, selecione File > Sync Project with Gradle Files . Você também pode precisar executar Build/Clean Project e Build/Rebuild Project para que as alterações de configuração ocorram.

Configurar autenticação do Firebase

Antes que seu aplicativo possa acessar as APIs do Firebase Authentication em nome de seus usuários, você precisa ativar o Firebase Authentication e os provedores de login que deseja usar em seu aplicativo.

  1. No console do Firebase , selecione Autenticação no painel de navegação do lado esquerdo.
  2. Selecione a guia Método de entrada .
  3. Clique em E-mail/Senha e alterne a opção para ativado (azul).
  4. Clique em Google , alterne a chave para ativado (azul) e defina um e-mail de suporte ao projeto.

Se você receber erros posteriormente neste codelab com a mensagem "CONFIGURATION_NOT_FOUND", volte a esta etapa e verifique novamente seu trabalho.

Configurar banco de dados em tempo real

O app neste codelab armazena mensagens de chat no Firebase Realtime Database. Nesta seção, criaremos um banco de dados e configuraremos sua segurança por meio de uma linguagem de configuração JSON chamada Firebase Security Rules.

  1. No Firebase console , selecione Realtime Database no painel de navegação do lado esquerdo.
  2. Clique em Create Database para criar uma nova instância do Realtime Database. Quando solicitado, selecione a região us-central1 e clique em Avançar .
  3. Quando solicitado sobre as regras de segurança, escolha o modo bloqueado e clique em Ativar .
  4. Após a criação da instância do banco de dados, selecione a guia Regras e atualize a configuração das regras com o seguinte:
     {
       "rules": {
         "messages": {
           ".read": "auth.uid != null",
           ".write": "auth.uid != null"
         }
       }
     }
    

Para obter mais informações sobre como as regras de segurança funcionam (incluindo documentação sobre a variável "auth"), consulte a documentação de segurança do Realtime Database .

Configurar armazenamento em nuvem para Firebase

  1. No console do Firebase , selecione Armazenamento no painel de navegação do lado esquerdo.
  2. Clique em Começar para habilitar o Cloud Storage para seu projeto.
  3. Siga as etapas na caixa de diálogo para configurar seu bucket, usando os padrões sugeridos.

Conecte-se aos recursos do Firebase

Em uma etapa anterior deste codelab, você adicionou o seguinte a MainActivity.kt . Este bloco condicional conectou seu projeto Android ao Firebase Emulator Suite.

// REMOVE OR DISABLE THIS
if (BuildConfig.DEBUG) {
    Firebase.database.useEmulator("10.0.2.2", 9000)
    Firebase.auth.useEmulator("10.0.2.2", 9099)
    Firebase.storage.useEmulator("10.0.2.2", 9199)
}

Se você deseja conectar seu aplicativo ao seu novo projeto real do Firebase e seus recursos reais do Firebase, você pode remover esse bloco ou executar seu aplicativo no modo de lançamento para que BuildConfig.DEBUG seja false .