Zum Inhalt springen

App-Seite

Zuerst nehmen wir uns die Hauptseite der App vor:

In Capgo, stellt eine App Ihre mobile Anwendung dar, die mit Capgo’s Live-Update-System integriert ist. Es ermöglicht Ihnen, Updates, Kanäle und Geräte reibungslos zu verwalten.

Startseite-Screenshot

Schauen wir uns das genauer an. Die Hauptanwendungsoberfläche ist in mehrere wichtige Bereiche unterteilt:

  1. Haupt-Navigation-Leiste: Bietet Zugriff auf verschiedene Abschnitte der App-Verwaltung:

    • Übersicht (1): Die aktuelle Ansicht, die wichtige Metriken und Zusammenfassungen anzeigt.
    • Informationen (2): Zeigt die grundlegenden Einstellungen und Details Ihrer App an (siehe Abschnitt „App-Informationen“ unten).
    • Pakete (3): Verwalten Sie die Versionen und Releases Ihrer App.
    • Kanäle (4): Konfigurieren und verwalten Sie verschiedene Update-Kanäle (z.B. Produktions- und Beta-Versionen).
    • Geräte (5): Zugriff auf und Verwaltung der registrierten Geräte, einschließlich der Einstellung spezifischer Überschreibungen.
    • Protokolle (6): Zugriff auf detaillierte Protokolle und Fehlerberichte für Ihre App.
    • Builds (7): Zugriff auf und Verwaltung Ihrer App-Builds.
  2. Statistiken Anzeige: Visualisiert wichtige Metriken für das letzte Abrechnungszeitraum (Daten spiegeln die Nutzung ab dem Abrechnungstag wider, nicht den 1. des Monats):

    • Monatlich aktive Benutzer (8): Verfolgt die Anzahl der einzigartigen aktiven Benutzer über die Zeit.
    • Speicher (9): Zeigt die aktuelle Speicherplatzverbrauch.
    • Bandbreite (10): Zeigt die Bandbreitenutzung.
    • Aktiver Bundle (11): Zeigt die Verteilung der aktiven Geräte über verschiedene App-Bundles.
  3. Zusammenfassende Karten: Bietet einen schnellen Überblick über Schlüsselzahlen:

    • Bundle-Uploads (12): Gesamtzahl der hochgeladenen App-Bundles.
    • Aktualisierungsstatistiken (13): Gesamtzahl der durchgeführten Aktualisierungen, einschließlich Anfragen, Installationen und Fehlern.
    • Deployments-Statistiken (14): Gesamtzahl der Bereitstellungen.
  4. Anzeigeoptionen (15-18): Steuerungselemente für die Filterung und Anzeige der Statistiken:

    • Täglich (15): Statistiken auf Tagesbasis anzeigen.
    • Akkumulativ (16): Statistiken über die Zeit hinweg anzeigen.
    • Rechnungsperiode (17): Statistiken für die aktuelle Rechnungsperiode anzeigen.
    • Datenbereich (18): Wählen Sie einen benutzerdefinierten Zeitraum (z.B. die letzten 30 Tage).

Dieser Abschnitt entspricht der Schaltfläche “Informationen” (1) in der oberen Navigationsleiste. Hier können Sie wichtige Details und Einstellungen für Ihre Anwendung anzeigen und verwalten.

Anwendungsinformationen-Seite
Anwendungsinformationen-Seite

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

  • App-Icon (2): Zeigt das Icon Ihrer Anwendung an. Klicken Sie auf die Schaltfläche “Ändern” , 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 diesen wie erforderlich anpassen.
  • Standard-Upload-Kanal (5): Legt den Standardkanal fest, an den neue Pakete hochgeladen werden. Klicken Sie auf das Bearbeitungssymbol, um einen anderen Standardkanal auszuwählen.
  • Standardherunterladekanal (6): Legt den Standardkanal fest, von dem Geräte Updates herunterladen. Klicken Sie auf das Bearbeitungssymbol, um einen anderen Standardkanal auszuwählen. Siehe die Abschnitt "Standardkanal-Konfiguration" unten für weitere Informationen. Automatische Löschung von nicht verwendeten Paketen (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 auf um die automatische Löschung zu deaktivieren. Dies hilft bei der Verwaltung von Speicherplatz und hält Ihre Paketliste sauber. 0 Paketmetadaten an Plugin ausliefern (8):
  • Wenn aktiviert, werden die Paket-Link- und Kommentarfelder an das __CAPGO_KEEP_0__-Updater-Plugin gesendet. Diese Funktion erfordert eine Pluginversion von 7.35.0 oder höher. When enabled, bundle link and comment fields will be sent to the Capacitor Updater plugin. This feature requires plugin version 7.35.0 or higher.
  • In diesem Abschnitt steht eine Option zur Verfügung, um die Übertragung Ihrer Anwendung an eine andere Organisation, der Sie angehören, zu initiieren. Default Channel Configuration
  • Löschen-Button: Ihre Anwendung wird dauerhaft aus Capgo entfernt. Diese Aktion ist unwiderruflich und entfernt alle zugehörigen Daten, Pakete, Kanäle und Geräte.
  • Aktualisieren-Button: Speichert alle Änderungen, die Sie in den bearbeitbaren Feldern auf dieser Seite vorgenommen haben (z.B. App-Name, Standard-Upload-Kanal, Einstellung für automatisches Löschen von Paketen).

Die Standard-Download-Kanal ist eine der wichtigsten Einstellungen für Ihre App. Sie bestimmt, welcher Kanal neue Geräte bei ihrem ersten Anschluss an Capgo Updates von erhalten.

Wenn ein Gerät von Capgo ein Update anfordert, bestimmt das System auf der Grundlage der folgenden Prioritäten (höchste Priorität zuerst), welcher Kanal verwendet werden soll:

  1. Forced device mapping: Wenn die Geräte-ID explizit auf einen Kanal in den Kanal-Einstellungen gezwungen wird, gewinnt dieser Kanal immer.
  2. Cloud override: Wenn das Gerät einem Kanal via setChannel() oder manuell im Dashboard zugewiesen wurde, wird dieser Vorrang genutzt.
  3. Capacitor Konfiguration defaultChannel: Wenn in Ihrem capacitor.config.* Datei gesetzt, wird diese für Test-/Beta-Builds verwendet.
  4. Standard-Download-Kanal: Die hier konfigurierte Einstellung—dies wird von etwa ~99% Ihrer Produktionsbenutzer verwendet.

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 zu setzen:

  1. Erstellen Sie separate Kanäle für jede Plattform (zum Beispiel production-ios, production-android, und production-electron)
  2. In den Einstellungen jedes Kanals aktivieren Sie nur die relevanten Plattform (iOS, Android- oder Electron-Toggle)
  3. Markieren Sie beide Kanäle als „Standard“ – Capgo ermöglicht dies, wenn Kanäle unterschiedliche Plattformen ansteuern

Wenn ein Gerät eine Aktualisierung anfordert:

  • iOS-Geräte erhalten Updates aus dem iOS-geschalteten Standardkanal
  • Android-Geräte erhalten Updates aus dem Android-geschalteten Standardkanal

Für die meisten Anwendungen ist der einfachste Ansatz ein einzelner Standardkanal, der alle drei Kernplattformen unterstützt:

  1. Erstelle einen Kanal (z.B., production)
  2. Stelle sicher, dass die Schalter für iOS, Android und Electron aktiviert sind
  3. Markiere ihn als Standardkanal

Dies sichert eine konsistente Verhaltensweise auf allen Plattformen und vereinfacht dein Release-Workflow

Wenn du den Standardkanal änderst:

  • Neue Geräte werden sofort Updates vom neuen Standardkanal erhalten
  • Bestehende Geräte die bereits eine Kanalzuweisung haben (über die Überschreibung oder die Zwangszuweisung) werden NICHT automatisch umgestellt
  • Um bestehende Geräte umzustellen, benötigen Sie entweder:
    • Verwenden Sie setChannel() um sie programmatisch zu überschreiben
    • Zwingen Sie sie auf den neuen Kanal im Dashboard
    • Löschen Sie ihre Geräte-Einträge (sie werden sich mit dem neuen Standard neu anmelden)

Tippschritt: Testen Sie immer Ihre neue Standardkanal mit einer kleinen Gruppe von zwingend umgestellten Geräten, bevor Sie ihn für alle Benutzer als Standard setzen

Wenn Sie App Seite um die Dashboard- und API-Operationen zu planen und es mit API-Übersicht für die Implementierungsdetails in API-Übersicht, Einführung für die Implementierungsdetails in Einführung, API-Schlüssel für die Implementierungsdetails in API-Schlüssel, Geräte für die Implementierungsdetails in Geräte, und Pakete für die Implementierungsdetails in Pakete.