Resumen

¡El tutorial de inicio rápido te guiará por los conceptos clave de Capgo! Exploraremos los siguientes conceptos:

1. Añadir una app a tu cuenta de Capgo

2. Integrar Capgo con tu CI/CD

3. Subir bundles a Capgo haciendo push de commits

4. Configurar y personalizar la publicación de bundles de Capgo

5. Configurar tu app para habilitar Live Updates con Capgo

6. Desplegar Live Updates en tu app desde Capgo

Simplemente sigue la guía paso a paso o ve directamente a la documentación del componente que te interese.

Empezar el tutorial

¡Sigue el tutorial de quickstart y ponte en marcha con Capgo en muy poco tiempo!

Guía de onboarding de CLI

Guía completa paso a paso del proceso de onboarding interactivo de CLI.

Lanza actualizaciones

Envía actualizaciones a tu app desde el dashboard de Capgo.

Automatiza actualizaciones

Integra Capgo con tu CI/CD y lanza la subida de bundles en Capgo al hacer push de commits.

Solución de problemas

Problemas comunes y cómo resolverlos.

Resumen

Finaliza el tutorial con un repaso rápido de lo aprendido.

Consejo

La función de actualización Over-the-Air (OTA) solo aplica a cambios en archivos HTML, CSS y JavaScript.

Si realizas cambios en el code nativo, como actualizar plugins de Capacitor, debes reenviar la app a la tienda para su aprobación.

Confidencialidad del bundle

Trata cada bundle subido a Capgo como un asset web público a menos que habilites el cifrado de Capgo. Los canales privados controlan qué dispositivos pueden recibir una actualización, pero no hacen que el bundle subido sea confidencial. El cifrado protege la ruta de entrega y evita que terceros generen actualizaciones cifradas válidas, pero los assets web distribuidos aún pueden ser sometidos a ingeniería inversa desde la app con suficiente esfuerzo, ya que la clave pública se distribuye en el binario. Consulta Cifrado de Live Update.

Únete a la comunidad de Discord

¡Únete al servidor de Discord de Capgo!

Mantenimiento

Versión del plugin	Compatibilidad con Capacitor	Mantenido
v7.*.* (≥7.25.0)	v7.*.*	✅ Soporte completo
v6.*.* (≥6.25.0)	v6.*.*	✅ Soporte completo
v5.*.* (≥5.10.0)	v5.*.*	✅ Soporte completo
v5.*.* (<5.10.0)	v5.*.*	⚠️ Obsoleto
v4.*.*	v4.*.*	❌ Ya no es compatible
v3.*.*	v3.*.*	❌ Ya no es compatible
>= 8	v4.*.*	⚠️ Obsoleto por problemas de versionado en nuestro proceso de CI

Cumplimiento de directrices de tiendas

Google Play para Android y la App Store de iOS tienen directrices con reglas que debes conocer antes de integrar la solución Capacitor-updater en tu aplicación.

Google Play

El tercer párrafo de Abuso de dispositivos y redes describe que actualizar el código fuente code por cualquier método que no sea el mecanismo de actualización de Google Play está restringido. Pero esta restricción no se aplica a actualizar bundles de JavaScript.

Esta restricción no se aplica a code que se ejecuta en una máquina virtual y tiene acceso limitado a las APIs de Android (como JavaScript en una webview o navegador).

Eso permite totalmente el uso de Capacitor-updater, ya que solo actualiza los bundles de JS y no actualizará el code nativo.

App Store

Párrafo 3.3.2, desde allá por 2015 Acuerdo de licencia del Apple Developer Program permite totalmente realizar actualizaciones over-the-air de JavaScript y assets, y en su última versión (20170605) descargable aquí esta resolución es aún más amplia:

Se interpreta que code puede descargarse en una aplicación, pero solo siempre que dicho code: (a) no cambie el propósito principal de la aplicación mediante funciones o funcionalidades que sean inconsistentes con el propósito previsto y anunciado de la aplicación tal como se envió a la App Store, (b) no cree una tienda o escaparate para otros code o aplicaciones, y (c) no eluda la firma, el sandbox u otras funciones de seguridad del SO.

Capacitor Updater te permite cumplir estas reglas totalmente, siempre que la actualización que lances no desvíe significativamente tu producto de su propósito original aprobado por la App Store.

Para seguir cumpliendo con las directrices de Apple, sugerimos que las apps distribuidas en la App Store no habiliten el Force update escenario, ya que en el Directrices de revisión de la App Store estado que:

Las apps no deben obligar a los usuarios a calificar la app, reseñarla, descargar otras apps u otras acciones similares para acceder a funcionalidades, contenido o al uso de la app.

Esto no es un problema para el comportamiento por defecto de la actualización en segundo plano, ya que no obligará al usuario a aplicar la nueva versión hasta la próxima vez que cierre la app, pero al menos deberías tenerlo en cuenta si decides mostrarlo.

Código abierto

El plugin está bajo la licencia LGPL-3.0 y el back-end bajo la licencia AGPL-3.0.

💡 LGPL-3.0 significa que si alguien modifica el code del plugin, es obligatorio publicarlo en open source con la misma licencia. Si usas el code sin modificarlo, no te afecta. Consulta el issue de abajo para más detalles; revisa el enlace 👇

¿Licencias?

Prueba GPTS Capgo para obtener ayuda en vez de leer la documentación

Puedes incluirlo en tu app sin preocupaciones

Notas finales

Si haces self-hosting y esta herramienta te resulta útil, considera apoyar mi trabajo haciéndote sponsor de GitHub.

Aposté por hacer open-source todo el code que construí aquí en vez de ponerle un paywall. Al abrirlo en lugar de pelear y esconderlo, creo que podemos hacer del mundo un lugar mejor.

Para que esto sea posible, es necesario que todos pongamos de nuestra parte, incluyéndote a ti 🥹. Si Capgo cloud no cubre tus necesidades, puedes apoyar a un maker independiente en GitHub Sponsors a tu propio ritmo.

Matemáticas simples

El precio del plan básico: $14*12 = $168 al año. Mientras que el promedio dev/hora = $60. Eso significa que 3 horas perdidas de dev time en self-host te permiten pagar todo un año; si gastas más de 3 horas, estás perdiendo dinero ^^

Continuar desde Overview

Si estás usando Resumen para planificar la automatización de CI/CD, conéctalo con CI/CD de Capgo para el flujo de trabajo del producto en Capgo CI/CD, Native Builds de Capgo para el flujo de trabajo del producto en Capgo Native Builds, Integraciones de Capgo para el flujo de trabajo del producto en Capgo Integraciones, Integración CI/CD para los detalles de implementación de CI/CD Integration, y Integración con GitHub Actions para los detalles de implementación de GitHub Actions Integration.