De V3 a V4

¿Por qué esta actualización?

Después de muchas charlas en la comunidad de Discord con usted. Descubrí que el modo manual era demasiado manual y no seguro de usar, por ejemplo, no era posible el auto-revert, así que si fallaba la actualización en modo manual, el usuario tenía que eliminar la aplicación y volver a instalarla, lo cual es una terrible experiencia de usuario.

Meanwhile, I took this as an opportunity to give more freedom to you, and remove all bad code I made.

Sección titulada “Instalación”

npm i @capgo/capacitor-updater@4

Sección titulada “Actualización automática en la nube”

Si utiliza el ejemplo básico en su aplicación, está seguro de migrar a la nueva versión, ¡disfrute!

Actualización automática autoalojada

Para usted, todavía simple, los cambios son:

• El nombre de la configuración desde autoUpdateUrl en updateUrl
• El método de punto final cambió de GET a POST

Usuarios manuales

Para usted, este es el cambio más significativo, pero para lo mejor! Usted obtiene toneladas de mejoras, ¡léalo con cuidado!

Cambios

• autoUpdateUrl se vuelve updateUrl ya que esta configuración se puede utilizar en modo manual también
• Eliminación de cancelDelay y delayUpdate en lugar de setDelay
• No más versionName en conjunto
• Cambio version clave, que se devolvía en la mayoría de las funciones a objeto BundleInfo

interface BundleInfo {
  id: string;
  version: string;
  downloaded: string;
  status: 'success' | 'error' | 'pending' | 'downloading'
}

• Renombrado de nombres engañosos ahora (aunque no puede explicarse con claridad, pero en el uso es fácil de entender el nuevo):
  • ¿Qué se llamaba a version ahora se refiere a bundle
  • id se refieren a la versión antigua version quien era una cadena de 10 caracteres aleatoria, esto id es la única forma confiable y única de acceder a sus paquetes, ejemplo 7Dfcd2RedN.
  • version se refiere ahora a versionName elige para un paquete, ejemplo 1.0.0
• updateUrl pasar de get a post, ya que los encabezados personalizados eran un problema para algunos de ustedes y post es más lógico, todos los encabezados anteriores se van al cuerpo y se agrega un prefijo cap_ desaparecen.
• versionName el método ha sido eliminado, a favor de getId
• list devuelve ahora una lista de BundleInfo
• Renombrar getId en getDeviceId
• autoUpdate se vuelve verdadero por defecto, si usas el modo Manual, establece a false.

Noticias

• Método getLatestEsta función permite obtener desde tu servidor configurado con updateUrl la última versión disponible.
• Método setDelay quien toma {tipo: “background” | “kill” | “nativeVersion” | “fecha”, valor? : string} como argumento para establecer un retardo en diferentes modos.
• Método next, para establecer la versión en la próxima puesta en segundo plano, en lugar de set quien lo hace de inmediato.
• Método isAutoUpdateEnabled, para informarte si estás en contexto de actualización automática
• Evento downloadComplete cuando se alcanza el 100% de descarga
• Se agregó un campo obligatorio version en el método de descarga
• notifyAppReady también se hace obligatorio en el modo manual, si no se llama después de 10 segundos la aplicación vuelve a la versión anterior.

Colaboradores

@lincolnthree Muchas gracias por empezar este trabajo, era imposible hacer que esta actualización funcionara sin ti.