Utilisation de Capgo en Chine

If you’re deploying your app to users in China, you’ll need to configure Capgo to use regional OST (Object Storage Technology) URLs to ensure reliable and fast updates.

translations

Due to network infrastructure and regulations in China (the Great Firewall), direct connections to international servers can be slow or unreliable. Capgo provides dedicated OST URLs with data located in Hong Kong to minimize latency and ensure your users receive updates as quickly and reliably as possible.

translations

To configure Capgo for China, you need to set three specific URLs in your Capacitor configuration file. These URLs point to Capgo’s Hong Kong-based infrastructure.

1. translations capacitor.config.ts fichier

2. Ajoutez la configuration suivante à la section : CapacitorUpdater section du 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 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 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

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

Utiliser les mises à jour en arrière-plan

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

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 d'actualisation 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 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

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;

Vérifiez 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 sur 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 la Chine

Note

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

Déploiement dans plusieurs régions

Utilisation de domaines chinois à l'échelle mondiale updater.capgo.com.cn Les URL de domaine chinois fonctionnent de manière fluide pour les applications multi-région :

Copier dans le presse-papier

Section titled “Using Chinese Domains Globally”

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 :

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

Considérations de performance :

Même si le .cn domaine est résolu globalement via DNS Alibaba 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

Utiliser le .cn 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 en matière de performance hors de Chine est généralement digne de la simplification du déploiement.

Alternative : Configurations spécifiques à la région

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

• La construction de variantes d'applications séparées 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 publication 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 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 d'uploader un nouveau bundle et de surveiller le processus de téléchargement
5. Contactez le support - Si des 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 Mise à jour du comportement pour personnaliser quand les mises à jour sont appliquées
• Explorez Canaux pour gérer différentes pistes de version
• Révisez Chiffrement pour sécuriser vos mises à jour

Continuez à partir de l'utilisation de Capgo en Chine

Si vous utilisez En utilisant Capgo en Chine pour planifier la livraison de mises à jour en direct, connectez-le avec 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 Types de mise à jour pour les détails d'implémentation dans Types de mise à jour.