Uso de Capgo en China

Si estás desplegando tu aplicación para usuarios en China, necesitarás configurar Capgo para utilizar URLs de OST regionales (Object Storage Technology) para asegurar actualizaciones fiables y rápidas.

Preguntas frecuentes sobre China-Specific URLs

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

Configuración

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

1. Abre tu capacitor.config.ts archivo

2. Agregue la siguiente configuración a la sección CapacitorUpdater 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 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 plugin de actualización Capgo aborta las API cuando responseTimeout se excede (el valor está en segundos). La infraestructura de Edge frente a Capgo también considera sobre 3 segundos como un presupuesto de fallas para algunas rutas.

In la China continental, la latencia transfronteriza es a menudo más alta. Mantenga un valor más alto para que el plugin tenga suficiente espacio para completar las comprobaciones de actualizaciones y descargas a través de responseTimeout en lugar de fallar temprano: updater.capgo.com.cn Copiar a portapapeles

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',
    },
  },
};

Presupuesto de fallas

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 utilizar autoUpdate: 'atBackground' para las 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 llevar 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. Utilizar 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

Notas

El comportamiento y el momento de la actualización siguen siendo los mismos que con la configuración estándar de Capgo. Consulte la Documentación de actualizaciones 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 .cn el 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.appque se resuelve directamente por Cloudflare donde se encuentra 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 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 la 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 en su aplicación.

Resolución de Problemas

Verifique su configuración

1. - Verifique que las tres URL estén configuradas correctamente en su Comunidad de Discord para obtener ayuda. Si experimenta problemas con actualizaciones en China, verifique su configuración. Puede monitorear el estado de salud y el estado de los puntos finales específicos de China de __CAPGO_KEEP_0__ en status.__CAPGO_KEEP_0__.com.cn. Utilice esta página para verificar incidentes, latencia y disponibilidad de las URL de OST de China antes de resolver problemas en su aplicación. Para resolver problemas, 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 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 - 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 Cuidado

Asegúrate de utilizar el

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 las actualizaciones
• Explora Canal para gestionar diferentes pistas de lanzamiento
• Revisa Cifrado 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 Capgo Actualizaciones en vivo for the product workflow in Capgo Live Updates, para el flujo de trabajo del producto en __CAPGO_KEEP_0__ Actualizaciones en vivo, 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.