Google 致力于为黑人社区推动种族平等。查看具体举措。

Ajouter Firebase à votre projet Android

Conditions préalables

  • Installer ou mettre à jour Android Studio est à sa dernière version.

  • Assurez-vous que votre projet répond aux exigences suivantes :

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

  • Mettre en place un dispositif physique ou utiliser un émulateur pour exécuter votre application.
    Notez que Firebase avec une dépendance SDKs sur les services Google Play nécessitent l'appareil ou émulateur pour avoir des services Google Play installés.

  • Connectez - vous à Firebase en utilisant votre compte Google.

Si vous ne possédez pas déjà un projet Android et que vous voulez juste essayer un produit Firebase, vous pouvez télécharger un de nos échantillons de démarrage rapide .


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

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


Option 1: Ajouter Firebase utilisant la console Firebase

Ajout Firebase à votre application implique des tâches à la fois dans la console Firebase et dans votre projet Android ouvert (par exemple, télécharger des fichiers de configuration Firebase de la console, puis de les déplacer 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. Visitez Comprendre Firebase projets 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 avec votre projet Firebase. L'enregistrement de votre application est souvent appelé "ajout" de votre application à votre projet.

  1. Allez à la console Firebase .

  2. Au centre de la page d'aperçu du projet, cliquez sur l'icône Android ( ) ou Ajouter application pour lancer le flux de travail de configuration.

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

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

  5. Cliquez sur l' application de vous inscrire.

Étape 3: Ajouter un fichier de configuration Firebase

  1. Ajoutez le fichier de configuration Android Firebase à 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 du module (au niveau de l'application) de votre application.

  2. Pour activer les produits Firebase dans votre application, ajoutez les services de google-plugin pour vos fichiers Gradle.

    1. Dans votre niveau racine (niveau du projet) de fichier Gradle ( build.gradle ), ajouter des règles pour inclure le plug - in Services Google 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.8'  // Google Services plugin
  }
}

allprojects {
  // ...

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

    2. Dans votre module fichier (app-niveau) Gradle (généralement app/build.gradle ), appliquer le plugin Google Services de Gradle:

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

android {
  // ...
}

Étape 4: Ajouter Firebase à votre application SDKs

  1. Utilisation de la Firebase Android BoM , déclarer les dépendances pour les produits Firebase que vous souhaitez utiliser dans votre application. Déclarer les dans votre module (app-niveau) de fichier Gradle (généralement app/build.gradle ).

    Analytique activée

    Java

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation platform('com.google.firebase:firebase-bom:28.3.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:28.3.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 le Firebase Android BoM , votre application utilise 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:28.3.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:28.3.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 le Firebase Android BoM , votre application utilise 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 passer à vérifier les recommandations prochaines étapes .

Si vous éprouvez des difficultés se mettre en place, bien que, visitez le dépannage Android et FAQ .


Option 2: Ajouter Firebase en utilisant l'assistant Firebase

L' assistant Firebase enregistre votre application avec un projet Firebase et ajoute les fichiers nécessaires Firebase, plugins et dépendances à votre projet Android - tout cela 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: Aide> Rechercher les mises à jour
    • macOS: Android> Studio de Check for Updates

  2. Ouvrez l'Assistant Firebase: Outils> Firebase.

  3. Dans le volet assistant, choisissez un produit Firebase ajouter à votre application. Développez la section, puis cliquez sur le lien tutoriel (par exemple, Google Analytics> Log un événement Analytics).

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

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

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

  5. Dans le volet adjoint, suivez les instructions d'installation restantes pour votre produit Firebase sélectionné.

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

C'est ça! Assurez - vous de vérifier les recommandations prochaines étapes .

Si vous éprouvez des difficultés se mettre en place, bien que, visitez le dépannage Android et FAQ .


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 Android Firebase :

Notez que lorsque vous utilisez le Firebase Android BoM , vous ne spécifiez pas les versions de bibliothèque individuelles lorsque vous déclarez les dépendances de la bibliothèque Firebase dans build.gradle .

Java

Service ou produit Dépendance Gradle Dernier
version		 Ajouter des analyses ?
Nomenclature Android Firebase
(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 de nomenclature spécifique, consultez les notes de publication de cette version de nomenclature.

 28.3.0
AdMob com.google.android.gms:play-services-ads 20.2.0
Analytique com.google.firebase:firebase-analytics 19.0.0
Fournisseur personnalisé App Check com.google.firebase:firebase-appcheck 16.0.0-beta02
Fournisseur de débogage App Check com.google.firebase:firebase-appcheck-debug 16.0.0-beta02
Fournisseur App Check SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.0.0-beta02
Plugin de distribution d'applications com.google.firebase:firebase-appdistribution-gradle 2.1.3
Indexation des applications com.google.firebase:firebase-appindexation 20.0.0
Authentification com.google.firebase:firebase-auth 21.0.1
Cloud Firestore com.google.firebase:firebase-firestore 23.0.3
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 20.0.0
Messagerie Cloud com.google.firebase:firebase-messagerie 22.0.0
Stockage en ligne com.google.firebase:firebase-storage 20.0.0
Crashlytiques com.google.firebase:firebase-crashlytics 18.2.0
NDK de Crashlytics com.google.firebase:firebase-crashlytics-ndk 18.2.0
Plugin Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.7.1
Prise en charge du module de fonctionnalité dynamique com.google.firebase:firebase-dynamic-module-support 16.0.0-beta01
Liens dynamiques com.google.firebase:firebase-dynamic-links 20.1.1
Messagerie intégrée com.google.firebase:firebase-inappmessaging 20.0.0
(obligatoire)
Affichage de la messagerie dans l'application com.google.firebase:firebase-inappmessaging-display 20.0.0
(obligatoire)
Installations de base de feu com.google.firebase:firebase-installations 17.0.0
API de téléchargement de modèles Firebase ML com.google.firebase:firebase-ml-modeldownloader 24.0.0
Suivi de la performance com.google.firebase:firebase-perf 20.0.2
Plugin de surveillance des performances com.google.firebase:perf-plugin 1.4.0
Base de données en temps réel com.google.firebase:firebase-database 20.0.1
Configuration à distance com.google.firebase:firebase-config 21.0.0
Plugin de services Google Play com.google.gms:google-services 4.3.8
Bibliothèques obsolètes
API de modèle personnalisé Firebase ML com.google.firebase:firebase-ml-model-interpreter 22.0.4
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 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 de langage naturel com.google.firebase:firebase-ml-langue-naturelle 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 : 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 des analyses ?
Nomenclature Android Firebase
(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 de nomenclature spécifique, consultez les notes de publication de cette version de nomenclature.

 28.3.0
AdMob com.google.android.gms:play-services-ads 20.2.0
Analytique com.google.firebase:firebase-analytics-ktx 19.0.0
Fournisseur personnalisé App Check com.google.firebase:firebase-appcheck 16.0.0-beta02
Fournisseur de débogage App Check com.google.firebase:firebase-appcheck-debug 16.0.0-beta02
Fournisseur App Check SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.0.0-beta02
Plugin de distribution d'applications com.google.firebase:firebase-appdistribution-gradle 2.1.3
Indexation des applications com.google.firebase:firebase-appindexation 20.0.0
Authentification com.google.firebase:firebase-auth-ktx 21.0.1
Cloud Firestore com.google.firebase:firebase-firestore-ktx 23.0.3
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions-ktx 20.0.0
Messagerie Cloud com.google.firebase:firebase-messaging-ktx 22.0.0
Stockage en ligne com.google.firebase:firebase-storage-ktx 20.0.0
Crashlytiques com.google.firebase:firebase-crashlytics-ktx 18.2.0
NDK de Crashlytics com.google.firebase:firebase-crashlytics-ndk 18.2.0
Plugin Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.7.1
Prise en charge du module de fonctionnalité dynamique com.google.firebase:firebase-dynamic-module-support 16.0.0-beta01
Liens dynamiques com.google.firebase:firebase-dynamic-links-ktx 20.1.1
Messagerie intégrée com.google.firebase:firebase-inappmessaging-ktx 20.0.0
(obligatoire)
Affichage de la messagerie dans l'application com.google.firebase:firebase-inappmessaging-display-ktx 20.0.0
(obligatoire)
Installations de base de feu com.google.firebase:firebase-installations-ktx 17.0.0
API de téléchargement de modèles Firebase ML com.google.firebase:firebase-ml-modeldownloader-ktx 24.0.0
Suivi de la performance com.google.firebase:firebase-perf-ktx 20.0.2
Plugin de surveillance des performances com.google.firebase:perf-plugin 1.4.0
Base de données en temps réel com.google.firebase:firebase-database-ktx 20.0.1
Configuration à distance com.google.firebase:firebase-config-ktx 21.0.0
Plugin de services Google Play com.google.gms:google-services 4.3.8
Bibliothèques obsolètes
API de modèle personnalisé Firebase ML com.google.firebase:firebase-ml-model-interpreter 22.0.4
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 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 de langage naturel com.google.firebase:firebase-ml-langue-naturelle 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 : 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 :