Depuración

Aquí hay algunas cuestiones comunes que podrías encontrar al usar Capgo y cómo resolverlas.

🚀 Necesita Ayuda Expert?

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

Obtener Soporte Profesional

Fallos de carga

Si falla la carga de tu paquete, verifica:

• 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 carga desde la raíz de tu proyecto Capacitor
• Tus activos web están construidos y actualizados

Opciones de carga avanzadas

El Capgo CLI ofrece algunas banderas adicionales para ayudar con problemas de carga comunes:

• --tusUtiliza el protocolo de carga resumible de tus para subir archivos más confiables de gran tamaño o en conexiones de red pobres. Si su archivo es mayor a 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 su 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

If you’re encountering issues with live updates, the Capgo debug command is a helpful tool for troubleshooting. To use it:

1. __CAPGO_KEEP_0__

   npx @capgo/cli@latest app debug

2. Arranque su aplicación en un dispositivo o emulador y realice 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. Observa la salida del comando de depuración. Mostrará información sobre el proceso de actualización, incluyendo:

   • Cuando la aplicación busca 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. Utiliza los registros de depuración para identificar dónde ocurre el problema. Por ejemplo:

   • Si no se encuentra una actualización, comprueba nuevamente que se subió correctamente el paquete y que la aplicación está configurada para utilizar el canal correcto.
   • Si la actualización se descarga pero no se instala, asegúrate de haber llamado a CapacitorUpdater.notifyAppReady() y de que la aplicación estuvo completamente cerrada y se volvió a abrir.
   • Si ves un mensaje de error, busca ese error específico en los Capgo docs o ponte 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 se encontró pero no se aplicó finalmente, enfócate tu investigación de problemas 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 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 impiden la descarga de la actualización

• Errores de permisos de archivo cuando se guarda o se lee el paquete de actualización
• Los problemas de conectividad de red pueden impedir 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 grep para Capgo para filtrar los registros.

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 finalización del descarga
• Activación y resultado de la instalación
• Cualquier error durante el proceso de actualización nativa

Los problemas específicos de iOS que podrías identificar en los registros incluyen:

• Problemas con certificados SSL al descargar la actualización
• Bloqueo de la descarga de la actualización por seguridad de transporte de aplicaciones
• Espacio de almacenamiento insuficiente para el paquete de actualización
• Falla al extraer o aplicar correctamente el paquete de actualización

Registros de Electron

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 Desarrollador) 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 crash o errores 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 los mensajes de ambos registros de proceso principal y de proceso de renderizado para separar los problemas de arranque de Electron de Capgo los problemas de ciclo de vida de actualización.

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 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 completamente y volver a abrir la aplicación, ya que las actualizaciones solo se aplican en una ejecución fresca
• Búsqueda de errores en los registros nativos que puedan indicar un problema al aplicar la actualización

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

Códigos de falla de actualización comunes

Si tus registros muestran errores del servidor como disable_auto_update_to_major, semver_error, o cannot_update_via_private_channel, utilice la guía dedicada:

• Problemas de Actualización Comunes

Explica qué significa cada problema común code, por qué ocurre y cómo solucionarlo.

SDK Installation

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

• Tu aplicación utiliza una versión compatible de Capacitor (4.0 o posterior)
• Has seguido los pasos del quickstart en orden, incluyendo sincronizar tu aplicación después de instalar el SDK

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

Consulte el integración de CI/CD documentación para obtener más consejos de depuración. También puedes utilizar el npx @capgo/cli@latest app debug comando para confirmar si tus 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 los detalles de implementación en @capgo/capacitor-uploader.