Ajouter Firebase à votre projet Android

Prérequis

  • Installez ou mettez à jour Android Studio vers sa dernière version.

  • Assurez-vous que votre projet répond à ces exigences (notez que certains produits peuvent avoir des exigences plus strictes) :

    • Cible le niveau d'API 21 (Lollipop) ou version ultérieure
    • Utilise Android 5.0 ou version ultérieure
    • Utilise Jetpack (AndroidX), ce qui implique de respecter les exigences de version suivantes :
      • com.android.tools.build:gradle v7.3.0 ou version ultérieure
      • compileSdkVersion 28 ou version ultérieure

  • Configurez un appareil physique ou utilisez un émulateur pour exécuter votre application.
    Notez que les SDK Firebase avec une dépendance sur les services Google Play nécessitent que les services Google Play soient installés sur l'appareil ou l'émulateur.

  • Connectez-vous à Firebase avec votre compte Google.

Si vous ne disposez pas encore de projet Android et que vous souhaitez simplement essayer un produit Firebase, vous pouvez télécharger l'un de nos exemples de démarrage rapide.


Vous pouvez connecter votre application Android à Firebase à l'aide de l'une des options suivantes :

  • Option 1 : (recommandé) Utilisez le workflow de configuration de la console Firebase.
  • Option 2 : Utilisez l'assistant Firebase d'Android Studio (une configuration supplémentaire peut être requise).


Option 1 : Ajouter Firebase à l'aide de la console Firebase

L'ajout de Firebase à votre application implique des tâches à la fois dans la console Firebase et dans votre projet Android ouvert (par exemple, vous téléchargez des fichiers de configuration Firebase depuis la console, puis vous les déplacez dans votre projet Android).

Étape 1 : Créez un projet Firebase

Avant de pouvoir ajouter Firebase à votre application Android, vous devez créer un projet Firebase pour vous connecter à votre application Android. Consultez Comprendre les projets Firebase pour en savoir plus sur les projets Firebase.

Étape 2 : Enregistrez votre application auprès de Firebase

Pour utiliser Firebase dans votre application Android, vous devez enregistrer votre application auprès de votre projet Firebase. L'enregistrement de votre application est souvent appelé "ajout" de votre application à votre projet.

  1. Accédez à la console Firebase.

  2. Au centre de la page de présentation du projet, cliquez sur l'icône Android () ou sur Ajouter une application pour lancer le workflow de configuration.

  3. Saisissez le nom du package de votre application dans le champ Nom du package Android.

  4. (Facultatif) Saisissez d'autres informations sur l'application : Pseudo de l'application et Certificat de signature de débogage SHA-1.

  5. Cliquez sur Enregistrer l'application.

Étape 3 : Ajoutez un fichier de configuration Firebase

  1. Téléchargez, puis ajoutez le fichier de configuration Firebase (google-services.json) de votre application à votre codebase :

    1. Cliquez sur Télécharger google-services.json pour obtenir le fichier de configuration Firebase de votre application.

    2. Déplacez votre fichier de configuration dans le répertoire racine du module (au niveau de l'application) de votre application.

  2. Pour rendre les valeurs de votre fichier de configuration google-services.json accessibles aux SDK Firebase, vous devez disposer du plug-in Gradle des services Google (google-services).

    1. Dans votre fichier Gradle au niveau de la racine (au niveau du projet) (<project>/build.gradle.kts ou <project>/build.gradle), ajoutez le plug-in des services Google en tant que dépendance :

      Kotlin 

      plugins {
  id("com.android.application") version "7.3.0" apply false
  // ...

  // Add the dependency for the Google services Gradle plugin
  id("com.google.gms.google-services") version "4.4.3" apply false
}

      Groovy 

      plugins {
  id 'com.android.application' version '7.3.0' apply false
  // ...

  // Add the dependency for the Google services Gradle plugin
  id 'com.google.gms.google-services' version '4.4.3' apply false
}

    2. Dans le fichier Gradle de votre module (au niveau de l'application) (généralement <project>/<app-module>/build.gradle.kts ou <project>/<app-module>/build.gradle), ajoutez le plug-in des services Google :

      Kotlin 

      plugins {
  id("com.android.application")

  // Add the Google services Gradle plugin
  id("com.google.gms.google-services")
  // ...
}

      Groovy 

      plugins {
  id 'com.android.application'

  // Add the Google services Gradle plugin
  id 'com.google.gms.google-services'
  // ...
}

Étape 4 : Ajoutez les SDK Firebase à votre application

  1. Dans le fichier Gradle de votre module (au niveau de l'application) (généralement <project>/<app-module>/build.gradle.kts ou <project>/<app-module>/build.gradle), ajoutez les dépendances pour les produits Firebase que vous souhaitez utiliser dans votre application. Nous vous recommandons d'utiliser Firebase Android BoM pour contrôler la gestion des versions des bibliothèques.

    Analytics activé 

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation(platform("com.google.firebase:firebase-bom:34.0.0"))

  // When using the BoM, you don't specify versions in Firebase library dependencies

  // Add the dependency for the Firebase SDK for Google Analytics
  implementation("com.google.firebase:firebase-analytics")

  // TODO: Add the dependencies for any other Firebase products you want to use
  // See https://firebase.google.com/docs/android/setup#available-libraries
  // For example, add the dependencies for Firebase Authentication and Cloud Firestore
  implementation("com.google.firebase:firebase-auth")
  implementation("com.google.firebase:firebase-firestore")
}

    En utilisant la Firebase Android BoM, votre application utilisera toujours des versions compatibles des bibliothèques Firebase Android.

    Analytics non activé 

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation(platform("com.google.firebase:firebase-bom:34.0.0"))

  // When using the BoM, you don't specify versions in Firebase library dependencies

  // TODO: Add the dependencies for Firebase products you want to use
  // See https://firebase.google.com/docs/android/setup#available-libraries
  // For example, add the dependencies for Firebase Authentication and Cloud Firestore
  implementation("com.google.firebase:firebase-auth")
  implementation("com.google.firebase:firebase-firestore")
}

    En utilisant la Firebase Android BoM, votre application utilisera toujours des versions compatibles des bibliothèques Firebase Android.

  2. Après avoir ajouté les dépendances pour les produits que vous souhaitez utiliser, synchronisez votre projet Android avec les fichiers Gradle.

Et voilà ! Vous pouvez passer directement à la section Étapes suivantes recommandées.

Si vous rencontrez des difficultés pour configurer votre appareil, consultez la section Dépannage et questions fréquentes concernant Android.


Option 2 : Ajouter Firebase à l'aide de l'assistant Firebase

L'assistant Firebase enregistre votre application dans un projet Firebase et ajoute les fichiers, plug-ins et dépendances Firebase nécessaires à votre projet Android, le tout, depuis Android Studio.

  1. Ouvrez votre projet Android dans Android Studio, puis assurez-vous d'utiliser les dernières versions d'Android Studio et de l'assistant Firebase :

    • Windows / Linux : Aide > Rechercher les mises à jour
    • macOS : Android Studio > Rechercher les mises à jour

  2. Ouvrez l'assistant Firebase : Tools > Firebase (Outils > Firebase).

  3. Dans le volet Assistant, sélectionnez un produit Firebase à ajouter à votre application. Développez sa section, puis cliquez sur le lien du tutoriel (par exemple, Analytics > Consigner un événement Analytics).

    1. Cliquez sur Connect to Firebase (Se connecter à Firebase) pour associer votre projet Android à Firebase.

    2. Cliquez sur le bouton pour ajouter le produit Firebase souhaité (par exemple, Ajouter Analytics à votre application).

  4. Synchronisez votre application pour vous assurer que toutes les dépendances disposent des versions nécessaires.

  5. Dans le volet Assistant, suivez les instructions de configuration restantes pour le produit Firebase que vous avez sélectionné.

  6. Ajoutez autant d'autres produits Firebase que vous le souhaitez via l'assistant Firebase.

Et voilà ! N'oubliez pas de consulter les étapes suivantes recommandées.

Si vous rencontrez des difficultés pour configurer votre appareil, consultez la section Dépannage et questions fréquentes concernant Android.


Bibliothèques disponibles

Cette section répertorie les produits Firebase compatibles avec Android et leurs dépendances Gradle. En savoir plus sur ces bibliothèques Firebase Android :

Notez que lorsque vous utilisez Firebase Android BoM, vous ne spécifiez pas de versions de bibliothèque individuelles lorsque vous déclarez des dépendances de bibliothèque Firebase dans votre fichier de configuration de compilation Gradle.

Service ou produit Dépendance Gradle Dernière
version		 Ajouter Analytics ?
Firebase Android BoM
(Bill of Materials)		 com.google.firebase:firebase-bom

La dernière version de Firebase BoM contient les dernières versions de chaque bibliothèque Firebase Android. Pour savoir quelles versions de bibliothèque correspondent à une version spécifique de BoM, consultez les notes de version de cette version de BoM.

 34.0.0
AdMob com.google.android.gms:play-services-ads 24.4.0
Firebase AI Logic 1 com.google.firebase:firebase-ai 17.0.0
Analytics com.google.firebase:firebase-analytics 23.0.0
App Check fournisseur personnalisé com.google.firebase:firebase-appcheck 19.0.0
App Check debug provider com.google.firebase:firebase-appcheck-debug 19.0.0
App Check Fournisseur Play Integrity com.google.firebase:firebase-appcheck-playintegrity 19.0.0
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta16
API App Distribution com.google.firebase:firebase-appdistribution-api 16.0.0-beta16
Plug-in App Distribution com.google.firebase:firebase-appdistribution-gradle 5.1.1
Authentication com.google.firebase:firebase-auth 24.0.0
Cloud Firestore com.google.firebase:firebase-firestore 26.0.0
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 22.0.0
Cloud Messaging com.google.firebase:firebase-messaging 25.0.0
Cloud Storage com.google.firebase:firebase-storage 22.0.0
Crashlytics com.google.firebase:firebase-crashlytics 20.0.0
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 20.0.0
Plug-in Crashlytics com.google.firebase:firebase-crashlytics-gradle 3.0.5
Data Connect com.google.firebase:firebase-dataconnect 17.0.0
Compatibilité avec les modules de fonctionnalités dynamiques com.google.firebase:firebase-dynamic-module-support 16.0.0-beta04
Dynamic Links com.google.firebase:firebase-dynamic-links 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging 22.0.0
(obligatoire)
In-App Messaging Écran com.google.firebase:firebase-inappmessaging-display 22.0.0
(obligatoire)
Firebase installations com.google.firebase:firebase-installations 19.0.0
API Model Downloader Firebase ML com.google.firebase:firebase-ml-modeldownloader 26.0.0
Performance Monitoring com.google.firebase:firebase-perf 22.0.0
Plug-in Performance Monitoring com.google.firebase:perf-plugin 2.0.0
Realtime Database com.google.firebase:firebase-database 22.0.0
Remote Config com.google.firebase:firebase-config 23.0.0
Plug-in des services Google Play com.google.gms:google-services 4.4.3
BIBLIOTHÈQUES OBSOLÈTES
App Check Fournisseur SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.1.2
App Indexing com.google.firebase:firebase-appindexing 20.0.0

Modules Firebase KTX

Analytics com.google.firebase:firebase-analytics-ktx 22.5.0
App Check fournisseur personnalisé com.google.firebase:firebase-appcheck-ktx 18.0.0
API App Distribution com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta15
Authentication com.google.firebase:firebase-auth-ktx 23.2.1
Cloud Firestore com.google.firebase:firebase-firestore-ktx 25.1.4
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions-ktx 21.2.1
Cloud Messaging com.google.firebase:firebase-messaging-ktx 24.1.2
Cloud Storage com.google.firebase:firebase-storage-ktx 21.0.2
Crashlytics com.google.firebase:firebase-crashlytics-ktx 19.4.4
Dynamic Links com.google.firebase:firebase-dynamic-links-ktx 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging-ktx 21.0.2
(obligatoire)
In-App Messaging Écran com.google.firebase:firebase-inappmessaging-display-ktx 21.0.2
(obligatoire)
Firebase installations com.google.firebase:firebase-installations-ktx 18.0.0
API Model Downloader Firebase ML com.google.firebase:firebase-ml-modeldownloader-ktx 25.0.1
Performance Monitoring com.google.firebase:firebase-perf-ktx 21.0.5
Realtime Database com.google.firebase:firebase-database-ktx 21.0.0
Remote Config com.google.firebase:firebase-config-ktx 22.1.2

Bibliothèques Firebase ML Kit

Firebase ML API de modèles personnalisés com.google.firebase:firebase-ml-model-interpreter 22.0.4
Firebase ML API Vision com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML : modèle d'étiquetage d'images com.google.firebase:firebase-ml-vision-image-label-model 20.0.2
Firebase ML : modèle de détection et de suivi d'objets com.google.firebase:firebase-ml-vision-object-detection-model 19.0.6
Firebase ML : modèle de détection des visages com.google.firebase:firebase-ml-vision-face-model 20.0.2
Firebase ML : modèle de lecture de codes-barres com.google.firebase:firebase-ml-vision-barcode-model 16.1.2
Firebase ML : API AutoML Vision Edge com.google.firebase:firebase-ml-vision-automl 18.0.6
Firebase ML : API Natural Language com.google.firebase:firebase-ml-natural-language 22.0.1
Firebase ML : modèle d'identification de la langue com.google.firebase:firebase-ml-natural-language-language-id-model 20.0.8
Firebase ML : modèle de traduction com.google.firebase:firebase-ml-natural-language-translate-model 20.0.9
Firebase ML : modèle de réponse suggérée com.google.firebase:firebase-ml-natural-language-smart-reply-model 20.0.8

1 Firebase AI Logic s'appelait auparavant "Vertex AI in Firebase" avec le package com.google.firebase:firebase-vertexai.


Étapes suivantes

Ajoutez les services Firebase à votre application :

  • Créez des fonctionnalités d'IA générative avec les modèles Gemini et Imagen à l'aide de Firebase AI Logic.

  • Obtenez des insights sur le comportement des utilisateurs avec Analytics.

  • Configurez un flux d'authentification des utilisateurs avec Authentication.

  • Stockez les données, comme les informations utilisateur, avec Cloud Firestore ou Realtime Database.

  • Stockez des fichiers, comme des photos et des vidéos, avec Cloud Storage.

  • Déclenchez le code de backend qui s'exécute dans un environnement sécurisé avec Cloud Functions.

  • Envoyez des notifications avec Cloud Messaging.

  • Découvrez quand et pourquoi votre application plante avec Crashlytics.

En savoir plus sur Firebase :