查看 2022 年 Google I/O 大会上介绍的 Firebase 新动态。了解详情

Comprendre les projets Firebase

Cette page propose de brefs aperçus de plusieurs concepts importants concernant les projets Firebase. Lorsqu'ils sont disponibles, suivez les liens pour trouver des informations plus détaillées sur les fonctionnalités, les services, les outils et les meilleures pratiques.

Relation entre les projets, les applications et les produits Firebase

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

Découvrez des informations plus détaillées sur ce processus dans le guide de démarrage de votre plate-forme :
iOS+ | Android | web | Unité | C++ | Flutter .

Comprendre la hiérarchie des projets Firebase

Diagramme montrant la hiérarchie de base d'un projet Firebase, y compris le projet, ses applications enregistrées et ses ressources et services provisionnés Ce diagramme montre la hiérarchie de base d'un projet Firebase. Voici les relations clés :

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

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

  • Toutes les applications Firebase enregistrées dans le même projet Firebase partagent et ont accès aux 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 nouveau projet Firebase, vous créez en fait un projet Google Cloud dans les coulisses. Vous pouvez même créer d'abord un projet Google Cloud, puis ajouter Firebase au projet ultérieurement. 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 Google Cloud Console. En savoir plus sur ce label dans notre FAQ .

Puisqu'un projet Firebase est un projet 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 Firebase Management ou la CLI Firebase ). Lorsque vous configurez un projet et enregistrez des applications, vous devez prendre des décisions organisationnelles 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 workflows de développement , y compris les bonnes pratiques générales et les consignes de sécurité générales pour la configuration de projets Firebase et l'enregistrement d'applications pour créer votre workflow de développement.

Interagir avec un projet Firebase

Outre les SDK du produit, 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 Firebase, les applications et les paramètres au niveau du projet.

Console Firebase - écran de présentation du projet

Le panneau de gauche de la console répertorie les produits Firebase, organisés par catégories de niveau supérieur. 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 avez commencé à utiliser Firebase, la zone principale de la console se transforme en un tableau de bord qui affiche des statistiques sur les produits que vous utilisez.

Notez qu'étant donné qu'un projet Firebase est également un projet Google Cloud, vous pouvez constater que diverses tâches ou produits nécessitent que vous utilisiez Google Cloud Console au lieu de la console Firebase.

Firebase CLI (un outil de ligne de commande)

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

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

API REST de gestion Firebase

À l'aide de l' API REST Firebase Management , vous pouvez gérer par programme un projet Firebase. Par exemple, vous pouvez enregistrer par programme une application avec un projet ou répertorier les applications qui sont 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 de développement à l'aide de différents identifiants, notamment le nom du projet , le numéro du projet et l' ID du projet .

Le nom du projet

Lorsque vous créez un projet, vous fournissez un nom de projet . Cet identifiant est le nom interne uniquement d'un projet dans la console Firebase , Google Cloud Console et la CLI Firebase . Le nom du projet n'est 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 un nom de projet à tout moment dans les Paramètres du projet de la console Firebase. Le nom du projet s'affiche dans le volet supérieur.

Le numéro de projet

Un projet Firebase (et son projet Google Cloud associé ) a un numéro de projet . Il s'agit de l'identifiant canonique global unique attribué par Google pour le projet. Utilisez cet identifiant lors de la configuration des intégrations et/ou 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, le numéro de projet est également supprimé et ne pourra plus jamais être utilisé par un autre projet.

L'identifiant 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 sur l'ensemble de Firebase et Google Cloud. Lorsque vous créez un projet Firebase, Firebase attribue automatiquement un ID unique au projet, mais vous pouvez le modifier lors de la configuration du projet. Cet identifiant doit généralement être traité comme un alias pratique pour référencer le 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 au répertoire de votre application locale.

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

À tout moment, vous pouvez obtenir le fichier de configuration ou l'objet Firebase d'une application .

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

  • Clé API : une simple chaîne chiffrée 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 : un identifiant unique défini par l'utilisateur pour le projet sur l'ensemble de Firebase et Google Cloud. Cet identifiant peut apparaître dans les URL ou les noms de certaines ressources Firebase, mais il doit généralement être traité comme un alias pratique pour référencer le projet. (exemple de valeur : myapp-project-123 )

  • ID d'application ("AppID") : l'identifiant unique de l'application Firebase sur l'ensemble de Firebase avec un format spécifique à la plate-forme :

    • Applications Apple Firebase : GOOGLE_APP_ID (exemple de valeur : 1:1234567890:ios:321abc456def7890 )
      Il ne s'agit pas d'un identifiant Apple Bundle.
    • Applications Android 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 spécifique à la plate-forme de l'application (ID du bundle Apple ou nom du package Android) et les valeurs spécifiques au projet Firebase, telles que la clé API, l'ID du projet, l'URL de la base de données en temps réel et Nom du bucket Cloud Storage. Compte tenu de cela, utilisez les règles de sécurité Firebase pour protéger vos données et vos fichiers dans Realtime Database , Cloud Firestore et Cloud Storage .

Pour les projets open source, nous ne recommandons généralement pas d'inclure le fichier de configuration ou l'objet Firebase de l'application dans le contrôle de code source car, dans la plupart des cas, vos utilisateurs doivent créer leurs propres projets Firebase et faire pointer leurs applications vers leurs propres ressources Firebase (via leur propre configuration Firebase fichier ou objet).

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

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

  • Nombre de projets par compte

    • Plan de tarification Spark - Le quota de création de projets est limité à un nombre inférieur de projets (généralement entre 5 et 10).
    • Plan tarifaire 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 du quota de création de projet est rarement une préoccupation pour la plupart des développeurs, mais si nécessaire, vous pouvez demander une augmentation du quota de projet .

    Sachez que la suppression complète d'un projet nécessite 30 jours et compte dans le quota du projet jusqu'à ce que le projet soit entièrement supprimé.

  • 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. En savoir plus sur la multilocation dans nos documents sur les meilleures pratiques.

    En savoir plus sur la limite d'applications par projet dans la FAQ.

  • Nombre de sites d'hébergement par projet

    La fonctionnalité multisite Firebase Hosting prend en charge un maximum de 36 sites par projet.

Lancement de votre application