Mit Capgo in China verwenden

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

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

   npm run build
   npx cap sync

Konfigurationsdetails

Hier ist, was jede URL tut:

• __CAPGO_KEEP_0__: https://updater.capgo.com.cn/updates - Wird verwendet, um nach und herunterzuladen verfügbare Updates für Ihre App zu überprüfen
• - Wird verwendet, um Analysen und Nutzungsstatistiken an __CAPGO_KEEP_0__ zurückzusenden: https://updater.capgo.com.cn/stats - Used to report analytics and usage statistics back to Capgo
• 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-Updaters in China sicherzustellen.

Empfohlene Einstellungen für China

Aufgrund der durch die Great Firewall of China verursachten Netzwerkleistungsgrenzen haben wir spezifische Empfehlungen für Apps, die in der Volksrepublik 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 Updates, bei dem Updates im Hintergrund heruntergeladen und bei der Hintergrundierung 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

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

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

1. Hochladen eines neuen Bundles zu Capgo:

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

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

3. Überwachen Sie den Updateprozess:

   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 Standard Capgo-Konfiguration. Siehe die Updateverhalten Dokumentation für Details zu den Anweisungen, wie und wann Updates angewendet werden.

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. Die updater.capgo.com.cn __CAPGO_KEEP_0__ ist global aufgrund der Alibaba-DNS-Infrastruktur gelö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 der chinesischen Hauptland (mit Hongkong-basierten Infrastruktur)
• Benutzer außerhalb Chinas (der gleiche Infrastruktur über Alibaba-DNS zugreifen)

Leistungserwägungen:

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

Tipp

Die 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 Leistungsverzicht 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:

• Die Erstellung separater App-Varianten mit unterschiedlichen Konfigurationen
• Die 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 unter support@capgo.app oder unserem Discord-Community für Hilfe.

Fehlersuche

Wenn Sie Probleme mit Updates in China erleben:

1. Überprüfen Sie Ihre Konfiguration - Überprüfen Sie, ob alle drei URLs korrekt in Ihrer capacitor.config.ts
2. Überprüfen Sie die Netzwerkverbindung - Stellen Sie sicher, dass Ihr Gerät auf die 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. Testen Sie Updates - 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 Discord-Gemeinschaft an support@__CAPGO_KEEP_0__.app für Unterstützung

Vorsicht

Stellen Sie sicher, dass Sie das .cn Domain (updater.capgo.com.cn) und nicht die standardmäßige internationale Domain verwenden, wenn Sie für China konfigurieren.

Nächste Schritte

• Erfahren Sie mehr über Aktualisierungsverhalten um anzupassen, wenn Updates angewendet werden
• Entdecken Sie Kanäle um verschiedene Release-Tracks zu verwalten
• Zurück zur Übersicht Verschlüsselung Ihre Updates zu sichern