Zum Inhalt springen

App-Seite

Zunächst 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. Sie ermöglicht Ihnen, Updates, Kanäle und Geräte reibungslos zu verwalten.

Hauptseite-Screenshot

Lassen Sie uns genauer hinschauen. Die Hauptseite der App ist in mehrere wichtige Bereiche unterteilt:

  1. Oberes Navigationsmenü: Bietet Zugriff auf verschiedene Abschnitte der App-Verwaltung:

    • Dashboard (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 und Verwaltung registrierter Geräte, einschließlich der Festlegung spezifischer Überschreibungen.
    • Protokolle (6): Zugriff auf detaillierte Protokolle und Fehlermeldungen für Ihre App.
    • Builds (7): Zugriff 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): Anzeigt die Bandbreitenutzung.
    • Aktiver Bundle (11): Zeigt die Verteilung der aktiven Geräte über verschiedene App-Bundles.
  3. Zusammenfassende Karten: Bietet einen schnellen Überblick über wichtige Zahlen:

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

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

Diese Sektion entspricht dem “Informationen”-Tab (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:

  • Anwendungsicon (2): Zeigt das Icon Ihrer Anwendung an. Klicken Sie auf den “Ändern”-Button, um ein neues Icon hochzuladen.
  • Anwendungs-ID (3): Eine eindeutige Identifikationsnummer für Ihre Anwendung innerhalb von Capgo. Diese ID kann nicht bearbeitet werden.
  • Anwendungsname (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 untenstehende Abschnitt "Kanal-Konfiguration" für weitere Informationen. Automatische Löschung von nicht verwendeten Paketen (nach x Sekunden) (7): Diese Einstellung ermöglicht die automatische Löschung alter Pakete, die nicht innerhalb einer bestimmten Zeit (in Sekunden) verwendet wurden. Setzen Sie auf "keine Löschung" um die automatische Löschung zu deaktivieren. Dies hilft bei der Verwaltung von Speicherplatz und hält Ihre Paketliste sauber.
  • 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. 0 Übertragung der Anwendungsbesitzrechte (9):
  • In diesem Abschnitt steht eine Option zur Verfügung, um die Übertragung Ihrer Anwendung an eine andere Organisation, der Sie angehören, zu initiieren. 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.
  • This setting allows you to automatically delete old bundles that haven’t been used for a specified duration (in seconds). Set to to disable auto-deletion.
  • Löschen-Button: Löscht Ihr Anwendungs-Verzeichnis permanent von Capgo. 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. Anwendungsname, 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 erhalten, wenn sie Updates anfordern.

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

  1. Zwingende Gerätemappe: Wenn das Geräte-ID explizit auf einen Kanal in den Kanal-Einstellungen gezwungen wird, gewinnt dieser Kanal immer.
  2. Cloud-Überschreibung: Wenn das Gerät einem Kanal via setChannel() oder manuell im Dashboard zugewiesen wurde, wird diese Überschreibung verwendet.
  3. Capacitor-Konfiguration defaultChannel: Wenn in Ihrem capacitor.config.* Datei gesetzt ist, wird diese für Test-/Beta-Builds verwendet.
  4. Standard-Download-Kanal: Die hier konfigurierte Einstellung – dies ist, was etwa 99% Ihrer Produktionsbenutzer verwenden werden.

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-geschützten Standardkanal
  • Android-Geräte erhalten Updates aus dem Android-geschützten 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 eine Überschreibung oder Zwang)
  • WIRD NICHT automatisch umschalten
    • Um bestehende Geräte umzuziehen, benötigen Sie entweder: setChannel() Verwenden Sie
    • 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)Tippsie