Utiliser Capgo en Chine

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

Pourquoi utiliser des 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 peu fiables. Capgo fournit des 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 les mises à jour aussi rapidement et aussi fiablement que possible.

Configuration

Pour configurer 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 section plugin : CapacitorUpdater Copier dans le presse-papiers

   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. Fenêtre de terminal

   npm run build
   npx cap sync

Détails de la configuration

Voici ce que chaque URL fait :

• 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 transmettre des statistiques d'utilisation et d'analytique à 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 URLs doivent être configurées ensemble pour garantir la pleine fonctionnalité du Capgo metteur à jour en Chine.

Réglages recommandés pour la Chine

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

Utiliser les mises à jour en arrière-plan

Nous recommandons fortement d'utiliser autoUpdate: 'atBackground' pour les applications en Chine. La connectivité réseau en Chine est moins performante que dans d'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 ralentis.

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

Avertissement

While notre infrastructure basée à Hong Kong aide à minimiser la latence et à améliorer la fiabilité, la performance du réseau vers la Chine continentale peut encore être affectée par le Grand Mur chinois. L'utilisation d'actualisations 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 complet

Copier dans le presse-papier

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;

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

Fenêtre de terminal

1. Upload a new bundle to Capgo:

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

2. Vérifier que les mises à jour fonctionnent correctement

3. Suivre 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 de l'OST de Chine

Remarque

Le comportement et la fréquence d'actualisation restent les mêmes que dans la configuration standard Capgo . Consultez la Comportement d'actualisation documentation pour plus d'informations sur la manière 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 chinoise pour tous les utilisateurs dans le monde. Le updater.capgo.com.cn Le domaine est résolu globalement grâce à l'infrastructure DNS d'Alibaba, ce qui le rend accessible à la fois à l'intérieur de la Chine et dans le monde entier.

Utilisation de domaines chinois à l'échelle mondiale

Les URLs de domaines chinois fonctionnent de manière fluide 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 seule configuration fonctionnera pour :

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

Considérations relatives à la performance :

Bien que .cn le domaine soit résolu globalement par Alibaba DNS et fonctionne partout, 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

En utilisant le .cn domaine pour tous les utilisateurs simplifie votre déploiement et assure 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 coût de performance en dehors de la Chine est généralement digne de la simplification du déploiement.

Alternative: Configurations Région-Spécifiques

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

• La construction de variants d'applications séparés avec des configurations différentes
• L'utilisation d'une configuration basée sur l'environnement pour définir dynamiquement les URL
• La création de différents canaux de mise à jour pour différentes régions

Si vous avez besoin d'assistance 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.

Solutions de dépannage

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 configurées dans votre capacitor.config.ts
2. Vérifiez la connectivité réseau - Assurez-vous que votre appareil peut atteindre le updater.capgo.com.cn domaine
3. Vérifiez les journaux - Utilisez npx @capgo/cli@latest app debug pour vérifier les messages d'erreur
4. Test de mise à 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, nous vous invitons à nous contacter à support@capgo.app ou rejoignez notre communauté Discord pour obtenir de l'aide

Attention

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

Section intitulée « Étapes suivantes »

• Comportement de mise à jour pour personnaliser l'application des mises à jour Découvrez
• Canaux pour gérer les différents circuits de publication Révision
• __CAPGO_KEEP_0__ Chiffrement pour sécuriser vos mises à jour

Continuez à utiliser Capgo en Chine

Si vous utilisez Utilisation de Capgo en Chine pour planifier la livraison d'actualisations en direct, connectez-le à Capgo Mises à jour en direct pour le flux de travail du produit dans Capgo Mises à jour en direct, Présentation pour les détails d'implémentation dans Présentation, Caractéristiques pour les détails d'implémentation dans Features, Comportement de mise à jour pour les détails d'implémentation dans Comportement de mise à jour, et Types de mise à jour pour les détails d'implémentation dans Types de mise à jour.