1. Visão Geral
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
( ) 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:
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.
- Inicie seu emulador Android.
- No Android Studio, clique em 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
- Na interface do usuário do Firebase Emulator Suite, selecione a guia Realtime Database .
- 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
- Clique em Executar (
).
- 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
- No Android Studio, clique no botão
botão Executar .
- 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.
- 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
- No seu navegador, acesse o console do Firebase .
- Selecione Adicionar projeto .
- Selecione ou insira um nome de projeto. Você pode usar o nome que quiser.
- Você não precisa do Google Analytics para este codelab, portanto, pode pular a ativação para seu projeto.
- 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:
- Na tela de visão geral do seu novo projeto, clique no ícone do Android para iniciar o fluxo de trabalho de configuração:
- Na próxima tela, insira
com.google.firebase.codelab.friendlychat
como o nome do pacote para seu aplicativo. - Clique em Registrar aplicativo e, em seguida, clique em Baixar google-services.json para baixar o arquivo de configuração do Firebase.
- Copie o arquivo
google-services.json
para o diretórioapp
do seu projeto Android. - 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
). - 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.
- No console do Firebase , selecione Autenticação no painel de navegação do lado esquerdo.
- Selecione a guia Método de entrada .
- Clique em E-mail/Senha e alterne a opção para ativado (azul).
- 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.
- No Firebase console , selecione Realtime Database no painel de navegação do lado esquerdo.
- 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 . - Quando solicitado sobre as regras de segurança, escolha o modo bloqueado e clique em Ativar .
- 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
- No console do Firebase , selecione Armazenamento no painel de navegação do lado esquerdo.
- Clique em Começar para habilitar o Cloud Storage para seu projeto.
- 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
.