Uso de 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 URLs Específicas de 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 inconfiables. Capgo proporciona URLs dedicadas de OST 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 confiable 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 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

Aquí está qué 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 de vuelta a Capgo
• URL del 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 juntas 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 plugin de actualizador de Capgo aborta las llamadas de API cuando responseTimeout se supera (el valor está en segundos). La infraestructura de borde de Edge en frente de Capgo también trata sobre 3 segundos como un presupuesto de falla para algunas rutas.

En la región continental de China, la latencia transfronteriza es a menudo más alta. Mantenga un valor más alto responseTimeout para que el complemento tenga suficiente espacio para completar las comprobaciones de actualizaciones 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 Para China, se recomienda un valor de Capgo o superior. 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.

Actualizaciones de fondo

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 el usuario sale del aplicativo o lo reinicia. Esto proporciona una experiencia más confiable para sus usuarios. autoUpdate: 'atBackground' Copiar a portapapeles

Advertencia

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

Configuración completa de ejemplo

backgroundUpdates

backgroundUpdates

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 China OST

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 Actualización documentación para obtener detalles sobre cómo y cuándo se aplican las actualizaciones.

Implementación en varias regiones

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. updater.capgo.com.cn Usar dominios chinos en todo el mundo

Sección titulada “Implementación en varias regiones”

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 de China continental (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.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 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 para la simplificación del despliegue. .cn Opción alternativa: Configuraciones específicas de región

Sección titulada “Opción alternativa: Configuraciones específicas de región”

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-región, por favor contacte con nosotros en

support@__CAPGO_KEEP_0__.app support@capgo.app Si necesita asistencia con estrategias de despliegue multi-región, por favor contacte con nosotros en support@__CAPGO_KEEP_0__.app o únete a nuestra comunidad de Discord o únete a nuestra 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 realizar el seguimiento de su aplicación.

Solución de Problemas

Si experimenta problemas con las actualizaciones en China:

1. Verifique su configuración - Verifique que las tres URL estén configuradas correctamente en su capacitor.config.ts
2. Elevar responseTimeout - Utilice al menos 60 segundos en China para que el complemento no aborte mientras la solicitud de actualización sigue en vuelo
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 estado.capgo.com.cn para cualquier incidente en curso o rendimiento degradado
5. Revisar registros - Utilice npx @capgo/cli@latest app debug para buscar mensajes de error
6. Pruebas de actualización - Intenta subir una nueva colección 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 .cn dominio (updater.capgo.com.cny no el dominio internacional estándar al configurar para China.

Pasos siguientes

• Aprende sobre Actualizar comportamiento para personalizar cuando se aplican actualizaciones
• Explora Canales para gestionar diferentes pistas de lanzamiento
• Revisa Cifrado para proteger tus actualizaciones

Sigue adelante desde el uso de Capgo en China

Si estás utilizando Usando Capgo en China para planificar la entrega de actualizaciones en vivo, conecta con Capgo Actualizaciones en vivo para el flujo de trabajo del producto en Capgo Actualizaciones en vivo, Resumen para el detalle de implementación en Resumen, Características para el detalle de implementación en Características, Comportamiento de actualización para los detalles de implementación en Update Behavior, y Tipos de Actualización para los detalles de implementación en Tipos de Actualización.