Google s'est engagé à promouvoir l'équité raciale pour les communautés noires. Regarde comment.
Cette page a été traduite par l'API Cloud Translation.
Switch to English

Ajoutez Firebase à votre projet Android

Conditions préalables

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

  • Assurez-vous que votre projet répond à ces exigences:

    • Cible le niveau d'API 16 (Jelly Bean) ou supérieur
    • Utilise Gradle 4.1 ou version ultérieure
    • Utilise Jetpack (AndroidX) , qui comprend la satisfaction de ces exigences de version:
      • com.android.tools.build:gradle v3.2.1 ou version ultérieure
      • compileSdkVersion 28 ou version ultérieure

  • Configurez un appareil physique ou utilisez un émulateur pour exécuter votre application.
    Les émulateurs doivent utiliser une image d'émulateur avec Google Play.

  • Connectez-vous à Firebase à l' aide de votre compte Google.

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 connecter votre application Android à Firebase à l'aide de l'une des options suivantes:

  • Option 1 : (recommandée) Utilisez le workflow de configuration de la console Firebase.
  • Option 2 : utilisez l'assistant Firebase d'Android Studio (nécessite 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 les fichiers de configuration Firebase à partir de la console, puis les déplacez dans votre projet Android).

Étape 1 : créer 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 avec Firebase

Une fois que vous avez un projet Firebase, vous pouvez y ajouter votre application Android.

Consultez Comprendre les projets Firebase pour en savoir plus sur les bonnes pratiques et les considérations relatives à l'ajout d'applications à un projet Firebase, notamment sur la gestion de plusieurs variantes de build.

  1. Accédez à la console Firebase .

  2. Au centre de la page de du projet, cliquez sur l'icône Android ( ) pour lancer le workflow de configuration.

    Si vous avez déjà ajouté une application à votre projet Firebase, cliquez sur Ajouter une application pour afficher les options de la plate-forme.

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

  4. (Facultatif) Entrez d'autres informations sur l'application: surnom de l'application et certificat de signature de débogage SHA-1 .

  5. Cliquez sur Enregistrer l'application .

Étape 3 : Ajouter un fichier de configuration Firebase

  1. Ajoutez le fichier de configuration Firebase Android à votre application:

    1. Cliquez sur Télécharger google-services.json pour obtenir votre fichier de configuration Firebase Android ( google-services.json ).

    2. Déplacez votre fichier de configuration dans le répertoire module (niveau application) de votre application.

  2. Pour activer les produits Firebase dans votre application, ajoutez le plug-in google-services à vos fichiers Gradle.

    1. Dans votre fichier Gradle au niveau racine (au niveau du projet) ( build.gradle ), ajoutez des règles pour inclure le plug-in Google Services Gradle. Vérifiez également que vous disposez du référentiel Maven de Google. 

      buildscript {

  repositories {
    // Check that you have the following line (if not, add it):
    google()  // Google's Maven repository
  }

  dependencies {
    // ...

    // Add the following line:
    classpath 'com.google.gms:google-services:4.3.3'  // Google Services plugin
  }
}

allprojects {
  // ...

  repositories {
    // Check that you have the following line (if not, add it):
    google()  // Google's Maven repository
    // ...
  }
}

    2. Dans le fichier Gradle de votre module (au niveau de l'application) (généralement app/build.gradle ), appliquez le plug-in Google Services Gradle: 

      apply plugin: 'com.android.application'
// Add the following line:
apply plugin: 'com.google.gms.google-services'  // Google Services plugin

android {
  // ...
}

Étape 4 : ajoutez des SDK Firebase à votre application

  1. Au fichier Gradle de votre module (au niveau de l'application) (généralement app/build.gradle ), ajoutez les dépendances des produits Firebase que vous souhaitez utiliser dans votre application.

    Analytics activé 

    dependencies {
  // ...

  // Add the Firebase SDK for Google Analytics
  implementation 'com.google.firebase:firebase-analytics:17.4.4'

  // Add the dependencies for any other Firebase products you want to use in your app
  // For example, to also use Firebase Authentication
  implementation 'com.google.firebase:firebase-auth:19.3.2'

  // Getting a "Could not find" error? Make sure that you've added
  // Google's Maven repository to your root-level build.gradle file
}

    Analytics non activé 

    dependencies {
  // ...

  // Add the dependencies for the Firebase products you want to use in your app
  // For example, to use Firebase Authentication
  implementation 'com.google.firebase:firebase-auth:19.3.2'

  // Getting a "Could not find" error? Make sure that you've added
  // Google's Maven repository to your root-level build.gradle file
}

  2. Synchronisez votre application pour vous assurer que toutes les dépendances ont les versions nécessaires.

  3. Si vous avez ajouté Analytics, exécutez votre application pour envoyer la vérification à Firebase que vous avez correctement intégré Firebase. Sinon, vous pouvez ignorer l'étape de vérification.

    Les journaux de votre appareil afficheront la vérification Firebase que l'initialisation est terminée. Si vous avez exécuté votre application sur un émulateur disposant d'un accès réseau, la console Firebase vous informe que la connexion de votre application est terminée.

C'est tout! Vous pouvez passer aux étapes suivantes .

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

L' assistant Firebase enregistre votre application avec un projet Firebase et ajoute les fichiers et le code Firebase nécessaires à votre projet Android, le tout depuis Android Studio.

Notez que l'option recommandée pour connecter votre application à Firebase est d'utiliser le workflow de configuration de la console Firebase .

  1. Ouvrez votre projet Android dans Android Studio.

  2. Sélectionnez Outils> Firebase pour ouvrir le volet Assistant .

  3. Choisissez un produit Firebase à ajouter à votre application. Développez sa section, puis cliquez sur le lien du didacticiel (par exemple, Analytics > Consigner un événement Analytics ).

  4. Cliquez sur Se connecter à Firebase pour connecter votre projet Android à Firebase.

  5. Dans le volet Assistant Firebase, cliquez sur le bouton pour ajouter la dépendance de bibliothèque pour le produit Firebase sélectionné (par exemple, Ajouter Analytics à votre application ).

  6. Synchronisez votre application pour vous assurer que toutes les dépendances ont les versions nécessaires.

  7. Si vous avez ajouté Analytics, exécutez votre application pour envoyer la vérification à Firebase que vous avez correctement intégré Firebase. Sinon, vous pouvez ignorer cette étape de vérification.

    Les journaux de votre appareil afficheront la vérification Firebase que l'initialisation est terminée. Si vous avez exécuté votre application sur un émulateur disposant d'un accès réseau, la console Firebase vous informe que la connexion de votre application est terminée.

  8. Dans le volet Assistant Firebase, suivez les instructions de configuration restantes pour le produit Firebase sélectionné.

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

C'est tout! Assurez-vous de consulter les étapes suivantes recommandées.

Contrôle de la gestion des versions de la bibliothèque avec une nomenclature Firebase (BoM)

Pour une gestion simplifiée des versions de bibliothèque, pensez à importer une nomenclature Firebase (BoM).

Bibliothèques disponibles

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

Java

Service ou produit Dépendances Gradle Ajouter Analytics?
AdMob com.google.android.gms: play-services-ads: 19.3.0
Analytique com.google.firebase: firebase-analytics: 17.4.4
Indexation des applications com.google.firebase: firebase-appindexing: 19.1.0
Authentification com.google.firebase: firebase-auth: 19.3.2
Cloud Firestore com.google.firebase: firebase-firestore: 21.5.0
Cloud Functions for Firebase Client SDK com.google.firebase: fonctions firebase: 19.0.2
Messagerie cloud com.google.firebase: messagerie Firebase: 20.2.4
Stockage en ligne com.google.firebase: stockage firebase: 19.1.1
Crashlytics com.google.firebase: firebase-crashlytics: 17.1.1
Liens dynamiques com.google.firebase: liens-dynamiques-firebase: 19.1.0
API Firebase ML Vision com.google.firebase: firebase-ml-vision: 24.0.3
API de modèle personnalisé Firebase ML com.google.firebase: interpréteur de modèle firebase-ml: 22.0.3
Messagerie dans l'application com.google.firebase: firebase-inappmessaging: 19.1.0
(obligatoire)
Affichage de la messagerie dans l'application com.google.firebase: firebase-inappmessaging-display: 19.1.0
(obligatoire)
Suivi de la performance com.google.firebase: firebase-perf: 19.0.8
Base de données en temps réel com.google.firebase: base de données firebase: 19.3.1
Configuration à distance com.google.firebase: firebase-config: 19.2.0
Nomenclature Firebase (BoM) com.google.firebase: firebase-bom: 25.7.0

La dernière version de Firebase BoM contient les dernières versions de chaque bibliothèque Firebase Android disponible à la sortie de BoM. Pour les versions de bibliothèque mappées sur les versions BoM précédentes, consultez les notes de publication de cette version.

Plug-in de services Google Play com.google.gms: services google: 4.3.3
Bibliothèques obsolètes
Firebase ML: modèle d'étiquetage d'image com.google.firebase: firebase-ml-vision-image-label-model: 20.0.1
Firebase ML: modèle de détection et de suivi d'objets com.google.firebase: Firebase-ml-vision-object-detection-model: 19.0.5
Firebase ML: modèle de détection de visage com.google.firebase: firebase-ml-vision-face-model: 20.0.1
Firebase ML: modèle de numérisation de codes-barres com.google.firebase: firebase-ml-vision-barcode-model: 16.1.1
Firebase ML: API AutoML Vision Edge com.google.firebase: firebase-ml-vision-automl: 18.0.5
Firebase ML: API en langage naturel com.google.firebase: firebase-ml-natural-language: 22.0.0
Firebase ML: modèle d'identification du langage com.google.firebase: firebase-ml-natural-language-language-id-model: 20.0.7
Firebase ML: Traduire le modèle com.google.firebase: firebase-ml-natural-language-translate-model: 20.0.8
Firebase ML: modèle de réponse intelligente com.google.firebase: firebase-ml-natural-language-smart-reply-model: 20.0.7

Kotlin + KTX

Service ou produit Dépendances Gradle Ajouter Analytics?
AdMob com.google.android.gms: play-services-ads: 19.3.0
Analytique com.google.firebase: firebase-analytics-ktx: 17.4.4
Indexation des applications com.google.firebase: firebase-appindexing: 19.1.0
Authentification com.google.firebase: firebase-auth-ktx: 19.3.2
Cloud Firestore com.google.firebase: firebase-firestore-ktx: 21.5.0
Cloud Functions for Firebase Client SDK com.google.firebase: fonctions-firebase-ktx: 19.0.2
Messagerie cloud com.google.firebase: messagerie Firebase: 20.2.4
Stockage en ligne com.google.firebase: firebase-storage-ktx: 19.1.1
Crashlytics com.google.firebase: firebase-crashlytics: 17.1.1
Liens dynamiques com.google.firebase: firebase-dynamic-links-ktx: 19.1.0
API Firebase ML Vision com.google.firebase: firebase-ml-vision: 24.0.3
API de modèle personnalisé Firebase ML com.google.firebase: interpréteur de modèle firebase-ml: 22.0.3
Messagerie dans l'application com.google.firebase: firebase-inappmessaging-ktx: 19.1.0
(obligatoire)
Affichage de la messagerie dans l'application com.google.firebase: firebase-inappmessaging-display-ktx: 19.1.0
(obligatoire)
Suivi de la performance com.google.firebase: firebase-perf: 19.0.8
Base de données en temps réel com.google.firebase: firebase-database-ktx: 19.3.1
Configuration à distance com.google.firebase: firebase-config-ktx: 19.2.0
Nomenclature Firebase (BoM) com.google.firebase: firebase-bom: 25.7.0

La dernière version de Firebase BoM contient les dernières versions de chaque bibliothèque Firebase Android disponible à la sortie de BoM. Pour les versions de bibliothèque mappées aux versions BoM précédentes, consultez les notes de publication de cette version.

Plug-in de services Google Play com.google.gms: services google: 4.3.3
Bibliothèques obsolètes
Firebase ML: modèle d'étiquetage d'image com.google.firebase: firebase-ml-vision-image-label-model: 20.0.1
Firebase ML: modèle de détection et de suivi d'objets com.google.firebase: Firebase-ml-vision-object-detection-model: 19.0.5
Firebase ML: modèle de détection de visage com.google.firebase: firebase-ml-vision-face-model: 20.0.1
Firebase ML: modèle de numérisation de codes-barres com.google.firebase: firebase-ml-vision-barcode-model: 16.1.1
Firebase ML: API AutoML Vision Edge com.google.firebase: firebase-ml-vision-automl: 18.0.5
Firebase ML: API en langage naturel com.google.firebase: firebase-ml-natural-language: 22.0.0
Firebase ML: modèle d'identification du langage com.google.firebase: firebase-ml-natural-language-language-id-model: 20.0.7
Firebase ML: Traduire le modèle com.google.firebase: firebase-ml-natural-language-translate-model: 20.0.8
Firebase ML: modèle de réponse intelligente com.google.firebase: firebase-ml-natural-language-smart-reply-model: 20.0.7

Prochaines étapes

En savoir plus sur Firebase:

Ajoutez des services Firebase à votre application: