Solución de Problemas

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

🚀 ¿Necesitas Ayuda Experta?

¿Atascado con un problema complejo? ¡Nuestro equipo experto está aquí para ayudar! Obtén soporte personalizado, revisiones de código y soluciones personalizadas adaptadas a tus necesidades específicas.

Obtener Soporte Profesional

Fallos en la Carga

Si tu carga de Paquete falla, verifica dos veces:

Tu ID de aplicación en capacitor.config.ts coincide con tu aplicación en el panel de Capgo
Estás ejecutando el comando de carga desde la raíz de tu proyecto Capacitor
Tus activos web están compilados y actualizados

Opciones avanzadas de carga

La CLI de Capgo proporciona algunas banderas adicionales para ayudar con problemas comunes de carga:

--tus: Usa el protocolo de carga reanudable tus para cargas más confiables de Paquetes grandes o en conexiones de red deficientes. Si tu Paquete es mayor a 10MB o estás en una conexión irregular, considera usar --tus:
Terminal window
```
npx @capgo/cli@latest bundle upload --tus
```
--package-json y --node-modules: Indica a Capgo dónde encontrar tu package.json raíz y node_modules si tu aplicación usa una estructura no estándar como un monorepo o espacio de trabajo npm. Pasa la ruta al package.json raíz y la ruta --node_modules:
Terminal window
```
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 documentos de CLI de Capgo para detalles completos sobre las opciones de carga disponibles.

Si aún tienes problemas con las cargas, contacta al soporte de Capgo para obtener más asistencia.

Depuración de Actualizaciones

Si encuentras problemas con las actualizaciones en vivo, el comando de depuración de Capgo es una herramienta útil para solucionar problemas. Para usarlo:

Ejecuta el siguiente comando en tu directorio de proyecto:
Terminal window
```
npx @capgo/cli@latest app debug
```
Lanza tu aplicación en un dispositivo o emulador y realiza la acción que debería activar una actualización (por ejemplo, reabrir la aplicación después de subir un nuevo Paquete).
Observa la salida del comando de depuración. Registrará 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
Usa los registros de depuración para identificar dónde está ocurriendo el problema. Por ejemplo:
- Si no se encuentra ninguna actualización, verifica dos veces que tu Paquete se subió exitosamente y que la aplicación está configurada para usar el canal correcto.
- Si la actualización se descarga pero no se instala, asegúrate de haber llamado a CapacitorUpdater.notifyAppReady() y que la aplicación se cerró completamente y se volvió a abrir.
- Si ves un mensaje de Error, busca ese Error específico en los documentos de Capgo o contacta al 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 que se encontró la versión de actualización esperada pero no se aplicó finalmente, enfoca tu solución de problemas 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 en Android e iOS pueden proporcionar información valiosa para la solución de problemas, especialmente para problemas en el lado nativo del proceso de actualización.

Registros de Android

Para acceder a los registros de Android:

Conecta tu dispositivo o inicia tu emulador
Abre Android Studio y selecciona “View > Tool Windows > Logcat”
En la ventana Logcat, filtra los registros solo al proceso de tu aplicación seleccionándolo del menú desplegable en la parte superior
Busca cualquier línea que incluya Capgo para encontrar los registros del SDK

Alternativamente, puedes usar el comando adb logcat y grep para Capgo para filtrar los registros.

El SDK de Capgo registrará eventos clave durante el proceso de actualización, tales como:

Cuándo se inicia una verificación de actualización
Si se encuentra una actualización y qué versión es
Cuándo la descarga de actualización comienza y se completa
Cuándo se activa la instalación de actualización
Cualquier Error que ocurra durante los pasos de actualización nativos

Problemas comunes específicos de Android que podrías ver en los registros incluyen:

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 de almacenamiento para el Paquete de actualización
Fallo al reiniciar la aplicación después de instalar la actualización

Registros de iOS

Para acceder a los registros de iOS:

Conecta tu dispositivo o inicia tu simulador
Abre Xcode y ve a “Window > Dispositivos and Simulators”
Selecciona tu dispositivo y haz clic en “Open Console”
En la salida de la consola, busca cualquier línea que incluya Capgo para encontrar los registros del SDK

También puedes usar el comando log stream en la terminal y grep para Capgo para filtrar los registros.

Similar a Android, el SDK de Capgo registrará eventos clave del lado de iOS:

Inicio y resultado de verificación de actualización
Inicio, progreso y finalización de descarga
Activación y resultado de instalación
Cualquier Error durante el proceso de actualización nativo

Problemas específicos de iOS que podrías identificar en los registros incluyen:

Problemas de certificado SSL al descargar la actualización
Seguridad de transporte de aplicaciones bloqueando la descarga de actualización
Espacio de almacenamiento insuficiente para el Paquete de actualización
Fallo al extraer o aplicar correctamente el Paquete de actualización

En ambas plataformas, los registros nativos proporcionan una vista de nivel inferior del 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 JavaScript de Capgo.

Al solucionar un problema complicado de actualización en vivo, es una buena idea capturar tanto los registros de depuración de Capgo como los registros nativos para obtener una imagen completa de lo que está sucediendo. Los dos registros juntos te darán la mejor oportunidad de identificar y resolver el problema.

Actualizaciones que no se aplican

Si has subido un Paquete pero no ves los cambios en tu dispositivo:

Asegúrate de haber llamado a CapacitorUpdater.notifyAppReady() en el código de tu aplicación como se muestra en el inicio rápido
Verifica que tu dispositivo esté conectado a internet y que los registros de depuración de Capgo muestren que la actualización se descargó
Intenta cerrar completamente y volver a abrir la aplicación, ya que las actualizaciones solo se aplican en un lanzamiento nuevo
Busca cualquier Error en los registros nativos que pueda indicar un problema al aplicar la actualización

Consulta la guía de implementación de actualizaciones en vivo para más detalles sobre el proceso de actualización. Si aún estás atascado, usa el comando npx @capgo/cli@latest app debug y los registros nativos para obtener más visibilidad sobre lo que está sucediendo.

Instalación del SDK

Si tienes problemas para instalar el SDK de Capgo, asegúrate de que:

Tu aplicación esté usando una versión compatible de Capacitor (4.0 o más reciente)
Hayas seguido los pasos del inicio rápido en orden, incluyendo sincronizar tu aplicación después de instalar el SDK

Integración CI/CD

Para problemas con la activación de cargas de Capgo desde tu pipeline de CI/CD:

Verifica dos veces que tu token de autenticación de Capgo esté configurado correctamente
Asegúrate de que estés ejecutando el comando de carga después de que tus activos web se hayan compilado
Verifica que el comando de carga esté usando el nombre de canal correcto para tu entorno objetivo

Consulta los documentos de integración CI/CD para más consejos de solución de problemas. También puedes usar el comando npx @capgo/cli@latest app debug para confirmar si tus actualizaciones activadas por CI/CD están siendo recibidas por la aplicación.