Solución de problemas

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

¿Necesita Ayuda Expertizada?

¿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 Apoyo 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 Capgo de la consola
• 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

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: 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 disponibles.

Si sigue teniendo problemas con las cargas, póngase en contacto con el soporte de Capgo para obtener más asistencia.

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. Lanzar tu aplicación en un dispositivo o emulador y realizar 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, compruebe que su paquete se ha 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 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 contacte 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, 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 utilizar el comando y grep para 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
• Conecta tu dispositivo o inicia tu emulador para acceder a los registros de Android y seguir los pasos a continuación.
• 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 lee el paquete de actualización
• Espacio de almacenamiento insuficiente 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

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

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

• El inicio, progreso y completación del descarga
• El disparo y resultado de la instalación
• Errores durante el proceso de actualización nativa
• El comando en la terminal y grep para filtrar los registros.

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:serveVerifica la salida del terminal durante el arranque, las comprobaciones de actualización y los errores de red mientras reproducir el flujo de actualización.
2. Abre las herramientas de desarrollo en la ventana de renderizado (Ver → Activar herramientas de desarrollo) e inspecciona los registros de la consola y las solicitudes de red fallidas mientras reproducir el flujo de actualización.
3. Para aplicaciones empaquetadas, compruebe 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 registro de escritorio o journalctl para el proceso de su aplicación

Cuando depuras actualizaciones, compara los mensajes de ambos registros de proceso principal y de proceso de renderizado para separar los problemas de arranque de Electron de los problemas de ciclo de vida de la actualización Capgo.

A lo largo de 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 trata de 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 lo que 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 la quickstart
• Verifique que su dispositivo esté conectado a Internet y los registros de depuración 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 actualización 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 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_erroro 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)
• 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 CI/CD:

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

• Double check your Capgo authentication token is set up correctly
• __CAPGO_KEEP_0__ Installation
• __CAPGO_KEEP_0__ __CAPGO_KEEP_1__

Ver la integración CI/CD los 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 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.