Depuración
Copia un prompt de configuración con los pasos de instalación y la guía completa en markdown para este plugin.
Entender los logs en la nube
Sección titulada “Entender los logs de la nube”Si recibes un rechazo de la nube code y necesitas guías de solución más detalladas, consulta Problemas comunes de actualización.
Los logs de Capgo pueden incluir metadatos del evento. En el dashboard, filtra por la acción en snake_case code y haz clic en la celda de metadatos para copiar el payload JSON completo. Los metadatos son especialmente útiles en eventos de crash y WebView, ya que pueden incluir el mensaje de error, la URL de origen, la línea y la columna, el estado del proceso, la presión de memoria o el motivo específico de la plataforma. Los logs antiguos aún pueden mostrar los alias camelCase heredados que se indican entre paréntesis.
Cada título de sección coincide con la acción code que aparece en la tabla de logs de la consola, para que puedas ir directamente a ella.
Límites del plan y respuestas normales
Sección titulada “Límites del plan y respuestas normales”Rechazos del backend relacionados con facturación, throttling o estados que no son errores.
InvalidIp
Sección titulada “InvalidIp”Qué significa
Capgo detectó tráfico que parece provenir de Google o de infraestructura cloud. Las actualizaciones con menos de cuatro horas de antigüedad se ignoran para que el tráfico de bots no se cuente como dispositivos facturables.
Qué hacer
Ignora esto en usuarios reales. Reintenta desde redes normales y dispositivos reales, o espera y vuelve a comprobarlo más tarde.
provider_infrastructure_request_blocked
Sección titulada “provider_infrastructure_request_blocked”Qué significa
Tu app está configurada para bloquear solicitudes desde rangos de IP de centros de datos conocidos de Google y Apple. La protección se aplica a las comprobaciones de actualización, estadísticas y solicitudes de canal-self, por lo que las sondas alojadas en la nube y los ejecutores del proveedor pueden recibir esta respuesta incluso cuando la configuración de la app es válida.
Qué hacer
Reintenta desde un dispositivo físico en una red de usuario normal. Si el tráfico originado por el proveedor es intencional, desactiva temporalmente Bloquear solicitudes de infraestructura del proveedor en la app Información tab, y luego vuelve a activarlo después de la prueba. Las nuevas apps activan esta configuración por defecto; las existentes mantienen su configuración anterior desactivada hasta que se modifique.
needPlanUpgrade
Sección titulada “needPlanUpgrade”Qué significa
Tu organización alcanzó el límite de su plan o de dispositivos. El dispositivo no recibirá actualizaciones hasta que actualices el plan o el próximo ciclo de facturación restablezca el uso.
Qué hacer
Actualiza tu plan en el dashboard o espera al próximo ciclo de facturación.
Qué significa
El dispositivo ya tiene el último bundle disponible para su canal. Este es un estado normal, no un fallo.
rateLimited
Sección titulada “rateLimited”Qué significa
El dispositivo envió demasiadas solicitudes de actualización o de canal en un intervalo corto.
Qué hacer
Stop calling update APIs inside render loops. Call setChannel / getChannel solo desde acciones del usuario y establece defaultChannel en capacitor.config.
Formato de versión
Sección titulada “Formato de versión”Rechazos del backend causados por metadatos de versión nativa no válidos.
semver_error
Sección titulada “semver_error”Qué significa
La versión de la app nativa en config falta o no es un semver válido (x.y.z).
Qué hacer
Configurar plugins.CapacitorUpdater.version a un semver válido, verifícalo en el Probador de SemVer, luego reconstruye y reinstala la app nativa.
Plataforma y target de build
Sección titulada “Segmentación por plataforma y build”Rechazos del backend cuando la política del canal bloquea una plataforma, tipo de build o clase de dispositivo.
disablePlatformIos
Sección titulada “disablePlatformIos”Qué significa
El dispositivo ejecuta iOS, pero las actualizaciones de iOS están desactivadas para este canal.
Qué hacer
Activa iOS en el canal si fue un error, o redirige los builds de iOS a un canal dedicado si el bloqueo es intencional.
disablePlatformAndroid
Sección titulada “disablePlatformAndroid”Qué significa
El dispositivo ejecuta Android, pero las actualizaciones de Android están desactivadas para este canal.
Qué hacer
Habilita Android en el canal si fue un error, o redirige los builds de Android a un canal dedicado si el bloqueo es intencional.
disablePlatformElectron
Sección titulada “disablePlatformElectron”Qué significa
El dispositivo ejecuta Electron, pero las actualizaciones de Electron están desactivadas para este canal.
Qué hacer
Habilita Electron en el canal si fue un error, o redirige los builds de Electron a un canal dedicado si el bloqueo es intencional.
disableDevBuild
Sección titulada “disableDevBuild”Qué significa
El dispositivo es un dev build, pero los dev builds están bloqueados para este canal.
Qué hacer
Permite dev builds en un canal de test, o mantén este canal solo para release y mueve los dispositivos de desarrollo a otro canal.
disableProdBuild
Sección titulada “disableProdBuild”Qué significa
Una build de producción llamada /updates, pero las actualizaciones de producción están bloqueadas para este canal.
Qué hacer
Permite actualizaciones de producción en el canal si fue un error, o dirige las builds de producción al canal correcto.
disableDevice
Sección titulada “disableDevice”Qué significa
Un teléfono o tableta real fue bloqueado porque este canal bloquea dispositivos reales.
Qué hacer
Activa las actualizaciones en dispositivos reales si fue un error, o mantén la restricción y dirige los dispositivos reales a otro canal.
disableEmulator
Sección titulada “disableEmulator”Qué significa
El dispositivo es un emulador, pero las actualizaciones en emuladores están desactivadas en este canal.
Qué hacer
Habilita las actualizaciones en el emulador en un canal de prueba, o mantén este canal bloqueado para emuladores y usa otro para validarlo.
Reglas de compatibilidad de auto-update
Sección titulada “Reglas de compatibilidad de auto-update”Rechazos del backend cuando las reglas de semver o metadatos bloquean el bundle de destino.
disableAutoUpdate
Sección titulada “disableAutoUpdate”Qué significa
El auto-update está desactivado por la política de compatibilidad del canal. Los metadatos incluyen auto_update con una regla coincidente como major, minor, patch, metadata, o none.
Qué hacer
Cambia la política de auto-update del canal para permitir el rollout previsto.
disableAutoUpdateUnderNative
Sección titulada “disableAutoUpdateUnderNative”Qué significa
El canal tiene un bundle más antiguo que la versión base del dispositivo y bloquea el envío de actualizaciones para versiones nativas inferiores.
Qué hacer
Publica un bundle igual o superior al baseline nativo, o desactiva la protección under-native en el canal.
disableAutoUpdateMetadata
Sección titulada “disableAutoUpdateMetadata”Qué significa
El canal requiere min_update_version, pero la versión nativa del dispositivo está por debajo de ese umbral.
Qué hacer
Configurar min_update_version en el bundle o release de destino de una versión nativa más reciente.
disableAutoUpdateToMajor
Sección titulada “disableAutoUpdateToMajor”Qué significa
El canal bloquea los saltos de versión mayor, por ejemplo 1.x.x a 2.x.x.
Qué hacer
Alinea la estrategia de canal con tu plan de despliegue mayor, o permite saltos mayores para esta pista. Ver Problemas comunes de actualización.
disableAutoUpdateToMinor
Sección titulada “disableAutoUpdateToMinor”Qué significa
El canal bloquea saltos de versión menor respecto a la línea base nativa del dispositivo (version_build), por ejemplo 1.2.3 a 1.3.0.
Qué hacer
Alinea la estrategia del canal con tu plan de despliegue de versiones menores o permite saltos menores en esta pista.
disableAutoUpdateToPatch
Sección titulada “disableAutoUpdateToPatch”Qué significa
El canal bloquea los cambios a nivel de parche manteniendo el mismo MAJOR.MINOR.PATCH prefijo; solo se permiten cambios en el sufijo.
Qué hacer
Alinea la cadencia de releases con la política del canal o permite saltos de parches en esta track.
Configuración del canal
Sección titulada “Channel setup”Rechazos del backend causados por una configuración de canal ausente o incompatible.
cannotUpdateViaPrivateChannel
Sección titulada “cannotUpdateViaPrivateChannel”Qué significa
El dispositivo intentó autoasociarse con un canal privado que no permite la autoasignación de dispositivos (allow_device_self_set es false) y el canal no es público.
Qué hacer
Activar allow_device_self_set en el canal o cambia el dispositivo a un canal público o permitido.
channelMisconfigured
Sección titulada “channelMisconfigured”Qué significa
El canal usa disable_auto_update: "version_number" pero el bundle min_update_version es null, por lo que Capgo no puede decidir qué dispositivos deben actualizarse.
Qué hacer
Completa la configuración de esa regla o cambia a un modo de auto-update más simple.
NoChannelOrOverride
Sección titulada “NoChannelOrOverride”Qué significa
No hay un canal predeterminado configurado y el dispositivo no tiene un override de canal.
Qué hacer
Configura un canal predeterminado en el dashboard o configura defaultChannel en el build.
Entrega y cifrado del bundle
Sección titulada “Entrega y cifrado del bundle”Rechazos del backend cuando Capgo no puede servir o descifrar el bundle.
cannotGetBundle
Sección titulada “cannotGetBundle”Qué significa
Capgo no pudo generar una URL de descarga firmada válida y no había un manifest de respaldo disponible.
Qué hacer
Vuelve a subir el bundle, regenera los manifests y verifica la configuración de R2 o del bundle público.
missingBundle
Sección titulada “missingBundle”Qué significa
El bundle asignado al canal no tiene contenido descargable: no external_url, no r2_path, no es una versión integrada y no hay entradas en el manifest.
Qué hacer
Vuelve a generar y subir la versión, luego confirma que el bundle tenga contenido real.
keyMismatch
Sección titulada “keyMismatch”Qué significa
La clave pública de cifrado del dispositivo no coincide con la clave usada para cifrar el bundle. Los metadatos pueden incluir device_key_id, bundle_key_id, y version.
Qué hacer
Compara los IDs de la clave del dispositivo y del bundle en la consola. Publica con la misma clave y versiones de CLI/plugin coincidentes.
Configuración de la app y clientes legacy
Sección titulada “Configuración de la app y clientes legacy”Rechazos del backend causados por la configuración de la app o versiones de updater no compatibles.
customIdBlocked
Sección titulada “customIdBlocked”Qué significa
La app envió un ID de dispositivo personalizado, pero esta app no acepta IDs personalizados, por lo que el ID se ignora.
Qué hacer
Deja de enviar IDs personalizados o actívalos solo cuando tu flujo de trabajo lo requiera.
blocked_by_server_url
Sección titulada “blocked_by_server_url”Qué significa
server.url se configura en la configuración de Capacitor, por lo que el WebView carga una URL remota en lugar de archivos de bundle locales. Las actualizaciones en vivo de Capgo requieren archivos locales y server.url no se recomienda en producción.
Qué hacer
Elimina o limpia server.url para builds de producción y mantener los payloads de actualización locales. Este code puede aparecer como una negativa del backend o como un stat a nivel de dispositivo.
backend_refusal
Sección titulada “backend_refusal”Qué significa
El plugin updater está en v4, una versión que el backend ya no acepta.
Qué hacer
Actualiza el plugin y CLI a v5+ (mejor v8) con Capacitor v5+, recompila y vuelve a publicar los metadatos del bundle.
Ciclo de vida de la actualización
Sección titulada “Ciclo de vida de actualización”Eventos en el dispositivo para el flujo de actualización normal, activación y rollback.
Qué significa
Acción de prueba interna usada para verificar el pipeline de estadísticas.
Qué significa
Capgo envió información de descarga para una nueva versión al dispositivo.
Qué significa
Se activó un bundle en el dispositivo.
set_fail
Sección titulada “set_fail”Qué significa
No se pudo activar un bundle en el dispositivo.
Qué hacer
Revisa los logs nativos con npx @capgo/cli@latest app debug y verifica la integridad del bundle, las rutas y notifyAppReady flujo.
Qué significa
El dispositivo volvió al bundle integrado.
Qué significa
Se eliminó un bundle en el dispositivo.
Fallos de descarga e instalación
Sección titulada “Fallas de descarga e instalación”Eventos del dispositivo para el progreso de la descarga, la validación del archivo y los errores de instalación.
download_0
Sección titulada “download_0”Qué significa
La secuencia de descarga comenzó con un progreso del 0%.
download_10
Sección titulada “download_10”Qué significa
Se ha descargado un nuevo bundle: el progreso se indica al 10%.
download_20
Sección titulada “download_20”Qué significa
Se ha descargado un nuevo bundle — progreso indicado al 20%.
download_30
Sección titulada “download_30”Qué significa
Se ha descargado un nuevo bundle — progreso indicado al 30%.
download_40
Sección titulada “download_40”Qué significa
Se ha descargado un nuevo bundle — progreso indicado al 40%.
download_50
Sección titulada “download_50”Qué significa
Se ha descargado un nuevo bundle — progreso indicado al 50%.
download_60
Sección titulada “download_60”Qué significa
Se ha descargado un nuevo bundle — progreso indicado al 60%.
download_70
Sección titulada “download_70”Qué significa
Se ha descargado un nuevo bundle — progreso indicado al 70%.
download_80
Sección titulada “download_80”Qué significa
Se ha descargado un nuevo bundle — progreso indicado al 80%.
download_90
Sección titulada “download_90”Qué significa
Se ha descargado un nuevo bundle — progreso indicado al 90%.
download_complete
Sección titulada “download_complete”Qué significa
La descarga del bundle finalizó con éxito.
download_manifest_start
Sección titulada “download_manifest_start”Qué significa
El dispositivo comenzó a descargar el manifiesto de la actualización.
download_manifest_complete
Sección titulada “download_manifest_complete”Qué significa
El dispositivo terminó de descargar el manifiesto de la actualización.
download_zip_start
Sección titulada “download_zip_start”Qué significa
El dispositivo comenzó a descargar el archivo del bundle.
download_zip_complete
Sección titulada “download_zip_complete”Qué significa
El dispositivo terminó de descargar el archivo del bundle.
download_manifest_file_fail
Sección titulada “download_manifest_file_fail”Qué significa
Falló la descarga de una entrada del manifest. version_name usa version:fileName para identificar el asset.
Qué hacer
Corrige el asset faltante o bloqueado, regenera el manifest y vuelve a subir el bundle.
download_manifest_checksum_fail
Sección titulada “download_manifest_checksum_fail”Qué significa
Un archivo manifest no superó la validación de checksum.
Qué hacer
Vuelve a subir el bundle con una versión actual de CLI y verifica los checksums del manifest.
download_manifest_brotli_fail
Sección titulada “download_manifest_brotli_fail”Qué significa
No se pudo descomprimir un archivo manifest con Brotli.
Qué hacer
Verifica la configuración de compresión y vuelve a subir los assets afectados.
download_fail
Sección titulada “download_fail”Qué significa
Error al descargar el bundle.
Qué hacer
Revisa la conexión de red, la expiración de la URL firmada, el acceso al CDN y el almacenamiento del dispositivo.
update_fail
Sección titulada “update_fail”Qué significa
El bundle se instaló pero la app nunca llamó notifyAppReady, así que Capgo hizo un rollback.
Qué hacer
Llama a notifyAppReady() después de que tu app termine el bootstrapping. Texto del log nativo notifyAppReady was not called, roll back current bundle corresponde a este code.
checksum_fail
Sección titulada “checksum_fail”Qué significa
El bundle descargado no superó la validación del checksum. Causas habituales: un desajuste de CRC32 vs SHA256 por un upload antiguo con CLI, o un desajuste de la clave de cifrado en plugins antiguos que muestran el fallo de descifrado como un fallo de checksum.
Qué hacer
Vuelve a subir con un CLI/plugin actual (SHA256). Si usas cifrado, verifica que la clave pública de la app coincida con la clave de subida, o actualiza al plugin 8.3.0+ para keyMismatch errors.
decrypt_fail
Sección titulada “decrypt_fail”Qué significa
El bundle descargado no se pudo descifrar.
Qué hacer
Verifica las claves de cifrado y vuelve a subir el bundle con el par de claves correspondiente.
windows_path_fail
Sección titulada “windows_path_fail”Qué significa
El zip contiene rutas de estilo Windows no válidas.
Qué hacer
Reconstruye el bundle con rutas Unix o sanea las rutas del archivo antes de subirlo.
canonical_path_fail
Sección titulada “canonical_path_fail”Qué significa
Las rutas de archivo dentro del zip no son canónicas.
Qué hacer
Fix archive path generation before upload.
directory_path_fail
Sección titulada “directory_path_fail”Qué significa
El zip contiene rutas de directorio no válidas.
Qué hacer
Corrige la estructura del archivo antes de subirlo.
unzip_fail
Sección titulada “unzip_fail”Qué significa
El dispositivo no pudo descomprimir el bundle descargado.
Qué hacer
Verifica la integridad del archivo y la compresión compatible.
low_mem_fail
Sección titulada “low_mem_fail”Qué significa
La descarga falló porque el dispositivo se quedó sin memoria.
Qué hacer
Reduce el tamaño del bundle o reintenta en un dispositivo con más memoria libre.
Salud de la app y eventos de WebView
Sección titulada “Salud de la app y eventos de WebView”Diagnósticos de crashes, memoria y WebView en el dispositivo. Revisa siempre el JSON de metadatos en el dashboard.
app_moved_to_background
Sección titulada “app_moved_to_background”Qué significa
La app pasó a segundo plano.
app_moved_to_foreground
Sección titulada “app_moved_to_foreground”Qué significa
La app pasó a primer plano.
app_crash
Sección titulada “app_crash”Qué significa
Crash en JavaScript o en la capa Capacitor. Los metadatos pueden incluir mensaje, stack, source y contexto del bundle activo.
Qué hacer
Inspecciona los metadatos y los logs nativos. Combina el reporte de errores de JS y nativo (por ejemplo, Sentry) para localizar la ruta code que falla.
app_crash_native
Sección titulada “app_crash_native”Qué significa
Crash en la plataforma nativa. Los metadatos pueden incluir plataforma, motivo, stack y detalles del proceso.
Qué hacer
Usa los crash logs de Xcode o Logcat y correlaciónalos con el bundle activo de los metadatos.
app_anr
Sección titulada “app_anr”Qué significa
Evento de Android Application Not Responding.
Qué hacer
Inspecciona trazas de ANR en Logcat y reduce el bloqueo del hilo principal tras las actualizaciones.
app_killed_low_memory
Sección titulada “app_killed_low_memory”Qué significa
El SO cerró la app debido a la presión de memoria.
Qué hacer
Reduce el uso de memoria tras activar la actualización e inspecciona los metadatos para ver indicadores de memoria disponible.
app_killed_excessive_resource_usage
Sección titulada “app_killed_excessive_resource_usage”Qué significa
El SO cerró la app por uso excesivo de recursos.
Qué hacer
Inspecciona los metadatos para ver el tipo de recurso o el motivo de la plataforma.
app_initialization_failure
Sección titulada “app_initialization_failure”Qué significa
El Updater o el inicio fallaron antes de que el runtime estuviera listo.
Qué hacer
Inspecciona los metadatos del paso fallido y el mensaje de error.
app_memory_warning
Sección titulada “app_memory_warning”Qué significa
Advertencia de memoria en iOS.
Qué hacer
Inspecciona el contexto de memoria en los metadatos y reduce el uso pico tras las actualizaciones.
webview_javascript_error
Sección titulada “webview_javascript_error”Qué significa
Error de JavaScript no capturado en la WebView. Los metadatos pueden incluir el mensaje, la URL de origen, la línea, la columna y el stack.
Qué hacer
Instala el reporte de errores en las capas JS y nativa para capturar la línea exacta que falla en producción.
webview_unhandled_rejection
Sección titulada “webview_unhandled_rejection”Qué significa
Rechazo de promesa no manejado en la WebView.
Qué hacer
Captura fallos asíncronos con reporte de errores de JS y nativo.
webview_resource_error
Sección titulada “webview_resource_error”Qué significa
No se pudo cargar un recurso de la WebView.
Qué hacer
Usa la URL de metadatos y los detalles del estado para corregir assets o reglas de red.
webview_security_policy_violation
Sección titulada “webview_security_policy_violation”Qué significa
La política de seguridad de contenido bloqueó un recurso.
Qué hacer
Ajusta el CSP usando la directiva metadata y los detalles de la URI bloqueada.
webview_unclean_restart
Sección titulada “webview_unclean_restart”Qué significa
La sesión anterior de WebView no se cerró correctamente, lo que puede indicar bucles de crash tras una actualización.
Qué hacer
Correlaciona con eventos de crash y errores de WebView antes y después del reinicio.
webview_render_process_gone
Sección titulada “webview_render_process_gone”Qué significa
El proceso de renderizado de Android WebView ha finalizado.
Qué hacer
Inspecciona las señales de crash del renderer en los metadatos y logs nativos.
webview_content_process_terminated
Sección titulada “webview_content_process_terminated”Qué significa
El proceso de contenido de la WebView de iOS terminó.
Qué hacer
Inspecciona el bundle activo y la URL de la página desde los metadatos.
Telemetría de inicio y navegación
Sección titulada «Telemetría de inicio y navegación»Estos eventos de temporización describen el ciclo de vida de la app. No garantizan que todas las funciones funcionen.
app_launch_start
Sección titulada «app_launch_start»Qué significa
La app inició una medición de lanzamiento. Es un evento normal del ciclo de vida.
app_launch_ready
Sección titulada “app_launch_ready”Qué significa
La app informó que estaba lista. Los metadatos de tiempo permiten comparar el arranque entre versiones. Es un evento normal del ciclo de vida.
app_launch_timeout
Sección titulada “app_launch_timeout”Qué significa
La app no informó que estaba lista dentro de su ventana de medición de inicio.
Qué hacer
Inspecciona los errores de inicio y la línea de tiempo del dispositivo. Verifica que el inicio llegue a la llamada de readiness y llama notifyAppReady() después de que el bootstrap se complete. Compara los tiempos y fallos con el bundle anterior antes de cambiar la configuración de timeout.
webview_dom_content_loaded
Sección titulada “webview_dom_content_loaded”Qué significa
El WebView informó que el contenido del DOM se cargó. Es un evento de temporización normal, no una prueba de que todos los recursos o las funciones de la aplicación estén listos.
webview_page_loaded
Sección titulada “webview_page_loaded”Qué significa
El WebView reportó una carga de página. Es un evento de temporización normal. Compara los metadatos de duración entre versiones al investigar cargas lentas.
app_nav
Sección titulada “app_nav”Qué significa
La app reportó un evento de navegación. Es telemetría normal. Los metadatos de ruta y duración permiten comparaciones por pantalla cuando la app los proporciona.
Resultados adicionales del updater
Sección titulada “Additional updater outcomes”set_next
Sección titulada “set_next”Qué significa
Un bundle se programó para activarse en un próximo lanzamiento de la app. La programación es normal y no significa que el bundle ya se haya activado.
channelPaused
Sección titulada “channelPaused”Qué significa
El canal seleccionado está en pausa. El servidor no envía ninguna actualización y el dispositivo mantiene su bundle actual. Esto puede ser una política de release intencional.
Qué hacer
Revisa por qué se pausó el canal y si es seguro reanudar. No reanudes un rollout de forma automática solo para silenciar este evento.
finish_download_fail
Sección titulada “finish_download_fail”Qué significa
El dispositivo no pudo finalizar un bundle descargado.
Qué hacer
Inspecciona los metadatos y los logs nativos para detectar errores de sistema de archivos o de validación. Verifica el almacenamiento disponible y el archivo subido antes de reintentar.
manifest_path_fail
Sección titulada “manifest_path_fail”Qué significa
La ruta del archivo de manifiesto no pasó la validación o no se pudo usar durante la actualización.
Qué hacer
Inspecciona la ruta que falla en los logs nativos, corrige el layout de archivos del bundle y vuelve a subirlo. No omitas la validación de rutas.
checksum_required
Sección titulada “checksum_required”Qué significa
El updater requiere metadatos de checksum que faltan para esta descarga.
Qué hacer
Sube el bundle de nuevo con el CLI actual y verifica que los metadatos de checksum estén presentes. No desactives las comprobaciones de integridad para evitar el error.
insufficient_disk_space
Sección titulada “insufficient_disk_space”Qué significa
El dispositivo no tiene suficiente almacenamiento para la actualización.
Qué hacer
Libera espacio de almacenamiento en el dispositivo, reduce el tamaño del bundle cuando sea posible y reintenta en un dispositivo de prueba afectado. Esto no se resuelve cambiando la política de versión de un canal.
update_check_error
Sección titulada “update_check_error”Qué significa
La verificación de actualización falló. Este evento por sí solo no identifica si la causa es la conectividad, la disponibilidad del servidor o una negativa específica de la respuesta.
Qué hacer
Inspecciona los metadatos de la respuesta y los logs nativos circundantes. Verifica la conectividad y la URL de actualización configurada, y busca cualquier error específico del backend en Common Update Problems antes de cambiar la configuración.
Contexto de entorno y canal
Sección titulada “Contexto de entorno y canal”Eventos de contexto del dispositivo que ayudan a correlacionar el comportamiento de las actualizaciones con cambios en el OS, la versión nativa o el canal.
os_version_changed
Sección titulada “os_version_changed”Qué significa
Device OS version changed between checks.
native_app_version_changed
Sección titulada “native_app_version_changed”Qué significa
La versión nativa de la app store cambió, lo que ayuda a separar los cambios nativos de los del bundle web.
getChannel
Sección titulada “getChannel”Qué significa
El dispositivo consultó su canal actual.
setChannel
Sección titulada “setChannel”Qué significa
Se estableció correctamente un canal para el dispositivo.
uninstall
Sección titulada “uninstall”Qué significa
La app se desinstaló o se borraron los datos de Capgo.
Estado del bundle
Sección titulada “Estado del bundle”SUCCESS: instalación del bundle completadaERROR: fallo en la instalación o descargaPENDING: descarga completada, pendiente de liberaciónDELETED: bundle eliminado, aún visible para estadísticasDOWNLOADING: descargando un bundle actualmente
Entender los logs del dispositivo
Sección titulada “Comprensión de los logs del dispositivo”Comando de depuración
Sección titulada “Comando de depuración”Existe un comando de depuración para usuarios de Capgo cloud.
npx @capgo/cli@latest app debugEsto te permitirá revisar todos los eventos que ocurren en la app y encontrar una solución si las actualizaciones no se aplican.
Logs nativos de iOS
Sección titulada “Logs nativos de iOS”para encontrar tus logs en Xcode
Logs nativos de Android
Sección titulada “Logs nativos de Android”para encontrar tus logs en Android Studio
Mapeo de frases de logs nativos
Sección titulada “Mapeo de frases de logs nativos”Failed to download fromse mapea adownload_failnotifyAppReady was not called, roll back current bundlese mapea aupdate_fail
Cómo encontrar el bundle descargado en un dispositivo
Sección titulada “Cómo encontrar el bundle descargado en un dispositivo”Para depurar en iOS, necesitas hacer un dump de la app en tu ordenador; puedes hacerlo así:
Xcode tiene una función integrada para inspeccionar el sistema de archivos de las apps instaladas por desarrolladores en un dispositivo iOS.

Para lograrlo:
- Conecta tu dispositivo al Mac y selecciona Window > Devices en la barra de menús de Xcode.
- Selecciona tu dispositivo en el panel izquierdo, en la sección Devices.
- Esto mostrará una lista de las apps instaladas por desarrolladores en ese dispositivo.
- Selecciona la app que quieres inspeccionar y luego toca el icono de los 3 puntos en la parte inferior de la pantalla.
- Aquí puedes ver el sistema de archivos actual descargando un snapshot del mismo.

Al seleccionar Download Container… se descargará y exportará un snapshot del sistema de archivos como un archivo .xcappdata que podrás explorar.

Haz clic derecho en este archivo y selecciona Show Package Contents para abrir la carpeta.
Abre la carpeta de datos de la app y deberías ver varias carpetas como Documents, Library, tmp, etc.

Luego encontrarás una versión en 2 carpetas:
library/NoCloud/ionic_built_snapshots es necesario tras reiniciar la app
y documents/versions para hot reload
Android
Sección titulada “Android”Para depurar en Android, necesitas acceder al dispositivo desde Android Studio:
- Haz clic en View > Tool Windows > Device File Explorer o en el botón Device File Explorer de la barra de ventanas de herramientas para abrir el Device File Explorer.
- Selecciona un dispositivo de la lista desplegable.
- Abre la ruta data/data/APP_NAME/ dónde APP_NAME es el ID de tu app.

Luego, busca la versions carpeta para ver todas las versiones
Entender logs de crash en producción de iOS
Sección titulada “Cómo entender los crash logs de producción de iOS”Continúa desde Depuración
Sección titulada «Continuar desde Debugging»Si estás usando Depuración para planificar el trabajo con plugins nativos, conéctalo con Al usar @capgo/capacitor-updater para la funcionalidad nativa al usar @capgo/capacitor-updater, Directorio de plugins de Capgo para el flujo de trabajo del producto en Capgo Plugin Directory, Plugins de Capacitor por Capgo para el detalle de implementación en los Plugins de Capacitor por Capgo, Añadir o actualizar plugins para el detalle de implementación en Agregar o actualizar plugins, y Alternativas a plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas a plugins de Ionic Enterprise.