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 lebendigen Update-System integriert ist. Es ermöglicht Ihnen, Updates, Kanäle und Geräte reibungslos zu verwalten.

Hauptseite-Bildschirmfoto

Zurücktreten Sie ein Stück weit. Die Hauptseite der App ist in mehrere wichtige Bereiche unterteilt:

  1. Haupt-Navigation-Leiste: Bietet Zugriff auf die Haupt-Ansichten zur App-Verwaltung. Das Bildschirmfoto ist illustrierend; der aktuelle Konsole enthält:

    • Dashboard: Metriken und Zusammenfassungen für die App.
    • Beobachten (beta): Native-Start, WebView, Problem und Release-Statussignale.
    • Information: Kernanwendungs-Einstellungen und -Details (siehe Anwendungs-Informationen).
    • Pakete: Ausgaben und Releases.
    • Kanäle: Kanal-Updates und progressive Rollouts.
    • Geräte: Registrierte Geräte und -Überschreibungen.
    • Protokolle: Log-Insights und Rohprotokolle.
    • Builds: Native Build-Management.
  2. Statistik-Anzeige: Wichtige Metriken werden visualisiert, die sich auf das letzte Abrechnungsintervall beziehen (die Daten spiegeln die Nutzung des Abrechnungstages wider, nicht den 1. des Monats):

    • Monatlich aktive Benutzer (8): Verfolgt die Anzahl der eindeutigen aktiven Benutzer über die Zeit.
    • Speicher (9): Zeigt die aktuelle Speicherbelegung an.
    • Bandbreite (10): Zeigt die Bandbreitenverwendung an.
    • Aktives 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): Zahl der hochgeladenen App-Bundles.
    • Updates-Statistiken (13): Zahl der durchgeführten Updates, einschließlich Anfragen, Installationen und Fehlern.
    • Deployments-Statistiken (14): Zahl der durchgeführten Bereitstellungen.
  4. Einstellungen für die Anzeige (15-18): Steuerung für das Filtern und Anzeigen der Statistiken:

    • __CAPGO_KEEP_0__ (15 Tagen): Statistiken täglich anzeigen.
    • __CAPGO_KEEP_0__ (16): Statistiken über die Zeit anzeigen.
    • __CAPGO_KEEP_0__ (17): Statistiken für den aktuellen Abrechnungszeitraum anzeigen.
    • __CAPGO_KEEP_0__ (18): Eine benutzerdefinierte Zeitperiode auswählen (z.B. die letzten 30 Tage).

In diesem Abschnitt entspricht die Anzeige die „Informationen“-Schaltfläche (1) in der oberen Navigationsleiste. Hier können Sie wichtige Details und Einstellungen für Ihre Anwendung anzeigen und verwalten.

Anwendungsinformationen-Seite
Anwendungs-Informationen-Seite

Die Screenshot ist älter als die aktuelle Konsole und zeigt nicht alle aktuellen Einstellungen an. 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. Klicken Sie auf den "Ändern"-Button, 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. Klicken Sie auf den Bearbeitungs-Icon, 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. Siehe die untenstehende Standardkanal-Konfiguration Sektion für detaillierte Informationen.
  • Automatische Entfernen von nicht verwendeten Paketen (nach x Sekunden) (7): Dieses Einstellung ermöglicht Ihnen, alte Pakete, die nicht innerhalb einer bestimmten Zeit verwendet wurden, automatisch zu löschen. Setzen Sie es auf 0 um die automatische Löschung zu deaktivieren. Dies hilft bei der Verwaltung des Speichers und hält Ihre Paketliste sauber.
  • Paketmetadaten an Plugin ausliefern (8): 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.
  • Updater-Plugin gesendet. Diese Funktion erfordert eine Pluginversion von 7.35.0 oder höher. When enabled, Capgo rejects update, stats, and channel-self requests from known Google and Apple datacenter IP ranges. Leave it enabled for normal production traffic. Disable it temporarily only when you intentionally test from provider infrastructure. New apps enable this protection by default; existing apps retain their previous disabled setting until you change it.
  • Wenn aktiviert, lehnt Updates, Statistiken und Anfragen an die eigenen Kanäle 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 Infrastruktur des Anbieters testen. Neue Apps aktivieren diese Schutzfunktion standardmäßig; bestehende Apps behalten ihre vorherige deaktivierte Einstellung, bis Sie sie ändern.
  • Entferne-App-Schaltfläche: Permanente Löschung Ihrer Anwendung aus Capgo. Diese Aktion ist unwiderruflich und entfernt alle zugehörigen 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. Anwendungsname, Standard-Upload-Kanal, Einstellung für automatisches Löschen von Paketen).

Der 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 ein Update anfordert, bestimmt das System auf der Grundlage der folgenden Prioritäten (höchste Priorität zuerst):

  1. Zwingende Gerätemappe: Wenn der Geräteeintrag 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.* file gesetzt ist, wird diese für Test-/Beta-Builds verwendet.
  4. Standard-Download-Kanal: Die hier konfigurierte Einstellung – das 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:

  • Wenn Sie Updates für eine Plattform vor der anderen ausrollen möchten
  • Wenn Sie unterschiedliche Updatestrategien pro Plattform benötigen
  • Wenn 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-androidund 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 die Kanäle unterschiedliche Plattformen ansteuern

Wenn ein Gerät einen Update-Antrag stellt:

  • 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. Erstellen Sie einen Kanal (z.B. production)
  2. Stellen Sie sicher, dass die Schalter für iOS, Android und Electron aktiviert sind
  3. Markieren Sie ihn als Standardkanal

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

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 umgeschaltet
  • Um bestehende Geräte umzuziehen, benötigen Sie entweder:
    • Verwenden Sie setChannel() um sie programmatisch zu überschreiben
    • Zwingen Sie sie in der Dashboard-Oberfläche auf den neuen Kanal
    • Löschen Sie ihre Geräte-Einträge (sie werden sich mit dem neuen Standard neu anmelden)

Tipps: Testen Sie immer Ihre neue Standardkanal-Instanz mit einer kleinen Gruppe von zwingend zugewiesenen Geräten, bevor Sie ihn für alle Benutzer als Standard einrichten

Wenn Sie Anwendungsseite um die Planungs-Übersicht 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äten und Bundles für die Implementierungsdetails in Bundles.