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 asegurar actualizaciones fiables y rápidas.

Preguntas frecuentes sobre China-Specific URLs

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 inseguras. Capgo proporciona URLs de OST dedicadas con datos ubicados en Hong Kong para minimizar la latencia y asegurar que sus usuarios reciben 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. Agregar la siguiente configuración a la sección de plugin: CapacitorUpdater plugin sección:

   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á lo que cada URL hace:

• updateUrl: https://updater.capgo.com.cn/updates - Se utiliza para verificar y descargar actualizaciones disponibles para su aplicación
• URL de estadísticas: https://updater.capgo.com.cn/stats - Se utiliza para informar estadísticas de análisis y uso 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 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, hemos 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 segundos como un presupuesto de fracaso 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 plugin 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 (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 llevar a una mala experiencia del usuario si las descargas se interrumpen o son lentas.

En su lugar, use 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 tus 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. Usar 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 configuraciones recomendadas 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 momento de la actualización siguen siendo los mismos que con la configuración estándar 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 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 de múltiples regiones, 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

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 status.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 context: Página/área: sitio web de marketing de Capgo. Rol: etiqueta de IU corta o elemento de navegación. Visto en: componente pricing/Faq.astro. Mensaje clave `contact_support` (Contactar con soporte). support@capgo.app support@__CAPGO_KEEP_0__.app o únete a nuestra comunidad de Discord para obtener asistencia

Cuidado

Asegúrate de utilizar el .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 Canales 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.