App-Seite

Was zeigt die App-Seite?

Schauen wir uns zuerst die Hauptseite der App an:

In Capgo steht eine App für deine mobile Anwendung, die mit dem live update-System von Capgo integriert ist. Damit kannst du Updates, Channels und Geräte nahtlos verwalten.

Schauen wir uns das genauer an. Die Hauptseite der App ist in mehrere Kernbereiche unterteilt:

1. Obere Navigationsleiste: Bietet Zugriff auf die wichtigsten App-Management-Ansichten. Der Screenshot dient der Veranschaulichung; die aktuelle Console enthält:

   • Dashboard: Metriken und Zusammenfassungen für die App.
   • Observe (beta): Signale zu Native Launch, WebView, Issues und Release-Health.
   • Informationen: Zentrale App-Einstellungen und Details (siehe App-Informationen).
   • Bundles: Versionen und Releases.
   • Kanäle: Update-Channels und progressive Rollout-Steuerung.
   • Geräte: Registrierte Geräte und Overrides.
   • Logs: Log-Insights und Raw Logs.
   • Builds: Native Build Management.

2. Statistik-Anzeige: Visualisiert wichtige Metriken für den letzten Abrechnungszeitraum (die Daten beziehen sich auf Ihren Abrechnungstag, nicht auf den 1. des Monats):

   • Monatlich aktive Nutzer (8): Verfolgt die Anzahl der eindeutigen aktiven Nutzer im Zeitverlauf.
   • Speicherplatz (9): Zeigt den aktuellen Speicherverbrauch an.
   • Bandbreite (10): Zeigt die genutzte Bandbreite an.
   • Aktives Bundle (11): Zeigt die Verteilung aktiver Geräte auf verschiedene App-Bundles.

3. Zusammenfassende Karten: Offers a quick overview of key counts:

   • Bundle-Uploads (12): Gesamtzahl der hochgeladenen App-Bundles.
   • Update-Statistiken (13): Gesamtzahl der durchgeführten Updates, einschließlich Requests, Installationen und Fehlschlägen.
   • Deployment-Statistiken (14): Gesamtzahl der Deployments.

4. Anzeigeoptionen (15-18): Steuerelemente zum Filtern und Anzeigen der Statistiken:

   • Täglich (15): Statistiken täglich anzeigen.
   • Kumulativ (16): Kumulative Statistiken im Zeitverlauf anzeigen.
   • Abrechnungszeitraum (17): Statistiken für den aktuellen Abrechnungszeitraum anzeigen.
   • Zeitraum (18): Einen benutzerdefinierten Zeitraum wählen (z. B. letzte 30 Tage).

App-Informationen

Dieser Abschnitt entspricht dem Tab „Information“ (1) in der oberen Navigationsleiste. Hier kannst du wichtige Details und Einstellungen deiner App einsehen und verwalten.

App-Informationen Seite

Der Screenshot ist älter als die aktuelle Console und zeigt nicht alle aktuellen Einstellungen. Nutze die Feldbeschreibungen unten als maßgebliche Quelle.

Hier ist eine Übersicht der verfügbaren Felder und Aktionen:

• App-Icon (2): Zeigt das Icon deiner App an. Über den Button „Change“ kannst du ein neues Icon hochladen.
• App-ID (3): Eine eindeutige Kennung für deine App innerhalb von Capgo. Diese ID kann nicht geändert werden.
• App-Name (4): Der Anzeigename für deine App. Diesen kannst du bei Bedarf anpassen.
• Standard-Upload-Channel (5): Legt den Standard-Channel fest, in den neue Bundles hochgeladen werden. Über das Bearbeiten-Icon kannst du einen anderen Standard-Channel auswählen.
• Standard-Download-Channel (6): Legt den Standard-Channel fest, von dem Geräte Updates herunterladen. Über das Bearbeiten-Icon kannst du einen anderen Standard-Channel auswählen. Die Channel-Seite zeigt zwar an, ob ein Channel der Standard-Channel ist, geändert wird er aber hier und nicht über einen Toggle im Channel. Öffne einen Channel und klicke auf In App-Einstellungen verwalten um direkt zu diesem Feld zu springen. Siehe den Abschnitt zur Standard-Channel-Konfiguration unten für detaillierte Informationen.
• Nicht genutzte Bundles automatisch löschen (nach x Sek.) (7): Mit dieser Einstellung werden alte Bundles, die über einen bestimmten Zeitraum (in Sekunden) nicht genutzt wurden, automatisch gelöscht. Setzen Sie den Wert auf 0 um das automatische Löschen zu deaktivieren. Das hilft beim Speicherplatzmanagement und hält Ihre Bundle-Liste sauber.
• Bundle-Metadaten für Plugins freigeben (8): Wenn aktiviert, werden Bundle-Link- und Kommentarfelder an das Capacitor Updater-Plugin gesendet. Diese Funktion erfordert die Plugin-Version 7.35.0 oder höher.
• Anfragen von Provider-Infrastruktur blockieren: Bei Aktivierung lehnt Capgo Update-, Stats- und Channel-Self-Anfragen aus bekannten IP-Bereichen von Google- und Apple-Rechenzentren ab. Lassen Sie dies für normalen Produktionsverkehr aktiviert. Deaktivieren Sie es nur temporär, wenn Sie gezielt Tests aus der Provider-Infrastruktur durchführen. Neue Apps haben diesen Schutz standardmäßig aktiviert; bestehende Apps behalten ihre vorherige Einstellung bei, bis Sie diese ändern.
• App-Besitz übertragen (9): In diesem Abschnitt kannst du den Transfer deiner App in eine andere Organisation, der du angehörst, einleiten.
• App löschen Button: Löscht Ihre App unwiderruflich von Capgo. Dieser Vorgang kann nicht rückgängig gemacht werden und entfernt alle zugehörigen Daten, Bundles, Channels und Geräte.
• Update-Button: Speichert alle Änderungen, die du in den bearbeitbaren Feldern auf dieser Seite vorgenommen hast (z. B. App Name, Default Upload Channel, Auto Delete Bundles Einstellung).

Abschnitt zur Standard-Channel-Konfiguration

Der Standard-Download-Channel ist eine der wichtigsten Einstellungen für deine App. Sie legt fest, von welchem Channel neue Geräte Updates erhalten, wenn sie sich zum ersten Mal mit Capgo verbinden.

Funktionsweise der Default Channels

Wenn ein Gerät ein Update von Capgo anfordert, ermittelt das System den Channel basierend auf der folgenden Priorisierung (höchste Priorität zuerst):

1. Erzwungenes Device-Mapping: Wenn eine Device-ID in den Channel-Einstellungen explizit einem Channel zugewiesen wurde, gewinnt dieser Channel immer.
2. Cloud-Override: Falls das Gerät über das Dashboard oder Public API einem Channel zugewiesen wurde, gilt dieser Override.
3. Plugin setChannel(): Bei aktuellen Plugin-Versionen ist das eine lokale Zuweisung, kein Dashboard-Override. Siehe Wie ein Gerät einen Channel auswählt.
4. Capacitor Konfiguration defaultChannel: Wenn in deiner capacitor.config.* -Datei gesetzt, wird dies für Test-/Beta-Builds verwendet.
5. Standard-Download-Channel: Die hier konfigurierte Einstellung. Dies ist das, was ~99 % deiner Production-User nutzen werden.

Plattformspezifische Standard-Channels

Du kannst plattformspezifische Standard-Channels konfigurieren – zum Beispiel einen für iOS, einen für Android und einen für Electron. Das ist nützlich, wenn:

• Du möchtest Updates erst für eine Plattform und dann für die andere ausrollen
• Du benötigst unterschiedliche Update-Strategien pro Plattform
• Du testest eine neue Version auf einer Plattform, während die andere stabil bleibt

So legst du plattformspezifische Defaults fest:

1. Erstelle separate Channels für jede Plattform (zum Beispiel production-ios, production-android, und production-electron)
2. Aktiviere in den Channel-Einstellungen nur die relevante Plattform (iOS, Android oder Electron Toggle)
3. An App-Informationen), und setze jeden dieser Channels als Default Download Channel für die jeweilige Plattform. Capgo erlaubt mehr als einen Default, wenn die Channels unterschiedliche Plattformen ansprechen.

Wenn ein Gerät ein Update anfordert:

• iOS-Geräte erhalten Updates vom iOS-aktivierten Default Channel
• Android-Geräte erhalten Updates über den standardmäßig für Android aktivierten Channel

Ein einzelner Standard-Channel (für die meisten Apps empfohlen)

Für die meisten Anwendungen ist ein einziger Default Channel, der alle drei Kernplattformen unterstützt, der einfachste Ansatz:

1. Erstelle einen Channel (z. B. production)
2. Stelle sicher, dass die Toggles für iOS, Android und Electron aktiviert sind
3. Setze ihn unter „Default Download Channel“ auf App-Informationen

Dies gewährleistet ein konsistentes Verhalten über alle Plattformen hinweg und vereinfacht deinen Release-Workflow.

Standard-Channel ändern

Wenn du den Default Channel änderst:

• Neue Geräte erhalten sofort Updates über den neuen Standard
• Bestehende Geräte die bereits einem Channel zugewiesen sind (via Override oder Force), wechseln NICHT automatisch
• Um bestehende Geräte zu verschieben, müssen Sie entweder:
  • Nutzt setChannel() (oder unsetChannel()) aus der App. Das Löschen des Backend-Geräteeintrags löscht keine lokale setChannel() Zuweisung.
  • Sie im Dashboard auf den neuen Channel zwingen (console/API override; läuft nach 90 Tagen ab)
  • Den console/API override löschen, damit die Priorisierung greift. Geräte mit nur dem Cloud-Default nutzen dann den neuen Standard.

Tipp: Teste deinen neuen Standard-Channel immer erst mit einer kleinen Gruppe von Force-Devices, bevor du ihn für alle Nutzer standardmäßig festlegst.

Weiter von der App-Seite

Wenn du es nutzt App-Seite um Dashboard- und API-Operationen zu planen, verbinde es mit API Übersicht für Details zur Implementierung im API Overview, Einführung für die Implementierungsdetails in der Einleitung, API Schlüssel für die Implementierungsdetails in API Keys, Geräte für die Implementierungsdetails in Devices und Bundles für die Implementierungsdetails in Bundles.