App-Seite
Einen Setup-Vorschlag mit den Installationsanweisungen und der vollständigen Markdown-Dokumentation für diesen Plugin kopieren.
Was zeigt die App-Seite?
Abschnitt mit dem Titel “Was zeigt die App-Seite?”Zunächst möchten wir uns die Hauptseite der App ansehen:
In Capgo, stellt eine App Ihre mobile Anwendung dar, die mit Capgo’s Live-Update-System integriert ist. Sie ermöglicht es Ihnen, Updates, Kanäle und Geräte reibungslos zu verwalten.

Lasst uns genauer hinschauen. Die Hauptseite der App ist in mehrere wichtige Bereiche unterteilt:
-
Oberes Navigationsmenü: Bietet Zugriff auf die Hauptansichten der App-Verwaltung. Das Bildschirmfoto ist illustrierend; der aktuelle Konsole enthält:
- Übersicht: Metriken und Zusammenfassungen für die App.
- Beobachten (beta): Native Start, WebView, Problem und Release-Statussignale.
- Information: Zentrale App-Einstellungen und -Details (siehe App-Information).
- Pakete: Versionen und Releases.
- Kanäle: Kanäle für Updates und progressive Rollouts.
- Geräte: Registrierte Geräte und -Überschreibungen.
- Protokolle: Log-Analyse und Rohprotokolle.
- Builds: Native Build-Management.
-
Statistik-Anzeige: Wichtige Metriken werden visualisiert, die sich auf das letzte Abrechnungszeitraum beziehen (die Daten spiegeln die Nutzung vom Abrechnungstag wider, nicht vom 1. des Monats):
- Monatlich aktive Benutzer (8): Verfolgt die Anzahl der eindeutigen aktiven Benutzer im Laufe der Zeit.
- Speicher (9): Zeigt die aktuelle Speicherbelegung an.
- Bandbreite (10): Zeigt die Bandbreitenutzung an.
- Aktives Bundle (11): Zeigt die Verteilung der aktiven Geräte über verschiedene App-Bundles.
-
Zusammenfassende Karten: Bietet einen schnellen Überblick über Schlüsselzahlen:
- Bundle-Uploads (12): Zahl der hochgeladenen App-Bundles.
- Updates-Statistiken (13): Zahl der durchgeführten Updates, einschließlich Anfragen, Installationen und Fehlschlägen.
- Deployments-Statistiken (14): Zahl der durchgeführten Bereitstellungen.
-
Anzeigeoptionen (15-18): Steuerungselemente für die Filterung und Anzeige der Statistiken:
- Täglich (15): Ziehen Sie täglich Statistiken an.
- Gesamt (16): Blicken Sie auf kumulative Statistiken über die Zeit.
- Rechnungsperiode (17): Blicken Sie auf Statistiken für die aktuelle Rechnungsperiode.
- Datenbereich (18): Wählen Sie einen benutzerdefinierten Zeitraum (z.B. die letzten 30 Tage).
Anwendungsinformationen
Abschnitt mit dem Titel “Anwendungsinformationen”In diesem Abschnitt entspricht die “Information”-Schaltfläche (1) in der oberen Navigationsleiste. Hier können Sie wichtige Details und Einstellungen für Ihre Anwendung anzeigen und verwalten.

Die Screenshot ist älter als der aktuelle Konsolen und zeigt nicht alle aktuellen Einstellungen. Verwenden Sie die Beschreibungen der Felder unten als Quelle der Wahrheit.
Hier ist eine Auflistung der verfügbaren Felder und Aktionen:
- App-Icon (2): Zeigt das Icon Ihrer Anwendung an. Sie können auf den "Ändern"-Button klicken, um ein neues Icon hochzuladen.
- App-ID (3): Eine eindeutige Identifikationsnummer für Ihre Anwendung innerhalb von Capgo. Diese ID ist nicht bearbeitbar.
- App-Name (4): Der Anzeigename für Ihre Anwendung. Sie können diese wie erforderlich ändern.
- Standard-Upload-Kanal (5): Legt den Standardkanal fest, an den neue Pakete hochgeladen werden. Sie können auf den Bearbeitungs-Icon klicken, um einen anderen Standardkanal auszuwählen.
- Standard-Download-Kanal (6): Legt das Standardkanal fest, von dem Geräte Updates herunterladen werden. Klicken Sie auf das Bearbeitungssymbol, um ein anderes Standardkanal auszuwählen. Die Kanal-Seite zeigt an, ob ein Kanal das Standardkanal ist, aber Sie ändern es hier, nicht mit einem Schalter auf dem Kanal. Öffnen Sie einen Kanal und klicken Sie Verwalten Sie in App-Einstellungen um zu diesem Feld zu springen. Siehe den Standardkanal-Konfiguration Abschnitt unten für detaillierte Informationen.
- Automatisch löschen Sie nicht verwendete Pakete (nach x Sekunden) (7): Dieses Einstellung ermöglicht Ihnen, alte Pakete, die nicht innerhalb einer bestimmten Dauer (in Sekunden) verwendet wurden, automatisch zu löschen. Setzen Sie es auf
0um die automatische Löschung zu deaktivieren. Dies hilft bei der Verwaltung des Speichers und hält Ihre Paketliste sauber. - Paketmetadata an Plugin ausliefern (8): Wenn aktiviert, werden die Paketlink- und Kommentarfelder an den Capacitor-Updater-Plugin gesendet. Diese Funktion erfordert eine Pluginversion von 7.35.0 oder höher.
- Blockieren Sie Anfragen an die Infrastruktur des Anbieters: Wenn aktiviert, lehnt Capgo Updates, Statistiken und Anfragen an den eigenen Kanal von bekannten Google- und Apple-Datacenter-IP-Adressen ab. Lassen Sie es für normalen Produktionsverkehr aktiviert. Deaktivieren Sie es nur temporär, wenn Sie absichtlich von der Anbieter-Infrastruktur testen. Neue Apps aktivieren diese Schutzfunktion standardmäßig; bestehende Apps behalten ihre vorherige deaktivierte Einstellung, bis Sie sie ändern.
- Übertragung der App-Besitzrechte (9): Dieser Abschnitt bietet die Möglichkeit, die Übertragung Ihrer Anwendung an eine andere Organisation, der Sie angehören, zu initiieren.
- Löschen-App-Schaltfläche: Löscht Ihre Anwendung dauerhaft von Capgo. Diese Aktion ist unwiderruflich und entfernt alle damit verbundenen Daten, Pakete, Kanäle und Geräte.
- aktualisieren-Schaltfläche: Speichert alle Änderungen, die Sie an den bearbeitbaren Feldern auf dieser Seite vorgenommen haben (z.B. App-Name, Standard-Upload-Kanal, Einstellung für automatisches Löschen von Paketen).
Standardkanal-Konfiguration
Abschnitt mit der Überschrift „Standardkanal-Konfiguration“Der Standard-Download-Kanal ist eine der wichtigsten Einstellungen für Ihre App. Sie bestimmt, welcher Kanal neue Geräte bei ihrer ersten Verbindung zu Capgo Updates erhalten.
Wie Standardkanäle funktionieren
Abschnitt mit dem Titel “Wie Default-Canäle funktionieren”Wenn ein Gerät von Capgo eine Aktualisierung anfordert, bestimmt das System auf der Grundlage der folgenden Prioritäten (höchste Priorität zuerst), welchen Kanal zu verwenden ist:
- Zwingende Gerätemap: Wenn das Gerätee-ID explizit auf einen Kanal in den Kanal-Einstellungen gezwungen wird, gewinnt dieser Kanal immer.
- Cloud-Übernahme: Wenn das Gerät einem Kanal von der Dashboard- oder Public-API-Oberfläche zugewiesen wurde, wird dieser Übernahme verwendet.
- Plugin
setChannel(): Bei aktuellen Plugin-Versionen handelt es sich um eine lokale Zuweisung, nicht um eine Dashboard-Übernahme. Siehe Wie ein Gerät einen Kanal auswählt. - Capacitor-Konfiguration
defaultChannel: Wenn dies in Ihremcapacitor.config.*Datei gesetzt ist, wird dies für Test-/Beta-Builds verwendet. - Standard-Download-Kanal: Die hier konfigurierte Einstellung. Dies ist das, was etwa 99 % Ihrer Produktionsbenutzer verwenden werden.
Plattform-spezifische Standardkanäle
Sektion mit dem Titel “Plattform-spezifische Standardkanäle”Sie können plattform-spezifische Standardkanäle konfigurieren – zum Beispiel einen für iOS, einen für Android und einen für Electron. Dies ist nützlich, wenn:
- Sie Updates für eine Plattform vor der anderen ausrollen möchten
- Sie unterschiedliche Updatestrategien pro Plattform benötigen
- Sie eine neue Version auf einer Plattform testen, während die andere stabil bleibt
Um plattform-spezifische Standards einzurichten:
- Erstellen Sie separate Kanäle für jede Plattform (zum Beispiel
production-ios,production-android, undproduction-electron) - Konfigurieren Sie in den Einstellungen jedes Kanals nur die relevanten Plattform (iOS-, Android- oder Electron-Toggle)
- On Anwendungsinformationen, setze jede dieser Kanäle als Standard-Download-Kanal für seine Plattform. Capgo ermöglicht mehr als einen Standard, wenn die Kanäle unterschiedliche Plattformen anpeilen.
Wenn ein Gerät einen Update anfordert:
- iOS-Geräte erhalten Updates aus dem iOS-fähigen Standardkanal
- Android-Geräte erhalten Updates aus dem Android-fähigen Standardkanal
Einziger Standardkanal (Empfohlen für die meisten Apps)
Sektion mit dem Titel “Einziger Standardkanal (Empfohlen für die meisten Apps)”Für die meisten Anwendungen ist der einfachste Ansatz ein einziger Standardkanal, der alle drei Kernplattformen unterstützt:
- Erstelle einen Kanal (z.B.
production) - Stelle sicher, dass die iOS-, Android- und Electron-Toggle aktiviert sind
- Setze ihn als Standard-Download-Kanal auf Anwendungsinformationen
Dadurch wird eine konsistente Verhaltensweise auf allen Plattformen gewährleistet und wird Ihr Release-Workflow vereinfacht.
Änderung der Standardkanal
Abschnitt mit dem Titel „Änderung der Standardkanal“Wenn Sie den Standardkanal ändern:
- Neue Geräte werden sofort Updates vom neuen Standardkanal erhalten.
- Bestehende Geräte die bereits eine Kanalzuweisung (über eine Überschreibung oder eine Zwangszuweisung) haben, werden NICHT automatisch umgestellt.
- Um bestehende Geräte umzustellen, müssen Sie entweder:
- Verwenden Sie
setChannel()(oderunsetChannel()Entfernen Sie die Backend-Geräte-Registrierung. Die Löschung der Backend-Geräte-Registrierung löscht nicht die lokalesetChannel()Zuweisung. - Zwingen Sie sie zur neuen Kanal in der Konsole (console/API überschreibt; gilt nach 90 Tagen)
- Löschen Sie die Konsole/API-Überschreibung, damit sie durch die Vorzugsetzung fallen. Geräte, die nur die Cloud-Standard haben, nehmen dann den neuen Standard auf.
- Verwenden Sie
Tipp: Testen Sie immer Ihre neue Standardkanal mit einer kleinen Gruppe von zwingenden Geräten, bevor Sie ihn für alle Benutzer zum Standard machen.
Fortsetzen von App-Seite
Sektion mit dem Titel “Fortsetzen von App-Seite”Wenn Sie die App-Seite verwenden, um das Dashboard und die API-Operationen zu planen, verbinden Sie sie mit API-Übersicht zur Detailinformation in API Übersicht Einführung zur Detailinformation in Einführung API Schlüssel zur Detailinformation in API Schlüssel Geräte zur Detailinformation in Geräte und Pakete zur Detailinformation in Pakete.