Comprendre les projets Firebase

Cette page présente brièvement plusieurs concepts importants concernant les projets Firebase. Lorsque cela est possible, suivez les liens pour obtenir des informations plus détaillées sur les fonctionnalités, les services, les outils et les bonnes pratiques.

Relation entre les projets, applications et produits Firebase

Un projet Firebase est l'entité de niveau supérieur de Firebase. Dans un projet, vous pouvez enregistrer vos applications Apple, Android ou Web. Une fois que vous avez enregistré vos applications auprès de Firebase, vous pouvez ajouter les SDK Firebase pour un nombre illimité de produits Firebase, comme Analytics, Cloud Firestore, Performance Monitoring ou Remote Config.

Pour en savoir plus sur ce processus, consultez le guide de démarrage de votre plate-forme:
iOS+ | Android | Web | Unity | C++ | Flutter.

Comprendre la hiérarchie des projets Firebase

Schéma illustrant la hiérarchie de base d'un projet Firebase, y compris le projet, ses applications enregistrées, ainsi que ses ressources et services provisionnés Ce schéma présente la hiérarchie de base d'un projet Firebase. Voici les principales relations:

  • Un projet Firebase est comme un conteneur pour toutes vos applications, ainsi que pour les ressources et les services provisionnés pour le projet.

  • Un projet Firebase peut comporter une ou plusieurs applications Firebase enregistrées (par exemple, les versions iOS et Android d'une application, ou les versions sans frais et payante d'une application).

  • Toutes les applications Firebase enregistrées dans le même projet Firebase partagent et ont accès à toutes les mêmes ressources et services provisionnés pour le projet. Voici quelques exemples :

    • Toutes les applications Firebase enregistrées dans le même projet Firebase partagent les mêmes backends, comme Firebase Hosting, Authentication, Realtime Database, Cloud Firestore, Cloud Storage et Cloud Functions.

    • Toutes les applications Firebase enregistrées dans le même projet Firebase sont associées à la même propriété Google Analytics, où chaque application Firebase est un flux de données distinct dans cette propriété.

Relation entre les projets Firebase et Google Cloud

Lorsque vous créez un projet Firebase, c'est en fait un projet Google Cloud que vous créez en coulisses. Vous pouvez même créer d'abord un projet Google Cloud, puis ajouter Firebase à ce projet plus tard. Vous pouvez considérer un projet Google Cloud comme un conteneur virtuel pour les données, le code, la configuration et les services.

Notez que pour tous les projets Firebase, Firebase ajoute automatiquement un libellé firebase:enabled sur la page Libellés de votre projet dans la console Google Cloud. Pour en savoir plus sur ce libellé, consultez nos questions fréquentes.

Étant donné qu'un projet Firebase est un projet Google Cloud:

  • Vous pouvez interagir avec un projet dans la console Firebase, ainsi que dans la console Google Cloud et la console Google APIs.

  • Vous pouvez utiliser des produits et des API de Firebase et de Google Cloud dans un projet.

  • Les autorisations et rôles IAM d'un projet sont partagés entre Firebase et Google Cloud. Tout accès d'un membre de votre projet à votre projet Google Cloud s'applique également à votre projet Firebase (et inversement).

  • La facturation d'un projet est partagée entre Firebase et Google Cloud. Si la facturation est activée pour votre projet Google Cloud, votre projet Firebase sera inclus dans le forfait Blaze avec paiement à l'usage de Firebase.

  • Les identifiants uniques d'un projet (comme le numéro de projet et l'ID de projet) sont partagés entre Firebase et Google Cloud.

  • La suppression d'un projet le supprime dans Firebase et Google Cloud.

  • La suppression ou la modification d'une ressource ou de données dans un projet s'applique à Firebase et à Google Cloud.

Configurer un projet Firebase et enregistrer des applications

Vous pouvez configurer un projet Firebase et enregistrer des applications dans la console Firebase (ou, pour les cas d'utilisation avancés, via l'API REST de gestion Firebase ou la CLI Firebase). Lorsque vous configurez un projet et enregistrez des applications, vous devez prendre des décisions d'organisation et ajouter des informations de configuration spécifiques à Firebase à vos projets locaux.

Pour les applications de production, vous devez configurer un workflow de développement clair, qui implique généralement l'utilisation de plusieurs environnements. Consultez notre documentation sur les flux de travail pour les développeurs, y compris les bonnes pratiques générales et les consignes générales de sécurité pour configurer des projets Firebase et enregistrer des applications afin de créer votre workflow de développement.

Interagir avec un projet Firebase

En plus des SDK de produits, vous pouvez interagir directement avec un projet Firebase à l'aide de plusieurs outils et interfaces différents.

Console Firebase

La console Firebase offre l'environnement le plus riche pour gérer les produits, les applications et les paramètres au niveau du projet Firebase.

<span class=Console Firebase - écran d'aperçu du projet" class="attempt-right screenshot" style="max-width: calc((100% - 40px)/1.75);">

Le panneau de gauche de la console liste les produits Firebase, organisés par catégories de premier niveau. En haut du panneau de gauche, accédez aux paramètres d'un projet en cliquant sur . Les paramètres d'un projet incluent les intégrations, les autorisations d'accès et la facturation.

Le milieu de la console affiche des boutons qui lancent des workflows de configuration pour enregistrer différents types d'applications. Une fois que vous commencez à utiliser Firebase, la zone principale de la console se transforme en tableau de bord qui affiche des statistiques sur les produits que vous utilisez.

Notez qu'un projet Firebase est également un projet Google Cloud. Vous constaterez peut-être que diverses tâches ou produits nécessitent d'utiliser la console Google Cloud plutôt que la console Firebase.

CLI Firebase (outil de ligne de commande)

Firebase propose également la CLI Firebase pour configurer et gérer des produits Firebase spécifiques, comme Firebase Hosting, Cloud Functions for Firebase et Firebase Extensions.

Après avoir installé la CLI, vous avez accès à la commande firebase globale. Utilisez la CLI pour associer votre répertoire d'application local à un projet Firebase, puis déployez de nouvelles versions de contenu hébergé par Firebase ou des mises à jour de fonctions.

API REST Firebase Management

L'API REST Firebase Management vous permet de gérer un projet Firebase de manière automatisée. Par exemple, vous pouvez enregistrer de manière programmatique une application avec un projet ou lister les applications déjà enregistrées (iOS+ | Android | Web).

Identifiants de projet Firebase

Un projet Firebase peut être identifié dans le backend Firebase et dans diverses interfaces pour les développeurs à l'aide de différents identifiants, y compris le nom du projet, le numéro de projet et l'ID de projet.

Nom du projet

Lorsque vous créez un projet, vous lui attribuez un nom. Cet identifiant est le nom interne uniquement d'un projet dans la console Firebase, la console Google Cloud et la CLI Firebase. Le nom du projet n'est pas exposé dans aucun produit, service ou ressource Firebase ou Google Cloud visible publiquement. Il sert simplement à vous aider à distinguer plus facilement plusieurs projets.

Vous pouvez modifier le nom d'un projet à tout moment dans les paramètres du projet de la console .Firebase Le nom du projet s'affiche dans le volet supérieur.

Numéro du projet

Un projet Firebase (et son projet Google Cloud associé) possède un numéro de projet. Il s'agit de l'identifiant canonique unique au niveau mondial attribué par Google pour le projet. Utilisez cet identifiant lorsque vous configurez des intégrations et/ou effectuez des appels d'API vers Firebase, Google ou des services tiers.

Vous ne pouvez pas modifier un numéro de projet. Si vous supprimez un projet, son numéro est également supprimé et ne peut plus jamais être utilisé par un autre projet.

ID du projet

Un projet Firebase (et son projet Google Cloud associé) possède un ID de projet. Il s'agit d'un identifiant unique défini par l'utilisateur pour le projet dans l'ensemble de Firebase et de Google Cloud. Lorsque vous créez un projet Firebase, Firebase lui attribue automatiquement un ID unique, mais vous pouvez le modifier lors de la configuration du projet. Vous pouvez généralement considérer cet identifiant comme un alias pratique pour faire référence au projet.

Fichiers et objets de configuration Firebase

Lorsque vous enregistrez une application avec un projet Firebase, la console Firebase fournit un fichier de configuration Firebase (applications Apple/Android) ou un objet de configuration (applications Web) que vous ajoutez directement à votre répertoire d'applications local.

  • Pour les applications Apple, vous devez ajouter un fichier de configuration GoogleService-Info.plist.
  • Pour les applications Android, vous devez ajouter un fichier de configuration google-services.json.
  • Pour les applications Web, vous devez ajouter un objet de configuration Firebase.

Vous pouvez à tout moment obtenir le fichier ou l'objet de configuration Firebase d'une application.

Un fichier ou un objet de configuration Firebase associe une application à un projet Firebase spécifique et à ses ressources (bases de données, buckets de stockage, etc.). La configuration inclut des "options Firebase", qui sont des paramètres requis par les services Firebase et Google pour communiquer avec les API de serveur Firebase et associer les données client au projet et à l'application Firebase. Voici les "options Firebase" minimales requises :

  • Clé API: chaîne chiffrée simple utilisée lors de l'appel de certaines API qui n'ont pas besoin d'accéder aux données utilisateur privées (exemple de valeur: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO)

  • ID de projet: identifiant unique défini par l'utilisateur pour le projet dans l'ensemble de Firebase et de Google Cloud. Il peut figurer dans des URL ou des noms de ressources Firebase, mais vous pouvez principalement le considérer comme un alias pratique pour faire référence au projet. (exemple de valeur: myapp-project-123)

  • ID d'application ("AppID"): identifiant unique de l'application Firebase dans l'ensemble de Firebase, avec un format propre à la plate-forme:

    • Applications Apple Firebase: GOOGLE_APP_ID (exemple de valeur : 1:1234567890:ios:321abc456def7890)
      Il ne s'agit pas d'un ID de bundle Apple.
    • Applications Android créées avec Firebase: mobilesdk_app_id (exemple de valeur : 1:1234567890:android:321abc456def7890)
      Il ne s'agit pas d'un nom de package Android ni d'un ID d'application Android.
    • Applications Web Firebase: appId (exemple de valeur : 1:65211879909:web:3ae38ef1cdcb2e01fe5f0c)

Le contenu du fichier ou de l'objet de configuration Firebase est considéré comme public, y compris l'ID propre à la plate-forme de l'application (ID de bundle Apple ou nom du package Android) et les valeurs propres au projet Firebase, comme la clé API, l'ID du projet, l'URL Realtime Database et le nom du bucket Cloud Storage. Par conséquent, utilisez Firebase Security Rules pour protéger vos données et vos fichiers dans Realtime Database, Cloud Firestore et Cloud Storage.

Pour les projets Open Source, nous vous recommandons généralement de ne pas inclure le fichier ou l'objet de configuration Firebase de l'application dans le contrôle des sources. En effet, dans la plupart des cas, vos utilisateurs doivent créer leurs propres projets Firebase et rediriger leurs applications vers leurs propres ressources Firebase (via leur propre fichier ou objet de configuration Firebase).

Limites générales pour les projets, applications et sites Firebase

Voici quelques limites générales concernant les projets, applications et sites Firebase:

  • Nombre de projets par compte

    • Forfait Spark : le quota de création de projets est limité à un nombre inférieur de projets (généralement entre 5 et 10).
    • Forfait Blaze : le quota de création de projets par compte augmente considérablement tant que le compte Cloud Billing associé est en règle.

    La limite de quota de création de projets est rarement un problème pour la plupart des développeurs. Toutefois, si nécessaire, vous pouvez demander à augmenter votre quota de projets.

    Notez que la suppression complète d'un projet prend 30 jours et est comptabilisée dans le quota de projets jusqu'à sa suppression définitive.

  • Nombre d'applications par projet

    Firebase limite le nombre total d'applications Firebase dans un projet Firebase à 30.

    Vous devez vous assurer que toutes les applications Firebase d'un même projet Firebase sont des variantes de plate-forme de la même application du point de vue de l'utilisateur final. Pour en savoir plus sur l'architecture multitenancy, consultez nos documents sur les bonnes pratiques.

    Pour en savoir plus sur la limite d'applications par projet, consultez les questions fréquentes.

  • Nombre de sites Hosting par projet

    La fonctionnalité multisite Firebase Hosting accepte un maximum de 36 sites par projet.

Lancer votre application