Capgo in China verwenden

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

Warum Verwenden Sie China-Spezifische URLs?

Aufgrund der Netzwerkinfrastruktur und -regulierungen 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 in Hongkong, 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

Das 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
• statsUrl: 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-Updater in China sicherzustellen

Empfehlungen für China

Aufgrund von Netzwerkleistungseinschränkungen, die durch den Großen Firewall von China verursacht werden, haben wir spezifische Empfehlungen für Apps, die in der Volksrepublik China bereitgestellt werden:

Timeout für API-Antwort erhöhen

Der Capgo-Updater-Plugin beendet API-Anrufe, wenn responseTimeout wird überschritten (Wert in Sekunden). Die Edge-Infrastruktur vor Capgo behandelt etwa 3 Sekunden als Fehlertoleranz für einige Pfade.

In China, ist die Querverzugszeit oft höher. Halten Sie eine höhere responseTimeout damit der Plugin genügend Zeit hat, um Aktualisierungsprüfungen und Downloads durchzuführen über updater.capgo.com.cn anstatt frühzeitig zu scheitern:

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

Tipp

Vorziehen responseTimeout: 60 Wählen Sie eine Version (oder höher) für China-Deployments. Ein niedriger Timeout beschleunigt die Updates nicht – er verursacht nur, dass das Plugin aufgibt, während der Anfrage auf Capgo’s Seite noch Erfolg haben kann.

Im Hintergrund aktualisieren

Wir empfehlen Ihnen stark, autoUpdate: 'atBackground' für Apps in China zu verwenden. 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 bei der Hintergrund- oder Neustart des Apps angewendet werden. 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. Durch das Verwenden von Hintergrund-Updates wird sichergestellt, 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. Ein neues Bundle hochladen auf Capgo:

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

2. Ihre App auf einem Testgerät in China installieren

3. Den Update-Prozess überwachen:

   npx @capgo/cli@latest app debug

4. Stellen Sie sicher, dass Updates von den China OST-URLs heruntergeladen werden

Hinweis

Das Updateverhalten und die Zeit bleiben gleich wie bei der Standard Capgo-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 aufgrund der Alibaba-DNS-Infrastruktur gelöst, sodass sie sowohl innerhalb Chinas als auch überall sonst auf der Welt zugänglich ist.

Globale Verwendung chinesischer Domains

Die chinesischen Domains funktionieren reibungslos für Apps mit 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 (mit Zugriff auf dieselbe Infrastruktur über Alibaba DNS)

Leistungsüberlegungen:

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

Tipps

Mit der Verwendung des .cn Domänen 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 festzulegen
• Verschiedene Release-Kanäle für verschiedene Regionen erstellen

Wenn Sie Unterstützung bei Strategien für die Multi-Region-Bereitstellung benötigen, wenden Sie sich bitte an support@capgo.app oder unserem Discord-Community für Hilfe.

Überwachung der chinesischen Infrastruktur

Sie können den Gesundheitszustand und den Status von Capgo’s chinesischen Endpunkten überwachen status.capgo.com.cn. Verwenden Sie diese Seite, um auf Vorfälle, Latenz und die Verfügbarkeit der chinesischen OST-URLs vor der Fehlerbehebung Ihrer App zu überprüfen.

Fehlerbehebung

Wenn Sie Probleme mit Updates in China erleben:

1. Überprüfen Sie Ihre Konfiguration - Überprüfen Sie, ob alle drei URLs korrekt in Ihrem capacitor.config.ts
2. Hochheben responseTimeout - Verwenden Sie mindestens 60 Sekunden in China, damit das Plugin nicht während des Updateanfrages abbricht
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 degradierte Leistung
5. Überprüfen Sie die Protokolle - Verwenden Sie npx @capgo/cli@latest app debug um nach Fehlermeldungen zu suchen
6. Test updates - Versuchen Sie, ein neues Bundle hochzuladen und den Downloadprozess zu überwachen
7. Kontakt zur Unterstützung - Wenn Probleme bestehen bleiben, wenden Sie sich an uns bei support@capgo.app oder beitreten Sie unserer Discord-Gemeinschaft für Unterstützung

Vorsicht

Stellen Sie sicher, dass Sie das .cn domain (updater.capgo.com.cnund nicht das Standard-Internationales-Domain-Format beim Konfigurieren für China.

Zukünftige Schritte

• Erkunden Sie Update-Verhalten anpassen um anzupassen, wenn Updates angewendet werden
• Entdecken Sie Kanäle um verschiedene Release-Tracks zu verwalten
• Überprüfen Sie Verschlüsselung um Ihre Updates zu sichern

Bleiben Sie weiterhin bei der Verwendung von Capgo in China

Wenn Sie __CAPGO_KEEP_0__ in China verwenden Verwenden Sie Capgo in China um die Live-Update-Planung zu steuern, verbinden Sie es mit Capgo Live Updates für den Produktworkflow in Capgo Live Updates, Übersicht für die Implementierungsdetails in Übersicht, Funktionen für die Implementierungsdetails in Funktionen Aktualisierungsverhalten für die Implementierungsdetails in Updateverhalten und Update-Typen für die Implementierungsdetails in Update-Typen.