Utiliser Capgo en Chine

Si vous déployez votre application auprès des utilisateurs en Chine, vous devrez configurer Capgo pour utiliser les adresses URL régionales OST (Object Storage Technology) afin d'assurer des mises à jour fiables et rapides.

Pourquoi Utiliser des Adresses URL Spécifiques à la Chine ?

En raison de l'infrastructure réseau et des réglementations en Chine (le Grand Mur Chinois), les connexions directes vers les serveurs internationaux peuvent être lentes ou peu fiables. Capgo fournit des adresses URL OST 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 Capgo pour la Chine, vous devez définir trois adresses URL spécifiques dans votre fichier de configuration Capacitor. Ces adresses URL pointent vers l'infrastructure de Capgo basée à Hong Kong.

1. Ouvrez votre capacitor.config.ts fichier

2. Ajoutez la configuration suivante à la section plugin : CapacitorUpdater Copiez dans le presse-papier

   import { CapacitorConfig } from '@capacitor/cli';
   
   const config: CapacitorConfig = {
     plugins: {
       CapacitorUpdater: {
         autoUpdate: true,
         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. Reconstruirez votre application pour appliquer les modifications :

   npm run build
   npx cap sync

Détails de la configuration

Voici ce que chaque URL fait :

• __CAPGO_KEEP_0__: https://updater.capgo.com.cn/updates - Utilisé pour vérifier et télécharger les mises à jour disponibles pour votre application
• - Utilisé pour transmettre des statistiques d'utilisation et d'analytique à __CAPGO_KEEP_0__: https://updater.capgo.com.cn/stats - Used to report analytics and usage statistics back to Capgo
• URL de mise à jour: https://updater.capgo.com.cn/channel_self - Utilisé pour vérifier et télécharger les mises à jour disponibles pour votre application

Conseil

Tous les trois URLs doivent être configurés ensemble pour garantir la pleine fonctionnalité de l'Capgo metteur à jour en Chine.

Réglages recommandés pour la Chine

En raison des limitations de performance 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 :

Désactiver les Mises à jour Directes

Nous recommandons fortement de désactiver directUpdate les mises à jour directes pour les applications en Chine. La connectivité réseau en Chine est moins performante que dans les autres régions, et les mises à jour directes (qui s'appliquent immédiatement) 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: true,
      directUpdate: false, // 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

Bien que notre infrastructure basée à Hong Kong aide à minimiser les latences et à améliorer la fiabilité, les performances réseau vers la Chine continentale peuvent encore être affectées par le Grand Mur chinois. La désactivation directUpdate s'assure que les mises à jour se terminent avec succès sans perturber l'expérience utilisateur.

Exemple de configuration complet

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: true,
      directUpdate: false, // Recommended: disable 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;

Testez 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échargez un nouveau bundle vers Capgo:

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

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

3. Surveillez le processus d'actualisation :

   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 d'actualisation restent les mêmes que dans une configuration standard de Capgo. Consultez la Comportement d'actualisation la documentation pour plus de détails sur la façon et le moment où les mises à jour sont appliquées.

Déploiement Multi-Région

Si votre application sert des utilisateurs à la fois à l'intérieur et à l'extérieur de la Chine, vous pouvez utiliser la configuration de domaine chinois pour tous les utilisateurs dans le monde. Le updater.capgo.com.cn domaine est résolu à l'échelle mondiale grâce à l'infrastructure DNS d'Alibaba, ce qui le rend accessible à la fois à l'intérieur de la Chine et dans le reste du monde.

Utilisation de Domaines Chinois à l'Échelle Mondiale

Les URL de domaines chinois fonctionnent de manière fluide pour les applications multi-région :

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: false, // 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 seule configuration fonctionnera pour :

• Utilisateurs en Chine continentale (en utilisant une infrastructure basée à Hong Kong)
• Utilisateurs à l'extérieur de la Chine (accédant à la même infrastructure via l'infrastructure DNS d'Alibaba)

Considérations relatives à la performance :

Bien que le domaine soit résolu globalement par Alibaba DNS et fonctionne partout, il est légèrement moins performant pour les utilisateurs en dehors de la Chine par rapport au domaine standard ( .cn ), qui est résolu directement par __CAPGO_KEEP_0__ 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.api.capgo.app), which is resolved directly by Cloudflare where our backend is hosted. However, DNS resolution is fast, so the performance difference is minimal and won’t significantly impact the user experience.

Utilisation du domaine pour tous les utilisateurs simplifie votre déploiement et garantit un comportement d'actualisation cohérent dans toutes les régions. Vous n'avez pas besoin de builds séparés ou de configurations basées sur l'environnement. Le petit avantage de performance en dehors de la Chine est généralement digne de la simplification du déploiement.

Alternative : Configurations spécifiques à la région .cn Section intitulée « Alternative : Configurations spécifiques à la région »

Si vous préférez optimiser différemment pour chaque région, vous pouvez également considérer :

Considérations relatives à la performance :

• Bien que le domaine soit résolu globalement par Alibaba DNS et fonctionne partout, il est légèrement moins performant pour les utilisateurs en dehors de la Chine par rapport au domaine standard (
• 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 ou rejoignez notre communauté Discord pour obtenir de l'aide.

Résolution des problèmes

Si vous rencontrez des problèmes avec les mises à jour en Chine :

1. Vérifiez votre configuration - Vérifiez que les trois URL sont correctement définies dans votre configuration capacitor.config.ts
2. Vérifiez la connectivité réseau - Assurez-vous que votre appareil puisse atteindre le updater.capgo.com.cn domaine
3. Examinez les journaux - Utilisez npx @capgo/cli@latest app debug pour vérifier les messages d'erreur
4. Testez les mises à jour - Essayez d'uploader un nouveau bundle et de surveiller le processus de téléchargement
5. Contactez le support - Si les problèmes persistent, contactez-nous à support@capgo.app ou rejoignez notre Communauté Discord pour obtenir de l'aide

Attention

Assurez-vous d'utiliser le .cn domaine (updater.capgo.com.cn) et non le domaine international standard lors de la configuration pour la Chine.

Étapes suivantes

• En savoir plus sur Comportement de mise à jour pour personnaliser l'application des mises à jour
• Découvrez Canaux pour gérer différentes pistes de version
• Vérifier Chiffrement pour sécuriser vos mises à jour