Depuración

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

🚀 Necesita Ayuda Expert?

Estancado 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.

Obtenga Soporte Profesional

Fallas de carga

Si falla la carga de su paquete, compruebe:

• Su ID de aplicación en capacitor.config.ts coincide con su aplicación en el panel de control de Capgo
• Está ejecutando el comando de carga desde la raíz de su proyecto de Capacitor
• Su contenido web está construido y actualizado

Opciones de carga avanzadas

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

• --tus: Utiliza el protocolo de carga resumible tus para subidas más fiables de paquetes grandes o en conexiones de red pobres. Si su paquete supera los 10MB o está en una conexión inestable, considere utilizar --tus:

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

• --package-json y --node-modules: Indica a Capgo dónde encontrar su raíz package.json y node_modules Si tu aplicación utiliza una estructura no estándar como un monorepo o npm espacio de trabajo. Proporciona la ruta al root package.json y --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 tu aplicación.

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

Si sigues teniendo problemas con las cargas, ponte en contacto con Capgo soporte para obtener asistencia adicional.

Actualizaciones de depuración

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

1. Ejecuta el siguiente comando en el directorio de tu proyecto:

   npx @capgo/cli@latest app debug

2. Lanza tu aplicación en un dispositivo o emulador y realiza 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 verifica si hay actualizaciones disponibles
   • Si se encuentra una actualización y qué versión es
   • Progreso de descarga e instalación para la actualización
   • Any errors that occur during the update process

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

   • Si no se encuentra ninguna actualización, compruebe que su paquete se ha subido con éxito y que 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 de 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.

El comando de depuración es especialmente útil para identificar problemas con el proceso de descarga y instalación de actualizaciones. Si los registros muestran que se encontró la versión de actualización esperada pero no se aplicó finalmente, centre su investigación en los pasos después de la descarga.

Depuración con Registros Nativos

Además del comando de depuración de 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

To 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 de SDK

Alternativamente, puedes usar el adb logcat comando y grep para buscar Capgo para filtrar los registros.

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

• Cuando se inicia una verificació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

Los problemas de conectividad de red que impiden la descarga de la actualización

• Errores de permisos de archivo al guardar o leer el paquete de actualización
• Falta de espacio en almacenamiento para el paquete de actualización
• iOS Logs
• Sección titulada “iOS Logs”

Para acceder a los registros de iOS:

Cualquier error que ocurra durante los pasos de actualización nativa

1. Cualquier error que ocurra durante los pasos de actualización nativa
2. Abra Xcode y vaya a “Ventana > Dispositivos y Simuladores”
3. Seleccione su dispositivo y haga clic en “Abrir Consola”
4. En la salida de la consola, busque cualquier línea que incluya Capgo para encontrar los registros SDK

También puede utilizar 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 del lado iOS:

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

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

• Problemas con certificados SSL al descargar la actualización
• 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

Para aplicaciones de Electron, revisa 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, verificaciones de actualización y errores de red.
2. Abre las Herramientas de Desarrollo en la ventana de renderizado (Ver → Alternar Herramientas de Desarrollo) e inspecciona los registros de la consola y las solicitudes de red fallidas mientras reproducís el flujo de actualización.
3. Para aplicaciones empaquetadas, compruebe herramientas de registro de OS para errores o fallas de arranque:
   • macOS: abrir Console.app y filtrar por el nombre de su aplicación
   • Windows: abrir Registro de Eventos → Registros de Windows → Aplicación
   • Linux: utilice su visor de registro de escritorio o journalctl para el proceso de su aplicación

When depurando actualizaciones, compara mensajes de ambas registros de proceso principal y proceso de renderizado para separar problemas de inicialización de Electron de Capgo 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 de JavaScript Capgo.

Cuando se está depurando un problema de actualización en vivo complicado, es una buena idea capturar tanto los registros de depuración 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úrese de que ha llamado a CapacitorUpdater.notifyAppReady() en su aplicación code como se muestra en el quickstart
• Verifique que su dispositivo está conectado a Internet y los registros de depuración Capgo muestren que se descargó la actualización
• Intente cerrar completamente y volver a abrir la aplicación, ya que las actualizaciones solo se aplican en una ejecución fresca
• Busque cualquier error en los registros nativos que pueda indicar un problema al aplicar la actualización

Consulte el guía para obtener más detalles sobre el proceso de actualización. Si aún se encuentra atascado, utilice el 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

Sección titulada “Códigos de error de actualización comunes”

, o disable_auto_update_to_major, semver_error, utilice la guía dedicada: cannot_update_via_private_channelProblemas de Actualización Comunes

• Explica qué significa cada __CAPGO_KEEP_0__ común, por qué sucede y cómo solucionarlo.

code de instalación

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 la sincronización de 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:

• Revisa 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 los integración CI/CD documentos para obtener más consejos de depuración. También puede utilizar el npx @capgo/cli@latest app debug comando para confirmar si sus actualizaciones desencadenadas por CI/CD están siendo recibidas por la aplicación.

Siga adelante desde la sección de depuración

depuración para planificar el almacenamiento y el manejo de archivos, conecte @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-almacenamiento-de-datos-sqlite para obtener detalles de implementación en @capgo/capacitor-almacenamiento-de-datos-sqlite, Utilice @capgo/capacitor-almacenamiento-de-datos-sqlite Using @capgo/capacitor-data-storage-sqlite para la capacidad nativa en Usando @capgo/capacitor-almacenamiento-de-datos-sqlite, @capgo/capacitor-archivo para el detalle 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-subidor.