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.

¿Por qué utilizar 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 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 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 Hong Kong de Capgo.

1. Abra su capacitor.config.ts archivo

2. Agregue la siguiente configuración al CapacitorUpdater sección de plugins:

   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. Reconstruye tu 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 tu aplicación
• statsUrl: https://updater.capgo.com.cn/stats - Se utiliza para enviar 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, hemos recomendaciones específicas para aplicaciones desplegadas en la región continental de China:

Usar Actualizaciones de Fondo

Nosotros recomendamos fuertemente el uso de autoUpdate: 'atBackground' For 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 provocar una mala experiencia del usuario si se interrumpen o ralentizan las descargas.

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 que nuestra infraestructura en Hong Kong ayuda a minimizar la latencia y mejorar la confiabilidad, el rendimiento de la red hacia la China continental todavía puede verse afectado por el Gran Muro de China. Utilizar actualizaciones de fondo ayuda a asegurarse de que las actualizaciones se completen con éxito sin interrumpir la experiencia del usuario.

Configuración Completa Ejemplo

¡Aquí hay 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
      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 de tu configuración

Después de configurar las URLs específicas de China, puede verificar que las actualizaciones están funcionando correctamente:

1. Subir un nuevo paquete a Capgo:

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

2. Instalar su aplicación en un dispositivo de prueba en China

3. Monitorear el proceso de actualización:

   npx @capgo/cli@latest app debug

4. Verificar que las actualizaciones están siendo descargadas desde las URLs OST de China

Nota

El comportamiento y el tiempo de actualización siguen siendo los mismos que con la configuración estándar de Capgo. Consulte la Actualizar Comportamiento 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. El updater.capgo.com.cn __CAPGO_KEEP_0__

Dominios chinos en todo el mundo

Las URLs de dominios chinos funcionan sin problemas para aplicaciones de varias 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 el .cn dominio se resuelve globalmente a través de DNS de Alibaba y funciona en todas partes, es ligeramente menos rendidor para los 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

Usar 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 o configuraciones basadas en entornos. El pequeño trato de rendimiento fuera de China es típicamente valioso para la simplificación del despliegue.

Opción alternativa: Configuraciones específicas de región

Si prefiere optimizar de manera diferente para cada región, también puede considerar:

• Crear variantes de aplicaciones separadas con diferentes configuraciones
• Usando 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 de múltiples regiones, por favor contacte con nosotros en support@capgo.app o únete a nuestra comunidad de Discord para obtener ayuda. Solución de problemas

Sección titulada “Solución de problemas”

Verifique su configuración

1. Si experimenta problemas con actualizaciones en China: Verifique su configuración - Verifique que todos los tres URLs estén configurados correctamente en su capacitor.config.ts
2. Verifique la conectividad de red - Asegúrese de que su dispositivo pueda alcanzar el updater.capgo.com.cn dominio
3. Revisar registros - Utilice npx @capgo/cli@latest app debug para buscar mensajes de error
4. Prueba actualizaciones - Intente subir un nuevo paquete y monitorear el proceso de descarga
5. Contactar con soporte - Si los problemas persisten, póngase en contacto con nosotros en soporte@capgo.app o únete a nuestra comunidad de Discord para obtener asistencia Advertencia

Asegúrate de utilizar el dominio (

) y no el dominio internacional estándar cuando configures para China. .cn Pasos siguientesupdater.capgo.com.cnSección titulada “Pasos siguientes”

Aprende sobre

• Aprende sobre cómo actualizar Aprende sobre cómo actualizar para personalizar cuando se aplican las actualizaciones
• Explora Canales para gestionar diferentes pistas de lanzamiento
• Revisar Cifrado para proteger tus actualizaciones

Sigue adelante desde el uso de Capgo en China

Si estás utilizando Usando Capgo en China para planificar el envío de actualizaciones en vivo, conectarlo 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 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.