Objetivo

Aprender a empaquetar una PWA para que pueda publicarse en tiendas oficiales, manteniendo funcionalidades offline, instalación y compatibilidad con dispositivos móviles.

Requisitos previos

_ Tener una PWA funcional en un dominio HTTPS.
_ Conocer las rutas de los archivos manifest.json y service-worker.js.
_ Una computadora con conexión a internet.
_ (Opcional) Cuenta de desarrollador en Google Play o Microsoft Store si quieres probar publicación.

Herramientas

Para empaquetar la PWA en diferentes formatos y generar archivos listos para publicación:

• PWABuilder: https://www.pwabuilder.com

Para crear contenedores Android nativos (APK/AAB) compatibles con Google Play:

• Bubblewrap: https://github.com/GoogleChromeLabs/bubblewrap

Paso a paso

Paso 1: Preparar tu PWA

1. Verifica que tu PWA cumpla los criterios básicos:

   • Servida sobre HTTPS.
   • manifest.json correctamente configurado con nombre, íconos y theme color.
   • service-worker.js activo para caching y funcionamiento offline.

2. Abre tu PWA en un navegador y verifica que se pueda “Agregar a la pantalla de inicio”.

Paso 2: Usar PWABuilder

1. Accede a PWABuilder
2. Ingresa la URL de tu PWA y haz clic en “Start”.
3. PWABuilder analizará tu PWA y te dará un reporte de compatibilidad.
4. Selecciona la opción Build My App y elige la plataforma deseada:
   • Android → genera un archivo listo para Google Play.
   • Windows → genera un paquete para Microsoft Store.
5. Descarga los archivos generados (APK/AAB para Android, MSIX para Windows).
6. Guarda estos archivos en una carpeta de tu proyecto.

Paso 3: Usar Bubblewrap (para Android)

1. Instala Bubblewrap en tu máquina:

npm install -g @bubblewrap/cli

1. Inicializa un nuevo proyecto de Bubblewrap:

bubblewrap init --manifest https://tu-pwa.com/manifest.json

1. Responde las preguntas del CLI:
   • Nombre de la app, ID del paquete (com.ejemplo.miapp), ruta de salida.
2. Genera el proyecto Android:

bubblewrap build

1. Esto creará un APK o AAB listo para subir a Google Play.

Paso 4: Probar la instalación

1. Instala la APK en un dispositivo Android (modo desarrollador habilitado).
2. Verifica que:
   • La app se pueda abrir sin problemas.
   • Funcione offline correctamente.
   • Iconos, splash screen y temas se muestren bien.

Paso 5: Preparar para publicación

1. Para Google Play:

   • Inicia sesión en tu cuenta de desarrollador.
   • Sube el archivo AAB.
   • Completa la información requerida: descripción, capturas de pantalla, categoría.

2. Para Microsoft Store:

   • Sube el paquete MSIX generado por PWABuilder.
   • Configura la tienda con la información de tu app.

Paso 6: Documentar y reflexionar

• Anota los desafíos que encontraste durante el empaquetado.
• Reflexiona sobre cómo cada herramienta facilita la distribución y qué ventajas ofrece.
• Piensa en qué tipo de distribución (web directa, tienda, híbrida) sería más efectiva para tu público.