Ajouter Firebase à votre projet Android

Prérequis

  • Installez ou mettez à jour Android Studio vers la 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 24 (Nougat) ou supérieur
    • Utilise Android 7.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 dépendants de Google Play services nécessitent que Google Play services soit installé sur l'appareil ou l'émulateur.

Si vous n'avez 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 associer votre application Android à Firebase de l'une des manières suivantes :

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



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 d'ajouter Firebase à votre application Android, vous devez créer un projet Firebase à associer à 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 l'enregistrer dans 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 "Vue d'ensemble du projet", cliquez sur l'icône Android () ou sur Ajouter une application pour lancer la configuration.

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

  4. (Facultatif) Saisissez un pseudonyme d'application, qui est un identifiant interne pratique, visible uniquement par vous dans la console Firebase.

  5. Cliquez sur Enregistrer l'application.

Étape 3 : Ajouter un fichier de configuration Firebase

  1. Téléchargez, puis ajoutez le fichier de configuration Firebase de votre application (google-services.json) à 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 vers 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 racine (au niveau du projet) (<project>/build.gradle.kts ou <project>/build.gradle), ajoutez le plug-in Gradle 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.6.0" 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.6.0' 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 Gradle 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 la Firebase Android BoM pour contrôler la gestion des versions de la bibliothèque.

    Analytics activé

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation(platform("com.google.firebase:firebase-bom:35.2.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")
    }

    Avec 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:35.2.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")
    }

    Avec 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 aux étapes suivantes recommandées.

Si vous rencontrez des difficultés lors de la configuration, consultez la page Dépannage et questions fréquentes sur Android.



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

Firebase Assistant 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 que vous utilisez les dernières versions d'Android Studio et de l'assistant Firebase :

    • Windows/Linux : Help > Check for updates (Aide > Rechercher des mises à jour)
    • macOS : Android Studio > Check for updates (Rechercher les mises à jour)
  2. Ouvrez l'assistant Firebase : Tools > Firebase (Outils > Firebase).

  3. Dans le volet Assistant, choisissez un produit Firebase à ajouter à votre application. Développez la section correspondante, puis cliquez sur le lien du tutoriel (par exemple, Analytics > Log an Analytics event (Enregistrer 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 veiller à ce 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 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 lors de la configuration, consultez la page Dépannage et questions fréquentes sur Android.



Bibliothèques disponibles

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

Notez que lorsque vous utilisez la 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 pour Android. Pour savoir quelles versions de bibliothèque sont mappées à une version BoM spécifique, consultez les notes de version de cette version BoM.

35.2.0
Plug-in Gradle des services Google com.google.gms:google-services 4.6.0
AdMob com.google.android.gms:play-services-ads 25.5.0
Firebase AI Logic 1 com.google.firebase:firebase-ai 18.2.0
Firebase AI Logic On-Device com.google.firebase:firebase-ai-ondevice 16.0.0-beta08
Firebase AI KSP com.google.firebase:firebase-ai-ksp-processor 17.0.0
Analytics com.google.firebase:firebase-analytics 24.0.0
Fournisseur personnalisé App Check com.google.firebase:firebase-appcheck 20.1.0
Fournisseur de débogage App Check com.google.firebase:firebase-appcheck-debug 20.1.0
Fournisseur Play Integrity App Check com.google.firebase:firebase-appcheck-playintegrity 20.1.0
Fournisseur App Check reCAPTCHA com.google.firebase:firebase-appcheck-recaptcha 20.1.0
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta21
API App Distribution com.google.firebase:firebase-appdistribution-api 16.0.0-beta21
Plug-in App Distribution com.google.firebase:firebase-appdistribution-gradle 5.3.1
Authentication com.google.firebase:firebase-auth 25.0.0
Cloud Firestore com.google.firebase:firebase-firestore 27.2.0
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 23.0.0
Cloud Messaging com.google.firebase:firebase-messaging 26.0.2
Cloud Storage com.google.firebase:firebase-storage 23.0.0
Crashlytics com.google.firebase:firebase-crashlytics 21.1.0
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 21.1.0
Plug-in Crashlytics com.google.firebase:firebase-crashlytics-gradle 3.0.8
Compatibilité avec les modules de fonctionnalités dynamiques com.google.firebase:firebase-dynamic-module-support 16.0.0-beta05
In-App Messaging com.google.firebase:firebase-inappmessaging 23.0.0
(obligatoire)
Écran In-App Messaging com.google.firebase:firebase-inappmessaging-display 23.0.0
(obligatoire)
Firebase installations com.google.firebase:firebase-installations 20.0.0
Performance Monitoring com.google.firebase:firebase-perf 23.0.1
Plug-in Performance Monitoring com.google.firebase:perf-plugin 2.0.2
Firebase Phone Number Verification com.google.firebase:firebase-pnv 17.0.0
Realtime Database com.google.firebase:firebase-database 23.0.0
Remote Config com.google.firebase:firebase-config 24.0.1
SQL Connect 2 com.google.firebase:firebase-dataconnect 18.0.1
BIBLIOTHÈQUES OBSOLÈTES OU NON COMPATIBLES
Dynamic Links com.google.firebase:firebase-dynamic-links 22.1.0

Modules Firebase KTX (plus compatibles)

Analytics À ne pas utiliser : les bibliothèques de modules KTX ne sont plus prises en charge.
com.google.firebase:firebase-analytics-ktx
22.5.0
Fournisseur personnalisé App Check À ne pas utiliser : les bibliothèques de modules KTX ne sont plus prises en charge.
com.google.firebase:firebase-appcheck-ktx
18.0.0
API App Distribution À ne pas utiliser : les bibliothèques de modules KTX ne sont plus prises en charge.
com.google.firebase:firebase-appdistribution-api-ktx
16.0.0-beta15
Authentication À ne pas utiliser : les bibliothèques de modules KTX ne sont plus prises en charge.
com.google.firebase:firebase-auth-ktx
23.2.1
Cloud Firestore À ne pas utiliser ; les bibliothèques de modules KTX ne sont plus prises en charge.
com.google.firebase:firebase-firestore-ktx
25.1.4
Cloud Functions for Firebase Client SDK À ne pas utiliser : les bibliothèques de modules KTX ne sont plus prises en charge.
com.google.firebase:firebase-functions-ktx
21.2.1
Cloud Messaging À ne pas utiliser : les bibliothèques de modules KTX ne sont plus prises en charge.
com.google.firebase:firebase-messaging-ktx
24.1.2
Cloud Storage À ne pas utiliser : les bibliothèques de modules KTX ne sont plus acceptées.
com.google.firebase:firebase-storage-ktx
21.0.2
Crashlytics À ne pas utiliser : les bibliothèques de modules KTX ne sont plus prises en charge.
com.google.firebase:firebase-crashlytics-ktx
19.4.4
Dynamic Links À ne pas utiliser : les bibliothèques de modules KTX ne sont plus prises en charge.
com.google.firebase:firebase-dynamic-links-ktx
22.1.0
In-App Messaging À ne pas utiliser ; les bibliothèques de modules KTX ne sont plus prises en charge.
com.google.firebase:firebase-inappmessaging-ktx
21.0.2
(obligatoire)
Écran In-App Messaging À ne pas utiliser : les bibliothèques de modules KTX ne sont plus prises en charge.
com.google.firebase:firebase-inappmessaging-display-ktx
21.0.2
(obligatoire)
Firebase installations À ne pas utiliser : les bibliothèques de modules KTX ne sont plus acceptées.
com.google.firebase:firebase-installations-ktx
18.0.0
API de téléchargement de modèles Firebase ML À ne pas utiliser : les bibliothèques de modules KTX ne sont plus prises en charge.
com.google.firebase:firebase-ml-modeldownloader-ktx
25.0.1
Performance Monitoring À ne pas utiliser : les bibliothèques de modules KTX ne sont plus prises en charge.
com.google.firebase:firebase-perf-ktx
21.0.5
Realtime Database À ne pas utiliser : les bibliothèques de modules KTX ne sont plus prises en charge.
com.google.firebase:firebase-database-ktx
21.0.0
Remote Config À ne pas utiliser : les bibliothèques de modules KTX ne sont plus prises en charge.
com.google.firebase:firebase-config-ktx
22.1.2

Bibliothèques Firebase ML et Firebase ML Kit

Firebase ML API de modèles personnalisés com.google.firebase:firebase-ml-model-interpreter 22.0.4
API de téléchargement de modèles Firebase ML com.google.firebase:firebase-ml-modeldownloader 26.1.1
API Firebase ML 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 de 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.

2 Firebase SQL Connect s'appelait auparavant "Firebase Data Connect".



Étapes suivantes

Ajoutez des services Firebase à votre application :

  • Créez des fonctionnalités d'IA générative avec des modèles Gemini à 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.

  • Stocker des données, telles que des informations utilisateur, avec Cloud Firestore ou Realtime Database.

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

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

  • Envoyer des notifications avec Cloud Messaging

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

En savoir plus sur Firebase