Utilizzare Capgo in Cina

Se stai distribuendo l'applicazione ai tuoi utenti in Cina, dovrai configurare Capgo per utilizzare le 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 in Cina (il Grande Muro di Cina), le connessioni dirette ai server internazionali possono essere lente o non affidabili. Capgo fornisce URL di 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

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

1. Apre il tuo capacitor.config.ts file

2. Aggiungi la seguente configurazione alla CapacitorUpdater sezione plugin:

   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 e scaricare le eventuali aggiornamenti disponibili per l'app
• statsUrl: https://updater.capgo.com.cn/stats - Usato per inviare statistiche di analytics e utilizzo di ritorno 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 dal Grande Muro di Cina, abbiamo raccomandazioni specifiche per le app distribuite nella Cina continentale:

Utilizzare Aggiornamenti in Background

Consigliamo vivamente l'uso di 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. autoUpdate: 'atBackground' 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.

Copia nella clipboard

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

Mentre la nostra infrastruttura basata a Hong Kong aiuta a minimizzare la latenza e migliorare la affidabilità, la prestazione della rete verso la Cina continentale può ancora essere influenzata dal Grande Muro di Cina. L'uso di aggiornamenti in background aiuta a garantire che gli aggiornamenti si completino con successo senza interrompere l'esperienza utente.

Esempio di Configurazione Completa

Sottosezione intitolata “Esempio di Configurazione Completa”

Copia nella clipboard

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;

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 bundle su Capgo:

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

2. Installa il tuo 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 stiano scaricando dagli URL OST della Cina

Nota

Il comportamento e il timing dell'aggiornamento rimangono gli stessi rispetto alla configurazione standard di Capgo. Vedi 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

Il dominio cinese funziona senza problemi per le app in più 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 funzionerà per:

• Utenti in Cina continentale (utilizzando infrastrutture basate a Hong Kong)
• Utenti fuori dalla Cina (che accedono alla stessa infrastruttura 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.

Consiglio

Utilizzare 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. La piccola perdita di prestazioni fuori dalla Cina è tipicamente valutabile rispetto alla distribuzione semplificata.

Alternativa: Configurazioni specifiche per regione

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

• Creare 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 per strategie di distribuzione multi-regionale, contattaci a support@capgo.app o unisciti alla nostra community di Discord per aiuto.

Risoluzione dei problemi

If si verificano 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. Controlla la connettività di rete - Assicurati che il tuo dispositivo possa raggiungere il updater.capgo.com.cn dominio
3. Visualizza i log - Utilizza 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 a supporto@capgo.app o unisciti alla nostra community 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

• Impara su Aggiorna il comportamento per personalizzare quando gli aggiornamenti vengono applicati
• Esplora Canali per gestire diverse tracce di rilascio
• Verifica Crittografia per proteggere i tuoi aggiornamenti

Continua da Utilizza Capgo in Cina

Se stai utilizzando Usando Capgo in Cina per pianificare la consegna di aggiornamenti in tempo reale, connettilo con Capgo Aggiornamenti in Tempo Reale per il flusso di lavoro del prodotto in Capgo Aggiornamenti in Tempo Reale, Panoramica per i dettagli di implementazione in Panoramica, Caratteristiche per i dettagli di implementazione in Caratteristiche, Comportamento dell'aggiornamento per i dettagli di implementazione in Comportamento dell'aggiornamento, e Tipi di Aggiornamento per i dettagli di implementazione in Tipi di Aggiornamento.