Configuración

Para tener un control más detallado sobre el sistema de actualizaciones, puede configurarlo con estas configuraciones:

Consejo

Cualquier cambio en estas configuraciones en el archivo capacitor.config requiere sincronizar la plataforma y publicar en la tienda para que las aplicaciones de producción las reciban.

Nota

Para tener la residencia de datos de la UE para Capgo Cloud, establezca updateUrl a https://plugin.eu.capgo.app/updates, statsUrl a https://plugin.eu.capgo.app/statsa channelUrl . Consulte https://plugin.eu.capgo.app/channel_selfUbicación de datos Sección titulada “allowModifyUrl”.

allowModifyUrl

Disponible en Android, iOS y Electron.

Predeterminado:

__CAPGO_KEEP_0__.config.json false

Necesita residencia de datos de la UE para capacitor Cloud. Establezca

{
  "plugins": {
    "CapacitorUpdater": {
      "allowModifyUrl": true
    }
  }
}

appId

Configure el identificador de la aplicación para la aplicación en la configuración.

Disponible en Android, iOS y Electron.

Predeterminado: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "appId": "com.example.app"
    }
  }
}

appReadyTimeout

Configure el número de milisegundos que el plugin nativo debe esperar antes de considerar una actualización ‘fallida’.

Disponible en Android, iOS y Electron.

Predeterminado: 10000 (10 segundos)

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "appReadyTimeout": 1000
    }
  }
}

autoDeleteFailed

Configurar si el complemento debe eliminar automáticamente paquetes fallidos.

Disponible en Android, iOS y Electron.

Predeterminado: true

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "autoDeleteFailed": false
    }
  }
}

autoDeletePrevious

Configurar si el complemento debe eliminar automáticamente paquetes anteriores después de una actualización exitosa.

Disponible en Android, iOS y Electron.

Predeterminado: true

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "autoDeletePrevious": false
    }
  }
}

autoSplashscreen

Automáticamente manejar la ocultación de la pantalla de bienvenida cuando se utilizan modos de aplicación instantánea. Cuando está habilitado, el complemento ocultará automáticamente la pantalla de bienvenida después de aplicar actualizaciones o cuando no se necesite ninguna actualización. Esto elimina la necesidad de escuchar manualmente eventos de aplicación lista y llamar a SplashScreen.hide(). Solo funciona cuando autoUpdate está configurado como "atInstall", "onLaunch", o "always". Valores legados todavía se admiten por compatibilidad hacia atrás. Requiere que el complemento @__CAPGO_KEEP_0__/pantalla de bienvenida esté instalado y configurado con launchAutoHide: false. Requiere que la actualización automática esté habilitada. directUpdate values are still supported for backward compatibility. Requires the @capacitor/splash-screen plugin to be installed and configured with launchAutoHide: false. Requires Auto Update to be enabled.

Valor predeterminado:

__CAPGO_KEEP_0__.config.json false

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "autoUpdate": "atInstall",
      "autoSplashscreen": true
    }
  }
}

autoUpdate

Configure cómo el plugin verifica, descarga y aplica actualizaciones en vivo. El plugin verifica actualizaciones cuando la aplicación se mueve al primer plano y en un temporizador repetido mientras la aplicación permanece abierta. periodCheckDelay controla el intervalo de ese temporizador. Los valores booleanos todavía se admiten por compatibilidad hacia atrás: true es lo mismo que "atBackground" y false contexto: Página/área: Sitio web de marketing de Capgo. Rol: Etiqueta de interfaz de usuario corta o elemento de navegación. Visto en: página trust.astro. Clave de mensaje `y` (Y). "off"es lo mismo que

. Los valores de cadena combinan la configuración de actualización automática y actualización directa previa.

• "off" Opciones: falseo
• "atBackground" contexto: Fragmento de texto HTML de una cadena de interfaz de usuario de Capgo más larga (clave de mensaje `preguntas_cta_alternativas`). Página/área: Comparación de alternativas de actualizaciones en vivo de Capacitor. Rol: Parágrafo de marketing o legal largo. Visto en: página alternativas.astro. Preservar términos de producto y marca de Capgo y términos de desarrollador exactamente. Clave de mensaje `preguntas_cta_alternativas` (Preguntas de CTAs de Alternativas). | Fragmento de texto HTML de una cadena de interfaz de usuario de Capgo más larga (clave de mensaje `preguntas_cta_appflow`). Página/área: Copia de marketing de comparación/migración de Appflow. Rol: Parágrafo de marketing o legal largo. Visto en: página ionic-appflow.astro. Preservar términos de producto y marca de Capgo y términos de desarrollador exactamente. Clave de mensaje `preguntas_cta_appflow` (Preguntas de CTAs de Appflow). | Fragmento de texto HTML de una cadena de interfaz de usuario de Capgo más larga (clave de mensaje `preguntas_cta_capwesome`). Página/área: Página de comparación de Capawesome. Rol: Parágrafo de marketing o legal largo. Visto en: página capwesome.astro. Preservar términos de producto y marca de Capgo y términos de desarrollador exactamente. Clave de mensaje `preguntas_cta_capwesome` (Preguntas de CTAs de Capwesome). | Fragmento de texto HTML de una cadena de interfaz de usuario de Capgo más larga (clave de mensaje `subtítulo_preguntas_faq_consultor`). Página/área: Página de servicios de consultoría. Rol: Subtítulo de sección o etiqueta. Visto en: página consultoría.astro. Preservar términos de producto y marca de Capgo y términos de desarrollador exactamente. Clave de mensaje `subtítulo_preguntas_faq_consultor` (Subtítulo de preguntas de FAQ de consultoría). | Página/área: Copia de marketing de comparación/migración de Appflow. Rol: Etiqueta de interfaz de usuario corta o elemento de navegación. Visto en: página ionic-appflow.astro, página ionic-enterprise-plugins.astro, página soluciones/ionic-enterprise-plugins.astro. Clave de mensaje `appflow_plugins_o` (Appflow Plugins O). true: Deshabilita las verificaciones de actualización automática. : Verifica y descarga automáticamente en cada verificación de primer plano, luego aplica la actualización la próxima vez que la aplicación se mueva al segundo plano
• "atInstall": Aplicar inmediatamente solo después de una instalación fresca o actualización de la tienda de aplicaciones nativa; en caso contrario, utilice "atBackground" comportamiento
• "onLaunch": Aplicar inmediatamente solo cuando la aplicación se trae a primer plano desde un estado asesinado (inicio frío). Después de esa primera comprobación, caiga en el "atBackground" comportamiento
• "always": Comprobar en cada transición de primer plano y aplicar inmediatamente siempre que esté disponible una actualización
• "onlyDownload": Comprobar y descargar automáticamente, emitir updateAvailable, y nunca establecer el siguiente paquete o aplicar una actualización automáticamente

Disponible en Android, iOS y Electron.

Predeterminado: "atBackground" (true aún se acepta)

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "autoUpdate": "onlyDownload"
    }
  }
}

channelUrl

Configure la URL / punto de conexión para operaciones de canal.

Disponible en Android, iOS y Electron.

Predeterminado: https://plugin.capgo.app/channel_self

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "channelUrl": "https://example.com/api/channel"
    }
  }
}

defaultChannel

Establezca el canal predeterminado para la aplicación en la configuración. Sensitive a mayúsculas y minúsculas. Esta configuración sobreescribirá el canal predeterminado establecido en la nube, pero aún respetará las sobrescripciones realizadas en la nube.

Disponible en Android, iOS y Electron.

Predeterminado: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "defaultChannel": "production"
    }
  }
}

directUpdate

Obsoleto. Utilice autoUpdate modos de cadena en su lugar: "atInstall", "onLaunch", o "always" Esta opción permanece soportada para aplicaciones existentes.

Opciones:

• false: Nunca haga actualizaciones directas
• 'atInstall': Igual que autoUpdate: "atInstall"
• 'onLaunch': Igual que autoUpdate: "onLaunch"
• 'always': Igual que autoUpdate: "always"
• true: (obsoleto) Igual que "always" para compatibilidad hacia atrás

Disponible en Android, iOS y Electron.

Predeterminado: false

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "autoUpdate": "atInstall"
    }
  }
}

disableJSLogging

Deshabilitar el registro de JavaScript del plugin. Si es verdadero, el plugin no registrará en la consola de JavaScript. Solo se realizará el registro nativo.

Disponible en Android, iOS y Electron.

Predeterminado: false

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "disableJSLogging": true
    }
  }
}

keepUrlPathAfterReload

Configurar el plugin para mantener la ruta de URL después de un recarga.

Precaución

Cuando se active un recarga, ‘window.history’ se borrará.

Disponible en Android, iOS y Electron.

Predeterminado: false

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "keepUrlPathAfterReload": true
    }
  }
}

periodCheckDelay

Configura el período de retraso para la verificación de actualizaciones periódicas. La unidad es en segundos. No puede ser menor a 600 segundos (10 minutos).

Disponible en Android, iOS y Electron.

Predeterminado: 600 10 minutos

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "periodCheckDelay": 600 // (10 minutes)
    }
  }
}

publicKey

Configura la clave pública para la cifrado de actualizaciones en vivo de fin a fin, versión 2.

Disponible en Android, iOS y Electron.

Predeterminado: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "publicKey": "YOUR_PUBLIC_KEY"
    }
  }
}

Cuidado

publicKey configura el cifrado V2 y debe coincidir con la clave privada utilizada durante la carga. Para las actualizaciones Delta, utilice el cifrado V2 con cifrado parcial habilitado, y active la restricción de paquetes cifrados si su organización requiere que cada carga esté cifrada. No confíe en publicKey como una política de servidor que impida la publicación de una Delta no cifrada.

resetWhenUpdate

Eliminar automáticamente los paquetes descargados previos cuando se instale una versión más nueva del paquete nativo en el dispositivo.

Disponible en Android, iOS y Electron.

Predeterminado: true

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "resetWhenUpdate": false
    }
  }
}

responseTimeout

Configure el número de milisegundos que el plugin nativo debe esperar antes de considerar a API como un tiempo de espera.

Disponible en Android, iOS y Electron.

Predeterminado: 20 (20 segundos)

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "responseTimeout": 10 // (10 seconds)
    }
  }
}

shakeMenu

Habilite la gesto de sacudir para mostrar el menú de actualización con fines de depuración/pruebas.

Disponible en Android, iOS y Electron.

Predeterminado: false

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "shakeMenu": true
    }
  }
}

statsUrl

Configure la URL/punto final al que se envían estadísticas de actualización.

Disponible en Android, iOS y Electron. Establezca a "" para deshabilitar el informe explícito de estadísticas a través de /stats.

No deshabilita todos los almacenamientos de dispositivo __CAPGO_KEEP_0__. statsUrl does not disable all Capgo device storage. If updateUrl se mantiene habilitado, /updates sigue almacenando la fila de facturación MAU, inventario de dispositivos y datos de eventos de decisión de actualización necesarios para servir actualizaciones y contar MAU. Consulte Compliance para la desglose de nivel de campo.

Predeterminado: https://plugin.capgo.app/stats

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "statsUrl": "https://example.com/api/stats"
    }
  }
}

updateUrl

Configure la URL / punto final al que se envían las comprobaciones de actualización.

Diseñado para Android, iOS y Electron.

Predeterminado: https://plugin.capgo.app/updates

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "updateUrl": "https://example.com/api/auto_update"
    }
  }
}

version

Configure la versión actual de la aplicación. Se utilizará para la primera solicitud de actualización. Si no se establece, el complemento obtendrá la versión del nativo code.

Disponible en Android, iOS y Electron.

Predeterminado: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "version": "1.0.0"
    }
  }
}

Configuración de desarrollo

localApi

Configure el CLI para utilizar un api local para pruebas.

Predeterminado: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "localApi": "http://localhost:54321/functions/v1"
    }
  }
}

localApiFiles

Configure CLI para utilizar un archivo local api para pruebas.

Predeterminado: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "localApiFiles": "http://localhost:54321/functions/v1/files"
    }
  }
}

localHost

Configure CLI para utilizar un servidor local para pruebas o servidor de actualizaciones autoalojado.

Predeterminado: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "localHost": "http://localhost:5173"
    }
  }
}

localSupa

Configure el CLI para utilizar un servidor local para pruebas o servidor de actualizaciones autoalojado.

Predeterminado: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "localSupa": "http://localhost:54321"
    }
  }
}

localSupaAnon

Configure el CLI para utilizar un servidor local para pruebas.

Predeterminado: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "localSupaAnon": "YOUR_LOCAL_ANON_KEY"
    }
  }
}

localWebHost

Configure el CLI para utilizar un servidor local para pruebas o servidor de actualizaciones autoalojado.

Predeterminado: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "localWebHost": "http://localhost:5173"
    }
  }
}

Consejo

Hay ajustes adicionales disponibles en la aplicación web de Capgo que se pueden configurar por canal sin necesidad de una actualización de aplicación nativa.

Continúa desde Configuración

Si estás utilizando Configuración para planificar la consola de dashboard y API operaciones, conecte con Usando @capgo/capacitor-actualizador para la capacidad nativa en Usando @capgo/capacitor-actualizador API Resumen para el detalle de implementación en API Resumen Introducción para el detalle de implementación en Introducción API Claves para el detalle de implementación en API Claves, y Dispositivos para el detalle de implementación en Dispositivos.