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 el panel de control, utilice el filtro de acción para filtrar por la acción en snake_case code listada 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, la línea y columna, el estado del proceso, la presión de memoria o la razón específica del sistema operativo. Los registros más antiguos pueden mostrar aún las alias de camelCase legado listadas en paréntesis.

Enviado desde el backend

code	Descripción
dirección IP inválida (__CAPGO_KEEP_0__)	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_de_plan (necesitaPlanUpgrade, previamente 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 (noNew)	El dispositivo tiene la última versión disponible.
error_de_version_semantica	La versión nativa no sigue el formato de versión semántica esperado.
plataforma_iOS_desactivada (disablePlatformIos)	El dispositivo se encuentra en la plataforma iOS, pero está desactivado en los ajustes de canal.
plataforma_android_desactivada (disablePlatformAndroid)	El dispositivo se encuentra en la plataforma Android, pero está desactivado en los ajustes de canal.
actualización_automatica_desactivada (disableAutoUpdate)	La actualización automática está desactivada por política de compatibilidad. Los metadatos incluyen auto_update con una regla de coincidencia como major, minor, patch, metadata, o none.
actualización_automatica_desactivada_bajo_nativo (__CAPGO_KEEP_0__)	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á deshabilitado en los ajustes del canal.
__CAPGO_KEEP_0__ (__CAPGO_KEEP_0__)	El dispositivo tiene una compilación de desarrollo, pero eso está deshabilitado en los ajustes del canal.
__CAPGO_KEEP_0__ (__CAPGO_KEEP_0__)	El dispositivo es un emulador, pero eso está deshabilitado en los ajustes del canal.
__CAPGO_KEEP_0__ (No se puede obtener el paquete)	Falló la generación de una URL firmada válida para la descarga del paquete. Esto ocurre cuando la generación de la URL del paquete falla o devuelve una URL inválida y no hay un manifiesto disponible como fallback.
no se puede actualizar a través de un canal privado (noPuedoActualizarPorCanalPrivado)	El dispositivo intentó asociarse automáticamente con un canal privado, pero los ajustes del canal no permiten la asociación automática de dispositivos (allow_device_self_set canal de configuración
El canal está configurado para deshabilitar la actualización automática por número de versión ( (), pero el campo de la)	no se puede actualizar a través de la información de metadatosdisable_auto_update: 'version_number'noPuedoActualizarPorMetadatos min_update_version El canal está configurado para deshabilitar la actualización automática por número de versión (
), pero el campo de la (no se puede actualizar a través de la información de metadatos)	La actualización automática está deshabilitada por el número de versión del metadato. El canal requiere que la versión del dispositivo sea al menos min_update_versionpero la versión actual del dispositivo es menor a este umbral.
desactivar_actualizaciones_mayor (desactivarActualizacionesMayor)	Configuración de canal disable_auto_update: 'major' evita actualizaciones que aumentarían el número de versión mayor, como bloquear 1.x.x actualizaciones a 2.x.x.
desactivar_actualizaciones_menor (desactivarActualizacionesMenor)	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 actualizaciones a 1.3.x.
desactivar_actualizaciones_auto_automatizadas_a_parche (desactivarActualizacionesAutoAutomatizadasAParche)	Configuración de canal disable_auto_update: 'patch' evita actualizaciones que aumentarían el número de versión de parche, o permite solo actualizaciones de nivel de parche dentro de la misma versión mayor.minor.
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_hay_canal (NoHayCanalOOverride)	No se ha configurado un canal por defecto para esta aplicación y el dispositivo no tiene un canal específico asignado. Al menos uno debe estar presente para que las actualizaciones funcionen.
limitado por tasa (rateLimited)	El dispositivo ha sido limitado por tasa debido a solicitudes excesivas.
clave_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.

Enviado desde el dispositivo

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 no se configuró correctamente.
reset	El dispositivo se ha reiniciado a la configuración predeterminada. builtin paquete.
descargar_XX	Se ha descargado un nuevo paquete - el progreso se indica con XX% (incrementos de 10%).
descargar_completo	Se ha terminado de descargar el nuevo paquete.
descargar_manifesto_inicio	El dispositivo comenzó a descargar el manifiesto de actualización.
descargar_manifesto_completo	El dispositivo terminó de descargar el manifiesto de actualización.
descargar_zip_inicio	El dispositivo comenzó a descargar el archivo del paquete.
descargar_zip_completo	El dispositivo ha terminado de descargar el archivo de la cesta.
__CAPGO_KEEP_0__	Una entrada del manifiesto falló al descargar; el payload de estadísticas indica version_name en la forma version:fileName para identificar el activo.
__CAPGO_KEEP_0__	El archivo del manifiesto falló la validación de checksum.
El archivo del manifiesto falló al descomprimir utilizando Brotli.	El nuevo paquete falló al descargar.
La actualización falló.	La actualización falló.
El nuevo paquete falló al descargar.	El nuevo paquete se ha instalado pero ha fallado en llamar notifyAppReady.
checksum_fail	El nuevo paquete ha fallado en validar el checksum. Esto puede ocurrir por varias razones: 1) Falta de coincidencia en el tipo de checksum: La última versión de la 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 la 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 desifrado fallará silenciosamente y causará un error de checksum. Si está utilizando cifrado y ve checksum_fail, compruebe que la clave pública en su aplicación capacitor.config.json coincide 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á un error adecuado desde el servidor en lugar de esto, lo que facilitará la detección de este problema. keyMismatch windows_path_fail
El zip tiene archivos que contienen rutas de Windows que son ilegales	checksum_fail
canonical_path_fail	El camino de los archivos no es canónico
directory_path_fail	Hay un error en el camino de los archivos zip
unzip_fail	La descomprimición falló
low_mem_fail	La descarga falló debido a la 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 capa JavaScript o Capacitor.
app_crash_native	La capa nativa informó un error de plataforma de crash.
app_anr	Android informó un evento de no respuesta de la aplicación.
app_killed_low_memory	El proceso de la aplicación fue eliminado después de presión de memoria baja.
app_killed_excessive_resource_usage	El sistema operativo eliminó la aplicación por uso excesivo de recursos.
app_initialization_failure	El flujo de actualización o inicio de la aplicación falló antes de que el tiempo de ejecución normal estuviera disponible.
app_memory_warning	iOS emitió una advertencia de memoria. El metadato puede incluir el paquete activo y el contexto de memoria cuando esté disponible.
webview_javascript_error	El WebView informó un error de JavaScript no capturado. El metadato puede incluir el mensaje, la URL de origen, la línea, la columna y la pila.
webview_unhandled_rejection	El WebView informó una rechazación de promesa no manejada. El metadato puede incluir la razón de rechazo, la URL de origen y la pila.
webview_resource_error	Un recurso de WebView falló para cargar. El metadato puede incluir la URL, el estado code, el tipo de recurso y el mensaje de error.
webview_security_policy_violation	El WebView informó una violación de la política de seguridad de contenido. El metadato puede incluir la URI bloqueada, la directiva y la URL del documento.
webview_unclean_restart	La aplicación detectó una sesión de WebView previa que no se cerró limpiamente. Esto puede ayudar a identificar los bucles de crash después de una actualización.
Proceso de renderizado de WebView eliminado	Android informó que el proceso de renderizado de WebView se ha salido. Los metadatos pueden incluir si el renderizador se ha estrellado y la prioridad del renderizador.
Proceso de contenido de WebView terminado	iOS informó que el proceso de contenido de WebView se ha terminado. Los metadatos pueden incluir el paquete activo y la URL de la página cuando esté disponible.
Fallo al descifrar el paquete descargado	getChannel
Se consultó el canal actual para el dispositivo. (setChannel)	Se estableció con éxito un canal para el dispositivo.
Se estableció con éxito un canal para el dispositivo. (Se consultó el canal actual para el dispositivo.)	getChannel
desinstalar	La aplicación se desinstaló o se eliminó los datos Capgo.
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: paquete instalado con éxito
• ERROR: falló la instalación o descarga
• PENDING: descarga finalizada, pendiente de liberación
• DELETED: paquete eliminado, pero sigue presentado para estadísticas
• DOWNLOADING: actualmente se está descargando un paquete

Entendiendo los registros del dispositivo:

Comando de depuración:

Hay un comando de depuración para los usuarios de Capgo de la nube.

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

para encontrar sus registros en Xcode

Obtener el registro del dispositivo en Xcode

Android:

para encontrar tus registros en Android Studio

Ver registros con Logcat

Explicaciones de Registros

• Failed to download from => lo mismo que __CAPGO_KEEP_0__
• notifyAppReady was not called, roll back current bundle => lo mismo que __CAPGO_KEEP_1__

Buscar el paquete descargado en tu dispositivo

iOS

Para depurar en iOS, necesitas descargar la aplicación en tu computadora, puedes hacerlo de la siguiente manera:

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

Para lograr esto:

• Conecta tu dispositivo a tu Mac y selecciona Ventana > Dispositivos en el menú de Xcode.
• Selecciona tu dispositivo en el panel izquierdo en la sección Dispositivos.
• Esto mostrará una lista de aplicaciones instaladas por desarrolladores para ese dispositivo.
• Selecciona la aplicación que deseas inspeccionar y luego selecciona el icono de tres puntos cerca de la parte inferior de la pantalla.
• Aquí puedes 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 puedes explorar.

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

Abra la carpeta de datos de la aplicación, y debería ver ahora unos pocos carpetas como Documentos, Biblioteca, tmp, etc.

Luego encontrará una versión en 2 carpetas:

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

y documents/versions para el recarga caliente

Android

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

• Haga clic en Ver > Ventanas de Herramientas > Explorador de Archivos del Dispositivo o haga clic en el botón Explorador de Archivos del Dispositivo en la barra de ventanas de herramientas para abrir el Explorador de Archivos del Dispositivo.
• Seleccione un dispositivo desde la lista desplegable.
• Abrir el camino data/data/__CAPGO_KEEP_0__/ donde __CAPGO_KEEP_0__ es su ID de aplicación.

Luego Encuentre 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