Usa Capgo in Cina

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

Perché utilizzare URL specifici per la Cina?

Dovuto a infrastrutture di rete e regolamenti in Cina (il Grande Muro della Cina), le connessioni dirette ai server internazionali possono essere lente o non affidabili. Capgo fornisce URL OST dedicati con dati ubicati a Hong Kong per ridurre la latenza e garantire che i tuoi utenti ricevano aggiornamenti il più velocemente e in modo affidabile possibile.

Configurazione

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

1. Apre il tuo capacitor.config.ts file

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

   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. Fermata di sistema

   npm run build
   npx cap sync

Dettagli di configurazione

Ecco cosa fa ogni URL:

• updateUrl: https://updater.capgo.com.cn/updates - Utilizzato per controllare l'aggiornamento e scaricare le versioni disponibili per l'app
• statsUrl: https://updater.capgo.com.cn/stats - Utilizzato per inviare statistiche di analytics e di utilizzo a Capgo
• channelUrl: https://updater.capgo.com.cn/channel_self - Utilizzato per recuperare la configurazione del canale e determinare quali aggiornamenti applicare

Suggerimento

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

Impostazioni Consigliate per la Cina

A causa delle limitazioni di prestazioni della rete causate dal Muro di Cina, abbiamo raccomandazioni specifiche per le app distribuite nella Cina continentale:

Aggiornamenti in Background

Noi consigliamo fortemente di utilizzare autoUpdate: 'atBackground' per le app in Cina. La connettività di rete in Cina è meno performante rispetto ad altre regioni, e i modi di applicazione istantanea 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 si svolge in background o si riavvia. Ciò fornisce un'esperienza più affidabile per i tuoi utenti.

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

Preavviso

Mentre l'infrastruttura basata a Hong Kong aiuta a ridurre la latenza e a migliorare la affidabilità, il rendimento della rete verso la Cina continentale può ancora essere influenzato dal Grande Firewall. L'aggiornamento in background 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: '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;

Testare la tua Configurazione

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

1. Carica un nuovo bundle su Capgo:

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

2. Installa la tua app su un dispositivo di test in Cina

3. Monitorare il processo di aggiornamento:

   npx @capgo/cli@latest app debug

4. Verificare che gli aggiornamenti stiano scaricando dalle URL OST di Cina

Nota

Il comportamento e la temporalità dell'aggiornamento rimangono gli stessi di una configurazione standard Capgo. Consultate la Comportamento dell'aggiornamento documentazione per ulteriori informazioni su come e quando vengono applicati gli aggiornamenti.

Deployamento 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. updater.capgo.com.cn grazie all'infrastruttura DNS di Alibaba, il dominio è risolto globalmente, rendendolo accessibile sia all'interno della Cina che in tutto il mondo.

Usare dominii Cinese a livello globale

Il dominio Cinese funziona senza problemi per le app multi-regioni:

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

Questa configurazione unica funziona per:

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

Considerazioni di prestazioni:

Mentre il .cn il dominio è risolto globalmente tramite DNS di Alibaba e funziona in tutto il mondo, è leggermente meno performante per gli utenti fuori dalla Cina rispetto al dominio standard (api.capgo.app), che è 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.

Tip

Utilizzando il .cn dominio per tutti gli utenti semplifica la tua distribuzione e garantisce un comportamento di aggiornamento coerente in tutte le regioni. Non hai bisogno di costruire separatamente o di configurazioni basate sull'ambiente. Il piccolo scambio di prestazioni fuori dalla Cina è tipicamente valutato rispetto alla distribuzione semplificata.

Alternative: Configurazioni per regione

Se preferisci ottimizzare diversamente per ogni regione, puoi anche considerare:

• Costruire varianti di app separate con configurazioni diverse
• Utilizzare la configurazione basata sull'ambiente per impostare dinamicamente gli URL
• Creare canali di rilascio diversi per diverse regioni

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

Sezione intitolata “Risoluzione dei problemi”

Verifica la tua configurazione

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

Attenzione

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

Sottosezione intitolata “Passaggi successivi”

• Comportamento dell'aggiornamento per personalizzare quando gli aggiornamenti vengono applicati Esplora
• Canali per gestire diverse tracce di rilascio Revisiona
• Esplora i canali per gestire diverse tracce di rilascio Crittografia per assicurare la sicurezza delle tue aggiornamenti

Continua a procedere da Utilizzare Capgo in Cina

Se stai utilizzando Utilizzare Capgo in Cina per pianificare la consegna degli aggiornamenti in tempo reale, connettilo con Capgo Live Updates per il flusso di lavoro del prodotto in Capgo Live Updates, Panoramica per i dettagli di implementazione in Panoramica, Caratteristiche per i dettagli di implementazione in Features, Comportamento di Aggiornamento per i dettagli di implementazione in Comportamento di Aggiornamento, e Tipi di Aggiornamento per i dettagli di implementazione in Tipi di Aggiornamento.