Utilizzo di Capgo in Cina

Se stai distribuendo il tuo'applicazione agli utenti in Cina, dovrai configurare Capgo per utilizzare URL regionali OST (Technology di archiviazione oggetti) per garantire aggiornamenti affidabili e veloci.

Perché utilizzare URL specifici della Cina?

A causa dell'infrastruttura di rete e delle normative in Cina (la Grande Muraglia), le connessioni dirette ai server internazionali possono essere lente o poco affidabili. Capgo fornisce URL dedicati OST con dati ubicati a Hong Kong per ridurre la latenza e garantire che gli utenti ricevano aggiornamenti il più velocemente e in modo più affidabile possibile.

Configurazione

Per configurare Capgo per la Cina, è necessario impostare tre URL specifiche nel proprio file di configurazione Capacitor. Questi URL puntano all'infrastruttura di Capgo basata a Hong Kong.

1. Apri il tuo capacitor.config.ts file

2. Aggiungi la seguente configurazione alla sezione del plugin: CapacitorUpdater Copia nel portapenne

   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. Finestra del terminale

   npm run build
   npx cap sync

Sezione intitolata “Dettagli della Configurazione”

Ecco cosa fa ogni URL:

• updateUrl: https://updater.capgo.com.cn/updates - Usato per verificare e scaricare eventuali aggiornamenti disponibili per il tuo app
• statsUrl: https://updater.capgo.com.cn/stats - Usato per inviare statistiche di analytics e di utilizzo a Capgo
• channelUrl: https://updater.capgo.com.cn/channel_self - Usato per recuperare la configurazione del canale e determinare quali aggiornamenti applicare

Suggerimento

Tutti e tre gli URL devono essere configurati insieme per garantire la piena funzionalità dell'aggiornatore Capgo in Cina.

Impostazioni consigliate per la Cina

A causa delle limitazioni di prestazioni della rete causate dalla Grande Muraglia Cinese, abbiamo raccomandazioni specifiche per le app distribuite nella Cina continentale:

Disabilita Aggiornamenti Diretti

Noi consigliamo fortemente di disabilitare directUpdate per le app in Cina. La connettività di rete in Cina è meno performante rispetto ad altre regioni, e gli aggiornamenti diretti (che si applicano immediatamente) possono portare a un'esperienza utente povera se i download vengono interrotti o sono lenti.

Invece, utilizzare il comportamento di aggiornamento predefinito dove gli aggiornamenti scaricano in background e si applicano quando l'app è in background o si riavvia. Ciò fornisce un'esperienza più affidabile per i tuoi utenti.

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

Attenzione

Sebbene la nostra infrastruttura di Hong Kong aiuti a minimizzare la latenza e migliorare la affidabilità, la prestazione della rete verso la Cina continentale può ancora essere influenzata dalla Grande Muraglia. Disabilitare directUpdate aiuta a garantire che gli aggiornamenti si completino con successo senza interrompere l'esperienza dell'utente.

Esempio di Configurazione Completa

Ecco un esempio completo con impostazioni raccomandate per le app distribuite in Cina:

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;

Testare la tua configurazione

Dopo aver configurato gli URL specifici per la Cina, puoi verificare che le aggiornamenti funzionino correttamente:

1. Carica un nuovo bundle in Capgo:

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

2. Installa l'app sul tuo dispositivo di test in Cina

3. Monitora il processo di aggiornamento:

   npx @capgo/cli@latest app debug

4. Verifica che gli aggiornamenti stiano venendo scaricati dai URL OST della Cina

Nota

Il comportamento e la cronologia degli aggiornamenti rimangono gli stessi di una configurazione standard di Capgo. Consulta la Comportamento degli aggiornamenti documentazione per ulteriori informazioni su come e quando gli aggiornamenti vengono applicati.

Distribuzione in più regioni

Se il tuo app serve utenti sia all'interno che all'esterno della Cina, puoi utilizzare la configurazione del dominio cinese per tutti gli utenti in tutto il mondo. Il updater.capgo.com.cn dominio viene risolto globalmente grazie all'infrastruttura DNS di Alibaba, rendendolo accessibile sia all'interno della Cina che in ogni altro luogo del mondo.

Utilizzo dei domini cinesi a livello globale

I URL dei domini cinesi funzionano in modo trasparente per le app multi-regionali:

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

Questa configurazione singola funziona per:

• Utenti in Cina continentale (utilizzando l'infrastruttura di Hong Kong)
• Utenti fuori dalla Cina (che accedono alla stessa infrastruttura tramite DNS di Alibaba)

Considerazioni di prestazioni:

Sebbene il .cn dominio sia risolto globalmente attraverso DNS di Alibaba e funzioni in ogni dove, è leggermente meno performante per gli utenti fuori dalla Cina rispetto al dominio standard (api.capgo.app ), che viene risolto direttamente da Cloudflare dove il nostro backend è ospitato. Tuttavia, la risoluzione DNS è veloce, quindi la differenza di prestazioni è minima e non avrà un impatto significativo sull'esperienza dell'utente.

Utilizza il dominio per tutti gli utenti semplifica la tua distribuzione e garantisce un comportamento di aggiornamento coerente in tutte le aree. Non hai bisogno di costruire versioni separate o configurazioni basate sull'ambiente. Il piccolo trade-off di prestazioni fuori dalla Cina è tipicamente valutato rispetto alla distribuzione semplificata.

Alternativa: Configurazioni per regione .cn Se preferisci ottimizzare in modo diverso per ogni regione, puoi anche considerare:

Costruire varianti di app separate con configurazioni diverse

Creare canali di rilascio diversi per regioni diverse

• Se hai bisogno di assistenza con strategie di distribuzione multi-regionale, contattaci a
• support@__CAPGO_KEEP_0__.app
• o unisciti al nostro

Se hai bisogno di assistenza con strategie di distribuzione multi-regionale, contattaci a support@capgo.app o unisciti al nostro Comunità di Discord per aiuto.

Risoluzione dei problemi

Se hai problemi con gli aggiornamenti in Cina:

1. Verifica la tua configurazione - Controlla che tutte e tre le URL siano correttamente impostate nel tuo capacitor.config.ts
2. Verifica la connettività di rete - Assicurati che il tuo dispositivo possa raggiungere il updater.capgo.com.cn dominio
3. Verifica i log - Utilizza npx @capgo/cli@latest app debug per verificare i messaggi di errore
4. Aggiorna le prove - Clicca su "Carica un nuovo bundle" e monitora il processo di download
5. Contatta il supporto - Se i problemi persistono, contattaci a supporto@capgo.app o unisciti alla nostra comunità Discord per ricevere assistenza

Attenzione

Assicurati di utilizzare il .cn dominio (updater.capgo.com.cn) e non il dominio internazionale standard quando si configura per la Cina.

Passaggi successivi

• Scopri di più Aggiorna il comportamento per personalizzare quando gli aggiornamenti vengono applicati
• Esplora Canali per gestire i diversi tracciati di rilascio
• Recensione Crittografia per proteggere le tue aggiornamenti