Eigene Domain
Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses Plugin.
Verwenden Sie einen eigenen Hostnamen, z. B. updates.example.com, for your app’s Live Updates API requests while Capgo continues to manage your channels, bundles, and rollouts.
Eigene Domains sind verfügbar auf Enterprise-Plan. Organisations-Admins können im Console einen Live Updates API-Hostnamen hinzufügen, die bereitgestellten DNS-Einträge veröffentlichen und den Aktivierungsstatus prüfen.
1. Eigene Domain hinzufügen
Abschnitt mit dem Titel „1. Eigene Domain hinzufügen“- Öffne die Capgo-Konsole und wähle deine Organisation aus.
- Gehe zu Einstellungen → Organisation → Allgemein und finde Eigene Domain. Du benötigst Berechtigung zur Aktualisierung der Organisationseinstellungen sowie einen aktiven Enterprise-Plan, um eine Domain hinzuzufügen.
- Gib einen Hostnamen wie
updates.example.comein, ohnehttps://, einen Pfad oder ein Wildcard. - Klicken Domain hinzufügen. Die Konsole zeigt die zu veröffentlichenden DNS-Einträge und einen Verifizierung ausstehend Status.
Sie können pro Organisation einen Live Updates API-Hostnamen konfigurieren. Sie müssen in der Lage sein, dessen DNS-Einträge zu bearbeiten.
Wenn die Benutzerdefinierte Domain Option ist nicht verfügbar, wenden Sie sich an Ihren Enterprise-Support oder senden Sie eine E-Mail support@capgo.app mit Ihrer Organisation, App-IDs, dem gewünschten Hostnamen und dem DNS-Anbieter. Wenden Sie sich außerdem vor der Einrichtung an den Support, bestimmte Datenresidenzregion oder einen benutzerdefinierten Hostnamen für Bundle-Downloads.
2. DNS konfigurieren und HTTPS verifizieren
Abschnitt mit dem Titel „2. DNS konfigurieren und HTTPS überprüfen“Fügen Sie bei Ihrem DNS-Anbieter die in der Konsole angezeigten oder vom Support bereitgestellten Einträge hinzu. Kopieren Sie den Eintragstyp, den Namen und den Wert exakt, einschließlich des CNAME und aller TXT-Einträge zur Bestätigung der Eigentümerschaft oder des Zertifikats. Klicken Sie auf einen Wert in der Konsole, um ihn zu kopieren. Wenn Sie Cloudflare DNS verwenden, behalten Sie den CNAME nur DNS außer Support bestätigt eine andere Einstellung.
Verwenden Sie das bereitgestellte Ziel, anstatt von einem CNAME auszugehen plugin.capgo.app ausreicht. Lassen Sie die DNS-Einträge bestehen, solange die Domain in Verwendung ist.
Nachdem die DNS-Einträge propagiert sind, klicken Sie auf Status aktualisieren. Die Console zeigt Aktiv nur an, wenn sowohl der Hostname als auch sein HTTPS-Zertifikat aktiv sind; dann bietet sie Updater-Konfiguration kopierenBei einem supportgestützten Setup bitten Sie den Support, die Aktivierung zu bestätigen. DNS und TLS-Konnektivität können Sie auch so prüfen:
dig updates.example.comcurl -v https://updates.example.com/updatesErsetze updates.example.com mit Ihrem bereitgestellten Hostnamen. Der curl Befehl prüft DNS, TLS und HTTP-Konnektivität; ein GET-Request an /updates ist kein gültiger Update-Check und kann einen API-Fehler zurückgeben. Prüfen Sie den tatsächlichen Update-Flow mit einem nativen Test-Build in Schritt 4.
3. Updater konfigurieren
Abschnitt mit dem Titel „3. Updater konfigurieren“Sobald die Domain aktiv ist, kopiere die Updater-Konfiguration aus der Console und trage alle drei URLs in capacitor.config.tsein. Für einen Hostnamen, der mit den Standardpfaden Capgo und API bereitgestellt wurde, verwende:
import type { CapacitorConfig } from '@capacitor/cli';
const config: CapacitorConfig = { appId: 'com.example.app', appName: 'My App', webDir: 'dist', plugins: { CapacitorUpdater: { autoUpdate: 'atBackground', updateUrl: 'https://updates.example.com/updates', statsUrl: 'https://updates.example.com/stats', channelUrl: 'https://updates.example.com/channel_self', }, },};
export default config;Ersetze die Beispiel-URLs durch die genauen URLs, die in der Console angezeigt oder vom Support bestätigt wurden. Behalte deine bestehenden App-Einstellungen und die übrigen Plugin-Optionen bei.
| Einstellung | Zweck |
|---|---|
updateUrl | Prüft, ob ein Bundle verfügbar ist. |
statsUrl | Meldet Update-Statistiken. |
channelUrl | Verarbeitet Device-Channel-Operationen. |
4. Synchronisieren, testen und releasen
Section titled “4. Sync, test, and release”Synchronisieren Sie die Konfiguration in Ihre nativen Projekte:
npx cap syncErstellen und installieren Sie eine native Testversion, dann:
- Laden Sie ein Test-Bundle in einen Test-Channel hoch, und zwar mit Ihrem üblichen Capgo-Workflow.
- Prüfen Sie die nativen Device-Logs, um sicherzustellen, dass Update-Anfragen Ihren Custom-Hostname erreichen und das Bundle erfolgreich heruntergeladen und installiert wird.
- Stellen Sie sicher, dass Update-Statistiken in der Console und bei Test-Channel-Operationen erscheinen, falls Ihre App diese nutzt.
- Veröffentlichen Sie eine neue native App-Version über Ihren üblichen Store-Distributionsprozess.
Ältere native Installationen nutzen weiterhin ihre konfigurierten Endpoint-URLs, bis die Nutzer die neue native Version installieren. Der Standard-Hostname des Updaters ist plugin.capgo.app, den Capgo verwaltet. Wenn Sie von einem anderen Custom-Hostname migrieren, den Sie selbst kontrollieren, halten Sie dessen DNS-Einträge und den Service aktiv, bis diese Nutzer migriert sind. Channels, Bundle-Uploads und Rollbacks nutzen weiterhin Ihre normale Capgo Console und Ihren CLI-Workflow.
Fehlerbehebung
Abschnitt mit dem Titel „Troubleshooting“Um eine Domain zu entfernen, verwenden Sie Domain entfernen → Entfernen bestätigen in den Organisationseinstellungen. Veröffentlichen Sie zuerst eine native App-Version mit den Ersatz-Endpoints und erlauben Sie Nutzern die Migration: Ältere Installationen verlieren den Zugriff über den entfernten Hostnamen. Entfernen Sie die Domain, bevor Sie die Organisation löschen.
- DNS löst nicht auf: Prüfen Sie den Record-Namen und das Ziel anhand der vom Support bereitgestellten Werte und prüfen Sie die Propagation bei Ihrem DNS-Anbieter.
- HTTPS schlägt fehl: Bitten Sie den Support, die Hostname-Aktivierung und die Zertifikatsbereitstellung zu prüfen, bevor Sie den nativen Build veröffentlichen.
- Anfragen verwenden weiterhin
plugin.capgo.app: Bestätigen Sie alle drei URLs, führen Sie ausnpx cap sync, bauen Sie neu und installieren Sie die neue native Version. - Bundle-Downloads verwenden einen anderen Hostnamen: Die Update-Antwort liefert die Download-URL. Fragen Sie den Support nach Custom Bundle Delivery oder siehe Eigener Speicher wenn Sie die Bundle-Speicherung selbst verwalten möchten.
- Updates schlagen trotz gültigem HTTPS fehl: die App-ID, den Channel, die native Version, den Zeitstempel der Anfrage und die nativen Logs mit Capgo Support.
Siehe Updater-Einstellungen für die vollständige Konfigurationsreferenz und Datenstandort für regionale Endpoint-Anforderungen.