Descubre las novedades de Firebase en Google I/O 2022. Más información

Comprender los proyectos de Firebase

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Esta página ofrece breves descripciones generales de varios conceptos importantes sobre los proyectos de Firebase. Cuando estén disponibles, siga los enlaces para encontrar información más detallada sobre características, servicios, herramientas y mejores prácticas.

Relación entre proyectos, aplicaciones y productos de Firebase

Un proyecto de Firebase es la entidad de nivel superior para Firebase. En un proyecto, puede registrar sus aplicaciones de Apple, Android o web. Después de registrar sus aplicaciones con Firebase, puede agregar los SDK de Firebase para cualquier número de productos de Firebase , como Analytics, Cloud Firestore, Performance Monitoring o Remote Config.

Obtenga información más detallada sobre este proceso en la guía de inicio de su plataforma:
iOS+ | androide | web | Unidad | C++ | aleteo

Comprender la jerarquía de los proyectos de Firebase

Diagrama que muestra la jerarquía básica de un proyecto de Firebase, incluido el proyecto, sus aplicaciones registradas y sus recursos y servicios aprovisionados Este diagrama muestra la jerarquía básica de un proyecto de Firebase. Estas son las relaciones clave:

  • Un proyecto de Firebase es como un contenedor para todas sus aplicaciones y cualquier recurso y servicio aprovisionado para el proyecto.

  • Un proyecto de Firebase puede tener una o más aplicaciones de Firebase registradas (por ejemplo, las versiones de iOS y Android de una aplicación, o las versiones gratuita y de pago de una aplicación).

  • Todas las aplicaciones de Firebase registradas en el mismo proyecto de Firebase comparten y tienen acceso a los mismos recursos y servicios aprovisionados para el proyecto . Aquí hay unos ejemplos:

    • Todas las aplicaciones de Firebase registradas en el mismo proyecto de Firebase comparten los mismos backends, como Firebase Hosting, Authentication, Realtime Database, Cloud Firestore, Cloud Storage y Cloud Functions.

    • Todas las aplicaciones de Firebase registradas en el mismo proyecto de Firebase están asociadas con la misma propiedad de Google Analytics, donde cada aplicación de Firebase es un flujo de datos independiente en esa propiedad.

Relación entre los proyectos de Firebase y Google Cloud

Cuando crea un nuevo proyecto de Firebase, en realidad está creando un proyecto de Google Cloud en segundo plano. Incluso puede crear un proyecto de Google Cloud primero y luego agregar Firebase al proyecto más adelante. Puede pensar en un proyecto de Google Cloud como un contenedor virtual de datos, código, configuración y servicios.

Dado que un proyecto de Firebase es un proyecto de Google Cloud:

Configuración de un proyecto de Firebase y registro de aplicaciones

Puede configurar un proyecto de Firebase y registrar aplicaciones en la consola de Firebase (o, para casos de uso avanzado, a través de la API REST de administración de Firebase o la CLI de Firebase). Cuando configura un proyecto y registra aplicaciones, debe tomar algunas decisiones organizativas y agregar información de configuración específica de Firebase a sus proyectos locales.

Para las aplicaciones de producción, debe configurar un flujo de trabajo de desarrollo claro, que generalmente implica el uso de múltiples entornos. Revise nuestra documentación sobre los flujos de trabajo de los desarrolladores , incluidas las mejores prácticas generales y las pautas generales de seguridad para configurar proyectos de Firebase y registrar aplicaciones para crear su flujo de trabajo de desarrollo.

Interactuar con un proyecto de Firebase

Además de los SDK del producto, puede interactuar directamente con un proyecto de Firebase utilizando varias herramientas e interfaces diferentes.

consola base de fuego

La consola de Firebase ofrece el entorno más completo para administrar los productos, las aplicaciones y la configuración a nivel de proyecto de Firebase.

Firebase console: pantalla de descripción general del proyecto

El panel del lado izquierdo de la consola enumera los productos de Firebase, organizados por categorías de nivel superior. En la parte superior del panel del lado izquierdo, acceda a la configuración de un proyecto haciendo clic en . La configuración de un proyecto incluye integraciones , permisos de acceso y facturación .

El centro de la consola muestra botones que inician flujos de trabajo de configuración para registrar varios tipos de aplicaciones. Después de comenzar a usar Firebase, el área principal de la consola se convierte en un tablero que muestra estadísticas sobre los productos que usa.

Tenga en cuenta que, dado que un proyecto de Firebase también es un proyecto de Google Cloud, es posible que varias tareas o productos requieran que use Google Cloud Console en lugar de Firebase console.

Firebase CLI (una herramienta de línea de comandos)

Firebase también ofrece Firebase CLI para configurar y administrar productos específicos de Firebase, como Firebase Hosting, Cloud Functions para Firebase y Firebase Extensions.

Después de instalar la CLI, tiene acceso al comando global firebase . Use la CLI para vincular su directorio de aplicaciones local a un proyecto de Firebase , luego implemente nuevas versiones de contenido alojado en Firebase o actualizaciones de funciones.

API REST de administración de Firebase

Con la API REST de administración de Firebase , puede administrar mediante programación un proyecto de Firebase. Por ejemplo, puede registrar mediante programación una aplicación con un proyecto o enumerar las aplicaciones que ya están registradas ( iOS+ | Android | web ).

Identificadores de proyectos de Firebase

Un proyecto de Firebase se puede identificar en el backend de Firebase y en varias interfaces de desarrollador mediante diferentes identificadores, incluidos el nombre del proyecto , el número del proyecto y el ID del proyecto.

el nombre del proyecto

Cuando crea un proyecto, proporciona un nombre de proyecto . Este identificador es el nombre solo interno para un proyecto en Firebase console , Google Cloud Console y Firebase CLI . El nombre del proyecto no está expuesto en ningún producto, servicio o recurso visible públicamente de Firebase o Google Cloud; simplemente sirve para ayudarlo a distinguir más fácilmente entre múltiples proyectos.

Puede editar el nombre de un proyecto en cualquier momento en la Configuración del proyecto de Firebase console. El nombre del proyecto se muestra en el panel superior.

el numero de proyecto

Un proyecto de Firebase (y su proyecto de Google Cloud asociado ) tiene un número de proyecto . Este es el identificador canónico único global asignado por Google para el proyecto. Utilice este identificador al configurar integraciones y/o realizar llamadas API a Firebase, Google o servicios de terceros.

No puede editar un número de proyecto. Si elimina un proyecto, el número de proyecto también se elimina y nunca más podrá ser utilizado por ningún otro proyecto.

El identificador del proyecto

Un proyecto de Firebase (y su proyecto de Google Cloud asociado ) tiene un ID de proyecto . Este es un identificador único definido por el usuario para el proyecto en todo Firebase y Google Cloud. Cuando crea un proyecto de Firebase, Firebase asigna automáticamente una ID única al proyecto, pero puede editarla durante la configuración del proyecto. Este identificador generalmente debe tratarse como un alias de conveniencia para hacer referencia al proyecto.

Objetos y archivos de configuración de Firebase

Cuando registra una aplicación con un proyecto de Firebase, la consola de Firebase proporciona un archivo de configuración de Firebase (aplicaciones de Apple/Android) o un objeto de configuración (aplicaciones web) que agrega directamente a su directorio de aplicaciones local.

  • Para las aplicaciones de Apple, agrega un archivo de configuración GoogleService-Info.plist .
  • Para las aplicaciones de Android, agrega un archivo de configuración google-services.json .
  • Para las aplicaciones web, agrega un objeto de configuración de Firebase.

En cualquier momento, puede obtener el objeto o el archivo de configuración de Firebase de una aplicación .

Un archivo de configuración u objeto de Firebase asocia una aplicación con un proyecto específico de Firebase y sus recursos (bases de datos, depósitos de almacenamiento, etc.). La configuración incluye "Opciones de Firebase", que son parámetros requeridos por los servicios de Firebase y Google para comunicarse con las API del servidor de Firebase y para asociar los datos del cliente con el proyecto de Firebase y la aplicación de Firebase. Estas son las "opciones de Firebase" mínimas requeridas:

  • Clave API : una cadena encriptada simple que se usa cuando se llama a ciertas API que no necesitan acceder a datos privados del usuario (valor de ejemplo: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO )

  • ID del proyecto : un identificador único definido por el usuario para el proyecto en todo Firebase y Google Cloud. Este identificador puede aparecer en las URL o los nombres de algunos recursos de Firebase, pero por lo general debe tratarse como un alias de conveniencia para hacer referencia al proyecto. (valor de ejemplo: myapp-project-123 )

  • Id. de la aplicación ("AppID") : el identificador único de la aplicación de Firebase en todo Firebase con un formato específico de la plataforma:

    • Aplicaciones Apple de Firebase: GOOGLE_APP_ID (valor de ejemplo: 1:1234567890:ios:321abc456def7890 )
      Esta no es una ID de paquete de Apple.
    • Aplicaciones Android de Firebase: mobilesdk_app_id (valor de ejemplo: 1:1234567890:android:321abc456def7890 )
      Este no es un nombre de paquete de Android o una ID de aplicación de Android.
    • Aplicaciones web de Firebase: appId (valor de ejemplo: 1:65211879909:web:3ae38ef1cdcb2e01fe5f0c )

El contenido del objeto o archivo de configuración de Firebase se considera público, incluido el ID específico de la plataforma de la aplicación (ID del paquete de Apple o nombre del paquete de Android) y los valores específicos del proyecto de Firebase, como la clave API, el ID del proyecto, la URL de la base de datos en tiempo real y Nombre del depósito de Cloud Storage. Dado esto, use las reglas de seguridad de Firebase para proteger sus datos y archivos en Realtime Database , Cloud Firestore y Cloud Storage .

Para proyectos de código abierto, generalmente no recomendamos incluir el objeto o el archivo de configuración de Firebase de la aplicación en el control de código fuente porque, en la mayoría de los casos, los usuarios deben crear sus propios proyectos de Firebase y apuntar sus aplicaciones a sus propios recursos de Firebase (a través de su propia configuración de Firebase). archivo u objeto).

Límites generales para proyectos, aplicaciones y sitios de Firebase

Estos son algunos límites generales para proyectos, aplicaciones y sitios de Firebase:

  • Número de proyectos por cuenta

    • Plan de precios de Spark: la cuota de creación de proyectos está limitada a un número menor de proyectos (normalmente, entre 5 y 10).
    • Plan de precios de Blaze: la cuota de creación de proyectos por cuenta aumenta sustancialmente siempre que la cuenta de facturación de la nube asociada esté al día.

    El límite en la cuota de creación de proyectos rara vez es una preocupación para la mayoría de los desarrolladores, pero si es necesario, puede solicitar un aumento en la cuota del proyecto .

    Tenga en cuenta que la eliminación completa de un proyecto requiere 30 días y cuenta para la cuota del proyecto hasta que el proyecto se elimine por completo.

  • Número de aplicaciones por proyecto

    Firebase restringe la cantidad total de aplicaciones de Firebase dentro de un proyecto de Firebase a 30.

    Debe asegurarse de que todas las aplicaciones de Firebase dentro de un solo proyecto de Firebase sean variantes de plataforma de la misma aplicación desde la perspectiva del usuario final. Obtenga más información sobre la tenencia múltiple en nuestros documentos de prácticas recomendadas.

    Obtenga más información sobre el límite de aplicaciones por proyecto en las preguntas frecuentes.

  • Número de sitios de alojamiento por proyecto

    La función multisitio de Firebase Hosting admite un máximo de 36 sitios por proyecto.

Lanzamiento de su aplicación