Instalar una extensión de Firebase

Puede instalar (y administrar ) cualquiera de las extensiones oficiales de Firebase utilizando Firebase console o Firebase CLI (interfaz de línea de comandos).

Asegúrese de revisar las diferencias en las acciones admitidas para Firebase CLI y Firebase console.


Para instalar o administrar extensiones, se le debe asignar uno de estos roles: Propietario o Editor o Administrador de Firebase .

Para instalar una extensión, su proyecto debe estar en el plan Blaze (pago por uso). Aunque no hay ningún cargo por instalar una extensión, es posible que se le cobre por el uso de los servicios de Firebase o de los servicios en la nube, como Cloud Secret Manager , si su uso excede el nivel gratuito de los servicios.

Antes de que empieces

Si aún no lo has hecho, agrega Firebase a tu proyecto y actualiza tu proyecto de Firebase al plan Blaze (pago por uso).

Paso 1 : Ver información detallada sobre una extensión

Este paso es opcional, pero muy recomendable.

Antes de instalar una extensión de Firebase, le recomendamos que revise la información detallada sobre la extensión, que incluye:

  • Cómo funciona la extensión, tareas previas a la instalación y detalles sobre la extensión
  • Información general de identificación y descripción.
  • Si las tareas de la extensión requieren una cuenta de facturación
  • Servicios de Google (API) y roles de acceso necesarios para el funcionamiento
  • Recursos creados para la extensión (como funciones)
  • Descripciones de parámetros configurables por el usuario

Para ver la información detallada de una extensión:

  1. Explore las extensiones oficiales de Firebase en Extensions Hub .

  2. Haga clic en la tarjeta de una extensión para:

Paso 2 : instalar una extensión

Durante el proceso de instalación, se le pedirá que revise las especificaciones básicas de la extensión (como las API habilitadas, los recursos creados, el acceso otorgado, etc.). Se le notificará sobre cualquier requisito de facturación y también se le pedirá que especifique valores para los parámetros configurables de la extensión.

  1. Explore las extensiones oficiales de Firebase en Extensions Hub .

  2. Haga clic en la tarjeta de una extensión, luego revise la información detallada de la extensión, que puede ofrecer instrucciones de uso específicas y cualquier tarea previa a la instalación.

  3. Haga clic en Instalar y luego siga las instrucciones que aparecen en pantalla para instalar la extensión.

Paso 3 : completar la configuración posterior a la instalación

Algunas extensiones tienen pasos obligatorios u opcionales que debes completar antes de usarlas. Encuentre estas instrucciones en la página de detalles posteriores a la instalación de su extensión en el panel de Extensiones de Firebase console (el enlace específico al panel se muestra en la terminal después de la instalación).

También puedes encontrar estas instrucciones en el archivo POSTINSTALL.md incluido en el directorio fuente de la extensión .

Crear recursos de Firebase

Si configuró la extensión para usar recursos de Firebase (colecciones de Cloud Firestore, rutas de Realtime Database, depósitos de Cloud Storage) que aún no existen, créelos antes de usar la extensión.

Crear controladores de eventos Eventarc

Algunas extensiones publican en Eventarc cuando ocurren eventos importantes durante la ejecución. Si una extensión publica eventos y usted habilitó eventos durante la instalación, puede escribir funciones que reaccionen a estos eventos con su propia lógica personalizada. Esto puede resultar útil, por ejemplo, para notificar a los usuarios cuando se completan tareas de larga duración o para posprocesar el resultado de una función de extensión.

Consulte la documentación de la extensión para obtener una lista de eventos (si los hay) que publica. Por ejemplo, consulte los tipos de eventos para la extensión Ejecutar pagos con Stripe .

Luego, consulte Activadores de eventos personalizados para obtener información sobre cómo escribir controladores de eventos de Eventarc.

Instalar múltiples instancias de extensión

Puedes instalar la misma extensión más de una vez en el mismo proyecto. Cada instancia instalada puede tener su propia configuración personalizada y sus propios recursos de extensión. Usted identifica y hace referencia a cada instancia instalada utilizando su ID de instancia , que es único dentro de su proyecto. Se le pedirá que confirme o edite el ID de instancia de cada instancia adicional de la extensión que instale.

Próximos pasos