Problemas de Actualización Comunes

Cuando una comprobación de actualización falla, Capgo suele devolver un error code y un message en la /updates respuesta. Esta página explica las fallas más comunes y las soluciones más rápidas.

Lee esto primero

• no_new_version_available es un estado normal, no un fallo.
• Muchos informes de "actualizaciones encontradas pero no aplicadas" son rechazos de política/configuración en lugar de retraso en caché, especialmente cuando la respuesta incluye una explicación explícita. error code.
• Usar npx @capgo/cli@latest app debug Mientras se reproduce el problema para ver detalles de solicitud/respuesta.

Códigos de falla comunes

disable_auto_update_to_major

Causa

Su canal bloquea actualizaciones importantes (disable_auto_update = major) y la versión mayor del paquete objetivo está por encima de la versión base del dispositivo.

Síntoma típico

version: 1.0.8 con old: 0.0.0 significa que el dispositivo informa la versión base 0.0.0¿Cómo interpretarlo?

El backend compara las versiones principales utilizando la versión base del dispositivo

y objetivo old Si el objetivo es version.

• , la versión base principal debe ser 1.0.1(por ejemplo 1 Si el objetivo es 1.0.0).
• , la versión base principal debe ser 10.0.1(por ejemplo 10 __CAPGO_KEEP_0__ 10.0.0).

Opción A (recomendada): alinea la línea base del dispositivo principal

Establecer plugins.CapacitorUpdater.version así que capacitor.config.* su MAJOR coincida con el MAJOR del paquete que deseas entregar (por ejemplo 1.0.0 para 1.0.1, 10.0.0 para 10.0.1).

Luego aplique esta configuración a la aplicación instalada una vez:

1. Ejecutar npx cap sync.
2. Reconstruir y reinstalar la aplicación nativa.

Opción B: relajar la política de canal

Permitir actualizaciones automáticas entre versiones principales en ajustes de canal (solo si esa estrategia de lanzamiento es intencional).

Documentos relacionados:

• Objetivo de versión: Deshabilitar actualizaciones automáticas entre versiones principales
• Canales: Deshabilitar estrategias de actualización

disable_auto_update_to_minor / disable_auto_update_to_patch

Causa

La política del canal es más estricta (minor o patch) que la actualización ofrecida.

• minor se bloquea cuando el paquete objetivo tiene una versión mayor o menor que la base nativa del dispositivo (version_build). 1.2.3 -> 1.3.0 Ejemplo: se bloquea.
• patch bloquea cualquier cambio de número mayor, menor o de parche desde version_buildSolo se permiten cambios de sufijo mientras MAJOR.MINOR.PATCH se mantiene idéntico, como 1.0.0-beta.1 -> 1.0.0-beta.2 o 1.0.0+build.1 -> 1.0.0+build.2.

Subir un conjunto de archivos compatible con la política actual, o

• cambiar la política de canal en dashboard/__CAPGO_KEEP_0__.
• change channel policy in dashboard/CLI.

Canales: Deshabilitar estrategias de actualización automática

• Sección titulada “desactivar_actualización_a_metadata”

disable_auto_update_to_metadata

El canal utiliza un objetivo de targeting basado en metadatos (

El canal utiliza un objetivo de targeting basado en metadatos (version_number) y la línea base del dispositivo está por debajo de lo requerido min_update_version.

Solucionar

• Ajustar la línea base del dispositivo (CapacitorUpdater.version) con la versión de la aplicación nativa instalada, o
• ajustar min_update_version / estrategia de canal.

Documentación relacionada:

• Canales: Deshabilitar estrategias de actualización automática

disable_auto_update_under_native

Causa

El canal impide las descargas hacia abajo por debajo de la línea base nativa.

Solucionar

• Subir una versión de paquete mayor o igual a la base nativa, o
• desactivar la protección de descenso “bajo nativo” para ese canal.

Documentos relacionados:

• Versionado de Objetivos: Prevención de Descenso Automático

cannot_update_via_private_channel

Causa

El canal seleccionado/por defecto no permite la asignación de dispositivo por parte del dispositivo.

Solución

• Usar un canal diferente con la asignación de dispositivo habilitada, o
• hacer el canal público / habilitar la asignación de dispositivo.

Documentos relacionados:

• Canales: Usando setChannel() desde tu aplicación

unknown_version_build / semver_error

Causa

La versión base del dispositivo está faltando (unknown) o no es una versión válida de semver.

Solución

• Establecer plugins.CapacitorUpdater.version a una versión válida de semver como 1.2.3.
• Sincronice y reconstruye la aplicación nativa.

Documentación relacionada:

• Canales: Versión de paquete y canales
• Solución de problemas: Actualizaciones no se aplican

unsupported_plugin_version

Causa

La versión del plugin de actualizador es demasiado antigua para las requisitos actuales del backend.

Solución

• Actualizar @capgo/capacitor-updater.
• Ejecutar npx cap sync.
• Reconstruir e instalar la aplicación nativa nuevamente.

disabled_platform_ios / disabled_platform_android

Causa

El canal tiene actualizaciones desactivadas para esa plataforma.

Reparar

• Habilitar la opción de plataforma en el canal.

disable_prod_build / disable_dev_build / disable_device / disable_emulator

Causa

El canal no permite el tipo de compilación actual o el objetivo de tiempo de ejecución.

Reparar

• Alinear las opciones del canal (allow_prod, allow_dev, allow_device, allow_emulator) con tu objetivo de prueba.

key_id_mismatch

Causa

La clave de cifrado del paquete y la clave del dispositivo difieren.

Reparar

• Utilice la misma clave de cifrado/clave pública en el flujo de trabajo de configuración de la aplicación y cifrado de paquete.

no_channel / null_channel_data

Causa

No se resolvió un canal válido para el dispositivo.

Solución

• Establezca un canal de nube predeterminado, o
• establezca defaultChannel en compilaciones de prueba, o
• asigne un override de canal para el dispositivo.

Documentación relacionada:

• Canales

on_premise_app

Causa

El backend devolvió HTTP 429 con on_premise_app Esto ocurre en tres situaciones:

1. El ID de la aplicación no existe en Capgo — la app_id enviado por el dispositivo no está registrado, por lo que el backend no tiene registro de él.
2. La aplicación está marcada como de uso en local — la aplicación existe pero está configurada para actualizaciones autoadministradas, por lo que el Capgo punto de conexión de la nube se niega a servirla.
3. El plan de la organización ha sido cancelado — la aplicación de la organización ya no tiene una suscripción activa.

Error común

Un error de ortografía en plugins.CapacitorUpdater.appId (en, ) o una incompatibilidad con el ID de la aplicación registrada en la consola de __CAPGO_KEEP_0__. El backend no puede distinguir entre ‘aplicación desconocida’ y ‘aplicación en el lugar’, por lo que devuelve el mismo error __CAPGO_KEEP_1__. capacitor.config.ts) or a mismatch with the app ID registered in the Capgo dashboard. The backend cannot distinguish “unknown app” from “on-premise app”, so it returns the same error code.

Verificar el

• debe coincidir exactamente con lo que se muestra en la consola de __CAPGO_KEEP_0__ (sensible a mayúsculas y minúsculas). app_id matches exactly what is shown in the Capgo dashboard (case-sensitive).
• Si la aplicación está configurada para estar en el lugar, establece npx @capgo/cli@latest app add.
• en su punto de actualización hospedado en lugar de la URL de nube de __CAPGO_KEEP_0__. plugins.CapacitorUpdater.updateUrl to your self-hosted update endpoint instead of the Capgo cloud URL.
• Lista de verificación rápida de diagnóstico

Sección titulada ‘Lista de verificación rápida de diagnóstico’

1. Fix
2. Confirmar CapacitorUpdater.version coincide con la versión nativa de la aplicación instalada.
3. Confirmar la política del canal (disable_auto_update) coincide con la versión de lanzamiento prevista.
4. Confirmar que los ajustes de plataforma/compilación permiten este dispositivo.
5. Ejecutar npx @capgo/cli@latest app debug y leer errores de backend code.

¿Necesita más ayuda?

• Solución de problemas
• Cómo obtener soporte

Siga adelante desde Problemas de actualización comunes

Si estás utilizando Problemas de Actualización Común para planificar el trabajo de plugin nativo, conecta con Usando @capgo/capacitor-actualizador para la capacidad nativa en Usando @capgo/capacitor-actualizador, Capgo Carpeta de Plugin para el flujo de trabajo del producto en Capgo Carpeta de Plugin, Capacitor Plugins por Capgo para el detalle de implementación en Capacitor Plugins por Capgo, Agregar o Actualizar Plugins para el detalle de implementación en Agregar o Actualizar Plugins, y Alternativas de Plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas de Plugins de Ionic Enterprise.