Capgo in China

Wenn Sie Ihre App an Benutzer in China bereitstellen, müssen Sie Capgo so konfigurieren, dass regionale OST-URLs (Object Storage Technology) verwendet werden, um zuverlässige und schnelle Updates sicherzustellen.

Wozu China-Spezifische URLs nutzen?

Aufgrund der Netzwerkinfrastruktur und der Vorschriften in China (der Große Firewall) können direkte Verbindungen zu internationalen Servern langsam oder unzuverlässig sein. Capgo bietet dedizierte OST-URLs mit Daten, die sich in Hongkong befinden, um die Latenz zu minimieren und sicherzustellen, dass Ihre Benutzer Updates so schnell und zuverlässig wie möglich erhalten.

Konfiguration

Um Capgo für China zu konfigurieren, müssen Sie drei bestimmte URLs in Ihrer Capacitor-Konfigurationsdatei festlegen. Diese URLs verweisen auf Capgo's Hongkong-basierte Infrastruktur.

1. Öffnen Sie Ihr capacitor.config.ts Datei

2. Fügen Sie die folgende Konfiguration in die CapacitorUpdater Plugin-Sektion ein:

   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. Rebuilden Sie Ihre App, um die Änderungen anzuwenden:

   npm run build
   npx cap sync

Konfigurationsdetails

Hier ist, was jede URL tut:

• updateUrl: https://updater.capgo.com.cn/updates - Wird verwendet, um nach und herunterzuladen verfügbare Updates für Ihre App zu überprüfen
• Statistik-URL: https://updater.capgo.com.cn/stats - Wird verwendet, um Analysen und Nutzungsstatistiken an Capgo zurückzusenden
• Kanal-URL: https://updater.capgo.com.cn/channel_self - Wird verwendet, um die Kanal-Konfiguration abzurufen und zu bestimmen, welche Updates angewendet werden sollen

Tip

Alle drei URLs müssen gemeinsam konfiguriert werden, um die volle Funktionalität des Capgo-Updaters in China sicherzustellen

Empfehlungen für China

Aufgrund der durch die Great Firewall of China verursachten Netzwerkleistungseinschränkungen haben wir spezifische Empfehlungen für Apps, die in China deployt sind:

Timeout für API-Antwort erhöhen

Der Capgo-Updater-Plugin unterbricht API-Aufrufe, wenn responseTimeout überschritten ist (Wert in Sekunden). Die Edge-Infrastruktur vor Capgo behandelt etwa Sekunden als Fehlertoleranz für einige Routen.

In der chinesischen Hauptlandmasse ist die grenzüberschreitende Latenz oft höher. Halten Sie eine höhere responseTimeout so dass der Plugin genügend Zeit hat, die Aktualisierungsprüfungen und -downloads durchzuführen, anstatt frühzeitig zu scheitern: updater.capgo.com.cn Auf die Zwischenablage kopieren

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

protectedTokens

Vorziehen responseTimeout: 60 (oder höher) für China-Deployments. Ein niedriger Timeout macht die Updates nicht schneller – es führt nur dazu, dass der Plugin aufhört, während der Anfrage auf Capgo’s Seite noch Erfolg haben kann.

Verwenden Sie Hintergrundaktualisierungen

Wir stark empfehlen die Verwendung autoUpdate: 'atBackground' für Apps in China. Die Netzwerkverbindung in China ist weniger leistungsfähig als in anderen Regionen, und Instant-Apply-Modi können zu einem schlechten Benutzererlebnis führen, wenn Downloads unterbrochen oder langsam sind.

Stattdessen verwenden Sie das Standard-Update-Verhalten, bei dem Updates im Hintergrund heruntergeladen und angewendet werden, wenn die App sich im Hintergrund befindet oder neu gestartet wird. Dies bietet eine zuverlässigere Erfahrung für Ihre Benutzer.

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

Vorsicht

Während unsere Hongkong-basierte Infrastruktur die Latenz minimiert und die Zuverlässigkeit verbessert, kann die Netzwerkperformance nach China noch durch den Großen Firewall beeinflusst werden. Die Verwendung von Hintergrundaktualisierungen hilft sicherzustellen, dass die Updates erfolgreich abgeschlossen werden, ohne das Benutzererlebnis zu stören.

Vollständiges Konfigurationsbeispiel

Hier ist ein vollständiges Beispiel mit empfohlenen Einstellungen für Apps, die in China bereitgestellt werden:

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;

Ihre Konfiguration testen

Nachdem Sie die China-spezifischen URLs konfiguriert haben, können Sie überprüfen, ob Updates korrekt funktionieren:

1. Laden Sie ein neues Bundle auf Capgo hoch:

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

2. Installieren Sie Ihre App auf einem Testgerät in China

3. Den Update-Prozess überwachen:

   npx @capgo/cli@latest app debug

4. Überprüfen Sie, ob Updates von den China-OST-URLs heruntergeladen werden

Hinweis

Das Updateverhalten und die Zeit bleiben gleich wie bei der StandardCapgo-Konfiguration. Siehe die Updateverhalten Dokumentation für Details zu den Anweisungen, wie und wann Updates angewendet werden.

Multi-Region-Implementierung

Wenn Ihre App Benutzer sowohl innerhalb als auch außerhalb Chinas bedient, können Sie die chinesische Domänenkonfiguration für alle Benutzer weltweit verwenden. Die updater.capgo.com.cn Domäne wird global dank der Alibaba-DNS-Infrastruktur gelöst, sodass sie sowohl innerhalb Chinas als auch überall sonst auf der Welt zugänglich ist.

Mit chinesischen Domains weltweit verwenden

Die chinesischen Domains funktionieren reibungslos für Apps in mehreren Regionen:

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

Diese einzelne Konfiguration funktioniert für:

• Benutzer in China (mit Hongkong-basiertem Infrastruktur)
• Benutzer außerhalb Chinas (der gleiche Infrastruktur über Alibaba-DNS zugreifen)

Leistungsüberlegungen:

Während der .cn Domain wird global über Alibaba-DNS gelöst und funktioniert überall, ist jedoch leicht weniger leistungsfähig für Benutzer außerhalb Chinas im Vergleich zur Standard-Domain (api.capgo.app, die direkt durch Cloudflare gelöst wird, wo unser Backend gehostet wird. Die DNS-Lösung ist jedoch schnell, sodass der Leistungsunterschied minimal ist und den Benutzererlebnis nicht signifikant beeinträchtigt.

Tip

Mit der Verwendung .cn für alle Benutzer vereinfacht sich Ihre Bereitstellung und sichert eine konsistente Aktualisierungsverhalten in allen Regionen. Sie benötigen keine separaten Builds oder Umgebungs-basierten Konfigurationen. Der kleine Leistungsaufwand außerhalb Chinas ist typischerweise der vereinfachten Bereitstellung wert.

Alternative: Regionsspezifische Konfigurationen

Wenn Sie lieber unterschiedlich für jede Region optimieren möchten, können Sie auch in Betracht ziehen:

• Separate App-Varianten mit unterschiedlichen Konfigurationen erstellen
• Umgebungs-basierte Konfiguration verwenden, um die URLs dynamisch zu setzen
• Für verschiedene Regionen verschiedene Release-Kanäle erstellen

Wenn Sie bei der Umsetzung von Strategien für die Bereitstellung in mehreren Regionen Unterstützung benötigen, wenden Sie sich bitte an support@capgo.app oder beitreten Sie unserem Discord Community Hilfe erhalten.

Überwachung der chinesischen Infrastruktur

Sie können die Gesundheit und den Status von Capgo’s chinesischen Endpunkten auf der Seite status.capgo.com.cnüberprüfen. Verwenden Sie diese Seite, um Vorfall, Latenz und Verfügbarkeit der chinesischen OST-URLs zu überprüfen, bevor Sie Ihr App auf Probleme hin überprüfen.

Schadensbegrenzung

Abschnitt mit dem Titel “Schadensbegrenzung”

1. Wenn Sie Probleme mit den Updates in China erleben: Überprüfen Sie Ihre Konfiguration. - Überprüfen Sie, ob alle drei URLs korrekt in Ihrer capacitor.config.ts
2. Erhöhen responseTimeout - Verwenden Sie mindestens 60 Sekunden in China, damit das Plugin nicht abbricht, während der Updateanfrage noch im Gange ist
3. Überprüfen Sie die Netzwerkverbindung - Stellen Sie sicher, dass Ihr Gerät auf die updater.capgo.com.cn Domain
4. Überprüfen Sie die China-Statusseite - Überprüfen Sie status.capgo.com.cn für laufende Vorfälle oder eine verringerte Leistung
5. Überprüfen Sie die Protokolle - Verwenden Sie npx @capgo/cli@latest app debug Fehlermeldungen zu überprüfen
6. Aktualisierungen testen - Ein neues Bundle hochladen und den Downloadprozess überwachen
7. Kontakt zur Unterstützung Falls Probleme bestehen bleiben, wenden Sie sich an support@capgo.app oder unserem Discord-Community für Unterstützung

Vorsicht

Stellen Sie sicher, dass Sie .cn Domain (updater.capgo.com.cn) und nicht das Standard-Internationale Domain bei der Konfiguration für China.

Zukünftige Schritte

• Erkunden Sie Updateverhalten um anzupassen, wann Updates angewendet werden
• Erkunden Sie Kanäle um verschiedene Release-Tracks zu verwalten
• Überprüfen Verschlüsselung um Ihre Updates zu sichern

Fortsetzen Sie mit dem Verwenden von Capgo in China

Wenn Sie __CAPGO_KEEP_0__ in China verwenden Verwenden Sie Capgo in China um die Lieferung von Live-Updates zu planen, verbinden Sie es mit Capgo Live Updates for the product workflow in Capgo Live Updates, zur Produktworkflow in __CAPGO_KEEP_0__ Live Updates, Übersicht zur Implementierungsdetail in Übersicht, Funktionen Aktualisierungsverhalten für die Implementierungsdetails in Aktualisierungsverhalten, und Aktualisierungstypen für die Implementierungsdetails in Aktualisierungstypen.