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:gradlev7.3.0 ou version ultérieurecompileSdkVersion28 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.
Accédez à la console Firebase.
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.
Saisissez le nom du package de votre application dans le champ Nom du package Android.
(Facultatif) Saisissez un pseudonyme d'application, qui est un identifiant interne pratique, visible uniquement par vous dans la console Firebase.
Cliquez sur Enregistrer l'application.
Étape 3 : Ajouter un fichier de configuration Firebase
Téléchargez, puis ajoutez le fichier de configuration Firebase de votre application (
) à votre codebase :google-services.json Cliquez sur Télécharger google-services.json pour obtenir le fichier de configuration Firebase de votre application.
Déplacez votre fichier de configuration vers le répertoire racine du module (au niveau de l'application) de votre application.
Pour rendre les valeurs de votre fichier de configuration
accessibles aux SDK Firebase, vous devez disposer du plug-in Gradle des services Google (google-services.json ).google-services Dans votre fichier Gradle au niveau racine (au niveau du projet) (
<project>/build.gradle.ktsou<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 }
Dans le fichier Gradle de votre module (au niveau de l'application) (généralement
<project>/<app-module>/build.gradle.ktsou<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
Dans le fichier Gradle de votre module (au niveau de l'application) (généralement
<project>/<app-module>/build.gradle.ktsou<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.
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.
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)
Ouvrez l'assistant Firebase : Tools > Firebase (Outils > Firebase).
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)).Cliquez sur Connect to Firebase (Se connecter à Firebase) pour associer votre projet Android à Firebase.
Cliquez sur le bouton pour ajouter le produit Firebase souhaité (par exemple,
Ajouter Analytics à votre application ).
Synchronisez votre application pour veiller à ce que toutes les dépendances disposent des versions nécessaires.
Dans le volet Assistant, suivez les instructions de configuration restantes pour le produit Firebase sélectionné.
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 :
Dépôt GitHub du SDK 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)
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Bibliothèques Firebase ML et Firebase ML Kit
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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
Consultez Comprendre les projets Firebase pour en savoir plus sur les projets Firebase et les bonnes pratiques associées.
Consultez En savoir plus sur Android et Firebase si vous avez des questions sur des concepts qui ne vous sont pas familiers ou qui sont spécifiques au développement Firebase et Android.
Découvrez des exemples d'applications Firebase.
Familiarisez-vous avec l'atelier de programmation Firebase pour Android.
Pour en savoir plus, suivez le cours Firebase in a Weekend.
Préparez-vous à lancer votre application :
- Configurez des alertes de budget pour votre projet dans la console Google Cloud.
- Surveillez le tableau de bord Utilisation et facturation dans la console Firebase pour obtenir une vue d'ensemble de l'utilisation de votre projet sur plusieurs services Firebase.
- Consultez la checklist de lancement de Firebase.
Vous rencontrez des problèmes avec Firebase et votre projet Android ? Consultez la page Dépannage et questions fréquentes sur Android.