Capgo in China verwenden

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 zuversichtliche 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, die sich in Hongkong befinden, 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 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
• 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 von Netzwerkleistungseinschränkungen, die durch den Großen Firewall von China verursacht werden, haben wir spezifische Empfehlungen für Apps, die in China deployt sind:

Hintergrundaktualisierungen verwenden

We empfehlen dringend die Verwendung von für Apps in China. Die Netzwerkverbindung in China ist weniger leistungsfähig als in anderen Regionen, und die sofortige Anwendung von Updates kann zu einem schlechten Benutzererlebnis führen, wenn Downloads unterbrochen oder langsam sind. autoUpdate: 'atBackground' Stattdessen verwenden Sie das Standard-Update-Verhalten, bei dem Updates im Hintergrund heruntergeladen und angewendet werden, wenn die App sich im Hintergrund befindet oder neu gestartet wird. Dies bietet ein zuverlässigeres Erlebnis für Ihre Benutzer.

Zwischenablage kopieren

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

Während unsere Infrastruktur in Hongkong die Latenz minimiert und die Zuverlässigkeit verbessert, kann die Netzwerkperformance nach China noch von dem Großen Firewall beeinflusst werden. Die Verwendung von Hintergrund-Updates hilft sicherzustellen, dass Updates erfolgreich abgeschlossen werden, ohne das Benutzererlebnis zu stören.

Vollständiges Konfigurationsbeispiel

Abschnitt mit dem Titel „Vollständiges Konfigurationsbeispiel“

Zwischenablage kopieren

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;

Ihre Konfiguration testen

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

1. Hochladen Sie ein neues Bundle auf Capgo:

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

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

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

Die Aktualisierungsverhalten und -zeit bleiben gleich wie bei einer Standard Capgo-Konfiguration. Siehe die Aktualisierungsverhalten Dokumentation für Details zu Aktualisierungen und wann sie angewendet werden.

Mehrregionale Bereitstellung

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 aufgelöst, sodass sie sowohl innerhalb Chinas als auch überall sonst auf der Welt zugänglich ist.

Globale Verwendung chinesischer Domains

Die chinesischen Domänen-URLs funktionieren reibungslos für Mehrregionen-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-basiertem Infrastruktur)
• Benutzer außerhalb Chinas (mit Zugriff auf dieselbe Infrastruktur über Alibaba-DNS)

Leistungsüberlegungen:

Während das .cn Domain ist global über Alibaba-DNS gelöst und funktioniert überall, ist es jedoch leicht weniger leistungsfähig für Benutzer außerhalb Chinas 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.

Tip

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 Leistungsverlust 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 überlegen:

• Einzelne App-Varianten mit unterschiedlichen Konfigurationen zu erstellen
• Umgebungs-basierte Konfigurationen zum dynamischen Festlegen der URLs zu verwenden
• Für verschiedene Regionen unterschiedliche Release-Kanäle zu erstellen

Wenn Sie bei der Umsetzung von Strategien für die Multi-Region-Veröffentlichung Unterstützung benötigen, wenden Sie sich bitte an support@capgo.app oder schließen Sie sich unserer Discord-Gemeinschaft an, um Hilfe zu erhalten.

Problembehandlung

Wenn Sie Probleme mit Updates in China haben:

1. Überprüfen Sie Ihre Konfiguration - Überprüfen Sie, ob alle drei URLs in Ihrem 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 nach Fehlermeldungen zu suchen
4. Testen Sie Updates - Versuchen Sie, ein neues Bundle hochzuladen und den Downloadprozess zu überwachen
5. Kontaktieren Sie den Support - Wenn Probleme anhalten, wenden Sie sich an uns bei support@capgo.app oder beitreten Sie unsere Discord-Gemeinschaft zur Unterstützung

Vorsicht

Stellen Sie sicher, dass Sie das .cn Domain (updater.capgo.com.cn) und nicht das Standard-Internationales Domain verwenden, wenn Sie sich für China einrichten.

Zukünftige Schritte

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

Weitermachen von "Using Capgo in China"

Wenn Sie "Using __CAPGO_KEEP_0__ in China" verwenden Verwendung von Capgo in China um die Live-Update-Lieferung zu planen, 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 Aktualisierungsverhalten, und Aktualisierungstypen für die Implementierungsdetails in Aktualisierungstypen.