Google 致力于为黑人社区推动种族平等。查看具体举措。
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.
    Notez que les SDK Firebase avec une dépendance aux services Google Play nécessitent que l'appareil ou l'émulateur ait installé les services Google Play.

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

Si vous ne possédez 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 (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 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

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

  1. Accédez à la console Firebase .

  2. Au centre de la page de du projet, cliquez sur l'icône Android ( ) ou 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) 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 (au niveau de l'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 que vous disposez également 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.5'  // 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. À l'aide de Firebase Android BoM , déclarez les dépendances des produits Firebase que vous souhaitez utiliser dans votre application. Déclarez-les dans le fichier Gradle de votre module (au niveau de l'application) (généralement app/build.gradle ).

    Analytics activé

    Java

    dependencies {
  // ...

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

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

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

  // Declare the dependencies for any other desired Firebase products
  // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
  implementation 'com.google.firebase:firebase-auth'
  implementation 'com.google.firebase:firebase-firestore'
}

    Kotlin + KTX

    dependencies {
  // ...

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

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

  // Declare the dependency for the Firebase SDK for Google Analytics
  implementation 'com.google.firebase:firebase-analytics-ktx'

  // Declare the dependencies for any other desired Firebase products
  // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
  implementation 'com.google.firebase:firebase-auth-ktx'
  implementation 'com.google.firebase:firebase-firestore-ktx'
}

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

    Analytics non activé

    Java

    dependencies {
  // ...

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

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

  // Declare the dependencies for the desired Firebase products
  // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
  implementation 'com.google.firebase:firebase-auth'
  implementation 'com.google.firebase:firebase-firestore'
}

    Kotlin + KTX

    dependencies {
  // ...

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

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

  // Declare the dependencies for the desired Firebase products
  // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
  implementation 'com.google.firebase:firebase-auth-ktx'
  implementation 'com.google.firebase:firebase-firestore-ktx'
}

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

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

C'est ça! Vous pouvez ignorer les étapes suivantes recommandées.


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

L' assistant Firebase enregistre votre application avec un projet Firebase et ajoute les fichiers, plugins et dépendances Firebase nécessaires à votre projet Android - le tout depuis Android Studio!

  1. Ouvrez votre projet Android dans Android Studio et accédez à l'assistant Firebase:

    1. Accédez à Fichier> Rechercher des mises à jour pour vous assurer que vous utilisez les dernières versions d'Android Studio et de l'assistant Firebase.

    2. Accédez à Outils> Firebase pour ouvrir le volet Assistant .

  2. 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 ).

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

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

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

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

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

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


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:

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 build.gradle .

Java

Service ou produit Dépendance Gradle Dernier
version		 Ajouter Analytics?
Firebase Android BoM
(Nomenclature)		 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 sont mappées à une version BoM spécifique, consultez les notes de publication de cette version BoM.

 27.0.0
AdMob com.google.android.gms: annonces de services de lecture 20.0.0
Analytique com.google.firebase: firebase-analytics 18.0.3
Indexation des applications com.google.firebase: firebase-appindexing 19.2.0
Authentification com.google.firebase: firebase-auth 20.0.4
Cloud Firestore com.google.firebase: firebase-firestore 22.1.2
Cloud Functions for Firebase Client SDK com.google.firebase: fonctions firebase 19.2.0
Messagerie cloud com.google.firebase: messagerie Firebase 21.1.0
Stockage en ligne com.google.firebase: stockage firebase 19.2.2
Crashlytics com.google.firebase: firebase-crashlytics 17.4.1
Liens dynamiques com.google.firebase: liens-dynamiques-firebase 19.1.1
API Firebase ML Model Downloader com.google.firebase: firebase-ml-modeldownloader 23.0.0
Messagerie dans l'application com.google.firebase: firebase-inappmessaging 19.1.5
(obligatoire)
Affichage de la messagerie dans l'application com.google.firebase: firebase-inappmessaging-display 19.1.5
(obligatoire)
Suivi de la performance com.google.firebase: firebase-perf 19.1.1
Base de données en temps réel com.google.firebase: base de données firebase 19.7.0
Configuration à distance com.google.firebase: firebase-config 20.0.4
Plug-in de services Google Play com.google.gms: services google 4.3.5
Bibliothèques obsolètes
API de modèle personnalisé Firebase ML com.google.firebase: interpréteur de modèle firebase-ml 22.0.4
API Firebase ML Vision com.google.firebase: firebase-ml-vision 24.1.0
Firebase ML: modèle d'étiquetage d'image 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 visage com.google.firebase: firebase-ml-vision-face-model 20.0.2
Firebase ML: modèle de numérisation 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 en langage naturel com.google.firebase: firebase-ml-natural-language 22.0.1
Firebase ML: modèle d'identification du langage com.google.firebase: firebase-ml-natural-language-language-id-model 20.0.8
Firebase ML: Traduire le modèle com.google.firebase: firebase-ml-natural-language-translate-model 20.0.9
Firebase ML: modèle de réponse intelligente com.google.firebase: firebase-ml-natural-language-smart-reply-model 20.0.8

Kotlin + KTX

Service ou produit Dépendance Gradle Dernier
version		 Ajouter Analytics?
Firebase Android BoM
(Nomenclature)		 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 sont mappées à une version BoM spécifique, consultez les notes de publication de cette version BoM.

 27.0.0
AdMob com.google.android.gms: annonces de services de lecture 20.0.0
Analytique com.google.firebase: firebase-analytics-ktx 18.0.3
Indexation des applications com.google.firebase: firebase-appindexing 19.2.0
Authentification com.google.firebase: firebase-auth-ktx 20.0.4
Cloud Firestore com.google.firebase: firebase-firestore-ktx 22.1.2
Cloud Functions for Firebase Client SDK com.google.firebase: firebase-functions-ktx 19.2.0
Messagerie cloud com.google.firebase: firebase-messaging-ktx 21.0.1
Stockage en ligne com.google.firebase: firebase-storage-ktx 19.2.2
Crashlytics com.google.firebase: firebase-crashlytics-ktx 17.4.1
Liens dynamiques com.google.firebase: firebase-dynamic-links-ktx 19.1.1
Messagerie dans l'application com.google.firebase: firebase-inappmessaging-ktx 19.1.5
(obligatoire)
Affichage de la messagerie dans l'application com.google.firebase: firebase-inappmessaging-display-ktx 19.1.5
(obligatoire)
Suivi de la performance com.google.firebase: firebase-perf-ktx 19.1.1
Base de données en temps réel com.google.firebase: firebase-database-ktx 19.7.0
Configuration à distance com.google.firebase: firebase-config-ktx 20.0.4
Plug-in de services Google Play com.google.gms: services google 4.3.5
Bibliothèques obsolètes
API de modèle personnalisé Firebase ML com.google.firebase: interpréteur de modèle firebase-ml 22.0.4
API Firebase ML Vision com.google.firebase: firebase-ml-vision 24.1.0
Firebase ML: modèle d'étiquetage d'image 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 visage com.google.firebase: firebase-ml-vision-face-model 20.0.2
Firebase ML: modèle de numérisation 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 en langage naturel com.google.firebase: firebase-ml-natural-language 22.0.1
Firebase ML: modèle d'identification du langage com.google.firebase: Firebase-ml-natural-language-language-id-model 20.0.8
Firebase ML: Traduire le modèle com.google.firebase: firebase-ml-natural-language-translate-model 20.0.9
Firebase ML: modèle de réponse intelligente com.google.firebase: firebase-ml-natural-language-smart-reply-model 20.0.8


Prochaines étapes

Ajoutez des services Firebase à votre application:

En savoir plus sur Firebase: