Verwendung von Capgo in China

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

Wozu China-Spezifische URLs nutzen?

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

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
• statsUrl: https://updater.capgo.com.cn/stats - Wird verwendet, um Analysen und Nutzungsstatistiken an Capgo zurückzusenden
• channelUrl: https://updater.capgo.com.cn/channel_self - Wird verwendet, um die Kanal-Konfiguration abzurufen und zu bestimmen, welche Updates angewendet werden sollen

Tipp

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

Empfehlungen für China

Aufgrund der durch die Große Firewall Chinas bedingten Netzwerkleistungsgrenzen haben wir spezifische Empfehlungen für Apps, die in China deployt sind:

Erhöhen Sie die API Antwortstimeout

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

In China beträgt die Überseekoordination oft höher. Halten Sie eine höhere responseTimeout so dass der Plugin genügend Zeit hat, Update-Überprüfungen und Downloads durchzuführen. 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

Präferenz 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 auf Capgo’s Seite aufhört, während der Anfrage noch Erfolg haben kann.

Benutzen Sie Hintergrund-Updates

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 Hintergrundierung oder Neustart des Apps angewendet werden. Dies bietet ein zuverlässigeres Erlebnis 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

Obwohl unsere Infrastruktur in Hongkong die Latenz minimiert und die Zuverlässigkeit verbessert, kann die Netzwerkperformance nach dem Festland China durch die Große Firewall noch beeinträchtigt werden. Hintergrundaktualisierungen helfen dabei sicherzustellen, dass Aktualisierungen erfolgreich abgeschlossen werden, ohne die Benutzererfahrung 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;

Testen Sie Ihre Konfiguration

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

1. Hochladen Sie ein neues Bundle zu Capgo:

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

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

3. Folgen Sie dem Update-Prozess:

   npx @capgo/cli@latest app debug

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

Hinweis

Das Updateverhalten und die Zeitplanung 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-Deployments

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 Die Domäne wird auf globaler Ebene dank Alibaba-DNS-Infrastruktur aufgelöst, sodass sie sowohl innerhalb Chinas als auch überall sonst auf der Welt zugänglich ist.

Chinesische Domains weltweit verwenden

Die chinesischen Domän-URLs funktionieren reibungslos für Multi-Region-Apps:

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-basierten Infrastruktur)
• Benutzer außerhalb Chinas (mit Zugriff auf dieselbe Infrastruktur über Alibaba-DNS)

Leistungserwägungen:

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

Tip

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

Alternative: Regionsspezifische Konfigurationen

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

• Erstellung separater App-Varianten mit unterschiedlichen Konfigurationen
• Verwendung einer Umgebungs-basierten Konfiguration, um die URLs dynamisch zu setzen
• Erstellung unterschiedlicher Releasekanäle für verschiedene Regionen

Wenn Sie bei der Umsetzung von Multi-Region-Deployments Unterstützung benötigen, wenden Sie sich bitte an uns bei support@capgo.app oder beitreten Discord-Gemeinschaft für Hilfe.

Überwachung der chinesischen Infrastruktur

Sie können die Gesundheit und den Status von Capgo’s chinesischem Endpunkt auf status.capgo.com.cnÜberprüfen Sie auf dieser Seite, ob es bei den China-OST-URLs zu Störungen, Latenz oder Ausfallzeiten kommt, bevor Sie Ihr App-Problem lösen.

Schadensbegrenzung

Wenn Sie Probleme mit den Updates in China haben:

1. Überprüfen Sie Ihre Konfiguration - Überprüfen Sie, ob alle drei URLs in Ihrer capacitor.config.ts
2. Erhöhen responseTimeout - Verwenden Sie mindestens 60 Sekunden in China, damit das Plugin nicht abbricht, während der Update-Antrag noch im Flug 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 Statusseite für China Überprüfen Sie status.capgo.com.cn Für alle laufenden Zwischenfällen oder degradierte Leistung
5. Review logs - Use npx @capgo/cli@latest app debug um Fehlermeldungen zu überprüfen
6. Updates testen - Versuchen Sie, ein neues Bundle hochzuladen und den Downloadprozess zu überwachen
7. Kontaktieren Sie den Support Wenn Probleme weiterhin bestehen, wenden Sie sich an uns support@capgo.app oder beitreten Discord-Gemeinschaft Für Unterstützung

Vorsicht

Stellen Sie sicher, dass Sie das .cn Domain (updater.capgo.com.cn) und nicht das Standard-Domänennamen verwenden, wenn Sie für China konfigurieren.

Nächste Schritte

• Erlernen Sie Updateverhalten um anzupassen, wann Updates angewendet werden
• Entdecken Kanäle verschiedene Veröffentlichungsstränge zu verwalten
• Überprüfen Verschlüsselung Deine Updates zu sichern

Fortsetzen mit Capgo in China

Wenn du __CAPGO_KEEP_0__ in China verwendest Capgo in China um live update-Lieferungen zu planen, verbinde es mit Capgo Live Updates zur Produktworkflow in Capgo Live Updates Übersicht zur Detailbeschreibung in Übersicht Funktionen zur Detailbeschreibung in Funktionen Updateverhalten zur Detailbeschreibung in Updateverhalten und Updatearten zur Detailbeschreibung in Updatearten.