Depuración

Aquí se presentan algunas cuestiones comunes que podrías encontrar al utilizar Capgo y cómo resolverlas.

🚀 ¿Necesita Ayuda Expertizada?

Atascado con un problema complejo? Nuestro equipo experto está aquí para ayudarlo. Obtenga soporte personalizado, code reseñas y soluciones personalizadas adaptadas a sus necesidades específicas.

Obtener Soporte Profesional

Fallas de subida

Si tu subida de paquete falla, revisa cuidadosamente:

• Tu ID de aplicación en capacitor.config.ts coincide con tu aplicación en la consola de Capgo
• Estás ejecutando el comando de subida desde la raíz de tu proyecto Capacitor
• Tu proyecto de activos web está construido y actualizado

Opciones de subida avanzadas

El Capgo CLI proporciona algunas banderas adicionales para ayudar con problemas de subida comunes:

• --tusUtiliza el protocolo de subida resumible de tus para subir archivos más confiables de grandes paquetes o en conexiones de red pobres. Si su paquete supera los 10MB o está en una conexión inestable, considere usar --tus:

  npx @capgo/cli@latest bundle upload --tus

• --package-json y --node-modules: Indica a Capgo dónde encontrar la carpeta raíz package.json y node_modules si su aplicación utiliza una estructura no estándar como un monorepo o npm espacio de trabajo. Proporcione la ruta a la carpeta raíz package.json y la --node_modules ruta:

  npx @capgo/cli@latest bundle upload --package-json=path/to/package.json --node_modules=path/to/node_modules

  Capgo necesita esta información para empaquetar correctamente las dependencias de su aplicación.

Puede combinar estas banderas con otras opciones como --channel según sea necesario. Consulte los Capgo CLI docs para obtener detalles completos sobre las opciones de carga disponibles.

Si sigue teniendo problemas con las cargas, póngase en contacto con Capgo soporte para obtener asistencia adicional.

Depuración de Actualizaciones

Si está encontrando problemas con las actualizaciones en vivo, el comando de depuración Capgo es una herramienta útil para el seguimiento de problemas. Para utilizarlo:

1. Ejecute el siguiente comando en el directorio de su proyecto:

   npx @capgo/cli@latest app debug

2. Lanzar su aplicación en un dispositivo o emulador y realizar la acción que debería desencadenar una actualización (por ejemplo, volver a abrir la aplicación después de subir un nuevo paquete).

3. Mire la salida del comando de depuración. Mostrará información sobre el proceso de actualización, incluyendo:

   • Cuando la aplicación verifica una actualización
   • Si se encuentra una actualización y qué versión es
   • Progreso de descarga e instalación para la actualización
   • Cualquier error que ocurra durante el proceso de actualización

4. Utilice los registros de depuración para identificar dónde está ocurriendo el problema. Por ejemplo:

   • Si no se encuentra una actualización, revise que su paquete se haya subido con éxito y la aplicación esté configurada para utilizar el canal correcto.
   • Si la actualización se descarga pero no se instala, asegúrese de haber llamado CapacitorUpdater.notifyAppReady() y que la aplicación estuviera completamente cerrada y se haya vuelto a abrir.
   • Si ve un mensaje de error, busque ese error específico en los Capgo docs o póngase en contacto con el soporte para obtener ayuda.

The command de depuración es especialmente útil para identificar problemas con el proceso de descarga e instalación de actualizaciones. Si los registros muestran la versión de actualización esperada encontrada pero no aplicada finalmente, centra tu investigación en los pasos después de la descarga.

Depuración con Registros Nativos

Además del comando de depuración Capgo, los registros nativos de Android, iOS y Electron pueden proporcionar información de depuración valiosa, especialmente para problemas en el lado nativo del proceso de actualización.

Registros de Android

Para acceder a los registros de Android:

1. Conecta tu dispositivo o inicia tu emulador
2. Abre Android Studio y selecciona “Ver > Ventanas de herramienta > Logcat”
3. En la ventana de Logcat, filtra los registros para solo mostrar el proceso de tu aplicación seleccionándolo desde el menú desplegable en la parte superior
4. Busca cualquier línea que incluya Capgo para encontrar los registros SDK

De manera alternativa, puedes utilizar el adb logcat y grep para Capgo para filtrar los registros.

Los Capgo SDK registrarán eventos de tecla durante el proceso de actualización, como:

• Cuando se inicia una comprobación de actualización
• Si se encuentra una actualización y qué versión es
• Cuando comienza y se completa la descarga de la actualización
• Cuando se activa la instalación de la actualización
• Cualquier error que ocurra durante los pasos de actualización nativa

Problemas de conectividad de red que impidan la descarga de la actualización

• Errores de permisos de archivo cuando se guardan o se leen el paquete de actualización
• Problemas de conectividad de red que impidan la descarga de la actualización
• Espacio de almacenamiento agotado para el paquete de actualización
• Falló el reinicio de la aplicación después de instalarse la actualización

Registros de iOS

Para acceder a los registros de iOS:

1. Conecta tu dispositivo o inicia tu simulador
2. Abre Xcode y ve a “Ventana > Dispositivos y Simuladores”
3. Selecciona tu dispositivo y haz clic en “Abrir Consola”
4. En la salida de la consola, busca cualquier línea que incluya Capgo para encontrar los registros SDK

Puedes utilizar también el log stream comando en la terminal y busca con grep por Capgo to filter the logs.

De manera similar a Android, el Capgo SDK registrará eventos clave en el lado iOS:

• Iniciación y resultado de la verificación de actualizaciones
• Inicio, progreso y completación del descarga
• Activación y resultado de la instalación
• Cualquier error durante el proceso de actualización nativa

Los problemas de certificado SSL al descargar la actualización son algunos de los problemas específicos de iOS que podrías identificar en los registros:

• La seguridad de transporte de la aplicación bloquea la descarga de la actualización
• Espacio de almacenamiento insuficiente para el paquete de actualización
• Falla al extraer o aplicar correctamente el paquete de actualización
• Registros de Electron Logs

Electron Logs

Para aplicaciones de Electron, compruebe tanto la salida del proceso principal como la del proceso de renderizado:

1. Ejecuta la aplicación de Electron desde tu terminal utilizando tu comando de lanzamiento normal (por ejemplo, bun run electron:dev o bun run electron:serve) y observa la salida del terminal para errores de inicio, comprobaciones de actualizaciones y errores de red.
2. Abre las herramientas de desarrollo en la ventana de renderizado (Vista → Alternar Herramientas de Desarrollo) e inspecciona los registros de la consola y las solicitudes de red fallidas mientras se reproduce el flujo de actualización.
3. Para aplicaciones empaquetadas, compruebe las herramientas de registro del sistema para errores de bloqueo o fallas de inicio:
   • macOS: abre Console.app y filtra por el nombre de tu aplicación
   • Windows: abre Event Viewer → Registros de Windows → Aplicación
   • Linux: utilice su visor de registros de escritorio o journalctl para el proceso de su aplicación

Al depurar actualizaciones, compare mensajes de ambos registros de proceso principal y de proceso de renderizado para separar problemas de arranque de Electron de problemas de ciclo de vida de actualización de Capgo.

En todas las plataformas, los registros nativos proporcionan una vista de nivel inferior en el proceso de actualización, con más detalles sobre la implementación nativa. Son especialmente útiles para identificar problemas que ocurren fuera de la capa de JavaScript de Capgo.

Al resolver un problema de actualización en vivo complicado, es una buena idea capturar tanto los registros de depuración de Capgo como los registros nativos para obtener una imagen completa de qué está sucediendo. Los dos registros juntos le darán la mejor oportunidad de identificar y resolver el problema.

No se están aplicando actualizaciones

Si ha subido un paquete pero no ve los cambios en su dispositivo:

• Asegúrate de haber llamado a CapacitorUpdater.notifyAppReady() en tu aplicación code como se muestra en el quickstart
• Verifica que tu dispositivo esté conectado a Internet y los registros de depuración de Capgo muestren que se descargó la actualización
• Intenta cerrar y abrir la aplicación completamente, ya que las actualizaciones solo se aplican en una ejecución fresca
• Busca cualquier error en los registros nativos que pueda indicar un problema al aplicar la actualización

Consultar el guía para obtener más detalles sobre el proceso de actualización. Si aún te quedas atascado, utiliza el comando y los registros nativos para obtener más visibilidad sobre qué está sucediendo. npx @capgo/cli@latest app debug Códigos de error de actualización comunes

Título de la sección “Códigos de error de actualización comunes”

If your logs show backend errors such as __CAPGO_KEEP_0__, __CAPGO_KEEP_1__, or __CAPGO_KEEP_2__, use the dedicated guide: disable_auto_update_to_major, semver_errorProblemas de Actualización Comunes cannot_update_via_private_channelExplica qué significa cada problema común __CAPGO_KEEP_0__, por qué ocurre y cómo solucionarlo.

• __CAPGO_KEEP_0__ Installation

Sección titulada “code Installation”

Si tienes problemas para instalar el SDK __CAPGO_KEEP_1__, asegúrate de:

If you’re having trouble installing the Capgo SDK, make sure:

• Your app is using a supported version of Capacitor (4.0 or newer)
• Common Update Problems It explains what each common __CAPGO_KEEP_0__ means, why it happens, and how to fix it. SDK Installation

Integración CI/CD

Para problemas con la activación de subidas de Capgo desde tu pipeline de CI/CD:

• Verifica que tu token de autenticación de Capgo esté configurado correctamente
• Asegúrate de ejecutar el comando de subida después de que se hayan construido tus activos web
• Verifica que el comando de subida esté utilizando el nombre de canal correcto para tu entorno de destino

Consultar la integración de CI/CD para obtener más consejos de depuración. También puedes utilizar el npx @capgo/cli@latest app debug comando para confirmar si las actualizaciones desencadenadas por CI/CD están siendo recibidas por la aplicación.

Sigue adelante desde Depuración

Si estás utilizando Solución de problemas para planificar el almacenamiento y el manejo de archivos, conecta con @capgo/capacitor-almacenamiento-de-datos-sqlite para los detalles de implementación en @capgo/capacitor-almacenamiento-de-datos-sqlite, Usando @capgo/capacitor-almacenamiento-de-datos-sqlite para la capacidad nativa en Usando @capgo/capacitor-almacenamiento-de-datos-sqlite, @capgo/capacitor-archivo para los detalles de implementación en @capgo/capacitor-archivo, Usando @capgo/capacitor-archivo para la capacidad nativa en Usando @capgo/capacitor-archivo, y @capgo/capacitor-subidor para el detalle de implementación en @capgo/capacitor-uploader.