Usar 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é usar URLs específicas de China?

Debido a la infraestructura de red y las regulaciones en China (el Gran Muro), 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 garantizar 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. 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

Sección titulada “Detalles de configuración”

updateUrl

• - Se utiliza para verificar y descargar actualizaciones disponibles para su aplicación: https://updater.capgo.com.cn/updates updateUrl
• statsUrl: https://updater.capgo.com.cn/stats - Se utiliza para enviar estadísticas de análisis y uso de vuelta 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 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, hemos recomendaciones específicas para las aplicaciones desplegadas en la región continental de China:

Usar Actualizaciones de Fondo

Recomendamos fuertemente 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 se interrumpen o se 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

Aunque nuestra infraestructura en Hong Kong ayuda a minimizar la latencia y mejorar la confiabilidad, la velocidad de la red hacia la China continental puede verse afectada por el Gran Muro de China. Utilizar actualizaciones de fondo ayuda a garantizar que las actualizaciones se completen con éxito sin interrumpir la experiencia del usuario.

Ejemplo de configuración completo

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 están funcionando 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. Verifica que las actualizaciones están siendo descargadas desde las URL OST de China

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 Múltiples Regionales

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 Uso de Dominios Chinos a Nivel Global

Sección titulada “Uso de Dominios Chinos a Nivel Global”

Copiar a portapapeles

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

This single configuration will work for:

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

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

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

Sección titulada “Solución de problemas”

If you experience issues with updates in China: __CAPGO_KEEP_0__

1. Verifica tu configuración - Revisa que los tres URLs estén configurados correctamente en tu capacitor.config.ts
2. Verifica la conectividad de red - Asegúrate de que tu dispositivo pueda acceder a updater.capgo.com.cn dominio
3. Revisa los registros - Utiliza npx @capgo/cli@latest app debug para buscar mensajes de error
4. Prueba las actualizaciones - Intenta subir un nuevo paquete y monitorea el proceso de descarga
5. Contacta con el soporte - Si persisten los problemas, contacte con nosotros en support@capgo.app o únase a nuestra comunidad de Discord para obtener asistencia

Cuidado

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

Pasos siguientes

• Aprende sobre Actualizar comportamiento para personalizar cuándo se aplican las 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, 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.