Usare 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?

A causa dell'infrastruttura di rete e delle normative cinesi (il Grande Muro di Cina), le connessioni dirette ai server internazionali possono essere lente o poco 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 più affidabile possibile.

Configurazione

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. file capacitor.config.ts Aggiungi la seguente configurazione alla sezione plugin:

2. Copia nel portapenne CapacitorUpdater Riavvia il tuo app per applicare le modifiche:

   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. Copia nel portapenne

   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 disponibile per il tuo 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 gli aggiornamenti da 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 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 in cui 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: '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

While 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 utente.

Configurazione Completa

Copiare nel portapenne

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;

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

Fenestra del terminale

1. Upload a new bundle to Capgo:

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

2. Upload a new bundle to __CAPGO_KEEP_0__

3. Segui il processo di aggiornamento:

   npx @capgo/cli@latest app debug

4. Verifica che gli aggiornamenti stiano scaricando dalle URL OST Cina

Nota

Il comportamento e la tempistica degli aggiornamenti rimangono gli stessi di una configurazione standard Capgo. Consulta 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 Il dominio è risolto globalmente grazie all'infrastruttura DNS di Alibaba, rendendolo accessibile sia all'interno della Cina che in tutto il mondo.

Usare domini cinesi globalmente.

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

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 funzionerà per:

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

Considerazioni di prestazioni:

Mentre il .cn 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 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.

Consiglio

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.

Alternativa: Configurazioni per regione

Se preferisci ottimizzare in modo diverso per ogni regione, puoi anche considerare:

• Costruire varianti di app separate con diverse configurazioni
• Utilizzare una 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, per favore contattaci a support@capgo.app o unisciti alla nostra Comunità Discord per aiuto.

Sezioni di risoluzione dei problemi

Se sperimenti problemi con gli aggiornamenti in Cina:

1. Verifica la tua configurazione - Controlla che tutti e tre gli URL siano impostati correttamente nel tuo capacitor.config.ts
2. Controlla la connettività della 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 - Prova ad uploadare un nuovo bundle e monitorare 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
• Rivedi Crittografia per assicurare la sicurezza delle tue aggiornamenti

Continua dall'uso di Capgo in Cina

Se stai utilizzando L'uso di 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.