Utilisation de Capgo en Chine

Si vous déployez votre application auprès des utilisateurs en Chine, vous devrez configurer le Capgo pour utiliser les URL de stockage d'objets régionaux (OST) afin d'assurer des mises à jour fiables et rapides.

Pourquoi Utiliser les URL Spécifiques à la Chine ?

En raison de l'infrastructure réseau et des réglementations en Chine (le Grand Mur), les connexions directes vers les serveurs internationaux peuvent être lentes ou non fiables. Le Capgo fournit des URL de stockage d'objets dédiées avec des données situées à Hong Kong pour minimiser la latence et vous assurer que vos utilisateurs reçoivent des mises à jour aussi rapidement et aussi fiablement que possible.

Configuration

Pour configurer le Capgo en Chine, vous devez définir trois URL spécifiques dans votre fichier de configuration Capacitor. Ces URL pointent vers l'infrastructure de Capgo basée à Hong Kong.

1. Ouvrez votre capacitor.config.ts fichier

2. Ajoutez la configuration suivante à la CapacitorUpdater section 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. Rebuild your app to apply the changes:

   npm run build
   npx cap sync

Détails de la configuration

Voici ce que fait chaque URL :

• updateUrl: https://updater.capgo.com.cn/updates - Utilisé pour vérifier et télécharger les mises à jour disponibles pour votre application
• statsUrl: https://updater.capgo.com.cn/stats - Utilisé pour signaler les statistiques d'analyse et d'utilisation vers Capgo
• channelUrl: https://updater.capgo.com.cn/channel_self Utilisé pour récupérer la configuration du canal et déterminer les mises à jour à appliquer.

Conseil

Toutes les trois URL doivent être configurées ensemble pour garantir la pleine fonctionnalité de l'actualiseur Capgo en Chine.

Paramètres recommandés pour la Chine

En raison des limitations de performances réseau causées par le Grand Mur de Chine, nous avons des recommandations spécifiques pour les applications déployées en Chine continentale :

Augmenter le temps de réponse de API

Le plugin de mise à jour Capgo interrompt les appels API lorsque responseTimeout est dépassé (la valeur est en) secondes). L'infrastructure Edge en avant de Capgo traite également environ secondes comme un budget de failure pour certaines routes.

Dans la Chine continentale, la latence transfrontalière est souvent plus élevée. Gardez un niveau responseTimeout L'extension a suffisamment d'espace pour terminer les vérifications et les téléchargements d'actualisations. updater.capgo.com.cn au lieu de failir tôt :

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

Conseil

Préférez responseTimeout: 60 (ou supérieur) pour les déploiements en Chine. Un temps d'attente bas ne fait pas les mises à jour plus rapides — il ne fait que faire abandonner le plugin pendant que la requête peut toujours réussir du côté de Capgo.

Mise à jour de fond d'écran

Nous nous recommandons vivement d'utiliser autoUpdate: 'atBackground' pour les applications en Chine. La connectivité réseau en Chine est moins performante que dans les autres régions, et les modes d'application instantanés peuvent entraîner une mauvaise expérience utilisateur si les téléchargements sont interrompus ou lents.

Au lieu de cela, utilisez le comportement de mise à jour par défaut où les mises à jour téléchargent en arrière-plan et s'appliquent lorsque l'application est en arrière-plan ou redémarre. Cela fournit une expérience plus fiable pour vos utilisateurs.

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

Attention

Même si notre infrastructure basée à Hong Kong aide à minimiser la latence et à améliorer la fiabilité, la performance réseau vers la Chine continentale peut encore être affectée par le Grand Mur Chinois. L'utilisation de mises à jour en arrière-plan aide à s'assurer que les mises à jour se terminent avec succès sans perturber l'expérience utilisateur.

Exemple de configuration complète

Voici un exemple complet avec les paramètres recommandés pour les applications déployées en Chine :

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;

Vérification de votre configuration

Après avoir configuré les URL spécifiques à la Chine, vous pouvez vérifier que les mises à jour fonctionnent correctement.

1. Télécharger un nouveau bundle dans Capgo :

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

2. Installer votre application sur un appareil de test en Chine

3. Surveiller le processus de mise à jour :

   npx @capgo/cli@latest app debug

4. Vérifiez que les mises à jour sont téléchargées à partir des URL OST de Chine.

Remarque

Le comportement et la fréquence de mise à jour restent les mêmes que pour une configuration standard Capgo. Consultez le Mise à jour Documentation pour plus de détails sur la mise à jour et son application.

Déploiement dans plusieurs régions

If your app serves users both inside and outside China, you can use the Chinese domain configuration for all users worldwide. The updater.capgo.com.cn Le domaine est résolu à l'échelle mondiale grâce à l'infrastructure DNS d'Alibaba, ce qui le rend accessible à la fois en Chine et dans le reste du monde.

Utilisation de domaines chinois à l'échelle mondiale

Les URL des domaines chinois fonctionnent sans heurt pour les applications multi-région :

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

Cette configuration unique fonctionnera pour :

• Utilisateurs en Chine continentale (utilisant des infrastructures basées à Hong Kong)
• Les utilisateurs en dehors de la Chine (accédant à la même infrastructure via DNS Alibaba)

Considérations de performance :

Même si le .cn Le domaine est résolu globalement par Alibaba DNS et fonctionne partout, mais il est légèrement moins performant pour les utilisateurs hors de Chine par rapport au domaine standard.api.capgo.app), qui est résolu directement par Cloudflare où notre backend est hébergé. Cependant, la résolution DNS est rapide, donc la différence de performance est minime et ne nuira pas significativement à l'expérience utilisateur.

Conseil

Utiliser le .cn domain for all users simplifies your deployment and ensures consistent update behavior across all regions. You don’t need separate builds or environment-based configurations. The small performance trade-off outside China is typically worth the simplified deployment.

Configurations région-spécifiques

Utiliser une configuration basée sur l'environnement pour définir dynamiquement les URL

• Créer différents canaux de mise à jour pour différentes régions
• Utiliser la configuration basée sur l'environnement pour définir dynamiquement les URL
• Créer différents canaux de mise à jour pour différentes régions

Si vous avez besoin d'aide pour les stratégies de déploiement multi-région, veuillez nous contacter à support@capgo.app rejoignez-nous Communauté Discord pour de l'aide.

Surveillance de l'infrastructure de Chine

Vous pouvez surveiller l'état de santé et le statut des points d'entrée spécifiques à la Chine de Capgo à status.capgo.com.cnVérifiez les incidents, les latences et les temps d'arrêt des URL OST de Chine avant de résoudre les problèmes de votre application.

Troubleshooting

Section intitulée « Résolution des problèmes »

1. Vérifiez votre configuration - Vérifiez que les trois URL sont correctement configurées dans votre capacitor.config.ts
2. Raise responseTimeout - Utilisez au moins 60 Les secondes en Chine afin que le plugin ne se bloque pas tant que la demande d'actualisation est toujours en cours.
3. Vérifiez la connectivité réseau - Assurez-vous que votre appareil peut atteindre le updater.capgo.com.cn domaine
4. Vérifiez la page de statut de Chine - Examinez statut.capgo.com.cn pour toute incident en cours ou une performance dégradée
5. Review logs - Utilisez npx @capgo/cli@latest app debug pour vérifier les messages d'erreur
6. Vérifiez les mises à jour - Essayez d'uploader un nouveau bundle et de surveiller le processus de téléchargement
7. - Contactez le support - Si les problèmes persistent, contactez-nous à support@capgo.app rejoignez-nous ou rejoignez notre communauté Discord

Caution

Assurez-vous d'utiliser le .cn domain (updater.capgo.com.cnet pas le domaine international standard lors de la configuration pour la Chine.

Étapes suivantes

• Apprenez-en plus Comportement de mise à jour pour personnaliser l'application des mises à jour
• Explorez Canaux pour gérer différents itinéraires de publication
• Réviser Chiffrement pour sécuriser vos mises à jour

Continuez de là depuis l'utilisation de Capgo en Chine

Si vous utilisez __CAPGO_KEEP_0__ L'utilisation de Capgo en Chine pour planifier la livraison de live update, connectez-l’à Capgo Mises à jour en direct for the product workflow in Capgo Live Updates, Overview pour les détails d'implémentation dans Vue d'ensemble. Features pour les détails d'implémentation dans les fonctionnalités, Mise à jour pour les détails d'implémentation dans le comportement de mise à jour. Types de mise à jour pour les détails d'implémentation dans les types d'actualisation.