Usando Capgo in Cina

If si stà deployando l'applicazione per gli utenti in Cina, sarà necessario configurare Capgo per utilizzare le URL regionali di OST (Object Storage Technology) per garantire aggiornamenti affidabili e veloci.

Why Use China-Specific URLs?

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 gli utenti ricevano aggiornamenti il più velocemente e in modo affidabile possibile.

Configurazione

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

1. Aprite il capacitor.config.ts file

2. Aggiungere la seguente configurazione alla sezione del 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. Riavvia l'app per applicare le modifiche:

   npm run build
   npx cap sync

Dettagli della configurazione

Ecco cosa fa ogni URL:

• updateUrl: https://updater.capgo.com.cn/updates - Utilizzato per verificare l'aggiornamento e scaricare eventuali aggiornamenti 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

Consiglio

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 Grande 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 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

Sebbene l'infrastruttura basata a Hong Kong aiuti 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;

Testa 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 l'app sul dispositivo di prova in Cina

3. Monitora il processo di aggiornamento:

   npx @capgo/cli@latest app debug

4. Verifica che gli aggiornamenti stiano essere scaricati dalle URL OST di 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.

Distribuzione in Regione Multipla

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 __CAPGO_KEEP_0__

è risolto globalmente grazie all'infrastruttura DNS di Alibaba, rendendolo accessibile sia all'interno della Cina che in ogni altro luogo del mondo.

Sezione intitolata “Utilizzo di Dominii Cinesi a Livello Globale”

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

Copia nel portapenne

• Questa configurazione unica funzionerà per:
• Utenti nella Cina continentale (utilizzando un'infrastruttura basata a Hong Kong)

Utenti all'esterno della Cina (che accedono alla stessa infrastruttura tramite DNS di Alibaba)

Mentre il .cn dominio è risolto globalmente attraverso Alibaba DNS e funziona in ogni parte del 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.

Suggerimento

L'uso del .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 configurazioni basate sull'ambiente. Il piccolo scambio di prestazioni fuori dalla Cina è tipicamente valutato in modo positivo rispetto alla distribuzione semplificata.

Alternative: Configurazioni per Regione

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

• La creazione di varianti di app separate con configurazioni diverse
• L'uso di configurazioni basate sull'ambiente per impostare dinamicamente gli URL
• Creare canali di rilascio diversi per diverse regioni

Se hai bisogno di assistenza per strategie di distribuzione multi-regionale, contattaci a support@capgo.app o unisciti alla nostra community 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 __CAPGO_KEEP_0__
3. Verifica i log - Utilizza il npx @capgo/cli@latest app debug per controllare i messaggi di errore
4. Testa gli aggiornamenti - Prova ad uploadare un nuovo bundle e monitorare il processo di download
5. Contatta il supporto - Se i problemi persistono, contattaci all'indirizzo support@capgo.app o unisciti alla nostra community di Discord per assistenza

Attenzione

Assicurati di utilizzare il .cn nome 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 diverse tracce di rilascio
• Recensione Crittografia per rendere sicure le tue aggiornamenti