Depuración

Entendiendo los registros de la nube:

Si obtiene una negación de la nube code y necesita pasos de remediación concretos, consulte Problemas de actualización comunes.

Capgo los registros pueden incluir metadatos para el evento. En la consola, utilice el filtro de acción para filtrar por la acción en snake_case code lista a continuación, y haga clic en la celda de metadatos para copiar el payload JSON completo. Los metadatos son especialmente útiles para eventos de crash y WebView porque pueden incluir contexto como el mensaje de error, la URL de origen, línea y columna, estado del proceso, presión de memoria o razón específica de la plataforma. Los registros antiguos pueden mostrar aún las alias de camelCase legado listados en paréntesis.

Enviado desde el backend

code	Descripción
dirección_ip_inválida (DirecciónIpInvalida)	El usuario se encuentra en un centro de datos de Google y la actualización es menor a 4 horas. Esto se hace para evitar que los dispositivos de los bots de Google se cuenten como dispositivos en su cuenta.
necesita_upgrade_plan (necesitaPlanUpgradeque tenía necesita_upgrade)	Indica que ha alcanzado el límite de su plan y el dispositivo no recibirá actualizaciones hasta que suba de plan o hasta el próximo mes.
no_hay_nueva_version_disponible (noHayNueva)	El dispositivo tiene la versión más reciente disponible.
__CAPGO_KEEP_0__	La versión nativa no sigue el formato de versión semántica esperado.
__CAPGO_KEEP_0__ (La plataforma nativa de iOS no está habilitada en los ajustes de canal.)	__CAPGO_KEEP_0__
La plataforma nativa de Android no está habilitada en los ajustes de canal. (__CAPGO_KEEP_0__)	La actualización automática está deshabilitada por política de compatibilidad. Los metadatos incluyen
__CAPGO_KEEP_0__ (__CAPGO_KEEP_0__)	__CAPGO_KEEP_0__ auto_update con una regla de coincidencia como major, minor, patch, metadata, o none.
desactivar_actualizaciones_auto_bajo_nativo (desactivarActualizacionesAutoBajoNativo)	El dispositivo tiene la versión (1.2.3), y el canal tiene una actualización (1.2.2) bajo la versión del dispositivo para enviar, pero eso está desactivado en los ajustes del canal.
desactivar_edicion_de_desarrollo (desactivarEdicionDeDesarrollo)	El dispositivo tiene una edición de desarrollo, pero eso está desactivado en los ajustes del canal.
desactivar_emulador (desactivarEmulador)	El dispositivo es un emulador, pero esa opción está deshabilitada en los ajustes del canal.
__CAPGO_KEEP_0__ (__CAPGO_KEEP_0__)	Falló la generación de una URL firmada válida para descargar el paquete. Esto ocurre cuando la generación de URL del paquete falla o devuelve una URL inválida y no hay un manifiesto disponible como fallback.
__CAPGO_KEEP_0__ (__CAPGO_KEEP_0__)	El dispositivo intentó asociarse automáticamente con un canal privado, pero los ajustes del canal no permiten la autoasociación de dispositivos (allow_device_self_set __CAPGO_KEEP_0__
El canal está configurado para deshabilitar la actualización automática por número de versión ( (__CAPGO_KEEP_0__)	__CAPGO_KEEP_0__disable_auto_update: 'version_number'__CAPGO_KEEP_0__ min_update_version El campo es nulo, lo que hace imposible determinar qué dispositivos deben recibir la actualización.
desactivar_actualización_a_metadata (desactivarActualizacionAMetadata)	La actualización automática está desactivada por el número de versión de los metadatos. El canal requiere que la versión del dispositivo sea al menos min_update_version, pero la versión actual del dispositivo es menor que este umbral.
desactivar_actualización_a_mayor (desactivarActualizacionAMayor)	Configuración de canal disable_auto_update: 'major' evita actualizaciones que aumenten el número de versión mayor, como bloquear 1.x.x actualizar a 2.x.x.
desactivar_actualización_a_menor (desactivarActualizacionAMenor)	Configuración de canal disable_auto_update: 'minor' evita actualizaciones que aumentarían el número de versión menor, como bloquear 1.2.x actualizarse a 1.3.x.
__CAPGO_KEEP_0__ (__CAPGO_KEEP_0__)	Configuración de canal disable_auto_update: 'patch' evita actualizaciones que aumentarían el número de versión parche, o permite solo actualizaciones de nivel parche dentro de la misma versión mayor.menor.
paquete_faltante (paqueteFaltante)	El paquete asignado a este canal no tiene contenido descargable. Esto significa que el paquete no tiene external_urlno r2_pathno es una versión integrada, y no hay entradas de manifiesto disponibles para su descarga.
no_channel (NoChannelOrOverride)	No se ha configurado un canal por defecto para esta aplicación y el dispositivo no tiene un canal específico asignado. Debe haber al menos uno presente para que las actualizaciones funcionen.
rate_limited (rateLimited)	El dispositivo ha sido limitado por tasa debido a solicitudes excesivas.
key_id_mismatch (keyMismatch)	La clave pública de cifrado del dispositivo no coincide con la clave pública utilizada para cifrar el paquete. Los metadatos incluyen device_key_id, bundle_key_id, y version para ayudar a identificar la incompatibilidad.

Sent from the device

code	Descripción
ping	Acción de prueba interna utilizada para verificar que el sistema de estadísticas está funcionando correctamente.
get	Se ha enviado información para descargar la nueva versión al dispositivo.
delete	Se ha eliminado un paquete en el dispositivo.
set	Se ha configurado un paquete en el dispositivo.
set_fail	El paquete falló en configurarse.
reset	El dispositivo se ha reiniciado a la builtin paquete.
download_XX	Se ha descargado un nuevo paquete - el progreso indicado por XX% (incrementos de 10%).
download_complete	La descarga del nuevo paquete ha terminado.
download_manifest_start	El dispositivo comenzó a descargar el manifiesto de actualización.
download_manifest_complete	El dispositivo ha terminado de descargar el manifiesto de actualización.
__CAPGO_KEEP_0__	El dispositivo comenzó a descargar el archivo de la caja.
El dispositivo terminó de descargar el archivo de la caja.	Falló la descarga de una entrada del manifiesto; el payload de estadísticas se encuentra
en la forma	para identificar el activo. version_name Falló la validación del checksum del manifiesto. version:fileName Falló la descomposición del manifiesto utilizando Brotli.
__CAPGO_KEEP_0__	__CAPGO_KEEP_0__
__CAPGO_KEEP_0__	__CAPGO_KEEP_0__
download_fail	El nuevo paquete falló al descargarse.
update_fail	El nuevo paquete se ha instalado pero ha fallado al llamar notifyAppReady.
checksum_fail	El nuevo paquete falló para validar el checksum. Esto puede ocurrir por varias razones: 1) Falta de coincidencia en el tipo de checksum: La última versión de CLI y plugins (versión 5.10.0+, 6.25.0+ o 7+) utiliza checksums SHA256, mientras que los plugins más antiguos utilizaron CRC32. Si ve un error de checksum, compruebe si el checksum es CRC32 (un hash más corto) en lugar de SHA256. Esto suele indicar que el paquete se subió con una versión antigua de CLI. Verifique la versión de su paquete en la consola de Capgo - los paquetes creados desde la versión 5.10.0/6.25.0/7 deben utilizar SHA256. Si ve checksums CRC32, asegúrese de tener la última versión del plugin instalada localmente (la CLI verifica la versión local del plugin para determinar qué tipo de checksum subir), luego actualice su CLI y vuelva a subir el paquete. 2) Falta de coincidencia en la clave de cifrado (en versiones de plugin inferiores a 8.3.0 o 5/6/7.38.0): En versiones de plugin más antiguas, si la clave pública del dispositivo no coincide con la clave utilizada para cifrar el paquete, la descomposición fallará silenciosamente y causará un error de checksum. Si está utilizando cifrado y ve checksum_failverifique que la clave pública en su capacitor.config.json coincida con la clave privada utilizada para subir el paquete. Actualizando a la versión de plugin 8.3.0+ (o 5/6/7.38.0+) le dará una descomposición correcta keyMismatch error from the server instead, making this issue easier to diagnose.
windows_path_fail	El zip tiene archivos que contienen rutas de Windows que son ilegales
canonical_path_fail	La ruta de los archivos no es canónica
directory_path_fail	Hay un error en la ruta de los archivos del zip
unzip_fail	Falló la descomprimición
low_mem_fail	La descarga falló debido a una falta de memoria en el dispositivo
app_moved_to_background	La aplicación ingresó al estado de fondo.
app_moved_to_foreground	La aplicación ingresó al estado de primer plano.
app_crash	La aplicación informó un error de crash detectado desde el nivel JavaScript o Capacitor. Los metadatos pueden incluir el mensaje, pila, fuente y contexto de paquete activo.
app_crash_native	El nivel nativo informó un error de plataforma. Los metadatos pueden incluir plataforma, razón, pila y detalles del proceso cuando estén disponibles.
app_anr	Android informó un evento de no respuesta de la aplicación. Los metadatos pueden incluir la razón de ANR, hilo o resumen de traza cuando estén disponibles.
app_killed_low_memory	El proceso de la aplicación fue eliminado después de presión de memoria baja. Los metadatos pueden incluir memoria disponible y señales de plataforma cuando estén disponibles.
app_killed_excessive_resource_usage	The sistema operativo mató la aplicación por uso excesivo de recursos. La información de metadatos puede incluir el tipo de recurso o la razón de plataforma cuando esté disponible.
falla_de_inicialización_de_aplicación	El actualizador o flujo de inicio de la aplicación falló antes de que la ejecución normal estuviera lista. La información de metadatos puede incluir el paso fallido y el mensaje de error.
advertencia_de_memoria_de_aplicación	iOS informó una advertencia de memoria. La información de metadatos puede incluir el paquete activo y el contexto de memoria cuando esté disponible.
error_de_javascript_no_capturado_de_WebView	El WebView informó un error de JavaScript no capturado. La información de metadatos puede incluir el mensaje, la URL de origen, la línea, la columna y la pila.
rechazo_de_promesa_no_manejado_de_WebView	El WebView informó un rechazo de promesa no manejado. La información de metadatos puede incluir la razón de rechazo, la URL de origen y la pila.
error_de_recursos_de_WebView	Un recurso de WebView falló para cargar. La información de metadatos puede incluir la URL, el estado code, el tipo de recurso y el mensaje de error.
violación_de_política_de_seguridad_de_WebView	El navegador web informó una violación de la política de seguridad de contenido.
__CAPGO_KEEP_0__	La aplicación detectó una sesión de navegador web previa que no se cerró limpiamente. Esto puede ayudar a identificar los bucles de falla después de una actualización.
El proceso de renderizado del navegador web se ha ido.	Android informó que el proceso de renderizado del navegador web se ha cerrado. Los metadatos pueden incluir si el renderizador se ha caído y la prioridad del renderizador.
El proceso de contenido del navegador web se ha terminado.	iOS informó que el proceso de contenido del navegador web se ha terminado. Los metadatos pueden incluir el paquete activo y la URL de la página cuando esté disponible.
Falló la descifrado del paquete descargado.	Se consultó el canal actual para el dispositivo.
getChannel (webview_unclean_restart)	webview_render_process_gone
set_canal (setChannel)	Se configuró correctamente el canal para el dispositivo.
desinstalar	La aplicación se desinstaló o se eliminó Capgo datos.
bloqueado_por_url_del_servidor	Server.url está presente en su capacitor configuración, lo que hace que Capacitor sirva la URL remota e ignore los archivos locales, mientras que nuestro actualizador está diseñado para funcionar con archivos locales. Server.url se considera una mala práctica en producción por los creadores de Capacitor y puede provocar muchos problemas y plugins que no funcionan correctamente.

Estado del paquete

• SUCCESS: se completó la instalación del paquete
• ERROR: falló la instalación o descarga
• PENDING: se completó la descarga, pendiente de liberación
• DELETED: Paquete eliminado, aún presentado para estadísticas
• DOWNLOADING: Descargando actualmente un paquete

Entendiendo los registros del dispositivo:

Comando de depuración:

Existe un comando de depuración para los usuarios de Cloudflare Capgo.

npx @capgo/cli@latest app debug

Esto le permitirá verificar todos los eventos que están ocurriendo en la aplicación y encontrar una solución si los actualizaciones no ocurren.

IOS

encontrar tus registros en Xcode

Obtener el registro del dispositivo en Xcode

Android:

encontrar tus registros en Android Studio

Ver registros con Logcat

Explicaciones de los registros

• Failed to download from => igual que falla de descarga
• notifyAppReady was not called, roll back current bundle == igual que == falla de actualización

Ubicar el paquete descargado en su dispositivo

iOS

Para depurar en iOS, necesita descargar la aplicación en su computadora, puede hacerlo de la siguiente manera:

Xcode tiene una característica incorporada para inspeccionar el sistema de archivos de las aplicaciones instaladas por desarrolladores en un dispositivo iOS.

Para lograr esto:

• Conecte su dispositivo a su Mac y seleccione Ventana > Dispositivos en el menú de Xcode.
• Seleccione su dispositivo en el panel izquierdo en la sección Dispositivos.
• Esto mostrará una lista de aplicaciones instaladas por desarrolladores para ese dispositivo.
• Seleccione la aplicación que desee inspeccionar y luego seleccione el icono de tres puntos cerca de la parte inferior de la pantalla.
• Aquí puede ver el sistema de archivos actual seleccionando descargar una instantánea de él.

Seleccionar Descargar Contenedor… descargará y exportará una instantánea del sistema de archivos como un archivo .xcappdata que puede explorar.

Haga clic derecho en este archivo y seleccione Mostrar Contenido de Paquete para abrir la carpeta.

Abrir la carpeta de datos de la aplicación, y debería ver ahora unos pocos carpetas como Documents, Library, tmp, etc.

Luego encontrará una versión en 2 carpetas:

library/NoCloud/ionic_built_snapshots es necesario después del reinicio de la aplicación

y documents/versions para el recarga caliente

Android

Para depurar en Android, necesitas acceder al dispositivo desde Android Studio:

• Haz clic en Ver > Ventanas de herramientas > Explorador de archivos de dispositivo o haz clic en el botón Explorador de archivos de dispositivo en la barra de ventanas de herramientas para abrir el Explorador de archivos de dispositivo.
• Selecciona un dispositivo de la lista desplegable.
• Abre la ruta data/data/APP_NOMBRE/ donde APP_NOMBRE es tu ID de aplicación.

Luego encuentra el versions carpeta para ver todas las versiones

¿Sabías que?

En Android, todas las versiones se almacenan en una carpeta, a diferencia de IOS donde tiene que duplicarse en dos ubicaciones.

Entendiendo los registros de errores de producción de ios

Cómo revisar los registros de errores de tu aplicación

Sigue adelante desde Depuración

Si estás utilizando Depuración para planificar el trabajo de plugin nativo, conecta con Usando @capgo/capacitor-actualizador para la capacidad nativa en Usando @capgo/capacitor-actualizador, Directorio de Plugins Capgo para el flujo de trabajo del producto en Directorio de Plugins Capgo, Plugins de Capgo en Capacitor para el detalle de implementación en Plugins de Capgo en Capacitor, 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.