Resolución de problemas

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

¿Necesita Ayuda Expertos?

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

Obtenga Soporte Profesional

Fracasos de carga

Si su carga de paquete falla, 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
• Sus activos web están construidos y actualizados

Opciones de carga avanzadas

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

• --tus: Utiliza el protocolo de subida resumible de tus para subidas más fiables de paquetes grandes o en conexiones de red pobres. Si su paquete es mayor a 10MB o está en una conexión inestable, considere utilizar Ventana de terminal Copiar a portapapeles --tus:

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

• --package-json si su aplicación utiliza una estructura no estándar como un monorepo o un espacio de trabajo __CAPGO_KEEP_0__. Pase la ruta a la carpeta raíz --node-modules: Tells Capgo where to find your root package.json el node_modules if your app uses a non-standard structure like a monorepo or npm workspace. Pass the path to the root package.json a --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.

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 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. Utiliza los registros de depuración para identificar dónde se está produciendo el problema. Por ejemplo:

   • If no update is found, double check that your bundle was uploaded successfully and the app is configured to use the correct channel.
   • Si no se encuentra ninguna actualización, comprueba que tu paquete se ha subido correctamente y que la aplicación está configurada para utilizar el canal correcto. CapacitorUpdater.notifyAppReady() If the update downloads but doesn’t install, make sure you’ve called
   • If you see an error message, look up that specific error in the Capgo docs or reach out to support for help.

and that the app was fully closed and reopened.

y que la aplicación se ha cerrado completamente y se ha vuelto a abrir.

Si ves un mensaje de error, busca ese error específico en los Capgo docs o contacta con el soporte para obtener ayuda.

The debug command is especially useful for identifying issues with the update download and installation process. If the logs show the expected update version was found but not ultimately applied, focus your troubleshooting on the steps after the download.

Debugging with Native Logs

1. Depuración con registros nativos. Section titled “Debugging with Native Logs” Sección titulada “Depuración con registros nativos” In addition to the __CAPGO_KEEP_0__ debug command, the native logs on Android, iOS, and Electron can provide valuable troubleshooting information, especially for issues on the native side of the update process. Además de la orden de depuración __CAPGO_KEEP_0__, los registros nativos en Android, iOS y Electron pueden proporcionar información de depuración valiosa, especialmente para problemas en el lado nativo del proceso de actualización. Android Logs Registros de Android Section titled “Android Logs” Sección titulada “Registros de Android” To access the Android logs: Para acceder a los registros de Android: Connect your device or start your emulator Conecta tu dispositivo o arranca tu emulador
2. Abra Android Studio y seleccione “Ver > Ventanas de herramienta > Logcat”
3. En la ventana de Logcat, filtre los registros para solo mostrar el proceso de su aplicación seleccionándolo desde el menú desplegable en la parte superior
4. Busque cualquier línea que contenga Capgo para encontrar los registros SDK

Alternativamente, puede utilizar el comando y grep para buscar 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
• Cuando comienza y se completa la descarga de la actualización
• Cuando se activa la instalación de la actualización
• No se traducen los tokens protegidos
• 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 lee el paquete de actualización
• Falta de espacio en almacenamiento para el paquete de actualización
• Fracaso al reiniciar la aplicación después de instalar la actualización
• Registro de iOS

Sección titulada “Registro de iOS”

Conecta tu dispositivo o inicia tu simulador

1. Abre Xcode y ve a “Ventana > Dispositivos y Simuladores”
2. Selecciona tu dispositivo y haz clic en “Abrir Consola”
3. Accede a los registros de iOS:
4. In la salida del 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 filtrar los registros.

De manera similar a Android, el Capgo SDK registrará eventos clave en el 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
• Cualquier error durante el proceso de actualización nativa

Los problemas de certificado SSL al descargar la actualización

• Los problemas específicos de iOS que pueda identificar en los registros incluyen:
• Bloqueo de seguridad de transporte de la aplicación al descargar la actualización
• Espacio de almacenamiento insuficiente para el paquete de actualización
• Fallida 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 el arranque, verificaciones de actualizaciones y errores de red.
2. Abre las herramientas de desarrollo en la ventana de renderizado (Vista → Habilitar 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 fallas de arranque o errores:
   • macOS: abrir Console.app y filtrar por el nombre de tu 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

Al depurar actualizaciones, compara mensajes de ambos registros de procesos principal y 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.

Cuando se encuentre resolviendo 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 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 desplegando actualizaciones en vivo guía para obtener más detalles sobre el proceso de actualización. Si aún se queda atascado, utilice el npx @capgo/cli@latest app debug comando y los registros nativos para obtener más visibilidad sobre qué está sucediendo.

Códigos de error de actualización comunes

Si los registros muestran errores de backend 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 code común, por qué sucede y cómo solucionarlo.

SDK Instalación

Si tiene 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 su aplicación después de instalar el __CAPGO_KEEP_0__ quickstart steps in order, including syncing your app after installing the SDK

Sección titulada “Integración de CI/CD”

Verifique que su token de autenticación de Capgo esté configurado correctamente

• Double check your Capgo authentication token is set up correctly
• Verifique que el comando de subida esté utilizando el nombre de canal correcto para su entorno de destino
• Consulte la

integración de CI/CD CI/CD Integration docs para obtener más consejos de depuración. También puedes usar 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 Depuración 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 el detalle de implementación en el archivo @capgo/capacitor-file, Usando el archivo @capgo/capacitor-file para la capacidad nativa en Usando el archivo @capgo/capacitor-file, y subidor @capgo/capacitor-uploader para el detalle de implementación en el subidor @capgo/capacitor-uploader.