Utiliser Capgo en Chine

Si vous déployez votre application pour des utilisateurs en Chine, il est recommandé d’utiliser les endpoints régionaux de Capgo pour des mises à jour plus stables.

Pourquoi utiliser des URLs dédiées à la Chine

Les contraintes réseau (latence, filtrage, routage international) peuvent dégrader l’accès aux infrastructures hors région. Capgo fournit des URLs optimisées pour cette zone afin de réduire les échecs et d’accélérer les téléchargements.

Configuration

Vous devez définir trois URLs dans capacitor.config.ts.

Ouvrez capacitor.config.ts.

Configurez le plugin CapacitorUpdater:

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;

Rebuild et synchronisez:
Terminal window
```
npm run build
npx cap sync
```

Détail des URLs

updateUrl: vérification et téléchargement des mises à jour
statsUrl: envoi des métriques d’usage
channelUrl: résolution du canal associé à l’appareil

Paramètres recommandés pour la Chine

Désactiver `directUpdate`

Nous recommandons directUpdate: false pour éviter des expériences dégradées en cas de réseau instable.

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: false,
      updateUrl: 'https://updater.capgo.com.cn/updates',
      statsUrl: 'https://updater.capgo.com.cn/stats',
      channelUrl: 'https://updater.capgo.com.cn/channel_self',
    },
  },
};

Exemple complet

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'My App',
  webDir: 'dist',
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: false,
      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érifier la configuration

Uploadez un bundle de test:

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

Installez l’application sur un appareil de test.
Surveillez le processus:
Terminal window
```
npx @capgo/cli@latest app debug
```
Vérifiez que les requêtes partent bien vers updater.capgo.com.cn.

Déploiement multi-région

Si vous servez des utilisateurs en Chine et hors Chine, vous pouvez conserver ces URLs pour tous. Le domaine .cn est résolu globalement.

Option unique globale

Vous pouvez utiliser une configuration unique pour tous les utilisateurs:

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: false,
      updateUrl: 'https://updater.capgo.com.cn/updates',
      statsUrl: 'https://updater.capgo.com.cn/stats',
      channelUrl: 'https://updater.capgo.com.cn/channel_self',
    },
  },
};

Cette approche simplifie fortement l’exploitation.

Option par région

Si vous voulez optimiser par zone géographique:

maintenez des variantes d’app
injectez les URLs par environnement
segmentez par canaux

Besoin d’aide: support@capgo.app ou Discord Communauté.

Dépannage

En cas de problème:

vérifiez les 3 URLs dans capacitor.config.ts
testez l’accès réseau à updater.capgo.com.cn
inspectez les logs avec npx @capgo/cli@latest app debug
testez un nouvel upload pour valider la chaîne complète
contactez support@capgo.app ou Discord Communauté

Étapes suivantes

Découvrir Comportement des mises à jour
Explorer les Canaux
Configurer le Chiffrement