Solución de problemas

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

¿Necesita Ayuda Expertizada?

¿Está atascado con un problema complejo? Nuestro equipo experto 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 lo siguiente:

• 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

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: 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 un espacio de trabajo npm. Proporciona 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 docs para obtener detalles completos sobre las opciones de carga disponible

Si sigue teniendo problemas con las cargas, comuníquese con el 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. Mira 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 que ha llamado a CapacitorUpdater.notifyAppReady() y que la aplicación se haya cerrado completamente y se haya vuelto a abrir.
   • Si ve un mensaje de error, busque ese error específico en los Capgo documentos 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 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 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 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 cuando se guarda o se lee el paquete de actualización
• Espacio de almacenamiento insuficiente para el paquete de actualización
• Falla al reiniciar la aplicación después de que se instala 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
• 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 renderizador:

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, verifica tanto la salida del proceso principal como la del proceso renderizador:
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. For aplicaciones empaquetadas, compruebe herramientas de registro del sistema para crash o fallas de arranque:
   • macOS: abrir Console.app y filtrar por el nombre de su aplicación
   • Windows: abrir Event Viewer → Registros de Windows → Aplicación
   • contexto: definición de aplicación. Página/área: sitio web de marketing de Capgo. Rol: copia de sitio web. Visto en: página de advertencia.astro. Clave de mensaje `application_definition` (Definición de aplicación).Linux journalctl : utilice su visor de registros de escritorio o

When debugging updates, compare messages from both main-process and renderer-process logs to separate Electron bootstrap issues from Capgo issues with the update lifecycle.

Across platforms, the native logs provide a lower-level view into the update process, with more details on the native implementation. They are especially useful for identifying issues that occur outside of the Capgo layer of JavaScript.

When troubleshooting a tricky live update problem, it’s a good idea to capture both the Capgo debug logs and the native logs for a comprehensive picture of what’s happening. The two logs together will give you the best chance of identifying and resolving the issue.

Actualizaciones que no se aplican

If you’ve uploaded a bundle but aren’t seeing the changes on your device:

• Make sure you’ve called __CAPGO_KEEP_0__ in your app as shown in the quickstart CapacitorUpdater.notifyAppReady() Check that your device is connected to the internet and the code debug logs show the update was downloaded Try fully closing and reopening the app, as updates are only applied on a fresh launch
• Check that your device is connected to the internet and the Capgo debug logs show the update was downloaded
• Problemas de actualización
• Si ha subido un paquete pero no ve los cambios en su dispositivo:

Consulte el actualización en vivo para obtener más detalles sobre el proceso de actualización. Si aún se encuentra atascado, utilice el npx @capgo/cli@latest app debug comando y registros nativos para obtener más visibilidad sobre qué está sucediendo.

Errores de actualización comunes

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

SDK Instalación

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.

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