Solución de problemas

Aquí hay algunos problemas comunes que podrías encontrar al usar Capgo y cómo resolverlos.

¿Necesita Ayuda Expertas?

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

Obtenga Soporte Profesional

Fallas de carga

Si su carga de paquete falla, compruebe nuevamente:

• Su ID de aplicación en capacitor.config.ts coincide con su aplicación en la consola 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 de tus para subidas más fiables de paquetes grandes o en conexiones de red pobres. Si su paquete supera los 10 MB o está en una conexión inestable, considere utilizar --tus:

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

• --package-json y --node-modules: Tells Capgo where to find your root package.json : Indica a __CAPGO_KEEP_0__ dónde encontrar su carpeta raíz 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 raíz package.json y el --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 documentos para obtener detalles completos sobre las opciones de carga disponibles.

Si sigue teniendo problemas con las cargas, póngase en contacto con el soporte de Capgo 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:

   • Cuándo 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
   • Errores que ocurran durante el proceso de actualización

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, verifique que su paquete se haya subido con éxito y que la aplicación esté configurada para utilizar el canal correcto.
   • Si el paquete se descarga pero no se instala, asegúrese de haber llamado a 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 técnico 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 la versión de actualización esperada se encontró 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 SDK

Alternativamente, puedes usar el comando y grep para adb logcat para filtrar los registros. Capgo Los registros __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ registrarán eventos de teclado durante el proceso de actualización, como:

The Capgo SDK will log key events during the update process, such as:

• Si se encuentra una actualización y qué versión es
• Conecta tu dispositivo o inicia tu emulador para acceder a los registros de Android y selecciona "Ver > Ventanas de herramienta > Logcat" en Android Studio.
• When the update download starts and completes
• Cuando se inicia y completa la descarga de la actualización
• Cuando se dispara la instalación de la actualización

Errores que ocurren 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 al guardar o leer el paquete de actualización
• Falta de espacio en almacenamiento para el paquete de actualización
• Fallas al reiniciar la aplicación después de instalar la actualización

Registros de iOS

Para acceder a los registros de iOS:

1. Conecta tu dispositivo o arranca tu simulador
2. Abra Xcode y vaya a ‘Ventana > Dispositivos y Simuladores’
3. Seleccione su dispositivo y haga clic en ‘Consola Abierta’
4. En la salida de la consola, busque cualquier línea que incluya Capgo para encontrar los registros SDK

Puede utilizar también el comando en la terminal y grep para log stream para filtrar los registros. Capgo De manera similar a Android, el __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ registrará eventos clave en el lado iOS:

Similar to Android, the Capgo SDK will log key iOS-side events:

• El inicio, progreso y finalización del descarga
• El disparo y resultado de la instalación
• Cualquier error durante el proceso de actualización nativa
• command

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, verifica 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:servey observa el resultado en la salida del terminal durante el arranque, las comprobaciones de actualización y los errores de red.
2. Abre las herramientas de desarrollo en la ventana de renderizado (Ver → Habilitar 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 o fallas de arranque:
   • macOS: abrir Console.app y filtrar por el nombre de su aplicación
   • Windows: abrir Vista de eventos → Registros de Windows → Aplicación
   • contexto: definición de aplicación (clave de mensaje `application_definition`). Página/área: sitio web de marketing de Capgo. Rol: copia de sitio web. Visto en: página disclaimer.astro. Clave de mensaje `application_definition` (Definición de aplicación).Linux journalctl : use su visor de registros de escritorio o

When depurando actualizaciones, compara los mensajes de ambos registros de procesos principal y de renderizado para separar los problemas de arranque 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 de Capgo.

Cuando se trata de un problema de actualización en vivo difícil de resolver, 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.

Actualizaciones no se aplican

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

• Asegúrese de haber llamado a __CAPGO_KEEP_0__ en su aplicación como se muestra en el CapacitorUpdater.notifyAppReady() in your app code as shown in the Verifique que su dispositivo esté conectado a Internet y los registros de depuración de __CAPGO_KEEP_0__ muestren que la actualización se descargó
• Check that your device is connected to the internet and the Capgo debug logs show the update was downloaded
• Busque cualquier error en los registros nativos que pueda indicar un problema al aplicar la actualización
• __CAPGO_KEEP_0__

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 Errores de actualización comunes

Sección titulada “Errores de actualización comunes”

o disable_auto_update_to_major, semver_errorutilice 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 Instalación

SDK Installation

Si está teniendo problemas para instalar el Capgo SDK, asegúrese de:

• Su aplicación utiliza una versión compatible de Capacitor (4.0 o posterior)
• Siga los pasos del quickstart en orden, incluyendo la sincronización de su aplicación después de instalar el __CAPGO_KEEP_0__ Integración CI/CD steps in order, including syncing your app after installing the SDK

Para problemas con la activación de subidas de __CAPGO_KEEP_0__ desde su pipeline de CI/CD:

For issues with triggering Capgo uploads from your CI/CD pipeline:

• Double check your Capgo authentication token is set up correctly
• Integración CI/CD
• Para problemas con la activación de subidas de __CAPGO_KEEP_0__ desde su pipeline de CI/CD:

Ver la 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 Depuración

Si está utilizando Depuración contexto: Área/Página: Soporte / página de soporte premium o sección de soporte en el pie de página. Rol: Título de sección o página. Visto en: página support-policy.astro. Clave de mensaje `support_policy_troubleshooting_title` (Título de política de soporte de depuración). @capgo/capacitor-data-storage-sqlite @capgo/capacitor-data-storage-sqlite para obtener detalles de implementación en @capgo/capacitor-data-storage-sqlite, para la capacidad nativa en Uso de @capgo/capacitor-almacenamiento-sqlite, @capgo/capacitor-archivo para el detalle de implementación en @capgo/capacitor-archivo, Uso de @capgo/capacitor-archivo para la capacidad nativa en Uso de @capgo/capacitor-archivo, y @capgo/capacitor-subidor para el detalle de implementación en @capgo/capacitor-subidor.