Verwendung von 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.

Warum China-Spezifische URLs verwenden?

Dank der Netzwerk-Infrastruktur 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 zur CapacitorUpdater Plugin-Sektion hinzu:

   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. Rebauen Sie Ihr 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-Updater in China sicherzustellen.

Empfehlungen für China

Aufgrund der durch die Great Firewall of China bedingten Einschränkungen der Netzwerkleistung haben wir spezifische Empfehlungen für Apps, die in China bereitgestellt werden:

Hintergrundaktualisierungen verwenden

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 Standardverhalten für Aktualisierungen, bei dem Aktualisierungen im Hintergrund heruntergeladen und angewendet werden, wenn die App im Hintergrund läuft oder neu gestartet wird. 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

While unsere Hongkong-basierte Infrastruktur die Latenz minimiert und die Zuverlässigkeit verbessert, kann die Netzwerkperformance nach China aufgrund des Großen Feuerwalls noch beeinträchtigt werden. Hintergrundaktualisierungen helfen sicherzustellen, dass Aktualisierungen erfolgreich abgeschlossen werden, ohne die Benutzererfahrung zu stören.

Vollständiges Konfigurationsbeispiel

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

Überprüfung Ihrer Konfiguration

Nach der Konfiguration der China-spezifischen URLs können Sie überprüfen, ob die Aktualisierungen korrekt funktionieren:

1. Eine neue Bundle hochladen auf Capgo:

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

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

3. Überwachen Sie den Aktualisierungsprozess:

   npx @capgo/cli@latest app debug

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

Hinweis

Das Aktualisierungsverhalten und die Zeit bleiben gleich wie bei der Standard-Capgo-Konfiguration. Siehe die Aktualisierungsverhalten Dokumentation für Details zu Aktualisierungen und Anwendung.

Multi-Region-Deployment

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. updater.capgo.com.cn ist weltweit dank Alibaba-DNS-Infrastruktur aufgelöst, sodass es sowohl innerhalb Chinas als auch überall sonst auf der Welt zugänglich ist.

Chinesische Domains weltweit verwenden

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 Konfiguration funktioniert für:

• Benutzer in der chinesischen Hauptland (mit Hongkong-basierten Infrastruktur)
• Benutzer außerhalb Chinas (der gleichen Infrastruktur über Alibaba-DNS zugreifen)

Leistungsüberlegungen:

Während .cn ist weltweit über Alibaba-DNS aufgelöst und funktioniert überall, ist es jedoch leicht weniger leistungsfähig für Benutzer außerhalb Chinas im Vergleich zur Standarddomain (api.capgo.app), die direkt durch Cloudflare aufgelöst wird, wo unser Backend gehostet wird. Dennoch ist die DNS-Auflösung schnell, sodass der Leistungszuwachs minimal ist und den Benutzererlebnis nicht signifikant beeinträchtigt.

Hinweis

Mit der Verwendung des .cn Domains für alle Benutzer vereinfacht die 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:

• Sind Sie getrennte App-Varianten mit unterschiedlichen Konfigurationen erstellen
• Mithilfe von Umgebungs-basierten Konfigurationen dynamisch die URLs setzen
• Verschiedene Release-Kanäle für verschiedene Regionen erstellen

Wenn Sie bei der Umsetzung von Mehr-Region-Bereitstellung-Strategien Unterstützung benötigen, wenden Sie sich bitte an support@capgo.app oder beitreten Sie unserer Discord-Gemeinschaft zur Hilfe.

Problembehandlung

Wenn Sie Probleme mit Updates in China erleben:

1. Überprüfen Sie Ihre Konfiguration - Überprüfen Sie, ob alle drei URLs in Ihrer capacitor.config.ts
2. Überprüfen Sie die Netzwerkverbindung - Stellen Sie sicher, dass Ihr Gerät auf das updater.capgo.com.cn Domain
3. Überprüfen Sie die Protokolle - Verwenden Sie npx @capgo/cli@latest app debug um Fehlermeldungen zu überprüfen
4. Testaktualisierungen - Versuchen Sie, ein neues Bundle hochzuladen und den Downloadprozess zu überwachen
5. Kontaktieren Sie den Support - Wenn Probleme bestehen bleiben, wenden Sie sich an uns unter support@capgo.app oder beitreten Sie unsere Discord-Gemeinschaft zur Unterstützung

Vorsicht

Sicherstellen, dass Sie das .cn Domänenname (updater.capgo.com.cn) und nicht den internationalen Standarddomänenname verwenden, wenn Sie sich für China einrichten.

Zukünftige Schritte

• Über Update-Verhalten um anzupassen, wenn Updates angewendet werden
• Entdecken 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 Live-Update-Übermittlung zu planen, verbinden Sie es mit Capgo Live Updates zur Produktworkflow in Capgo Live Updates, Übersicht zur Implementierungsdetail in Übersicht, Funktionen Detaillierungen zur Implementierung in Features, Updateverhalten Detaillierungen zur Implementierung in Updateverhalten, und Update-Typen Detaillierungen zur Implementierung in Update-Typen.