Saltar al contenido principal
Actualizaciones directas

Mostrar la última versión cuando los usuarios abran su aplicación

Por defecto, un live update ejecuta una sesión después de descargarla. Los modos de actualización directa la aplican en lugar de eso, detrás de su pantalla de bienvenida, por lo que la primera pantalla que ven los usuarios ya es la nueva versión.

Actualiza automáticamente: al instalar, al iniciar o siempre
Pantalla de bienvenida mantenida hasta que el update esté listo
Descargas de Delta mantienen la espera corta

El Problema

Actualizaciones de fondo llegan tarde una sesión

¿Qué sucede en el modo predeterminado?

1

El usuario abre la aplicación

La aplicación arranca en el paquete que ya tiene. El actualizador verifica si hay una nueva y la descarga en segundo plano.

2

La sesión ejecuta la versión actual

Para el resto de esa sesión, el usuario ejecuta el code que se instaló antes de su arreglo.

3

La actualización se aplica al siguiente reinicio

Cuando el usuario sale de la aplicación, el actualizador instala el nuevo paquete. Lo ven la próxima vez que abren la aplicación.

Para la mayoría de las liberaciones, ese es el equilibrio adecuado. Cuando la sesión que comienza después de su carga debe ejecutar el nuevo code, utilice un modo de actualización directa.

Cuando la primera sesión importa

Un flujo de pago o inicio de sesión roto

Los usuarios que abren la aplicación no deben pasar por la pantalla rota una vez más antes de que se aplique la solución.

Una corrección de seguridad en la capa web

Quieres que el JavaScript parcheado se ejecute desde el lanzamiento, no desde la próxima sesión.

Un cambio desactualizado

Términos, advertencias o contenido de eventos que deben estar actualizados en la primera pantalla que los usuarios vean.

La Solución

¿Qué cambia con un modo de actualización directa?

El actualizador verifica al iniciar mientras la pantalla de inicio de sesión permanece visible. Si hay una nueva colección disponible, la descarga y la aplicación antes de que la pantalla de inicio de sesión se oculte.

Modo predeterminado (en segundo plano)

1
El usuario abre la aplicación
2
La aplicación muestra la versión actual
3
La actualización se descarga en segundo plano
4
La actualización se aplica en la próxima sesión

No espera al lanzamiento. Los usuarios ven la actualización una sesión más tarde.

Modo directo (onLaunch)

1
El usuario abre la aplicación y la pantalla de bienvenida permanece visible
2
El actualizador verifica y descarga los archivos modificados
3
La actualización se aplica, el logo de carga desaparece, la nueva versión se muestra

Los usuarios ven la nueva versión en la primera pantalla. Esperan en la pantalla de bienvenida mientras se descarga

Documentación de comportamiento de actualización

Cómo funciona

Cómo configurar actualizaciones directas

Un modo directo es una configuración nativa, por lo que se envía en una construcción de tienda primero. Después de eso, cada live update sigue a él. Los comandos provienen de los Capgo docs.

  1. Agregue el plugin de pantalla de bienvenida y elija un modo

    Instale @capacitor/splash-screen, luego establezca autoUpdate, autoSplashscreen y launchAutoHide en capacitor.config.ts.

    npm install @capacitor/splash-screen
    npx cap sync
    
    // capacitor.config.ts
    plugins: {
      CapacitorUpdater: {
        autoUpdate: 'onLaunch', // or 'atInstall' / 'always'
        autoSplashscreen: true,
        keepUrlPathAfterReload: true,
      },
      SplashScreen: { launchAutoHide: false },
    }
    Pantalla de bienvenida
  2. Envíe la configuración en una compilación de tienda

    capacitor.config se compila en la aplicación nativa, por lo que el nuevo modo llega a los usuarios con su próxima publicación de tienda. Capgo Build puede producirla en la nube.

    npx @capgo/cli@latest build request --platform ios
    npx @capgo/cli@latest build request --platform android
    Capgo Build docs
  3. Cargar paquetes como deltas

    Los usuarios esperan la descarga al inicio, por lo que envíe solo los archivos modificados. El CLI detecta modos de aplicación instantánea y solicita una carga de delta.

    npx @capgo/cli@latest bundle upload --channel production --delta
    Deltas de actualizaciones
  4. Mantener el rollback automático

    Llame a notifyAppReady() una vez que su aplicación haya comenzado. Si un nuevo paquete falla al iniciar, el dispositivo regresa a la última que funcionaba.

    import { CapacitorUpdater } from '@capgo/capacitor-updater'
    
    await CapacitorUpdater.notifyAppReady()
    NotificarAplicaciónListo()

Elige el modo que se adapte a tu aplicación

Actualizaciones directas son un trueque: un breve retraso al lanzamiento a cambio de la nueva versión en la primera pantalla.

Tres modos de aplicación instantánea

Establece autoUpdate en capacitor.config.ts. Cada modo decide cuándo una actualización puede aplicarse mientras el usuario espera.

  • atInstall: solo después de una instalación fresca o una actualización de la tienda de la aplicación nativa
  • onLaunch: cuando la aplicación comienza desde un estado asesinado (iniciación fría)
  • always: en cada verificación de antecedentes, incluso mientras la aplicación está abierta
Configuración del actualizador

3

Modos de aplicación instantánea en autoUpdate

Gestión de pantalla de bienvenida

Los modos directos necesitan @capacitor/pantalla de bienvenida con launchAutoHide establecido en falso, y autoSplashscreen establecido en verdadero. El actualizador oculta la pantalla de bienvenida una vez que se aplica la actualización, o una vez que sabe que no es necesario ninguna actualización.

  • No se necesita una llamada manual SplashScreen.hide()
  • keepUrlPathAfterReload mantiene al usuario en la misma ruta después de la recarga
  • Listen for appReady if you need extra work after the splash hides
Gestión de pantalla de bienvenida

autoSplashscreen

Requerido para cada modo directo

Compromisos a tener en cuenta

Los usuarios esperan la descarga al arranque, y con siempre una actualización pueden recargar la aplicación mientras está en uso. Planifiquen para ambos

  • Subir con --delta para que solo se descarguen los archivos modificados
  • Save and restore app state so a reload does not lose user progress
  • Mantener el modo predeterminado cuando una sesión de retraso es suficiente
Documentación de actualizaciones delta

--delta

Recomendado para cada subida de actualizaciones directas

Cuándo usar actualizaciones directas

Utilice un modo directo cuando la sesión actual debe ejecutar el nuevo code. Mantenga el modo predeterminado para todo lo demás

Arreglos críticos de bugs

Bugs de pago, inicio de sesión o datos donde correr el viejo code durante una sesión más es demasiado.

Inscripción inicial

Aplica el último paquete inmediatamente después de una instalación fresca o actualización de la tienda, por lo que los nuevos usuarios comienzan en su onboarding actual.

Contenido desactualizado

Páginas de eventos, anuncios o términos que deben estar actualizados cuando los usuarios abren la aplicación.

Parches de seguridad

Seguridad de capas web que deberían ejecutarse desde el arranque. Las correcciones en nativo code todavía necesitan una actualización de la tienda.

Lanzamientos regulares

Pocas mejoras de estilo y características pequeñas justifican una espera en el lanzamiento. El modo por defecto las aplica una sesión después.

Aplicaciones que permanecen abiertas durante horas

Con verificaciones periódicas (cada 10 minutos por defecto) se puede aplicar una actualización mientras la aplicación está abierta. Guarda el estado antes de confiar en él.

Mantener la espera de arranque corta

La espera en la lanzamiento es la verificación de actualizaciones más el descarga. Las actualizaciones delta reducen la descarga a los archivos que cambiaron.

~50ms

Latencia típica API

Delta

Solo se descargan los archivos que han cambiado

1B+

Actualizaciones entregadas por mes

Apps built with Capacitor

Public information apps need urgent content fixes

Las aplicaciones de emergencia, salud y cívicas no pueden esperar días para corregir una lista de verificación rota, un enlace de recursos o un anuncio de ubicación específico. Las actualizaciones directas permiten que la capa web se mueva tan pronto como se aprueba la corrección.

Icono de aplicación de FEMA METEO

FEMA

Guía de emergencia donde pequeños errores de contenido pueden convertirse en urgentes.

Instalaciones de Google Play
1.6M
Calificación de tienda
4.0
Icono de la aplicación Conecte SUS MEDICAL

Conecte sus

Superficies de registros y orientación médica donde los cambios de copia aprobada necesitan entrega rápida.

Instalaciones de Google Play
27,7M
Calificación de la tienda
4.6
Icono de la aplicación e-Título SOCIAL

e-Título

Flujos de identidad cívica donde la guía segura de versiones importa en varios dispositivos.

Instalaciones de Google Play
54,9M
Calificación de la tienda
4.8

Pruebas de clientes

Lo que los equipos que envían con Capgo dicen

5.0/5 valorado por equipos de desarrolladores 9,400+ equipos Leer reseñas

Kapil

Fundador, NuTriQ

Ser capaz de enviar actualizaciones OTA de producción de inmediato sin tener que esperar a los ciclos de revisión completos de la Tienda de Aplicaciones ha sido una ventaja operativa masiva.

Retrato de Sergiu S

Sergiu S

Desarrollador principal, drivolino GmbH

La extensión de actualización de Capgo Capacitor ha cambiado completamente la forma en que enviamos actualizaciones. Lo que solía tomar días ahora solo toma minutos.

Retrato de Luis Dominguez

Luis Domínguez

El que paga, Anirol

“Desde que empecé a usar Capgo todo es más rápido, y puedo dar a mis usuarios el tiempo que merecen sin descuidar mi vida diaria.”

FAQ

Preguntas sobre actualizaciones directas

¿Cuándo usarlas, cómo configurarlas y qué cuestan al lanzamiento.

¿Debemos usar actualizaciones directas o el modo de fondo por defecto?

Use el modo por defecto para la mayoría de las versiones: no hay espera al lanzamiento, y los usuarios obtienen la actualización en la siguiente sesión. Use un modo directo cuando la sesión que comienza después de su carga debe ejecutar el nuevo code, por ejemplo, una reparación de una compra rota o una corrección de seguridad en la capa web.

Actualización de comportamiento de documentos

¿Cuál es la diferencia entre atInstall, onLaunch y siempre?

atInstall aplica una actualización inmediatamente solo después de una instalación fresca o una actualización de tienda de la aplicación nativa, luego actúa como el valor predeterminado. onLaunch aplica inmediatamente cuando la aplicación comienza desde un estado eliminado. siempre verifica en cada estado de primer plano y aplica tan pronto como se complete la descarga, incluso mientras el usuario está en la aplicación.

Configuración del actualizador

¿Por qué es necesario el plugin de pantalla de bienvenida?

Direct modes apply the update while the user waits. Without @capacitor/splash-screen, autoSplashscreen: true, and launchAutoHide: false, users can see a flicker or the old UI before the reload. With them, the splash stays up until the update is applied or the updater knows none is needed.

Manejo de pantalla de bienvenida

¿Podemos activar las actualizaciones directas con un live update?

No. autoUpdate lives in capacitor.config, which is read into the native app at build time. Ship the new setting in a store release. After that, every live update follows the new mode.

Compatibilidad nativa de documentación

Nuestra configuración utiliza directUpdate. ¿Aún se mantiene?

directUpdate is deprecated but still detected. Its values match the autoUpdate modes atInstall, onLaunch, and always. Move the setting to autoUpdate in your next native release.

Configuración del actualizador

Coloca tu próxima corrección en la primera pantalla

Prueba un modo de actualización directa en una versión de prueba durante la prueba y mide el tiempo de espera de lanzamiento en tu propia aplicación

Prueba durante 14 días sin tarjeta de crédito