Lorsque vous développez votre projet Android à l'aide de Firebase, vous pouvez découvrir des concepts qui ne sont pas familiers ou spécifiques à Firebase. Cette page vise à répondre à ces questions ou à vous diriger vers des ressources pour en savoir plus.
Si vous avez des questions sur un sujet non traité sur cette page, n'hésitez pas à visiter l'une de nos communautés en ligne . Nous mettrons également régulièrement à jour cette page avec de nouveaux sujets, alors revenez voir si nous avons ajouté le sujet sur lequel vous souhaitez en savoir plus!
Plug-in Firebase Assistant pour Android Studio
L'assistant Firebase est un plugin Android Studio qui enregistre votre application Android avec un projet Firebase et ajoute les fichiers de configuration Firebase, les plugins et les dépendances nécessaires à votre projet Android - le tout depuis Android Studio!
Suivez les instructions de la page de démarrage d'Android pour utiliser l'assistant Firebase. Assurez-vous que vous utilisez les versions les plus récentes d'Android Studio et de Firebase Assistant (accédez à Fichier> Rechercher les mises à jour ).
Lorsque vous sélectionnez des produits Firebase spécifiques à ajouter à votre application, l'assistant Firebase déclare automatiquement les dépendances requises dans votre fichier app/build.gradle
. Cependant, pour utiliser des fonctionnalités Firebase qui dépassent les capacités actuelles de Firebase Assistant, vous souhaiterez peut-être apporter des modifications manuelles à ces dépendances:
Si vous souhaitez utiliser Firebase Android BoM , mettez à jour les dépendances dans votre fichier Gradle de module (au niveau de l'application) (généralement
app/build.gradle
) pour importer la plate-forme BoM. Vous devrez également supprimer les versions de chaque ligne de dépendance de bibliothèque Firebase.Si vous souhaitez utiliser une bibliothèque d'extensions Kotlin , modifiez la ligne de dépendance ajoutée à votre fichier Gradle de module (au niveau de l'application) (généralement
app/build.gradle
) pour utiliser la versionktx
de la bibliothèque Firebase à la place.
Services Google - plugin et fichier de configuration
Dans le cadre de l'ajout de Firebase à votre projet Android, vous devez ajouter le plug google-services
in google-services
et un fichier de configuration
à votre projet.
Si vous ajoutez Firebase à votre projet Android via la console Firebase , l' API Management REST ou la CLI Firebase , vous devez ajouter manuellement le plug-in et le fichier de configuration à votre projet. Cependant, si vous utilisez Firebase Assistant , ces tâches sont automatiquement effectuées pour vous lors de la configuration.
Consultez la documentation Android pour découvrir comment le plug-in des services Google et le fichier de configuration fonctionnent ensemble.
Firebase Android BoM (nomenclature)
Le Firebase Android BoM (Bill of Materials) vous permet de gérer toutes les versions de votre bibliothèque Firebase en ne spécifiant qu'une seule version - la version de BoM.
Lorsque vous utilisez Firebase BoM dans votre application, BoM extrait automatiquement les versions de bibliothèque individuelles mappées à la version de BoM. Toutes les versions de bibliothèques individuelles seront compatibles. Lorsque vous mettez à jour la version de BoM dans votre application, toutes les bibliothèques Firebase que vous utilisez dans votre application seront mises à jour vers les versions mappées à cette version de BoM.
Pour savoir quelles versions de la bibliothèque Firebase sont mappées à une version BoM spécifique, consultez les notes de publication de cette version BoM. Si vous avez besoin de comparer les versions de bibliothèque mappées à une version BoM par rapport à une autre version BoM, utilisez le widget de comparaison ci-dessous.
En savoir plus sur la prise en charge de Gradle pour les plates-formes BoM .
Voici comment utiliser Firebase Android BoM pour déclarer des dépendances dans votre fichier Gradle de module (au niveau de l'application) (généralement app/build.gradle
). Lorsque vous utilisez BoM, vous ne spécifiez pas de versions de bibliothèque individuelles dans les lignes de dépendance.
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:27.0.0') // Declare the dependencies for the desired Firebase products without specifying versions // For example, declare the dependencies for Firebase Authentication and Cloud Firestore implementation 'com.google.firebase:firebase-auth' implementation 'com.google.firebase:firebase-firestore' }
Voici quelques questions fréquemment posées sur l'utilisation de Firebase Android BoM:
Voici comment remplacer une version de bibliothèque désignée dans la BoM:
Maintenez la ligne pour importer la plateforme BoM.
Dans la ligne de dépendance de la bibliothèque, spécifiez la version de bibliothèque souhaitée. Par exemple, voici comment déclarer des dépendances si vous souhaitez utiliser la v18.0.0 de l'indexation des applications, quelle que soit la version désignée dans le BoM, mais que vous souhaitez utiliser les versions de BoM pour l'authentification et Cloud Firestore:
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:27.0.0') // Declare the dependency for the App Indexing library and specify a version // This specified library version overrides the version designated in the BoM. implementation 'com.google.firebase:firebase-appindexing:18.0.0' // Declare the dependencies for the other Firebase libraries without specifying versions // These libraries will use the versions designated in the BoM. implementation 'com.google.firebase:firebase-auth' implementation 'com.google.firebase:firebase-firestore' }
Non. Pour ajouter et utiliser des bibliothèques Firebase dans votre application, vous devez déclarer chaque bibliothèque comme une ligne de dépendance distincte dans le fichier Gradle de votre module (au niveau de l'application) (généralement app/build.gradle
).
À l' aide des BoM assure que les versions de toutes les bibliothèques Firebase dans votre application sont compatibles, mais le BoM n'ajoute pas les bibliothèques Firebase à votre application.
Oui! Lorsque vous déclarez vos lignes de dépendance de bibliothèque Firebase spécifiques, utilisez simplement le nom de la bibliothèque KTX, comme ceci:
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:27.0.0') // Declare the dependencies for the desired Firebase products, without specifying versions // 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' }
Non. Firebase Android BoM gère uniquement les versions de bibliothèque pour les bibliothèques Firebase. La seule exception est l'inclusion du SDK Google Mobile Ads, car il est si couramment utilisé dans les applications Firebase.
Même si chaque bibliothèque Firebase est versionnée indépendamment, elles sont construites ensemble pour garantir que la dernière version de chaque bibliothèque est compatible avec les autres.
En utilisant BoM pour gérer les versions de la bibliothèque Firebase de votre application, vous n'avez pas besoin de savoir quelle version d'une bibliothèque Firebase est compatible avec une autre bibliothèque Firebase.
Même si vous n'utilisez qu'une seule bibliothèque Firebase dans votre application pour le moment, nous vous recommandons toujours d'utiliser BoM car vous ne savez jamais quand vous voudrez peut-être utiliser une autre bibliothèque Firebase!
Oui, vous pouvez toujours utiliser le BoM! Pour Gradle 5.0 et versions ultérieures, la prise en charge BoM est automatiquement activée. Cependant, pour les versions antérieures de Gradle, il vous suffit d' activer la fonction BoM et d'importer le BoM un peu différemment.
À votre fichier
settings.gradle
, ajoutezenableFeaturePreview('IMPROVED_POM_SUPPORT')
.Dans le fichier Gradle de votre module (au niveau de l'application) (généralement
app/build.gradle
), importez le BoM comme une bibliothèque normale (sans le modificateur deplatform
-platform
), comme ceci:dependencies { // Import the Firebase BoM implementation 'com.google.firebase:firebase-bom:27.0.0' // Declare the dependencies for the desired Firebase products, without specifying versions // For example, declare the dependencies for Firebase Authentication and Cloud Firestore implementation 'com.google.firebase:firebase-auth' implementation 'com.google.firebase:firebase-firestore' }
Visitez le dépôt du SDK Firebase Android sur GitHub .
Comparez les versions de Firebase BoM
Bibliothèques d'extensions Kotlin (KTX)
Les bibliothèques d'extensions Firebase Kotlin (KTX) sont de petits compagnons des SDK Firebase de base qui vous permettent d'écrire du code Kotlin magnifique et idiomatique.
Pour utiliser une bibliothèque KTX dans votre application, modifiez votre dépendance pour inclure le suffixe -ktx
. Chaque bibliothèque KTX a automatiquement une dépendance sur la bibliothèque de base, il n'est donc pas nécessaire d'inclure les deux dépendances dans votre application.
dependencies { // Import the BoM for the Firebase platform (learn more) implementation platform('com.google.firebase:firebase-bom:27.0.0')// Declare the base library implementation 'com.google.firebase:firebase-analytics'// Declare the KTX library instead (which automatically has a dependency on the base library) implementation 'com.google.firebase:firebase-analytics-ktx' }
Chaque bibliothèque KTX fournit différentes extensions syntaxiques de la bibliothèque de base. Par exemple, la bibliothèque Analytics KTX simplifie la journalisation des événements:
Avant (utilisation de la bibliothèque de base)
val analytics = FirebaseAnalytics.getInstance(); val bundle = Bundle(); bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id); bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name); bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image"); analytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM, bundle);
Après (en utilisant la bibliothèque KTX à la place)
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) { param(FirebaseAnalytics.Param.ITEM_ID, id) param(FirebaseAnalytics.Param.ITEM_NAME, name) param(FirebaseAnalytics.Param.CONTENT_TYPE, "image") }
Tous les produits Firebase proposent une bibliothèque KTX à l' exception de Firebase ML et de l'indexation des applications.
Si vous ne l'avez pas encore fait, consultez la documentation de référence de l' API pour les bibliothèques KTX.
Plugin Gradle des services Google vs services Google Play vs Google Play Store
Plusieurs éléments de l'écosystème Google, Firebase et Android ont des conventions de dénomination similaires. Voici une brève explication pour chacun:
- Plugin Gradle des services Google
- Un plugin Gradle (
com.google.gms.google-services
) qui s'exécute au moment de la construction pour garantir que votre application dispose de la bonne configuration pour accéder aux API Firebase et Google - Malgré son nom, ce plugin n'a aucun rapport avec les services Google Play (voir l'entrée suivante) et n'a aucun impact sur les capacités de votre application au moment de l'exécution.
- Ce plugin traite également le fichier
google-services.json
que vous ajoutez à votre application dans le cadre de la configuration de Firebase. En savoir plus sur le plug-in Gradle des services Google . - Services Google Play
- Un service d'arrière-plan invisible qui s'exécute sur un appareil Android et fournit plusieurs API Google courantes (comme Google Maps et Google Sign In) aux applications sur l'appareil
- En centralisant ces API communes dans un seul service, cela réduit la taille des autres applications et permet à un appareil de recevoir des mises à jour de sécurité automatiques et des améliorations de fonctionnalités sans mise à jour du système d'exploitation. En savoir plus sur les services Google Play .
- Google Play Store
- Un magasin pour télécharger des applications, des films, des livres et plus encore sur un appareil Android
- En tant que développeur, vous gérez la distribution, les versions, etc. de votre application via la console Google Play. Si un appareil dispose du Google Play Store, il exécute également les services Google Play (voir l'entrée précédente). En savoir plus sur le Google Play Store pour les développeurs .
- Services Google Play Jeux
- Un ensemble d'API pour les développeurs de jeux mobiles
- En savoir plus sur les services Google Play Jeux et comment intégrer Firebase à votre projet de services Google Play Jeux .
Ressources Open Source pour les SDK Firebase Android
Firebase prend en charge le développement open source et nous encourageons les contributions et commentaires de la communauté.
SDK Android Firebase
La plupart des SDK Firebase Android sont développés en tant que bibliothèques open source dans notre référentiel public Firebase GitHub . Nous travaillons activement pour déplacer bientôt les bibliothèques Firebase développées en privé vers notre GitHub public!
Exemples de démarrage rapide
Firebase gère une collection d'exemples de démarrage rapide pour la plupart des API Firebase sur Android. Retrouvez ces guides de démarrage rapide dans notre référentiel de démarrage rapide Firebase GitHub .
Vous pouvez ouvrir chaque démarrage rapide en tant que projet Android Studio, puis les exécuter sur un appareil mobile ou un appareil virtuel (AVD). Vous pouvez également utiliser ces démarrages rapides comme exemple de code pour utiliser les SDK Firebase.