Uso de Capgo en China

Si está desplegando su aplicación a usuarios en China, necesitará configurar Capgo para utilizar URLs de OST regionales (Object Storage Technology) 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 de China), las conexiones directas a servidores internacionales pueden ser lentas o inestables. 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 fiable 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 sección del plugin: CapacitorUpdater Copiar a portapapeles

   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. Ventana de terminal

   npm run build
   npx cap sync

Sección titulada “Detalles de configuración”

updateUrl

• - Se utiliza para verificar y descargar actualizaciones disponibles para su aplicación: https://updater.capgo.com.cn/updates plugin
• URL de estadísticas: https://updater.capgo.com.cn/stats - Se utiliza para informar estadísticas de análisis y uso a Capgo
• URL de canal: 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 las aplicaciones desplegadas en la región continental de China:

Aumentar el Tiempo de Respuesta de API

El plugin de actualización Capgo aborta las API llamadas cuando responseTimeout se supera (el valor está en segundos). La infraestructura de Edge frente a Capgo también considera sobre 3 segundos como un presupuesto de fracaso para algunas rutas.

En la China continental, la latencia transfronteriza es a menudo más alta. Mantenga un valor más alto responseTimeout para que el plugin tenga suficiente espacio para completar las comprobaciones de actualización y descargas a través de 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 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 dé por vencido mientras la solicitud puede aún tener éxito en el lado de Capgo.

Usar Actualizaciones de Fondo

Nosotros recomendamos fuertemente el uso de 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 dar lugar a 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',
    },
  },
};

Advertencia

Mientras nuestra infraestructura en Hong Kong ayuda a minimizar la latencia y mejorar la confiabilidad, el rendimiento de la red hacia la China continental puede verse afectado por el Gran Muro. El uso de actualizaciones de fondo ayuda a asegurarse de que las actualizaciones se completen con éxito sin interrumpir la experiencia del usuario.

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 direcciones URL de OST de China

Nota

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

Despliegue 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. El updater.capgo.com.cn 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 a nivel global

Las URLs de dominios chinos 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 basada en 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 El 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 prefiere optimizar de manera diferente para cada región, también puede considerar:

• Crear variantes de aplicación separadas con diferentes configuraciones
• Usar configuración basada en entorno para establecer dinámicamente las URL
• Crear diferentes canales de lanzamiento para diferentes regiones

Si necesita asistencia con estrategias de despliegue multi-regional, por favor contacte con nosotros en support@capgo.app o únete a nuestro Comunidad de Discord para obtener 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 en status.capgo.com.cn. Utilice esta página para verificar incidentes, latencia y disponibilidad de las URL de OST de China antes de resolver problemas con su aplicación.

Resolución de Problemas

Si experimenta problemas con actualizaciones en China:

1. Verifique su configuración - Verifique que las tres URL estén configuradas correctamente en su capacitor.config.ts
2. Aumentar 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. Verificar la conectividad de red - Asegúrese de que su dispositivo pueda acceder a updater.capgo.com.cn dominio
4. Verificar la página de estado de China - Revisar estado.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 - Intenta subir una nueva paquete y monitorea el proceso de descarga
7. Contactar con soporte - Si los problemas persisten, ponte en contacto con nosotros en support@capgo.app o únete a nuestra comunidad de Discord para obtener asistencia Advertencia

Asegúrate de utilizar el

Contactar con soporte .cn dominio (updater.capgo.com.cn) y no el dominio internacional estándar al configurar para China.

Próximos Pasos

• Aprende sobre Comportamiento de Actualización para personalizar cuando se aplican actualizaciones
• Explora Canal para gestionar diferentes pistas de lanzamiento
• Revisa Encriptación para asegurar tus actualizaciones

Sigue adelante desde el uso de Capgo en China

Si estás utilizando Uso de Capgo en China para planificar la entrega de actualizaciones en vivo, conecta con Actualizaciones en vivo de Capgo for the product workflow in Capgo Live Updates, para el flujo de trabajo del producto en Actualizaciones en vivo de __CAPGO_KEEP_0__ Resumen para el detalle de implementación en Resumen Características Comportamiento de Actualización para el detalle de implementación en Comportamiento de Actualización, y Tipos de Actualización para el detalle de implementación en Tipos de Actualización.