0Pricing
Android Academy · Aula

Configurando o Firebase

Conecte seu aplicativo a um projeto do Firebase.

Configurando o Firebase é uma aula grátis de Android Academy no CoddyKit. Esta é a aula 1 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Android Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Android Academy inclui 4 aulas no total.

O que é o Firebase?

Firebase é a plataforma de desenvolvimento de aplicativos do Google. Ela fornece ao seu aplicativo Android um back-end pronto, para que você não precise criar e hospedar servidores por conta própria.

Neste curso, você conectará um aplicativo ao Firebase e usará três de seus serviços mais populares:

  • Autenticação — permite iniciar sessão com e-mail ou Google
  • Cloud Firestore — um banco de dados NoSQL em tempo real
  • Cloud Messaging (FCM) — notificações push

Esta primeira lição é dedicada à configuração: criar um projeto e integrá-lo ao seu aplicativo Android.

Criar um projeto do Firebase

Tudo começa no console do Firebase, em console.firebase.google.com.

  • Clique em Adicionar projeto e dê um nome a ele.
  • Cada projeto do Firebase corresponde a um projeto do Google Cloud nos bastidores.
  • Um projeto do Firebase pode conter vários aplicativos (Android, iOS e web).

Dentro do projeto, registre seu aplicativo Android específico usando o application ID (nome do pacote), por exemplo com.coddykit.demo. É por meio desse ID que o Firebase identifica de qual aplicativo vem uma solicitação.

O arquivo google-services.json

Quando você registra seu aplicativo Android, o Firebase gera um arquivo de configuração chamado google-services.json.

Baixe-o e coloque-o na pasta raiz do módulo do aplicativo (ao lado de build.gradle.kts, dentro do diretório app/).

Esse JSON contém o ID do projeto, as chaves de API e os dados de registro do aplicativo. As ferramentas de compilação o leem automaticamente — quase nunca é necessário abri-lo manualmente.

// File location in your project:
// app/google-services.json

// It is generated for you and looks roughly like:
{
  "project_info": {
    "project_id": "my-demo-app",
    "storage_bucket": "my-demo-app.appspot.com"
  },
  "client": [
    { "client_info": { "mobilesdk_app_id": "1:1234567890:android:abc123" } }
  ]
}

Adicionar o plug-in do Google Services

Para que o Gradle leia google-services.json, adicione o plug-in do Google Services para Gradle.

A abordagem moderna usa o bloco plugins com catálogos de versões. Você declara o plug-in no arquivo de compilação raiz (com apply false) e depois o aplica no arquivo de compilação do módulo.

// Root build.gradle.kts (project level)
plugins {
    id("com.android.application") version "8.5.0" apply false
    id("org.jetbrains.kotlin.android") version "2.0.0" apply false
    id("com.google.gms.google-services") version "4.4.2" apply false
}

Aplicar o plug-in no módulo

Em build.gradle.kts do módulo app, aplique o plug-in para que ele processe seu arquivo de configuração durante a compilação.

Sem esta linha, a inicialização do Firebase falhará em tempo de execução, mesmo que todo o restante esteja correto.

// app/build.gradle.kts (module level)
plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    id("com.google.gms.google-services")
}

A BoM do Firebase

O Firebase tem muitas bibliotecas (Auth, Firestore, Messaging, Analytics...). Manter as versões sincronizadas é fácil com a Bill of Materials (BoM).

Você declara a BoM uma vez e depois adiciona cada dependência do Firebase sem uma versão — a BoM seleciona versões compatíveis para você.

// app/build.gradle.kts -> dependencies { }
dependencies {
    // One BoM controls all Firebase versions
    implementation(platform("com.google.firebase:firebase-bom:33.1.0"))

    // No version numbers here - the BoM decides
    implementation("com.google.firebase:firebase-auth")
    implementation("com.google.firebase:firebase-firestore")
    implementation("com.google.firebase:firebase-messaging")
}

Inicialização automática

Você pode esperar ter de chamar algo como Firebase.initialize() na classe Application. Com o SDK moderno, normalmente, não é necessário.

O plug-in do Google Services gera automaticamente um provedor de inicialização que é executado na inicialização do aplicativo usando google-services.json. Quando sua Activity é iniciada, o Firebase já está pronto.

// You normally do NOT need this anymore:
// FirebaseApp.initializeApp(context)

// Firebase is initialized automatically on app launch.
// You can just start using a service:
import com.google.firebase.Firebase
import com.google.firebase.firestore.firestore

val db = Firebase.firestore   // ready to use

O estilo Kotlin KTX

O Firebase oferece acessadores idiomáticos do Kotlin por meio do objeto Firebase. Em vez de FirebaseFirestore.getInstance(), você escreve Firebase.firestore.

Essas extensões são mais naturais de ler e representam o estilo recomendado no código moderno para Android.

import com.google.firebase.Firebase
import com.google.firebase.auth.auth
import com.google.firebase.firestore.firestore
import com.google.firebase.messaging.messaging

val auth = Firebase.auth          // FirebaseAuth
val db = Firebase.firestore       // FirebaseFirestore
val fcm = Firebase.messaging      // FirebaseMessaging

// Equivalent old style:
// val auth = FirebaseAuth.getInstance()

Adicionar a permissão de Internet

O Firebase se comunica com os servidores do Google, portanto seu aplicativo precisa de acesso à rede. Declare a permissão INTERNET no manifesto.

Essa é uma permissão normal, concedida automaticamente no momento da instalação — não é necessária uma solicitação em tempo de execução.

<!-- AndroidManifest.xml -->
<manifest xmlns:android="http://schemas.android.com/apk/res/android">

    <uses-permission android:name="android.permission.INTERNET" />

    <application ... >
        <!-- activities, services -->
    </application>
</manifest>

Verificar a conexão

Uma maneira rápida de confirmar que a configuração funciona é ler um valor ou verificar o aplicativo atual do Firebase. Se o Firebase não tivesse sido inicializado, acessar um serviço geraria uma exceção.

Muitos desenvolvedores também adicionam temporariamente a dependência Analytics e procuram um evento no console como um teste básico, mas simplesmente acessar um serviço no código já comprova que a integração está correta.

import android.util.Log
import com.google.firebase.Firebase
import com.google.firebase.firestore.firestore

fun verifyFirebase() {
    val app = Firebase.firestore.app
    Log.d("Firebase", "Connected to project: ${app.options.projectId}")
}

Erros comuns de configuração

Se o Firebase não estiver funcionando, verifique primeiro estes pontos:

  • Nome do pacote incorreto — o applicationId do aplicativo deve corresponder ao que foi registrado.
  • google-services.json ausente — ele deve estar na pasta app/.
  • O plug-in não foi aplicado no arquivo de compilação do módulo.
  • Permissão INTERNET ausente no manifesto.
  • Impressão digital SHA-1 não adicionada — necessária posteriormente para o login do Google.

Verificação rápida

Qual é a finalidade do arquivo google-services.json?

Recapitulação: configuração concluída

Você conectou um aplicativo Android ao Firebase. Etapas principais:

  • Crie um projeto no console do Firebase e registre seu aplicativo pelo nome do pacote.
  • Adicione google-services.json à pasta app/.
  • Aplique o plug-in do Google Services e adicione a Firebase BoM, além das bibliotecas necessárias.
  • O Firebase é inicializado automaticamente — acesse os serviços por meio de Firebase.auth, Firebase.firestore etc.
  • Não se esqueça da permissão INTERNET.

A seguir: iniciar sessão dos usuários com a Firebase Authentication.

Perguntas Frequentes

A aula “Configurando o Firebase” é grátis?

Sim — o texto completo de “Configurando o Firebase” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Android Academy, atualize para CoddyKit PRO. O curso de Android Academy inclui 4 aulas no total.

O que vou aprender em “Configurando o Firebase”?

Conecte seu aplicativo a um projeto do Firebase. Você pratica Android Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar Android Academy?

Nenhuma experiência prévia é necessária. Android Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 4.

Quanto tempo leva a aula “Configurando o Firebase”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de Android Academy?

Sim. Cada aula de Android Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

  1. Configurando o Firebase
  2. Autenticação do Firebase
  3. Noções básicas do Cloud Firestore
  4. Envio com o Cloud Messaging
← Voltar para Android Academy