Utilizzo di Capgo in Cina

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

Perché utilizzare URL specifici per la Cina?

A causa dell'infrastruttura di rete e delle normative in Cina (il Grande Muro di Cina), le connessioni dirette ai server internazionali possono essere lente o non affidabili. Capgo fornisce URL dedicati di OST 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

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

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 dei comandi

   npm run build
   npx cap sync

Sottosezione intitolata “Dettagli della configurazione”

updateUrl

• - Utilizzato per verificare e scaricare le eventuali aggiornamenti disponibili per la tua app: https://updater.capgo.com.cn/updates Used to check for and download available updates for your 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

Consiglio

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

Impostazioni Raccomandate per la Cina

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

Aumentare il Timeout di Risposta di API

Aggiornatore Capgo interrompe API chiamate quando responseTimeout è superato (il valore è in secondi). L'infrastruttura Edge davanti a Capgo considera circa secondi come un budget di fallimento per alcune rotte.

In Cina continentale, la latenza transfrontaliera è spesso più alta. Mantenere un valore più alto responseTimeout assicura che l'aggiornatore abbia abbastanza spazio per completare le verifiche degli aggiornamenti e le scariche attraverso updater.capgo.com.cn al posto di fallire presto:

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'atBackground',
      // Seconds. Raise above the default (20) for China network conditions.
      responseTimeout: 60,
      updateUrl: 'https://updater.capgo.com.cn/updates',
      statsUrl: 'https://updater.capgo.com.cn/stats',
      channelUrl: 'https://updater.capgo.com.cn/channel_self',
    },
  },
};

Suggerimento

Prefer responseTimeout: 60 (o superiore) per le distribuzioni in Cina. Un timeout basso non rende le aggiornamenti più veloci — causa solo il plugin a rinunciare mentre la richiesta potrebbe ancora riuscire sul lato di Capgo.

Utilizza Aggiornamenti in background

Noi fortemente consigliamo 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 sforna 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',
    },
  },
};

Attenzione

Mentre la nostra infrastruttura basata a Hong Kong aiuta a minimizzare la latenza e a migliorare la affidabilità, la prestazione della rete verso la Cina continentale può ancora essere influenzata dal Grande Muro. Utilizzare gli aggiornamenti 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
      responseTimeout: 60, // Seconds — give China network more room
      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;

Verifica la tua Configurazione

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

1. Incarica un nuovo pacchetto su Capgo:

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

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

3. Monitora il processo di aggiornamento:

   npx @capgo/cli@latest app debug

4. Verifica che gli aggiornamenti vengano scaricati dalle URL OST di Cina

Nota

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

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. 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 di domini cinesi a livello globale

I URL dei domini cinesi funzionano senza problemi 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:

• Gli utenti della Cina continentale (utilizzando infrastrutture basate a Hong Kong)
• Gli utenti fuori dalla Cina (che accedono allo stesso insieme di infrastrutture tramite DNS Alibaba)

Considerazioni di prestazioni:

Mentre il .cn dominio è risolto globalmente tramite DNS Alibaba e funziona 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.

Consigli

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 versioni separate o di configurazioni basate sull'ambiente. Il piccolo scambio di prestazioni fuori dalla Cina è tipicamente valutato in base alla distribuzione semplificata.

Alternativa: Configurazioni specifiche per regione

Se preferisci ottimizzare in modo diverso 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 regioni diverse

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

Monitoraggio dell'infrastruttura cinese

Puoi monitorare lo stato di salute e lo stato dei punti di accesso specifici per la Cina di Capgo a status.capgo.com.cn. Utilizza questa pagina per verificare gli incidenti, la latenza e la disponibilità degli URL OST della Cina prima di risolvere i problemi del tuo app.

Risoluzione dei problemi

Se hai problemi con gli aggiornamenti in Cina:

1. Verifica la tua configurazione - Controlla che tutti e tre gli URL siano correttamente impostati nel tuo capacitor.config.ts
2. Rilancia responseTimeout - Utilizza almeno 60 secondi in Cina affinché il plugin non interrompa l'aggiornamento mentre la richiesta è ancora in corso
3. Controlla la connettività di rete - Assicurati che il tuo dispositivo possa raggiungere il updater.capgo.com.cn dominio
4. Controlla la pagina dello stato della Cina - Verifica lo stato.capgo.com.cn per eventuali incidenti in corso o prestazioni degradate
5. Verifica i log - Utilizza npx @capgo/cli@latest app debug per verificare i messaggi di errore
6. Aggiornamenti di test - Cercare di caricare un nuovo bundle e monitorare il processo di download
7. Contattare il supporto Contattare il supporto support@capgo.app supporto@__CAPGO_KEEP_0__.app o unisciti alla nostra comunità Discord

Attenzione

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

Passaggi successivi

• Scopri Comportamento dell'aggiornamento per personalizzare quando gli aggiornamenti vengono applicati
• Esplora Canali per gestire diverse tracce di rilascio
• Revisiona Crittografia per assicurare le tue aggiornamenti

Continua dall'uso di Capgo in Cina

Se stai utilizzando Utilizza Capgo in Cina per pianificare la consegna degli aggiornamenti in tempo reale, connettilo con Aggiornamenti in Tempo Reale Capgo for the product workflow in Capgo Live Updates, per il flusso di lavoro del prodotto in Aggiornamenti in Tempo Reale __CAPGO_KEEP_0__ Sintesi per i dettagli di implementazione in Sintesi Sintesi delle funzionalità in Sintesi delle funzionalità Comportamento dell'aggiornamento per il dettaglio di implementazione in Comportamento dell'aggiornamento, e Tipi di Aggiornamento per il dettaglio di implementazione in Tipi di Aggiornamento.