Actualiza al SDK web modular (v9)

En el caso de las apps que usan la versión 8 o una anterior del SDK web, te recomendamos migrarlas a la versión 9 siguiendo las instrucciones de esta guía.

En esta guía, se supone que conoces 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 usar un agrupador de módulos en tu entorno de desarrollo. De lo contrario, no podrás aprovechar los principales beneficios 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.
  • Compat: Son plataformas de API conocidas que tienen compatibilidad total con la versión 8, lo que te permite actualizar a la versión 9 sin cambiar todo el código del SDK de una sola vez. Las bibliotecas de compatibilidad tienen ventajas mínimas o nulas de tamaño o rendimiento en comparación con sus contrapartes 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. Esto significa que puedes compilar y depurar tu app con mayor facilidad mientras trabajas en el proceso de actualización.

En el caso de las apps que tienen una exposición muy pequeña al SDK web, puede ser práctico refactorizar el código de la versión 8 sin usar las bibliotecas de compatibilidad 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 compatibles de Authentication para obtener el beneficio de 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 modulares y compatibles de la versión 9 con npm (versión más reciente: https://www.npmjs.com/package/firebase):

npm i firebase@11.0.2

# OR

yarn add firebase@11.0.2

Actualiza las importaciones a la v9 compatible

Para que tu código siga funcionando después de actualizar la dependencia de la v8 a la v9, cambia las sentencias de importación para que se use la versión “compat” 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 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. Usar 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 se encadena desde la instancia de autenticación 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, lo que permite las 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á en un momento futuro.