Capgo in China verwenden

Wenn Sie Ihre App für Benutzer in China bereitstellen, müssen Sie Capgo für die Verwendung regionaler OST-URLs (Object Storage Technology) konfigurieren, um zuverlässige und schnelle Updates sicherzustellen.

Warum China-spezifische URLs verwenden?

Aufgrund der Netzwerkinfrastruktur und Vorschriften in China (der Great Firewall) können direkte Verbindungen zu internationalen Servern langsam oder unzuverlässig sein. Capgo stellt dedizierte OST-URLs mit Daten in Hongkong bereit, 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 spezifische URLs in Ihrer Capacitor-Konfigurationsdatei festlegen. Diese URLs verweisen auf die in Hongkong basierende Infrastruktur von Capgo.

Öffnen Sie Ihre capacitor.config.ts-Datei

Fügen Sie die folgende Konfiguration zum CapacitorUpdater-Plugin-Abschnitt 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;

Bauen Sie Ihre App neu, um die Änderungen anzuwenden:
Terminal-Fenster
```
npm run build
npx cap sync
```

Konfigurationsdetails

Hier ist, was jede URL macht:

updateUrl: https://updater.capgo.com.cn/updates - Wird verwendet, um verfügbare Updates für Ihre App zu überprüfen und herunterzuladen
statsUrl: https://updater.capgo.com.cn/stats - Wird verwendet, um Analysen und Nutzungsstatistiken an Capgo zurückzumelden
channelUrl: https://updater.capgo.com.cn/channel_self - Wird verwendet, um Kanalkonfiguration abzurufen und zu bestimmen, welche Updates angewendet werden

Empfohlene Einstellungen für China

Aufgrund von Netzwerkleistungseinschränkungen durch die Great Firewall of China haben wir spezifische Empfehlungen für Apps, die in Festlandchina bereitgestellt werden:

Direkte Updates deaktivieren

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

Verwenden Sie stattdessen das Standard-Update-Verhalten, bei dem Updates im Hintergrund heruntergeladen und angewendet werden, wenn die App in den Hintergrund geht oder neu startet. Dies bietet eine zuverlässigere Erfahrung für Ihre Benutzer.

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: false, // Empfohlen für China
      updateUrl: 'https://updater.capgo.com.cn/updates',
      statsUrl: 'https://updater.capgo.com.cn/stats',
      channelUrl: 'https://updater.capgo.com.cn/channel_self',
    },
  },
};

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, // Empfohlen: für bessere Zuverlässigkeit in China deaktivieren
      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:

Ein neues Bundle zu Capgo hochladen:

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

Ihre App auf einem Testgerät in China installieren
Den Update-Prozess überwachen:
Terminal-Fenster
```
npx @capgo/cli@latest app debug
```
Überprüfen, dass Updates von den China OST-URLs heruntergeladen werden

Multi-Region-Bereitstellung

Wenn Ihre App Benutzer sowohl innerhalb als auch außerhalb Chinas bedient, können Sie die chinesische Domain-Konfiguration für alle Benutzer weltweit verwenden. Die updater.capgo.com.cn-Domain wird dank der Alibaba DNS-Infrastruktur global aufgelöst und ist sowohl in China als auch überall sonst auf der Welt zugänglich.

Chinesische Domains global verwenden

Die chinesischen Domain-URLs funktionieren nahtlos für Multi-Region-Apps:

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: false, // Empfohlen für China-Benutzer
      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 Festlandchina (verwenden in Hongkong basierende Infrastruktur)
Benutzer außerhalb Chinas (greifen auf dieselbe Infrastruktur über Alibaba DNS zu)

Leistungsüberlegungen:

Obwohl die .cn-Domain global über Alibaba DNS aufgelöst wird und überall funktioniert, ist sie für Benutzer außerhalb Chinas im Vergleich zur Standard-Domain (api.capgo.app), die direkt von Cloudflare aufgelöst wird, wo unser Backend gehostet ist, etwas weniger leistungsfähig. Die DNS-Auflösung ist jedoch schnell, sodass der Leistungsunterschied minimal ist und die Benutzererfahrung nicht wesentlich beeinträchtigt.

Alternative: Regionsspezifische Konfigurationen

Wenn Sie es vorziehen, für jede Region unterschiedlich zu optimieren, können Sie auch in Betracht ziehen:

Separate App-Varianten mit unterschiedlichen Konfigurationen zu erstellen
Umgebungsbasierte Konfiguration zu verwenden, um die URLs dynamisch festzulegen
Verschiedene Release-Kanäle für verschiedene Regionen zu erstellen

Wenn Sie Unterstützung bei Multi-Region-Bereitstellungsstrategien benötigen, kontaktieren Sie uns bitte unter support@capgo.app oder treten Sie unserer Discord-Community bei, um Hilfe zu erhalten.

Fehlerbehebung

Wenn Sie Probleme mit Updates in China haben:

Überprüfen Sie Ihre Konfiguration - Überprüfen Sie doppelt, dass alle drei URLs in Ihrer capacitor.config.ts korrekt festgelegt sind
Netzwerkkonnektivität prüfen - Stellen Sie sicher, dass Ihr Gerät die updater.capgo.com.cn-Domain erreichen kann
Protokolle überprüfen - Verwenden Sie npx @capgo/cli@latest app debug, um auf Fehlermeldungen zu prüfen
Updates testen - Versuchen Sie, ein neues Bundle hochzuladen und den Download-Prozess zu überwachen
Support kontaktieren - Wenn Probleme bestehen bleiben, wenden Sie sich an uns unter support@capgo.app oder treten Sie unserer Discord-Community bei, um Unterstützung zu erhalten

Nächste Schritte

Erfahren Sie mehr über Update-Verhalten, um anzupassen, wann Updates angewendet werden
Erkunden Sie Kanäle, um verschiedene Release-Tracks zu verwalten
Überprüfen Sie Verschlüsselung, um Ihre Updates zu sichern