Actualiza al SDK web modular (v9)

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

En esta guía, se presupone que conoces la versión 8 y que un agrupador de módulos como webpack o Resumen para la actualización y el desarrollo continuo de la versión 9.

Te recomendamos que uses un agrupador de módulos en tu entorno de desarrollo. Si no usa una, no podrá aprovechar la versión 9 de la beneficios en la reducción del tamaño de la app. 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. (eliminación de código sin usar) para que tu aplicación web sea lo más pequeña y rápida posible.
  • Compatibilidad: 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 poco o ningún tamaño o más ventajas de rendimiento en comparación con sus versiones 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 la actualización el proceso de administración de recursos.

En el caso de las apps que tienen 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 eres actualizar una app de este tipo, puedes seguir las instrucciones de esta guía para “versión 9 modular” 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 Autenticación 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 de compatibilidad con npm (versión más reciente https://www.npmjs.com/package/firebase):

npm i firebase@10.13.1

# OR

yarn add firebase@10.13.1

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. El La función onAuthStateChanged no está encadenada desde la instancia auth como lo haría estar en la versión 8; en cambio, es una función libre que toma auth como su 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 8 se bloqueará en algún momento.