Solución de problemas

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

¿Necesita Ayuda de Experto?

¿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 Capacitor
• Su contenido web está construido y actualizado

Opciones de carga avanzadas

La 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 node_modules si su aplicación utiliza una estructura no estándar como un repositorio monolítico 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 más asistencia.

Actualización 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
   • Cualquier error que ocurra 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, compruebe que su paquete se ha subido correctamente y que la aplicación está configurada para utilizar el canal correcto.
   • Si el archivo de actualización se descarga pero no se instala, asegúrese de que ha llamado a CapacitorUpdater.notifyAppReady() y que la aplicación se ha cerrado completamente y se ha 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 e instalación de actualizaciones. Si los registros muestran 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

Para acceder a los registros de Android:

1. Conecta tu dispositivo o inicia tu emulador
2. Abre Android Studio y selecciona "Ver > Ventanas de herramientas > 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 utilizar el comando y grep para buscar adb logcat para filtrar los registros. Capgo Los registros de __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
• Para acceder a los registros de Android:
• 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 incluyen:

• 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

Sección titulada “Registros de iOS”

Conecta tu dispositivo o inicia tu simulador

1. Problemas de conectividad de red que impiden la descarga de la actualización
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

Puede 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 del lado iOS:

• La iniciación y resultado de la verificación de actualizaciones
• El inicio, progreso y completación del descarga
• El disparo y resultado de la instalación
• Errores 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
• Fallas 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:servePara aplicaciones de Electron, revisa tanto la salida del proceso principal como la del proceso de renderizado:
2. Ejecuta la aplicación de Electron desde tu terminal utilizando tu comando de lanzamiento normal (por ejemplo, `electron .` o `npm start`) y observa la salida del terminal durante el arranque, las comprobaciones de actualización y los errores de red.
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
   • Linux: utilice su visor de registros de escritorio o journalctl para el proceso de su aplicación

When depurando actualizaciones, compara los mensajes de ambos registros de proceso principal y de 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 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 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 de Capgo muestren que la actualización se descargó
• 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 queda atascado, utilice el 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_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 de 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)
• Ha seguido los pasos del quickstart en orden, incluyendo la sincronización de la 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
• __CAPGO_KEEP_0__ Installation

Ver la integración CI/CD documentación para obtener más consejos de depuración. También puede 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.

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 Usando @capgo/capacitor-almacenamiento-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.