Usando Capgo en China

Si estás desplegando tu aplicación a usuarios en China, necesitarás configurar Capgo para utilizar URLs de almacenamiento de objetos regionales para asegurar actualizaciones fiables y rápidas.

¿Por qué usar 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 poco fiables. Capgo proporciona URLs de OST dedicadas con datos ubicados en Hong Kong para minimizar la latencia y asegurarse de que sus usuarios reciben 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 de 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

Detalles de configuración

Esto es lo que cada URL hace:

• 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 obtener la configuración del canal y determinar qué actualizaciones aplicar

Consejo

Todas las tres URLs 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 aplicaciones desplegadas en la región continental de China:

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 provocar 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

While nuestra infraestructura basada 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. El uso de actualizaciones de fondo ayuda a asegurarse de que las actualizaciones se completen con éxito sin interrumpir la experiencia del usuario.

Configuración Completa

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 tu Configuración

Después de configurar las URL específicas de China, puedes verificar que las actualizaciones funcionan correctamente:

1. Subir 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. Monitore el proceso de actualización:

   npx @capgo/cli@latest app debug

4. Verificar que las actualizaciones se están descargando desde las URLs de OST de China

Nota

El comportamiento y la sincronización de actualizaciones 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.

Diseño de 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 gracias a la infraestructura de DNS de Alibaba, el dominio se resuelve globalmente, lo que lo hace accesible tanto dentro de China como en cualquier otro lugar del mundo.

Usar dominios chinos globalmente.

Las URLs de dominios chinos funcionan de manera fluida 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 la infraestructura de 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 cualquier lugar, 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

Al utilizar el .cn dominio para todos los usuarios simplifica su despliegue y garantiza un comportamiento de actualización consistente en todas las regiones. No necesita crear compilaciones separadas o configuraciones basadas en entornos. El pequeño trato de rendimiento fuera de China es típicamente merecedor de la simplificación del despliegue.

Opción alternativa: Configuraciones regionales

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

• Crear variantes de aplicación separadas con diferentes configuraciones
• Usar configuraciones basadas en entornos 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 soporte@capgo.app o únete a nuestra comunidad de Discord para obtener ayuda. Sección titulada “Solución de problemas”

Si experimentas problemas con las actualizaciones en China:

- Revisa que las tres URLs estén configuradas correctamente en tu

1. Verifica la conectividad de red - Asegúrate de que tu dispositivo pueda acceder a capacitor.config.ts
2. dominio Revisa los registros updater.capgo.com.cn for help.
3. Section titled “Troubleshooting” - Utilice npx @capgo/cli@latest app debug para verificar mensajes de error
4. Actualizaciones de prueba - Intente subir una nueva paquete y monitorear el proceso de descarga
5. Contactar con soporte - Si los problemas persisten, comuníquese con nosotros en support@capgo.app o únase a nuestra comunidad de Discord para obtener asistencia

Advertencia

Asegúrese de utilizar el dominio ( .cn ) y no el dominio internacional estándar cuando se configura para China.updater.capgo.com.cnPasos siguientes

Sección titulada “Paso a paso”

• Comportamiento de actualización para personalizar cuando se aplican actualizaciones Explora
• Canales para gestionar diferentes pistas de lanzamiento Revisa
• __CAPGO_KEEP_0__ 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 los detalles de implementación en Características, Actualizar Comportamiento para los detalles de implementación en Actualizar Comportamiento, y Tipos de Actualización para los detalles de implementación en Tipos de Actualización.