Zum Inhalt springen

Kanäle

Wie Capgo einen Kanal (Priorität) auswählt.

Wie Capgo einen Kanal (Priorität) auswählt

Wenn ein Gerät Capgo um eine Aktualisierung bittet, wird der zu verwendende Kanal wie folgt bestimmt (höchste Priorität zuerst):

  1. Zwangsmapping von Geräten: Wenn der Geräte-ID explizit einem Kanal zugeordnet wird (siehe die Zwangsmapping von Geräten Liste innerhalb der Kanal-Einstellungen), gewinnt dieser Kanal immer.
  2. Cloud-Übernahme (erstellt durch setChannel() oder Webapp-Aktion): Aufrufen von setChannel (oder Ändern des Kanal des Geräts im Dashboard) schreibt eine persistente Überschreibung im Cloud, die an diesem Geräte-ID geknüpft ist. Diese Überschreibung wird nach der Zwangsmapping, aber vor den Standards berücksichtigt. Wiederherstellen der App tut dies nicht; Löschen der Geräte-Eintrag tut.
  3. Capacitor Konfiguration defaultChannel (Testbau Standard): Für interne / Beta / Testversionen können Sie defaultChannel (Legacy-Schlüssel channel) in capacitor.config.* so starten Testgeräte auf einem Vorabkanal (z.B. beta, pr-123). Wenn dieser fehlt, wird das Gerät auf den Cloud-Standard weitergeleitet. Produktionssysteme lassen diesen normalerweise ungesetzt.
  4. Cloud-Standardkanal (Hauptstrategie für etwa 99 % der Nutzer): Der Hauptproduktionskanal, auf den sich fast alle echten Benutzer landen. Jedes neue Gerät ohne Zwang, ohne Übernahme und ohne Konfiguration defaultChannel verwendet diesen. Eine Änderung rollt (oder rollt zurück) für alle in Sekunden – kein neuer Binary.

Warum der Cloud-Standard ist der Hauptweg:

  • Sofortige Bereitstellung oder Rolloback ohne Wiederaufbau oder Neuveröffentlichung von nativen Binären.
  • Ein Ort, um die iOS-, Android- und Electron-Verhalten zu verwalten.
  • Sicherer: Sie können die Bundles bestätigen und die Einstellungen überprüfen, bevor Sie die Standardwerte ändern.
  • Nachvollziehbare Änderungen (Mitarbeiter können im UI / Protokollen sehen, wer was geändert hat). Designprinzip: Schichten oben (zwingen / überschreiben / Konfiguration) sind Ausnahmen

(Einzelnen Benutzer debuggen, QA-Switching, Testbuild-Standard). Normalbenutzer fließen in den Cloud-Standard. Die Änderung des Cloud-Standardkanals beeinflusst neue

  • Wird nicht erzwungen
  • Haben Sie bereits eine Cloud-Überschreibung
  • Haben Sie keine App-Ebene defaultChannel definiert

Wenn ein Testbuild mit defaultChannel: 'beta' und Sie später die Cloud-Standard auf productiongerüsteten Geräte, die auf beta durch die Konfiguration bleiben, bis Sie: (a) sie mit setChannel()übernehmen, (b) sie zwingen oder (c) die Geräte-Einträge löschen.

Geräte bleiben auf ihrem aktuellen Kanal, bis Sie:

  • Sie auf einen anderen Kanal zwingen.
  • Aufrufen setChannel() (Ersetzen Sie die Cloud-Überschreibung) oder ändern Sie es manuell im Dashboard.
  • Entfernen / archivieren Sie den Kanal, auf dem sie sich befinden (dann fallen sie bei der nächsten Überprüfung wieder durch die Präzedenz zurück).

Wenn ein Kanal für eine Plattform deaktiviert ist (siehe iOS / Android / Electron-Schaltflächen) und sonst ausgewählt worden wäre, springt die Auswahl darüber hinweg und fällt auf das nächste Regel zurück.

Hinweis: Die Einstellung defaultChannel bedeutet, dass eine Änderung einen neuen Binary erfordert; verwenden Sie es absichtlich für Test/QA, nicht für allgemeine Produktionssteuerung.

capacitor.config.ts
// Example: a TestFlight or internal QA build defaults to the beta channel.
const config = {
plugins: {
Capgo: {
defaultChannel: 'beta', // Test build default. Omit in production so users attach to cloud default.
// legacy key: channel
},
},
};
export default config;

Wenn Sie später die Standard-Einstellung im Dashboard auf productionändern, werden Geräte, die bereits auf einem anderen Kanal (via Konfiguration, Überschreibung oder Zwang) sind, NICHT automatisch umgestellt; nur frische Geräte (oder solche, deren Überschreibung/Zwang Sie löschen) greifen es auf.


Zunächst möchten wir uns die Kanäle-Seite ansehen. Sie können sie über den App-Button und dann den Kanäle-Tab.

Kanäle-Liste

Wie Sie sehen können, gibt es in der unteren rechten Ecke einen Plus-Button. (1 im Bild) Wenn Sie darauf klicken, öffnet sich ein Modalfenster, in dem Sie einen neuen Kanal erstellen können.

neuer Kanal

Anschließend klicken Sie auf Add ein neuer Kanal sollte im Listen erscheinen.

nach Kanal erstellen

Manchmal ist die Konfiguration eines Kanals nicht gültig. In diesem Fall erhalten Sie eine große Warnung und der Misconfigured Spalte wird sagen Yes für einen oder mehrere der Kanäle. Sie können mehr über es hier

Kanal löschen ist einfach. Klicken Sie einfach auf den Müll-Icon und bestätigen Sie die Löschung. (2 in der Abbildung)

Klicken Sie auf den Kanalnamen, um einen Modalfenster zu öffnen, in dem Sie die Kanal-Einstellungen verwalten können. (3 im Bild

Kanal-Einstellungen

Die Seite mit den Kanal-Einstellungen enthält alle Konfigurationsoptionen für Ihren Kanal. Lassen Sie uns jede Einstellung durchgehen.


Zuerst das Default channel Schaltfläche. Wenn aktiviert, wird dieser Kanal zum Standardkanal für neue Geräte. Für eine umfassende Erklärung, wie Standardkanäle funktionieren, einschließlich der Einrichtung plattform-spezifischer Standards (eine für iOS, eine für Android und eine für Electron), sehen Sie sich die Standardkanal-Konfiguration Abschnitt an.


Zweitens die IOS Einstellung. Dies ist relativ einfach. Wenn diese falsch ist, werden iOS-Geräte nicht erlaubt, Updates von diesem Kanal herunterzuladen.

Drittens ist die Android Einstellung. Dies ähnelt der IOSWenn dies falsch ist, werden Android-Geräte nicht erlaubt, Updates von diesem Kanal herunterzuladen.

Viertes ist die Electron Einstellung. Dies ähnelt der IOS und AndroidWenn dies falsch ist, werden Electron-Apps nicht erlaubt, Updates von diesem Kanal herunterzuladen.

Fünftes ist die Disable auto downgrade under native Einstellung. Wenn dies wahr ist, wird es unmöglich sein, von einer nativen Version herunterzubügeln. Das bedeutet, wenn Sie eine 1.2.0 Version in den App-Store oder Play-Store hochgeladen haben und versuchen, die Kanalversion auf 1.1.0 zu setzen, wird die Aktualisierung (Herunterbügeln) fehlschlagen.

Sechstes ist die Disable auto update. Diese Einstellung ist ziemlich komplex, und Sie können mehr darüber erfahren hier

Was das betrifft Allow development build. Wenn dies wahr ist, werden Entwicklungsbuilds erlaubt, Updates von diesem Kanal herunterzuladen. Wenn nicht, werden alle Updateanfragen, die auf prod auf

gesetzt ist, abgelehnt. Dies ist vor allem für Testzwecke nützlich. Allow Emulators. If this is false then Capgo will disallow any update request that comes from an emulator. This is mostly useful for testing purposes.

. Wenn dies falsch ist, wird Allow devices to self associate__CAPGO_KEEP_0__ jede Updateanfrage, die von einem Emulator kommt, ablehnen. Dies ist vor allem für Testzwecke nützlich. Der Achte ist der . Wenn dies wahr ist, wird die Methode Methode mit diesem Kanal verwenden, dann wird die Anfrage fehlschlagen.

Wenn Sie Kanäle für die Planung der Kanalroutings und der geplanten Rollout verwenden, verbinden Sie es mit Kanäle für die Implementierungsdetails in Kanäle, Kanäle für die Implementierungsdetails in Kanäle, Beta-Testlösung für das Produktworkflow in Beta-Testlösung, Versionziel-Lösung für den Produktworkflow in Versionziel-Lösung, und Capgo Umgebungsbest Practices: Staging mit einem Mobile App ID für den praktischen Kontext in Capgo Umgebungsbest Practices: Staging mit einem Mobile App ID.