Kanäle

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

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 auf einen Kanal gezwungen 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 in der Dashboard schreibt eine persistente Überschreibung in der Cloud, die an diesem Geräte-Id gebunden ist. Diese Überschreibung wird nach der Zwangsmapping, aber vor den Standards berücksichtigt. Wiederinstallieren der App tut nicht löschen Sie es; das Löschen der Geräte-Einträge tut.
3. Capacitor-Konfiguration defaultChannel (Standardbau für Tests): Für interne / Beta- / Testversionen können Sie defaultChannel (Legacy-Schlüssel channel) in capacitor.config.* so dass Testgeräte auf einem Vorkabel-Channel starten (z.B. beta, pr-123). Wenn dieser fehlt, wird das Gerät auf den Cloud-Standard umgestellt. Produktionsversionen lassen diesen normalerweise ungesetzt.
4. Cloud-Standard-Channel (Hauptstrategie für etwa 99% der Benutzer): Die Hauptproduktionskanal, auf den sich fast alle echten Benutzer begeben. Jedes neue Gerät ohne Zwang, ohne Überprüfung und ohne Konfiguration defaultChannel verwendet diesen. Ändern Sie ihn, und es wird für alle in Sekunden (oder zurückgerollt) – kein neuer Binary.

Why die Cloud-Standard ist der Hauptweg: Instante Ausrollen oder Zurücksetzen ohne Neu- oder Wieder-Veröffentlichen von nativen Binärdateien.

• Ein Ort, um iOS, Android und Electron-Verhalten zu verwalten.
• Sicherer: Sie können die Pakete bestätigen und die Einstellungen überprüfen, bevor Sie den Standard ändern.
• Verfolgbare Änderungen (Mitarbeiter können im UI / Protokollen sehen, wer was geändert hat). Designprinzip: Ebenen oben (Zwangs-/Über-/Konfiguration) sind
• Ausnahmen (Einzelnen Benutzer debuggen, QA-Switching, Test-Standard-Defaults). Normalbenutzer fließen in den Cloud-Standard ein. Die Änderung des

Cloud-Standard-Kanals wirkt Die Änderung des Cloud-Standard-Kanals wirkt sich auf die Benutzer aus. Die Änderung des Cloud-Standard-Kanals wirkt sich auf die Benutzer aus. neue normale Geräte, die:

• Nicht gezwungen werden
• Nicht bereits eine Cloud-Überschreibung haben
• Keine App-Ebene defaultChannel definiert

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

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

• Zwingen Sie sie in einen anderen Kanal.
• Aufrufen setChannel() (Erstellen/Überschreiben Sie die Cloud-Überschreibung) 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äzedenz wieder zurück bei der nächsten Überprüfung).

Wenn ein Kanal für eine Plattform deaktiviert ist (siehe iOS/Android/Electron-Toggle) und sonst hätte ausgewählt werden sollen, 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-Konfigurationsexample

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 ändern productionGeräte, die bereits auf einem anderen Kanal (via Konfiguration, Überschreiben oder Zwang) sind, werden NICHT automatisch umgezogen; nur frische Geräte (oder solche, deren Überschreiben/Zwang Sie löschen) fassen es auf.

---

Kanalverwaltung

Zunächst schauen wir uns die Kanal-Seite an. Sie können sie erreichen, indem Sie auf Ihr App klicken und dann auf den Kanal-Tabs klicken Klick auf Ihr App und dann Klick auf den Kanal-Tabs.

Kanal erstellen

Wie Sie sehen, gibt es einen Plus-Button in der unteren rechten Ecke. (1 im Bild) Klicken Sie darauf, um einen Modal zu öffnen, in dem Sie einen neuen Kanal erstellen können.

Klicken Sie dann auf Add ein neuer Kanal sollte in der Liste erscheinen.

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 Yes für einen oder mehrere der Kanäle. Sie können mehr über es

hier

Um einen Kanal aus der Web-Anwendung zu löschen, öffnen Sie das Kanäle Fenster für Ihre App und suchen Sie die Zeile für den Kanal. In der Aktion Spalte klicken Sie auf das Papierkorb-Icon, klicken Sie dann auf Löschen in der Bestätigungsansicht.

Wenn das Papierkorb-Icon nicht sichtbar ist, haben Sie für das App keine channel.delete Berechtigung. Bitten Sie einen Organisation- oder App-Administrator, eine Rolle zu erteilen, die Kanäle löschen kann, oder löschen Sie den Kanal mit einem API-Schlüssel, der die Berechtigung hat:

npx @capgo/cli@latest channel delete <channel-name> <app-id>

Eine Organisation- und App-gesteuerte App-Vorschau Eine Schlüssel kann atomisch nur die nicht öffentliche Vorschaukanal und das mit ihm erstellte Paket löschen. Sie kann nicht einen bestehenden Standard-/Hauptkanal ändern oder löschen, einen anderen Vorschau-Schlüssels Kanal oder ein anderes Schlüssels Paket. channel delete <preview-channel> <app-id> --delete-bundleSiehe API Schlüssel für die geringsten Rechte-Konfiguration.

Ein Kanal verwalten

Wenn Sie auf den Kanalnamen klicken, öffnet sich ein Modalfenster, in dem Sie die Kanal-Einstellungen verwalten können. (3 Kanal-Einstellungen

protectedTokens

---

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), siehe den Abschnitt Standardkanal-Konfiguration.

---

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

Viertens ist die Electron Einstellung. Dies ist ähnlich wie IOS und Android. Wenn dies falsch ist, werden Electron-Anwendungen nicht in der Lage sein, Updates von diesem Kanal herunterzuladen.

Fünftes ist die Disable auto downgrade under native Einstellung. Wenn dies wahr ist, dann wird es unmöglich sein, von einer native Version herunterzustufen. 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, dann wird die Aktualisierung (Herunterstufung) fehlschlagen.

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

Was das Allow development buildangeht. Wenn dies wahr ist, dann werden Entwicklungsbuilds in der Lage sein, Updates von diesem Kanal herunterzuladen. Wenn nicht, dann werden alle Aktualisierungsanfragen, die prod auf falsch gesetzt haben, abgelehnt werden. Dies ist vor allem für Testzwecke nützlich.

Siebtes ist die Allow Emulators. Wenn dies falsch ist, dann wird Capgo jede Aktualisierungsanfrage, die von einem Emulator kommt, ablehnen. Dies ist vor allem für Testzwecke nützlich.

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

Progressive Rollouts

Der Kanal Information Registerkarte enthält ein Progressive Ausrollout Abschnitt. Legen Sie ein Zielpaket fest, wählen Sie den Prozentsatz und die Entscheidungs-Cache-Dauer, dann aktivieren Sie die Ausrollout. Aus demselben Abschnitt können Sie die Aussetzung oder die Wiederaufnahme der Ausstrahlung, die Förderung des Ziels auf Stabil, die Rückkehr oder die Konfiguration einer automatischen Aussetzung, Rückkehr oder Benachrichtigung einstellen, wenn die Fehlerzeichen einen Schwellenwert überschreiten.

Progressive Ausrollout-Kontrollen erscheinen oben auf der Kanal-Informationen-Seite.

Weiterlesen Progressive Ausrollouts Bevor Sie eine aktivieren. Es erklärt sich sticky Cohorts, sichere Prozentsatzänderungen und Auto-Pause-Verhalten.

Weiter von Kanälen

Wenn Sie "Kanäle" verwenden, um die Kanalrouten und die gestaffelte Ausrollout zu planen, verbinden Sie es mit Kanäle Kanäle Kanäle für die Implementierungsdetails in Kanäle, Kanäle für die Implementierungsdetails in Kanäle, Beta-Testlösung für den Produktworkflow in Beta-Testlösung, Versionsziel-Lösung für den Produktworkflow in Versionsziel-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.