Verwendung von Capgo in China

Wenn Sie Ihre App für 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?

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 zur CapacitorUpdater Plugin-Sektion hinzu:

   import { CapacitorConfig } from '@capacitor/cli';
   
   const config: CapacitorConfig = {
     plugins: {
       CapacitorUpdater: {
         autoUpdate: true,
         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:

• __CAPGO_KEEP_0__updateUrl: https://updater.capgo.com.cn/updates - Wird verwendet, um nach und herunterzuladen verfügbare Updates für Ihre App zu überprüfen
• __CAPGO_KEEP_0__statsUrl: https://updater.capgo.com.cn/stats - Wird verwendet, um Analysen und Nutzungsstatistiken an Capgo zurückzusenden
• __CAPGO_KEEP_0__channelUrl: https://updater.capgo.com.cn/channel_self - Wird verwendet, um 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 der Netzwerkleistungsgrenzen, die durch die Große Firewall Chinas verursacht werden, haben wir spezifische Empfehlungen für Apps, die in China bereitgestellt werden:

__CAPGO_KEEP_0__

Wir empfehlen Ihnen dringend, für Apps in China die directUpdate deaktivieren. Die Netzwerkverbindung in China ist weniger leistungsfähig als in anderen Regionen, und direkte Updates (die sofort angewendet werden) können zu einem schlechten Benutzererlebnis führen, wenn Downloads unterbrochen oder langsam sind.

Stattdessen verwenden Sie das Standardverhalten für Updates, 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: true,
      directUpdate: false, // 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 Infrastruktur in Hongkong die Latenz minimiert und die Zuverlässigkeit verbessert, kann die Netzwerkleistung nach China aufgrund der Großen Firewall noch beeinträchtigt werden. Die Deaktivierung directUpdate sichert die erfolgreiche Abschluss der Updates und verhindert, dass das Benutzererlebnis gestört wird.

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: true,
      directUpdate: false, // Recommended: disable 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;

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. Überprüfen Sie, ob Updates von den China OST-URLs heruntergeladen werden

Hinweis

Das Updateverhalten und die Zeit bleiben bei der Standardkonfiguration von Capgo gleich. 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 Nutzung chinesischer Domains

Die chinesischen Domänennamen funktionieren reibungslos für Apps in mehreren Regionen:

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: false, // 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 der Volksrepublik China (mit Hongkong-basiertem Infrastruktur)
• Benutzer außerhalb Chinas (mit demselben Infrastruktur über Alibaba-DNS)

Leistungsbetrachtungen:

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

Tip

Mit der Verwendung des .cn 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 die Vereinfachung der Bereitstellung wert.

Alternative: Region-Spezifische 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
• 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 nehmen Sie an unserem Discord-Community Hilfe suchen.

Fehlersuche

Wenn Sie Probleme mit Updates in China haben:

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 updater.capgo.com.cn domain
3. Überprüfen Sie die Protokolle - Verwenden Sie npx @capgo/cli@latest app debug Fehlermeldungen überprüfen
4. Testaktualisierungen - Versuchen Sie, ein neues Bundle hochzuladen und den Downloadprozess zu überwachen
5. Kontakt zur Unterstützung - Wenn Probleme weiterhin bestehen, 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 .cn Bereich (updater.capgo.com.cn) und nicht das Standard-International-Domain bei der Konfiguration für China.

Nächste Schritte

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