获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

Instalar una extensión de Firebase

Puede instalar (y administrar ) cualquiera de las extensiones oficiales de Firebase mediante 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.

de Firebase


Para instalar o administrar extensiones, debe tener asignado 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). Si bien no se cobra por instalar una extensión, es posible que se le cobre por el uso de los servicios de Firebase o servicios en la nube, como Cloud Secret Manager , si su uso supera el nivel gratuito de los servicios.

Antes de que empieces

  1. Si aún no lo ha hecho, agregue Firebase a su proyecto .

  2. Si aún no lo ha hecho, actualice su proyecto al plan Blaze (pago por uso).

  3. Instale o actualice a la versión más reciente de Firebase CLI.

  4. Tome nota de su ID de proyecto de Firebase o del alias de proyecto configurado previamente.

    • Id . firebase projects:list desde cualquier lugar de tu computadora.
    • Alias ​​del proyecto : ejecuta firebase use desde el directorio de tu aplicación local.

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, cualquier tarea previa a la instalación y detalles sobre la extensión
  • Datos identificativos generales y descripción
  • Si las tareas de la extensión requieren una cuenta de facturación
  • Servicios de Google (API) y roles de acceso requeridos para la operación
  • 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. Asegúrese de haber configurado su entorno y seleccionado una extensión .

  2. Ejecute el comando extension-info desde cualquier lugar de su computadora:

    firebase ext:info publisher-id/extension-id

    Los argumentos publisher-id y extension-id son obligatorios y se pueden encontrar en la página de detalles de preinstalación de la extensión .

Paso 2 : Instala 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á cualquier requisito de facturación y también se le pedirá que especifique valores para los parámetros configurables de la extensión.

  1. Asegúrese de haber configurado su entorno y seleccionado una extensión .

  2. Desde su directorio local de Firebase, ejecute el comando extension-install. Si se le solicita, ingrese los valores de los parámetros para personalizar la instancia de la extensión.

    firebase ext:install publisher-id/extension-id --project=projectId-or-alias

    Los argumentos publisher-id y extension-id son obligatorios y se pueden encontrar en la página de detalles de preinstalación de la extensión .

    Ejecutar este comando agrega una instancia de extensión a su manifiesto de extensiones.

  3. Luego, para implementar las extensiones en su manifiesto en un proyecto de Firebase, ejecute:

    firebase deploy --only extensions --project=projectId-or-alias

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

Algunas extensiones tienen pasos obligatorios u opcionales que debe 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 Extensiones de Firebase console (el enlace específico al panel se muestra en la terminal después de la instalación).

También puede encontrar estas instrucciones en el archivo POSTINSTALL.md incluido en el directorio de origen 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 habilitó eventos durante la instalación, puede escribir funciones que reaccionen a estos eventos con su propia lógica personalizada. Esto puede ser útil, por ejemplo, para notificar a los usuarios cuando se completen tareas de ejecución prolongada o para procesar posteriormente la salida de una función de extensión.

Consulte la documentación de la extensión para obtener una lista de los eventos (si los hay) que publica.

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

Instalar múltiples instancias de extensión

Puede 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

  • Vea los detalles y la configuración de su extensión instalada en la consola de Firebase.

  • Supervise la actividad de su extensión instalada, incluidas las comprobaciones de su estado, uso y registros.

  • Usando Firebase CLI, administre su extensión instalada. Puede reconfigurar o desinstalar su extensión, así como actualizar su extensión a la última versión.

  • Usando la consola Firebase, administre su extensión instalada. Para las extensiones oficiales de Firebase, puede reconfigurar o desinstalar su extensión, así como actualizar su extensión a la última versión.

  • Como práctica recomendada para todos los proyectos, asegúrese de configurar alertas de presupuesto para su proyecto y monitorear su panel de uso y facturación en la consola de Firebase.