Kanäle

Kopieren Sie einen Setup-Prompt mit den Installationsanweisungen und der vollständigen Markdown-Guideline für diesen Plugin.

Wie Capgo einen Kanal (Vorrang) auswählt

Wenn ein Gerät Capgo für eine Aktualisierung anfragt, wird der zu verwendende Kanal in folgender Reihenfolge (höchster Vorrang zuerst) bestimmt:

Zwingende Gerätemappe: Wenn der Geräteeintrag explizit auf einen Kanal gezwungen wird (siehe die Zwingende Geräte Liste innerhalb der Kanal-Einstellungen), gewinnt dieser Kanal immer.
Cloud-Übertrag (erstellt durch setChannel() oder Webapp-Aktion): Aufrufen von setChannel (oder Ändern eines Geräts im Dashboard) schreibt eine persistente Überschreibung im Cloud, die an diesem Geräteeintrag gebunden ist. Diese Überschreibung wird nach der zwingenden Zuweisung, aber vor den Standards berücksichtigt. Wiederinstallieren der App löscht sie nicht; Löschen des Geräteeintrags
Capacitor-Konfiguration defaultChannel (Standardkonfiguration für Testbuild): Für interne / Beta / Testversionen können Sie defaultChannel (Legacy-Schlüssel channel) in capacitor.config.* so starten Testgeräte auf einem Vorabveröffentlichungs-Kanal (z.B. beta, pr-123). Wenn dieser fehlt, wird das Gerät auf die Cloud-Standard-Einstellung weitergeleitet. Produktionsversionen lassen diesen normalerweise ungesetzt.
Cloud-Standard-Kanal (Hauptschlagseite für etwa 99% der Nutzer): Die Hauptproduktionskanal, auf den sich fast alle echten Nutzer landen. Jedes neue Gerät ohne Zwang, ohne Übernahme und ohne Konfiguration defaultChannel verwendet diesen. Ändern Sie ihn, und es wird für alle in Sekunden (ohne neue Binärdatei) ausgerollt (oder zurückgerollt).

Weshalb der Cloud-Standard die Hauptroute ist:

Instante Ausrollen oder Zurückrollen ohne Wiederaufbau oder Neuveröffentlichung von nativen Binärdateien.
Ein Ort, an dem Sie iOS, Android- und Electron-Verhalten verwalten können.
Sicherer: Sie können die Bundles bestätigen und die Einstellungen überprüfen, bevor Sie die Standard-Einstellung ändern.
Änderungen, die nachvollziehbar sind (Mitarbeiter können im Benutzeroberfläche und in den Protokollen sehen, wer was geändert hat). Grundsatz der Gestaltung: Schichten oben (zwingen / überschreiben / Konfiguration) sind Ausnahmen (Debugging für einzelne Benutzer, QA-Switching, Test-Standard-Einstellungen). Normalbenutzer fließen in die Cloud-Standard-Einstellung.

Die Änderung der Cloud-Standard-Kanal beeinflusst neue normale Geräte, die:

Nicht gezwungen werden
Bereits eine Cloud-Überlagerung haben
Haben Sie keine App-Ebene defaultChannel definiert

Wenn ein Testbuild mit defaultChannel: 'beta' und Sie ändern die Cloud-Standardspalte später zu production, Geräte, die zuerst auf beta über die Konfiguration bleiben, bis Sie: (a) sie mit setChannel()überrunden, oder (b) sie zwingen, oder (c) die Geräte-Einträge löschen.

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

Zwingen Sie sie auf einen anderen Kanal.
Aufrufen setChannel() (Erstellung/Überschreibung der Cloud-Überladung) oder ändern Sie es manuell im Dashboard.
Löschen/Archivieren Sie den Kanal, auf dem sie sich befinden (dann fallen sie wieder durch die Präzedenzfolge zurück bei der nächsten Überprüfung).

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

Anmerkung: 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 Konfigurationsbeispiel

// 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 des Dashboards auf productionändern, werden Geräte, die bereits auf einem anderen Kanal (über Konfiguration, Überschreibung oder Zwang) liegen, NICHT automatisch umgestellt; nur frische Geräte (oder solche, deren Überschreibung/Zwang Sie löschen) greifen es auf.

Kanalverwaltung

Zunächst schauen wir uns die Kanal-Seite an. Sie können sie über auf Ihre App klicken und dann auf die Kanäle-Taste klicken.

Ein Kanal erstellen

Wie Sie sehen können, befindet sich in der unteren rechten Ecke ein Plus-Button. (1 in der Abbildung) Durch Klicken darauf öffnet sich ein Modalfenster, in dem Sie einen neuen Kanal erstellen können.

Dann sollte sich nach dem Klicken auf Add ein neuer Kanal in der Liste befinden.

Was bedeutet fehlerhaft konfiguriert?

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 darüber erfahren hier

Ein Kanal löschen

Das Löschen eines Kanals ist einfach. Klicken Sie einfach auf den Mülleimer-Icon und bestätigen Sie die Löschung. (2 in der Abbildung)

Ein Kanal verwalten

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

Die Kanal-Einstellungen-Seite 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 dies falsch ist, werden iOS-Geräte nicht erlaubt, Updates von diesem Kanal herunterzuladen.

Drittens ist die Android Einstellung. Dies ist ähnlich wie IOS. Wenn dies falsch ist, werden Android-Geräte nicht erlaubt, Updates von diesem Kanal herunterzuladen.

Viertes ist das Electron Einstellung. Dies ist ähnlich wie IOS und Android. Wenn dies falsch ist, werden Electron-Anwendungen nicht erlaubt, Updates von diesem Kanal herunterzuladen.

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

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

Betrifft Allow development build. Wenn dies wahr ist, werden Entwicklungsbuilds erlaubt, Updates aus diesem Kanal herunterzuladen. Wenn nicht, werden alle Updateanfragen, die auf __CAPGO_KEEP_0__ prod setzen, abgelehnt.

Seventh ist der Allow Emulators. Wenn dies falsch ist, wird Capgo jede Updateanfrage von einem Emulator ablehnen. Dies ist vor allem für Testzwecke nützlich.

Eight ist der Allow devices to self associate. Wenn dies wahr ist, wird die setChannel -Methode verfügbar sein. Wenn dies auf falsch gesetzt ist und Sie versuchen, die setChannel -Methode mit diesem Kanal aufzurufen, wird der Aufruf fehlschlagen.

Weiter mit Kanälen

Wenn Sie " Kanäle" zum Planen der Kanalrouten und der schrittweisen Veröffentlichung verwenden, verbinden Sie es mit " Kanäle" für die Implementierungsdetails in Kanälen, " Kanäle" für die Implementierungsdetails in Kanälen, " Beta-Testlösung" für das Produktworkflow in Beta-Testlösung, " Version-Zielsystemlösung" für das Produktworkflow in Version-Zielsystemlösung und Capgo Umgebungsbest Practices: Staging mit einem Mobilgerät-App-ID für den praktischen Kontext in Capgo Umgebungsbest Practices: Staging mit einem Mobilgerät-App-ID.