Utilisation de Capgo en Chine

Si vous déployez votre application auprès des utilisateurs en Chine, vous devrez configurer Capgo pour utiliser les URL de stockage d'objets régionaux (OST) pour vous assurer d'avoir 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 des mises à jour aussi rapidement et aussi fiablement que possible.

Configuration

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

1. Ouvrez votre capacitor.config.ts fichier

2. Ajoutez la configuration suivante à la section CapacitorUpdater 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. Rebâtissez votre application pour appliquer les modifications :

   npm run build
   npx cap sync

Détails de la configuration

Voici ce que fait chaque URL :

• miseÀJourUrl: 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 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é du Capgo metteur à jour en Chine.

Réglages 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 :

Utilisez les Mises à Jour en Arrière-plan

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 de Chine. L'utilisation des 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
      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;

Tester 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 sur 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 de OST de Chine

Note

Le comportement et la fréquence des mises à jour restent les mêmes que dans la configuration standard de Capgo. Consultez la Comportement de mise à jour documentation pour plus d'informations sur la manière et le moment où les mises à jour sont appliquées.

Déploiement dans plusieurs régions

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

The URLs de domaine 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 seule configuration fonctionnera pour :

• Les utilisateurs de la Chine continentale (utilisant une infrastructure basée à Hong Kong)
• Les utilisateurs hors de Chine (accédant à la même infrastructure via DNS Alibaba)

Considérations de performance :

Alors que le .cn domaine est 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

Utilisation du .cn Le domaine pour tous les utilisateurs simplifie vos déploiements 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 compromis en matière de performance en dehors de la Chine vaut généralement la simplification du déploiement.

Configuration alternative : Configurations spécifiques à la région

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_KEEP_0__.app support@capgo.app communauté Discord pour obtenir de l'aide. Si vous avez besoin d'assistance pour les stratégies de déploiement multi-région, veuillez nous contacter à support@__CAPGO_KEEP_0__.app ou rejoignez notre communauté Discord pour obtenir de l'aide.

Résolution de 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 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. Examinez les journaux - Utilisez npx @capgo/cli@latest app debug pour vérifier les messages d'erreur
4. Testez les mises à jour - Essayez de télécharger 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 .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 Mise à jour du comportement pour personnaliser l'application des mises à jour
• Découvrez Canaux pour gérer différents itinéraires de publication
• Vérifiez Chiffrement pour sécuriser vos mises à jour

Continuez à partir de l'utilisation de 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, Vue d'ensemble pour les détails d'implémentation dans Vue d'ensemble, Caractéristiques pour les détails d'implémentation dans Caractéristiques, Comportement de mise à jour pour les détails d'implémentation dans Comportement de mise à jour, et Mises à jour de type pour le détail d'implémentation dans Mises à jour de type.