Usando Capgo en China

Si está desplegando su aplicación a usuarios en China, necesitará configurar Capgo para utilizar URLs de almacenamiento de objetos regionales (OST) para garantizar actualizaciones fiables y rápidas.

Preguntas frecuentes sobre China

Debido a la infraestructura de red y las regulaciones en China (el Gran Muro), las conexiones directas a servidores internacionales pueden ser lentas o inseguras. Capgo proporciona URLs de OST dedicadas con datos ubicados en Hong Kong para minimizar la latencia y garantizar que sus usuarios reciban actualizaciones lo más rápido y de manera más segura posible.

Configuración

Para configurar Capgo para China, necesita establecer tres URLs específicas en su archivo de configuración Capacitor. Estas URLs apuntan a la infraestructura de Capgo en Hong Kong.

1. Abra su capacitor.config.ts archivo

2. Agregue la siguiente configuración a la CapacitorUpdater sección del plugin:

   import { CapacitorConfig } from '@capacitor/cli';
   
   const config: CapacitorConfig = {
     plugins: {
       CapacitorUpdater: {
         autoUpdate: 'atBackground',
         updateUrl: 'https://updater.capgo.com.cn/updates',
         statsUrl: 'https://updater.capgo.com.cn/stats',
         channelUrl: 'https://updater.capgo.com.cn/channel_self',
       },
     },
   };
   
   export default config;

3. Reconstruya su aplicación para aplicar los cambios:

   npm run build
   npx cap sync

Detalles de configuración

Esto es lo que hace cada URL:

• updateUrl: https://updater.capgo.com.cn/updates - Se utiliza para verificar y descargar actualizaciones disponibles para su aplicación
• statsUrl: https://updater.capgo.com.cn/stats - Se utiliza para informar estadísticas de análisis y uso a Capgo
• channelUrl: https://updater.capgo.com.cn/channel_self - Se utiliza para recuperar la configuración del canal y determinar qué actualizaciones aplicar

Consejo

Todas las tres URL deben configurarse conjuntamente para garantizar la funcionalidad completa del actualizador de Capgo en China.

Configuración Recomendada para China

Debido a las limitaciones de rendimiento de la red causadas por el Gran Muro de China, tenemos recomendaciones específicas para aplicaciones desplegadas en la región continental de China:

Aumentar el Tiempo de Respuesta de API

El actualizador de Capgo aborta las llamadas a API cuando responseTimeout se supera (el valor está en segundos) La infraestructura de borde de Capgo también trata sobre segundos como un presupuesto de fracaso para algunas rutas.

En la región continental china, la latencia transfronteriza es a menudo mayor. Mantenga una mayor responseTimeout El plugin tiene suficiente espacio para completar las comprobaciones y descargas de actualizaciones. updater.capgo.com.cn en lugar de fallar temprano:

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'atBackground',
      // Seconds. Raise above the default (20) for China network conditions.
      responseTimeout: 60,
      updateUrl: 'https://updater.capgo.com.cn/updates',
      statsUrl: 'https://updater.capgo.com.cn/stats',
      channelUrl: 'https://updater.capgo.com.cn/channel_self',
    },
  },
};

Consejo

Preferir responseTimeout: 60 o (o superior) para despliegues en China. Un tiempo de espera bajo no hace que las actualizaciones sean más rápidas — solo hace que el plugin deje de intentarlo mientras la solicitud puede aún tener éxito en el lado de Capgo.

Usar Actualizaciones de Fondo

Nosotros recomendamos fuertemente usar autoUpdate: 'atBackground' para aplicaciones en China. La conectividad de red en China es menos eficiente que en otras regiones, y los modos de aplicación instantánea pueden provocar una mala experiencia del usuario si las descargas se interrumpen o son lentas.

En su lugar, utilice el comportamiento de actualización predeterminado donde las actualizaciones se descargan en segundo plano y se aplican cuando la aplicación se pone en segundo plano o se reinicia. Esto proporciona una experiencia más confiable para sus usuarios.

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'atBackground', // Recommended for China
      updateUrl: 'https://updater.capgo.com.cn/updates',
      statsUrl: 'https://updater.capgo.com.cn/stats',
      channelUrl: 'https://updater.capgo.com.cn/channel_self',
    },
  },
};

Caution

While our Hong Kong-based infrastructure helps minimize latency and improve reliability, network performance to mainland China can still be affected by the Great Firewall. Using background updates helps ensure updates complete successfully without disrupting the user experience.

Ejemplo de Configuración Completa

Aquí tienes un ejemplo completo con ajustes recomendados para aplicaciones desplegadas en China:

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'My App',
  webDir: 'dist',
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'atBackground', // Recommended for better reliability in China
      responseTimeout: 60, // Seconds — give China network more room
      updateUrl: 'https://updater.capgo.com.cn/updates',
      statsUrl: 'https://updater.capgo.com.cn/stats',
      channelUrl: 'https://updater.capgo.com.cn/channel_self',
    },
  },
};

export default config;

Prueba tu configuración

Después de configurar las URL específicas de China, puedes verificar que las actualizaciones funcionan correctamente:

1. Sube un nuevo paquete a Capgo:

   npx @capgo/cli@latest bundle upload --channel=production

2. Instala tu aplicación en un dispositivo de prueba en China

3. Monitorea el proceso de actualización:

   npx @capgo/cli@latest app debug

4. Verificar que las actualizaciones se están descargando desde las URL de OST de China

Nota

El comportamiento y el tiempo de actualización permanecen los mismos que con la configuración estándar Capgo. Consulte el Comportamiento de Actualización documentación para obtener detalles sobre cómo y cuándo se aplican las actualizaciones.

Implementación en varias regiones

Si su aplicación sirve a usuarios tanto dentro como fuera de China, puede utilizar la configuración de dominio chino para todos los usuarios del mundo. updater.capgo.com.cn El dominio se resuelve globalmente gracias a la infraestructura de DNS de Alibaba, lo que lo hace accesible tanto dentro de China como en cualquier otro lugar del mundo.

Usando dominios chinos en todo el mundo

Las URLs de dominio chino funcionan sin problemas para aplicaciones de múltiples regiones:

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'atBackground', // Recommended for China users
      updateUrl: 'https://updater.capgo.com.cn/updates',
      statsUrl: 'https://updater.capgo.com.cn/stats',
      channelUrl: 'https://updater.capgo.com.cn/channel_self',
    },
  },
};

Esta configuración única funcionará para:

• Usuarios en la región continental de China (utilizando infraestructura de Hong Kong)
• Usuarios fuera de China (accediendo a la misma infraestructura a través de DNS de Alibaba)

Consideraciones de rendimiento:

Mientras que el .cn dominio se resuelve globalmente a través de DNS de Alibaba y funciona en todas partes, es ligeramente menos rendidor para usuarios fuera de China en comparación con el dominio estándar (api.capgo.app), que se resuelve directamente por Cloudflare donde se hospeda nuestro backend. Sin embargo, la resolución de DNS es rápida, por lo que la diferencia de rendimiento es mínima y no afectará significativamente la experiencia del usuario.

Consejo

Usando el .cn dominio para todos los usuarios simplifica su despliegue y garantiza un comportamiento de actualización consistente en todas las regiones. No necesita compilaciones separadas ni configuraciones basadas en entornos. El pequeño trato de rendimiento fuera de China es típicamente valioso a cambio de un despliegue simplificado.

Configuraciones Alternativas: Configuraciones por Región

Si prefieres optimizar de manera diferente para cada región, también puedes considerar:

• Configurando variantes de aplicaciones separadas con diferentes configuraciones
• Crear diferentes canales de lanzamiento para diferentes regiones
• Crear diferentes canales de lanzamiento para diferentes regiones

Si necesita asistencia con estrategias de implementación de múltiples regiones, por favor contáctenos en soporte@capgo.app unirse a nosotros Configuraciones por Región ayuda.

Monitoreo de Infraestructura de China

Puede monitorear el estado de salud y el estado de los puntos finales específicos de China de Capgo. estatus.capgo.com.cnUtilice esta página para verificar incidentes, latencia y disponibilidad de las URL de OST de China antes de resolver problemas con tu aplicación.

Troubleshooting

Sección titulada “Resolución de Problemas”

1. Verifica tu configuración - Verifique que todas las tres URLs estén configuradas correctamente en su capacitor.config.ts
2. Raise responseTimeout - Utilice al menos 60 segundos en China para que el complemento no aborte mientras la solicitud de actualización sigue en tránsito
3. Verifique la conectividad de red - Asegúrese de que su dispositivo pueda acceder a updater.capgo.com.cn dominio
4. Verifique la página de estado de China - Revisar estatus.capgo.com.cn para cualquier incidente en curso o rendimiento degradado
5. Revisar registros - Utilice npx @capgo/cli@latest app debug para verificar mensajes de error
6. Actualizaciones de prueba - Prueba subiendo una nueva paquete y monitoreando el proceso de descarga
7. Contactar con soporte Si los problemas persisten, contáctenos en soporte@capgo.app únete a nosotros o unirse a nuestra comunidad de Discord

Caution

Asegúrese de utilizar el .cn domain (updater.capgo.com.cny no el dominio internacional estándar al configurar para China.

Pasos siguientes

• Aprende sobre Comportamiento de actualización para personalizar cuando se aplican las actualizaciones
• Explora Canales para gestionar diferentes pistas de lanzamiento
• Revisa Cifrado para proteger tus actualizaciones

Continúa desde el uso de Capgo en China

Si estás utilizando __CAPGO_KEEP_0__ Uso de Capgo en China Para planificar la entrega de live update, conecte con Capgo Live Updates para el flujo de trabajo del producto en Capgo Live Updates Resumen para los detalles de implementación en Resumen Características para los detalles de implementación en Características Comportamiento de actualización para los detalles de implementación en Comportamiento de Actualización, y Tipos de Actualización para los detalles de implementación en Tipos de Actualización.