Actualiza al SDK web modular (v9)

Se recomienda que las apps que usan la versión 8 o una anterior del SDK web migren a la versión 9 con las instrucciones de esta guía.

En esta guía, se supone que estás familiarizado con la versión 8 y que aprovecharás un agrupador de módulos como webpack o Rollup para actualizar y continuar el desarrollo de la versión 9.

Te recomendamos que uses un agrupador de módulos en tu entorno de desarrollo. Si no usas una, no podrás aprovechar los beneficios principales de la versión 9 en cuanto a la reducción de tamaño de las apps. Necesitarás npm o yarn para instalar el SDK.

Acerca de las bibliotecas compatibles

Hay dos tipos de bibliotecas disponibles para la versión 9 del SDK web:

  • Modulares: Son nuevas plataformas de API diseñadas para facilitar la eliminación de código no utilizado para que tu app web sea lo más pequeña y rápida posible.
  • Compatibilidad: Se trata de una plataforma de API conocida que es totalmente compatible con la versión 8, lo que te permite actualizar a la versión 9 sin cambiar todo el código del SDK a la vez. Las bibliotecas de compatibilidad tienen pocas o ninguna ventaja de tamaño o rendimiento en comparación con sus equivalentes de la versión 8.

En esta guía, se supone que aprovecharás las bibliotecas compatibles de la versión 9 para facilitar la actualización. Estas bibliotecas te permiten seguir usando el código de la versión 8 junto con el código refactorizado para la versión 9. Eso significa que puedes compilar y depurar tu app con mayor facilidad a medida que trabajas en el proceso de actualización.

En el caso de las apps con una exposición muy pequeña al SDK web, podría ser práctico refactorizar el código de la versión 8 sin usar las bibliotecas compatibles de la versión 9. Si actualizas una app de este tipo, puedes seguir las instrucciones de “versión 9 modular” de esta guía sin usar las bibliotecas de compatibilidad.

Acerca del proceso de actualización

Cada paso del proceso de actualización está delimitado de manera que puedas terminar de editar el código fuente de tu app y, luego, compilarla y ejecutarla sin fallas. En resumen, la actualización de una app consta de estos pasos:

  1. Agrega las bibliotecas de la versión 9 y las bibliotecas compatibles a tu app.
  2. Actualiza las sentencias de importación del código al formato compatible de la v9.
  3. Refactoriza el código con el estilo modular.
  4. Quita la biblioteca y el código de compatibilidad de Authentication para obtener el beneficio del tamaño de la app.
  5. Actualiza el código de inicialización con el estilo modular.
  6. Quita todas las sentencias y el código compatibles de la versión 9 de tu app.

Obtén el SDK de la versión 9

Para comenzar, obtén las bibliotecas de la versión 9 y las bibliotecas compatibles con npm (versión más reciente https://www.npmjs.com/package/firebase):

npm i firebase@10.12.2

# OR

yarn add firebase@10.12.2

Actualiza las importaciones a la v9 compatible

Para que tu código siga funcionando después de actualizar tu dependencia de la versión 8 a la 9, cambia las sentencias de importación para que usen la versión de “compatibilidad” de cada importación. Por ejemplo:

Antes: Versión 8

import firebase from 'firebase/app';
import 'firebase/auth';
import 'firebase/firestore';

Después: Compatible de la versión 9

// v9 compat packages are API compatible with v8 code
import firebase from 'firebase/compat/app';
import 'firebase/compat/auth';
import 'firebase/compat/firestore';

Refactoriza con el estilo modular

Si bien las API de la versión 8 se basan en un espacio de nombres y patrón de servicio de cadena de puntos, el enfoque modular de la versión 9 implica que el código se organizará principalmente en torno a las funciones. En la versión 9, el paquete de Firebase/app y los demás no muestran una exportación completa que contiene todos los métodos del paquete. En cambio, los paquetes exportan funciones individuales.

En la versión 9, los servicios se pasan como el primer argumento y, luego, la función usa los detalles del servicio para hacer el resto.

Ejemplo: Refactoriza una función de Authentication simple

Antes: Compatible de la versión 9

El código compatible de la versión 9 es idéntico al código de la versión 8, pero las importaciones cambiaron. El uso de las bibliotecas de compatibilidad durante la actualización te permite seguir usando el código de la versión 8 junto con el código refactorizado para la versión 9.

import firebase from "firebase/compat/app";
import "firebase/compat/auth";

const auth = firebase.auth();
auth.onAuthStateChanged(user => {
  // Check for user status
});

Después: Modular de la versión 9

La función getAuth acepta firebaseApp como primer parámetro. La función onAuthStateChanged no está encadenada desde la instancia auth como lo estaría en la versión 8. En cambio, es una función libre que acepta auth como primer parámetro.

import { getAuth, onAuthStateChanged } from "firebase/auth";

const auth = getAuth(firebaseApp);
onAuthStateChanged(auth, user => {
  // Check for user status
});

Actualiza el código de inicialización

Actualiza el código de inicialización de tu app con la sintaxis de la nueva versión 9 modular. Es importante que lo hagas después de completar la refactorización de todo el código de la app, ya que firebase.initializeApp() inicializa el estado global de las API modulares y las compatibles, mientras que la función modular initializeApp() inicializa solo el estado de las API modulares.

Antes: Compatible de la versión 9

import firebase from "firebase/compat/app"

firebase.initializeApp({ /* config */ });

Después: Modular de la versión 9

import { initializeApp } from "firebase/app"

const firebaseApp = initializeApp({ /* config */ });

Quita el código compatible

Si quieres obtener los beneficios de tamaño que brinda el SDK modular de la versión 9, en algún momento, debes convertir todas las invocaciones al estilo modular que se indicó anteriormente y quitar todas las sentencias import "firebase/compat/* de tu código. Cuando finalices, no debería haber más referencias al espacio de nombres global firebase.* ni ningún otro código con el estilo de SDK de la versión 8.

Beneficios y limitaciones de la versión 9

La versión 9 totalmente modularizada tiene las siguientes ventajas sobre las versiones anteriores:

  • La versión 9 permite disminuir sustancialmente el tamaño de las apps. Adopta el formato moderno de módulos de JavaScript, que permiten prácticas de eliminación de código no utilizado, en las que importas solo los artefactos que necesita tu app. Según tu app, la eliminación de código no utilizado con la versión 9 puede reducir hasta en un 80% el tamaño en kilobytes de una app comparable compilada con la versión 8.
  • La versión 9 seguirá beneficiándose del desarrollo continuo de funciones, mientras que la versión 8 se congelará más adelante.