Funciones y configuraciones
Configuración del Plugin Updater
Section titled “Configuración del Plugin Updater”Consulta el Readme de GitHub para más información.
CapacitorUpdater puede configurarse con estas opciones:
| Prop | Tipo | Descripción | Por defecto | Desde |
|---|---|---|---|---|
appReadyTimeout | number | Configura el número de milisegundos que el Plugin nativo debe esperar antes de considerar una actualización como ‘fallida’. Solo disponible para Android e iOS. | 10000 // (10 segundos) | |
responseTimeout | number | Configura el número de milisegundos que el Plugin nativo debe esperar antes de considerar un timeout de API. Solo disponible para Android e iOS. | 20 // (20 segundos) | |
autoDeleteFailed | boolean | Configura si el Plugin debe eliminar automáticamente los Paquetes fallidos. Solo disponible para Android e iOS. | true | |
autoDeletePrevious | boolean | Configura si el Plugin debe eliminar automáticamente los Paquetes anteriores después de una actualización exitosa. Solo disponible para Android e iOS. | true | |
autoUpdate | boolean | Configura si el Plugin debe usar Actualización Automática a través de un servidor de actualizaciones. Solo disponible para Android e iOS. | true | |
resetWhenUpdate | boolean | Elimina automáticamente los Paquetes descargados anteriores cuando se instala un nuevo Paquete de aplicación nativa en el dispositivo. Solo disponible para Android e iOS. | true | |
updateUrl | string | Configura la URL / endpoint al que se envían las verificaciones de actualización. Solo disponible para Android e iOS. | https://Plugin.Capgo.Aplicación/Actualizaciones | |
channelUrl | string | Configura la URL / endpoint para operaciones de canal. Solo disponible para Android e iOS. | https://Plugin.Capgo.Aplicación/channel_self | |
statsUrl | string | Configura la URL / endpoint al que se envían las estadísticas de actualización. Solo disponible para Android e iOS. Establece en "" para deshabilitar el reporte de estadísticas. | https://Plugin.Capgo.Aplicación/stats | |
publicKey | string | Configura la clave pública para cifrado de actualizaciones en vivo de extremo a extremo Versión 2 Solo disponible para Android e iOS. | undefined | 6.2.0 |
version | string | Configura la versión actual de la aplicación. Esto se usará para la primera solicitud de actualización. Si no se establece, el Plugin obtendrá la versión del código nativo. Solo disponible para Android e iOS. | undefined | 4.17.48 |
directUpdate | boolean | ‘always’ | ‘atInstall’ | ‘onLaunch’ | Configura cuándo el Plugin debe realizar instalación directa de actualizaciones. Solo para modo autoUpdate. Funciona bien para aplicaciones menores a 10MB y con cargas realizadas usando el flag —partial. Zip o aplicaciones mayores a 10MB serán relativamente lentas para que los usuarios actualicen. - false: Nunca hacer actualizaciones directas (usar comportamiento predeterminado: descargar al inicio, establecer cuando se pone en segundo plano) - atInstall: Actualización directa solo cuando la aplicación está instalada, actualizada desde la tienda, de lo contrario actúa como directUpdate = false - onLaunch: Actualización directa solo al instalar la aplicación, actualizarla desde la tienda o después de cerrar la aplicación, de lo contrario actúa como directUpdate = false - always: Actualización directa en todos los casos anteriores (aplicación instalada, actualizada desde la tienda, después de cerrar la aplicación o reanudar la aplicación), nunca actúa como directUpdate = false - true: (obsoleto) Lo mismo que “always” para retrocompatibilidad Solo disponible para Android e iOS. | false | 5.1.0 |
autoSplashscreen | boolean | Maneja automáticamente el ocultamiento de la pantalla de bienvenida cuando se usa directUpdate. Cuando está habilitado, el Plugin ocultará automáticamente la pantalla de bienvenida después de aplicar las actualizaciones o cuando no se necesite actualización. Esto elimina la necesidad de escuchar manualmente los eventos appReady y llamar a SplashScreen.hide(). Solo funciona cuando directUpdate está establecido en “atInstall”, “always” o true. Requiere que el Plugin @Capacitor/splash-screen esté instalado y configurado con launchAutoHide: false. Requiere que autoUpdate y directUpdate estén habilitados. Solo disponible para Android e iOS. | false | 7.6.0 |
periodCheckDelay | number | Configura el período de retraso para la verificación periódica de actualizaciones. La unidad es en segundos. Solo disponible para Android e iOS. No puede ser menor a 600 segundos (10 minutos). | 600 // (10 minutos) | |
localS3 | boolean | Configura el CLI para usar un servidor local para pruebas o servidor de actualizaciones auto-hospedado. | undefined | 4.17.48 |
localHost | string | Configura el CLI para usar un servidor local para pruebas o servidor de actualizaciones auto-hospedado. | undefined | 4.17.48 |
localWebHost | string | Configura el CLI para usar un servidor local para pruebas o servidor de actualizaciones auto-hospedado. | undefined | 4.17.48 |
localSupa | string | Configura el CLI para usar un servidor local para pruebas o servidor de actualizaciones auto-hospedado. | undefined | 4.17.48 |
localSupaAnon | string | Configura el CLI para usar un servidor local para pruebas. | undefined | 4.17.48 |
localApi | string | Configura el CLI para usar una API local para pruebas. | undefined | 6.3.3 |
localApiFiles | string | Configura el CLI para usar una API de archivos local para pruebas. | undefined | 6.3.3 |
allowModifyUrl | boolean | Permite que el Plugin modifique dinámicamente updateUrl, statsUrl y channelUrl desde el lado de JavaScript. | false | 5.4.0 |
defaultChannel | string | Establece el canal predeterminado para la aplicación en la configuración. Sensible a mayúsculas. Esta configuración anulará el canal predeterminado establecido en la nube, pero aún respetará las anulaciones hechas en la nube. | undefined | 5.5.0 |
appId | string | Configura el id de la aplicación en la configuración. | undefined | 6.0.0 |
keepUrlPathAfterReload | boolean | Configura el Plugin para mantener la ruta de URL después de una recarga. ADVERTENCIA: Cuando se activa una recarga, ‘window.history’ se borrará. | false | 6.8.0 |
disableJSLogging | boolean | Deshabilita el registro de JavaScript del Plugin. Si es true, el Plugin no registrará en la consola de JavaScript. Solo se realizará el registro nativo | false | 7.3.0 |
shakeMenu | boolean | Habilita el gesto de sacudir para mostrar el menú de actualización para propósitos de depuración/prueba | false | 7.5.0 |
Ejemplos
Section titled “Ejemplos”En capacitor.config.json:
{ "plugins": { "CapacitorUpdater": { "appReadyTimeout": 1000 // (1 segundo), "responseTimeout": 10 // (10 segundos), "autoDeleteFailed": false, "autoDeletePrevious": false, "autoUpdate": false, "resetWhenUpdate": false, "updateUrl": https://example.com/api/auto_update, "channelUrl": https://example.com/api/channel, "statsUrl": https://example.com/api/stats, "publicKey": undefined, "version": undefined, "directUpdate": undefined, "autoSplashscreen": undefined, "periodCheckDelay": undefined, "localS3": undefined, "localHost": undefined, "localWebHost": undefined, "localSupa": undefined, "localSupaAnon": undefined, "localApi": undefined, "localApiFiles": undefined, "allowModifyUrl": undefined, "defaultChannel": undefined, "appId": undefined, "keepUrlPathAfterReload": undefined, "disableJSLogging": undefined, "shakeMenu": undefined } }}En capacitor.config.ts:
/// <reference types="@capgo/capacitor-updater" />
import { CapacitorConfig } from '@capacitor/cli';
const config: CapacitorConfig = { plugins: { CapacitorUpdater: { appReadyTimeout: 1000 // (1 segundo), responseTimeout: 10 // (10 segundos), autoDeleteFailed: false, autoDeletePrevious: false, autoUpdate: false, resetWhenUpdate: false, updateUrl: https://example.com/api/auto_update, channelUrl: https://example.com/api/channel, statsUrl: https://example.com/api/stats, publicKey: undefined, version: undefined, directUpdate: undefined, autoSplashscreen: undefined, periodCheckDelay: undefined, localS3: undefined, localHost: undefined, localWebHost: undefined, localSupa: undefined, localSupaAnon: undefined, localApi: undefined, localApiFiles: undefined, allowModifyUrl: undefined, defaultChannel: undefined, appId: undefined, keepUrlPathAfterReload: undefined, disableJSLogging: undefined, shakeMenu: undefined, }, },};
export default config;notifyAppReady()setUpdateUrl(...)setStatsUrl(...)setChannelUrl(...)download(...)next(...)set(...)delete(...)list(...)reset(...)current()reload()setMultiDelay(...)cancelDelay()getLatest(...)setChannel(...)unsetChannel(...)getChannel()listChannels()setCustomId(...)getBuiltinVersion()getDeviceId()getPluginVersion()isAutoUpdateEnabled()removeAllListeners()addListener('download', ...)addListener('noNeedUpdate', ...)addListener('updateAvailable', ...)addListener('downloadComplete', ...)addListener('majorAvailable', ...)addListener('updateFailed', ...)addListener('downloadFailed', ...)addListener('appReloaded', ...)addListener('appReady', ...)isAutoUpdateAvailable()getNextBundle()setShakeMenu(...)isShakeMenuEnabled()- Interfaces
- Alias de Tipos
Métodos
Section titled “Métodos”notifyAppReady()
Section titled “notifyAppReady()”notifyAppReady() => Promise<AppReadyResult>Notifica a Capacitor Updater que el Paquete actual está funcionando (ocurrirá un Reversión si este método no se llama en cada inicio de aplicación) Por defecto, este método debe llamarse en los primeros 10 segundos después del inicio de la aplicación, de lo contrario ocurrirá un Reversión. Cambia este comportamiento con {@Enlace appReadyTimeout}
Retorna: Promise<AppReadyResult>
setUpdateUrl(…)
Section titled “setUpdateUrl(…)”setUpdateUrl(options: UpdateUrl) => Promise<void>Establece la updateUrl para la aplicación, esto se usará para verificar actualizaciones.
| Parámetro | Tipo | Descripción |
|---|---|---|
options | UpdateUrl | contiene la URL a usar para verificar actualizaciones. |
Desde: 5.4.0
setStatsUrl(…)
Section titled “setStatsUrl(…)”setStatsUrl(options: StatsUrl) => Promise<void>Establece la statsUrl para la aplicación, esto se usará para enviar estadísticas. Pasar una cadena vacía deshabilitará la recopilación de estadísticas.
| Parámetro | Tipo | Descripción |
|---|---|---|
options | StatsUrl | contiene la URL a usar para enviar estadísticas. |
Desde: 5.4.0
setChannelUrl(…)
Section titled “setChannelUrl(…)”setChannelUrl(options: ChannelUrl) => Promise<void>Establece la channelUrl para la aplicación, esto se usará para establecer el canal.
| Parámetro | Tipo | Descripción |
|---|---|---|
options | ChannelUrl | contiene la URL a usar para establecer el canal. |
Desde: 5.4.0
Descargar(…)
Section titled “Descargar(…)”download(options: DownloadOptions) => Promise<BundleInfo>Descarga un nuevo Paquete desde la URL proporcionada, debe ser un archivo zip, con archivos dentro o con un id único dentro con todos tus archivos
| Parámetro | Tipo | Descripción |
|---|---|---|
options | DownloadOptions | Las {@Enlace DownloadOptions} para descargar un nuevo Paquete zip. |
Retorna: Promise<BundleInfo>
next(…)
Section titled “next(…)”next(options: BundleId) => Promise<BundleInfo>Establece el siguiente Paquete a usar cuando la aplicación se recarga.
| Parámetro | Tipo | Descripción |
|---|---|---|
options | BundleId | Contiene el ID del siguiente Paquete a establecer en el próximo inicio de la aplicación. {@Enlace BundleInfo.id} |
Retorna: Promise<BundleInfo>
Establecer(…)
Section titled “Establecer(…)”set(options: BundleId) => Promise<void>Establece el Paquete actual e inmediatamente recarga la aplicación.
| Parámetro | Tipo | Descripción |
|---|---|---|
options | BundleId | Un objeto {@Enlace BundleId} que contiene el nuevo id del Paquete a establecer como actual. |
Eliminar(…)
Section titled “Eliminar(…)”delete(options: BundleId) => Promise<void>Elimina el Paquete especificado del almacenamiento de la aplicación nativa. Usa con {@Enlace list} para obtener los IDs de Paquete almacenados.
| Parámetro | Tipo | Descripción |
|---|---|---|
options | BundleId | Un objeto {@Enlace BundleId} que contiene el ID de un Paquete a eliminar (nota, este es el id del Paquete, NO el nombre de versión) |
list(…)
Section titled “list(…)”list(options?: ListOptions | undefined) => Promise<BundleListResult>Obtiene todos los Paquetes descargados localmente en tu aplicación
| Parámetro | Tipo | Descripción |
|---|---|---|
options | ListOptions | Las {@Enlace ListOptions} para listar Paquetes |
Retorna: Promise<BundleListResult>
reset(…)
Section titled “reset(…)”reset(options?: ResetOptions | undefined) => Promise<void>Restablece la aplicación al Paquete builtin (el enviado a Apple Aplicación Store / Google Play Store) o al último Paquete cargado exitosamente.
| Parámetro | Tipo | Descripción |
|---|---|---|
options | ResetOptions | Contiene {@Enlace ResetOptions.toLastSuccessful}, true restablece al Paquete builtin y false restablecerá al último Paquete cargado exitosamente. |
current()
Section titled “current()”current() => Promise<CurrentBundleResult>Obtiene el Paquete actual, si no hay ninguno establecido retorna builtin. currentNative es el Paquete original instalado en el dispositivo
Retorna: Promise<CurrentBundleResult>
reload()
Section titled “reload()”reload() => Promise<void>Recarga la vista
setMultiDelay(…)
Section titled “setMultiDelay(…)”setMultiDelay(options: MultiDelayConditions) => Promise<void>Establece un array de {@Enlace DelayCondition} que contiene condiciones que el Plugin usará para retrasar la actualización.
Después de que se cumplan todas las condiciones, el proceso de actualización comenzará nuevamente como de costumbre, por lo que la actualización se instalará después de poner en segundo plano o cerrar la aplicación.
Para el tipo date, el valor debe ser una cadena de fecha iso8601.
Para el tipo background, el valor debe ser un número en milisegundos.
Para el tipo nativeVersion, el valor debe ser el número de versión.
Para el tipo kill, el valor no se usa.
La función tiene comportamiento inconsistente, la opción kill activa la actualización después del primer cierre y no después del siguiente segundo plano como otras opciones. Esto se corregirá en una futura versión mayor.
| Parámetro | Tipo | Descripción |
|---|---|---|
options | MultiDelayConditions | Contiene el array de {@Enlace MultiDelayConditions} de condiciones a establecer |
Desde: 4.3.0
cancelDelay()
Section titled “cancelDelay()”cancelDelay() => Promise<void>Cancela una {@Enlace DelayCondition} para procesar una actualización inmediatamente.
Desde: 4.0.0
getLatest(…)
Section titled “getLatest(…)”getLatest(options?: GetLatestOptions | undefined) => Promise<LatestVersion>Obtiene el último Paquete disponible desde la URL de actualización
| Parámetro | Tipo |
|---|---|
options | GetLatestOptions |
Retorna: Promise<LatestVersion>
Desde: 4.0.0
setChannel(…)
Section titled “setChannel(…)”setChannel(options: SetChannelOptions) => Promise<ChannelRes>Establece el canal para este dispositivo. El canal debe permitir auto-asignación para que esto funcione. No uses este método para establecer el canal al inicio. Este método es para establecer el canal después de que la aplicación esté lista, y el usuario haya interactuado. Si quieres establecer el canal al inicio, usa {@Enlace PluginsConfig} para establecer el canal predeterminado. Este método envía al backend de Capgo una solicitud para vincular el ID del dispositivo al canal. Capgo puede aceptar o rechazar dependiendo de la configuración de tu canal.
| Parámetro | Tipo | Descripción |
|---|---|---|
options | SetChannelOptions | Es el canal {@Enlace SetChannelOptions} a establecer |
Retorna: Promise<ChannelRes>
Desde: 4.7.0
unsetChannel(…)
Section titled “unsetChannel(…)”unsetChannel(options: UnsetChannelOptions) => Promise<void>Desestablece el canal para este dispositivo. El dispositivo volverá entonces al canal predeterminado
| Parámetro | Tipo |
|---|---|
options | UnsetChannelOptions |
Desde: 4.7.0
getChannel()
Section titled “getChannel()”getChannel() => Promise<GetChannelRes>Obtiene el canal para este dispositivo
Retorna: Promise<GetChannelRes>
Desde: 4.8.0
listChannels()
Section titled “listChannels()”listChannels() => Promise<ListChannelsResult>Lista todos los canales disponibles para este dispositivo que permiten auto-asignación
Retorna: Promise<ListChannelsResult>
Desde: 7.5.0
setCustomId(…)
Section titled “setCustomId(…)”setCustomId(options: SetCustomIdOptions) => Promise<void>Establece un ID personalizado para este dispositivo
| Parámetro | Tipo | Descripción |
|---|---|---|
options | SetCustomIdOptions | es el {@Enlace SetCustomIdOptions} customId a establecer |
Desde: 4.9.0
getBuiltinVersion()
Section titled “getBuiltinVersion()”getBuiltinVersion() => Promise<BuiltinVersion>Obtiene la versión de la aplicación nativa o la versión builtin si se estableció en la configuración
Retorna: Promise<BuiltinVersion>
Desde: 5.2.0
getDeviceId()
Section titled “getDeviceId()”getDeviceId() => Promise<DeviceId>Obtiene el ID único usado para identificar el dispositivo (enviado al servidor de actualización automática)
Retorna: Promise<DeviceId>
getPluginVersion()
Section titled “getPluginVersion()”getPluginVersion() => Promise<PluginVersion>Obtiene la versión del Plugin nativo Capacitor Updater (enviado al servidor de actualización automática)
Retorna: Promise<PluginVersion>
isAutoUpdateEnabled()
Section titled “isAutoUpdateEnabled()”isAutoUpdateEnabled() => Promise<AutoUpdateEnabled>Obtiene el estado de la configuración de actualización automática.
Retorna: Promise<AutoUpdateEnabled>
removeAllListeners()
Section titled “removeAllListeners()”removeAllListeners() => Promise<void>Elimina todos los listeners de este Plugin.
Desde: 1.0.0
addListener(‘Descargar’, …)
Section titled “addListener(‘Descargar’, …)”addListener(eventName: 'download', listenerFunc: (state: DownloadEvent) => void) => Promise<PluginListenerHandle>Escucha el evento de descarga de Paquete en la Aplicación. Se activa una vez que comienza una descarga, durante la descarga y cuando termina. Esto te devolverá todos los porcentajes de descarga durante la descarga
| Parámetro | Tipo |
|---|---|
eventName | ’Descargar’ |
listenerFunc | (state: DownloadEvent) => void |
Retorna: Promise<PluginListenerHandle>
Desde: 2.0.11
addListener(‘noNeedUpdate’, …)
Section titled “addListener(‘noNeedUpdate’, …)”addListener(eventName: 'noNeedUpdate', listenerFunc: (state: NoNeedEvent) => void) => Promise<PluginListenerHandle>Escucha el evento de no necesidad de actualización, útil cuando quieres forzar la verificación cada vez que se inicia la aplicación
| Parámetro | Tipo |
|---|---|
eventName | ’noNeedUpdate’ |
listenerFunc | (state: NoNeedEvent) => void |
Retorna: Promise<PluginListenerHandle>
Desde: 4.0.0
addListener(‘updateAvailable’, …)
Section titled “addListener(‘updateAvailable’, …)”addListener(eventName: 'updateAvailable', listenerFunc: (state: UpdateAvailableEvent) => void) => Promise<PluginListenerHandle>Escucha el evento de actualización disponible, útil cuando quieres forzar la verificación cada vez que se inicia la aplicación
| Parámetro | Tipo |
|---|---|
eventName | ’updateAvailable’ |
listenerFunc | (state: UpdateAvailableEvent) => void |
Retorna: Promise<PluginListenerHandle>
Desde: 4.0.0
addListener(‘downloadComplete’, …)
Section titled “addListener(‘downloadComplete’, …)”addListener(eventName: 'downloadComplete', listenerFunc: (state: DownloadCompleteEvent) => void) => Promise<PluginListenerHandle>Escucha eventos de downloadComplete.
| Parámetro | Tipo |
|---|---|
eventName | ’downloadComplete’ |
listenerFunc | (state: DownloadCompleteEvent) => void |
Retorna: Promise<PluginListenerHandle>
Desde: 4.0.0
addListener(‘majorAvailable’, …)
Section titled “addListener(‘majorAvailable’, …)”addListener(eventName: 'majorAvailable', listenerFunc: (state: MajorAvailableEvent) => void) => Promise<PluginListenerHandle>Escucha el evento de actualización Mayor en la Aplicación, te permite saber cuando una actualización mayor está bloqueada al establecer disableAutoUpdateBreaking
| Parámetro | Tipo |
|---|---|
eventName | ’majorAvailable’ |
listenerFunc | (state: MajorAvailableEvent) => void |
Retorna: Promise<PluginListenerHandle>
Desde: 2.3.0
addListener(‘updateFailed’, …)
Section titled “addListener(‘updateFailed’, …)”addListener(eventName: 'updateFailed', listenerFunc: (state: UpdateFailedEvent) => void) => Promise<PluginListenerHandle>Escucha el evento de fallo de actualización en la Aplicación, te permite saber cuando la actualización ha fallado al instalarse en el próximo inicio de la aplicación
| Parámetro | Tipo |
|---|---|
eventName | ’updateFailed’ |
listenerFunc | (state: UpdateFailedEvent) => void |
Retorna: Promise<PluginListenerHandle>
Desde: 2.3.0
addListener(‘downloadFailed’, …)
Section titled “addListener(‘downloadFailed’, …)”addListener(eventName: 'downloadFailed', listenerFunc: (state: DownloadFailedEvent) => void) => Promise<PluginListenerHandle>Escucha el evento de fallo de descarga en la Aplicación, te permite saber cuando la descarga de un Paquete ha fallado
| Parámetro | Tipo |
|---|---|
eventName | ’downloadFailed’ |
listenerFunc | (state: DownloadFailedEvent) => void |
Retorna: Promise<PluginListenerHandle>
Desde: 4.0.0
addListener(‘appReloaded’, …)
Section titled “addListener(‘appReloaded’, …)”addListener(eventName: 'appReloaded', listenerFunc: () => void) => Promise<PluginListenerHandle>Escucha el evento de recarga en la Aplicación, te permite saber cuando ha ocurrido una recarga
| Parámetro | Tipo |
|---|---|
eventName | ’appReloaded’ |
listenerFunc | () => void |
Retorna: Promise<PluginListenerHandle>
Desde: 4.3.0
addListener(‘appReady’, …)
Section titled “addListener(‘appReady’, …)”addListener(eventName: 'appReady', listenerFunc: (state: AppReadyEvent) => void) => Promise<PluginListenerHandle>Escucha el evento de aplicación lista en la Aplicación, te permite saber cuando la aplicación está lista para usar
| Parámetro | Tipo |
|---|---|
eventName | ’appReady’ |
listenerFunc | (state: AppReadyEvent) => void |
Retorna: Promise<PluginListenerHandle>
Desde: 5.1.0
isAutoUpdateAvailable()
Section titled “isAutoUpdateAvailable()”isAutoUpdateAvailable() => Promise<AutoUpdateAvailable>Obtiene si la actualización automática está disponible (no deshabilitada por serverUrl).
Retorna: Promise<AutoUpdateAvailable>
getNextBundle()
Section titled “getNextBundle()”getNextBundle() => Promise<BundleInfo | null>Obtiene el siguiente Paquete que se usará cuando la aplicación se recargue. Retorna null si no hay un siguiente Paquete establecido.
Retorna: Promise<BundleInfo | null>
Desde: 6.8.0
setShakeMenu(…)
Section titled “setShakeMenu(…)”setShakeMenu(options: SetShakeMenuOptions) => Promise<void>Habilita o deshabilita el menú de sacudida para propósitos de depuración/prueba
| Parámetro | Tipo | Descripción |
|---|---|---|
options | SetShakeMenuOptions | Contiene el booleano Habilitado para habilitar o deshabilitar el menú de sacudida |
Desde: 7.5.0
isShakeMenuEnabled()
Section titled “isShakeMenuEnabled()”isShakeMenuEnabled() => Promise<ShakeMenuEnabled>Obtiene el estado actual del menú de sacudida
Retorna: Promise<ShakeMenuEnabled>
Desde: 7.5.0
Interfaces
Section titled “Interfaces”AppReadyResult
Section titled “AppReadyResult”| Prop | Tipo |
|---|---|
bundle | BundleInfo |
BundleInfo
Section titled “BundleInfo”| Prop | Tipo |
|---|---|
id | string |
version | string |
downloaded | string |
checksum | string |
status | BundleStatus |
UpdateUrl
Section titled “UpdateUrl”| Prop | Tipo |
|---|---|
url | string |
StatsUrl
Section titled “StatsUrl”| Prop | Tipo |
|---|---|
url | string |
ChannelUrl
Section titled “ChannelUrl”| Prop | Tipo |
|---|---|
url | string |
DownloadOptions
Section titled “DownloadOptions”Esta URL y versiones se usan para descargar el Paquete desde el servidor. Si usas backend, toda la información será proporcionada por el método getLatest. Si no usas backend, necesitas proporcionar la URL y versión del Paquete. Checksum y sessionKey son requeridos si cifraste el Paquete con el comando CLI encrypt, deberías recibirlos como resultado del comando.
| Prop | Tipo | Descripción | Por defecto | Desde |
|---|---|---|---|---|
url | string | La URL del archivo zip del Paquete (ej: dist.zip) a descargar. (Puede ser cualquier URL. Ej: Amazon S3, una etiqueta de GitHub, cualquier otro lugar donde hayas alojado tu Paquete.) | ||
version | string | El código/nombre de versión de este Paquete/versión | ||
sessionKey | string | La clave de sesión para la actualización, cuando el Paquete está cifrado con una clave de sesión | undefined | 4.0.0 |
checksum | string | El checksum para la actualización, debe estar en sha256 y cifrado con clave privada si el Paquete está cifrado | undefined | 4.0.0 |
manifest | ManifestEntry[] | El manifiesto para descargas de múltiples archivos | undefined | 6.1.0 |
ManifestEntry
Section titled “ManifestEntry”| Prop | Tipo |
|---|---|
file_name | string | null |
file_hash | string | null |
download_url | string | null |
BundleId
Section titled “BundleId”| Prop | Tipo |
|---|---|
id | string |
BundleListResult
Section titled “BundleListResult”| Prop | Tipo |
|---|---|
bundles | BundleInfo[] |
ListOptions
Section titled “ListOptions”| Prop | Tipo | Descripción | Por defecto | Desde |
|---|---|---|---|---|
raw | boolean | Si retornar la lista de Paquetes sin procesar o el manifiesto. Si es true, la lista intentará leer la base de datos interna en lugar de archivos en disco. | false | 6.14.0 |
ResetOptions
Section titled “ResetOptions”| Prop | Tipo |
|---|---|
toLastSuccessful | boolean |
CurrentBundleResult
Section titled “CurrentBundleResult”| Prop | Tipo |
|---|---|
bundle | BundleInfo |
native | string |
MultiDelayConditions
Section titled “MultiDelayConditions”| Prop | Tipo |
|---|---|
delayConditions | DelayCondition[] |
DelayCondition
Section titled “DelayCondition”| Prop | Tipo | Descripción |
|---|---|---|
kind | DelayUntilNext | Configura condiciones de retraso en setMultiDelay |
value | string |
LatestVersion
Section titled “LatestVersion”| Prop | Tipo | Descripción | Desde |
|---|---|---|---|
version | string | Resultado del método getLatest | 4.0.0 |
checksum | string | 6 | |
major | boolean | ||
message | string | ||
sessionKey | string | ||
error | string | ||
old | string | ||
url | string | ||
manifest | ManifestEntry[] | 6.1 |
GetLatestOptions
Section titled “GetLatestOptions”| Prop | Tipo | Descripción | Por defecto | Desde |
|---|---|---|---|---|
channel | string | El canal para obtener la última versión El canal debe permitir ‘self_assign’ para que esto funcione | undefined | 6.8.0 |
ChannelRes
Section titled “ChannelRes”| Prop | Tipo | Descripción | Desde |
|---|---|---|---|
status | string | Estado actual de establecer canal | 4.7.0 |
error | string | ||
message | string |
SetChannelOptions
Section titled “SetChannelOptions”| Prop | Tipo |
|---|---|
channel | string |
triggerAutoUpdate | boolean |
UnsetChannelOptions
Section titled “UnsetChannelOptions”| Prop | Tipo |
|---|---|
triggerAutoUpdate | boolean |
GetChannelRes
Section titled “GetChannelRes”| Prop | Tipo | Descripción | Desde |
|---|---|---|---|
channel | string | Estado actual de obtener canal | 4.8.0 |
error | string | ||
message | string | ||
status | string | ||
allowSet | boolean |
ListChannelsResult
Section titled “ListChannelsResult”| Prop | Tipo | Descripción | Desde |
|---|---|---|---|
channels | ChannelInfo[] | Lista de canales disponibles | 7.5.0 |
ChannelInfo
Section titled “ChannelInfo”| Prop | Tipo | Descripción | Desde |
|---|---|---|---|
id | string | El ID del canal | 7.5.0 |
name | string | El nombre del canal | 7.5.0 |
public | boolean | Si este es un canal público | 7.5.0 |
allow_self_set | boolean | Si los dispositivos pueden auto-asignarse a este canal | 7.5.0 |
SetCustomIdOptions
Section titled “SetCustomIdOptions”| Prop | Tipo |
|---|---|
customId | string |
BuiltinVersion
Section titled “BuiltinVersion”| Prop | Tipo |
|---|---|
version | string |
DeviceId
Section titled “DeviceId”| Prop | Tipo |
|---|---|
deviceId | string |
PluginVersion
Section titled “PluginVersion”| Prop | Tipo |
|---|---|
version | string |
AutoUpdateEnabled
Section titled “AutoUpdateEnabled”| Prop | Tipo |
|---|---|
enabled | boolean |
PluginListenerHandle
Section titled “PluginListenerHandle”| Prop | Tipo |
|---|---|
remove | () => Promise<void> |
DownloadEvent
Section titled “DownloadEvent”| Prop | Tipo | Descripción | Desde |
|---|---|---|---|
percent | number | Estado actual de descarga, entre 0 y 100. | 4.0.0 |
bundle | BundleInfo |
NoNeedEvent
Section titled “NoNeedEvent”| Prop | Tipo | Descripción | Desde |
|---|---|---|---|
bundle | BundleInfo | Estado actual de descarga, entre 0 y 100. | 4.0.0 |
UpdateAvailableEvent
Section titled “UpdateAvailableEvent”| Prop | Tipo | Descripción | Desde |
|---|---|---|---|
bundle | BundleInfo | Estado actual de descarga, entre 0 y 100. | 4.0.0 |
DownloadCompleteEvent
Section titled “DownloadCompleteEvent”| Prop | Tipo | Descripción | Desde |
|---|---|---|---|
bundle | BundleInfo | Se emite cuando una nueva actualización está disponible. | 4.0.0 |
MajorAvailableEvent
Section titled “MajorAvailableEvent”| Prop | Tipo | Descripción | Desde |
|---|---|---|---|
version | string | Se emite cuando un nuevo Paquete mayor está disponible. | 4.0.0 |
UpdateFailedEvent
Section titled “UpdateFailedEvent”| Prop | Tipo | Descripción | Desde |
|---|---|---|---|
bundle | BundleInfo | Se emite cuando una actualización falla al instalarse. | 4.0.0 |
DownloadFailedEvent
Section titled “DownloadFailedEvent”| Prop | Tipo | Descripción | Desde |
|---|---|---|---|
version | string | Se emite cuando falla una descarga. | 4.0.0 |
AppReadyEvent
Section titled “AppReadyEvent”| Prop | Tipo | Descripción | Desde |
|---|---|---|---|
bundle | BundleInfo | Se emite cuando la aplicación está lista para usar. | 5.2.0 |
status | string |
AutoUpdateAvailable
Section titled “AutoUpdateAvailable”| Prop | Tipo |
|---|---|
available | boolean |
SetShakeMenuOptions
Section titled “SetShakeMenuOptions”| Prop | Tipo |
|---|---|
enabled | boolean |
ShakeMenuEnabled
Section titled “ShakeMenuEnabled”| Prop | Tipo |
|---|---|
enabled | boolean |
Alias de Tipos
Section titled “Alias de Tipos”BundleStatus
Section titled “BundleStatus”Pendiente: El Paquete está pendiente de ser ESTABLECIDO como el próximo Paquete. downloading: El Paquete se está descargando. Éxito: El Paquete se ha descargado y está listo para ser ESTABLECIDO como el próximo Paquete. Error: El Paquete ha fallado al descargarse.
‘Éxito’ | ‘Error’ | ‘Pendiente’ | ‘downloading’
DelayUntilNext
Section titled “DelayUntilNext”‘background’ | ‘kill’ | ‘nativeVersion’ | ‘date’