Kanäle

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

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

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

Zwangsmapping für Geräte: Wenn die Geräte-ID explizit auf einen Kanal gezwungen wird (die Geräte Registerkarte auf der Kanal-Seite), gewinnt dieser Kanal immer. Zwangs-Mappings sind Konsole/API-Überladungen. Capgo entfernt sie 90 Tage nach dem letzten Überladungsschreiben. Siehe Konsole und API-Überladungen verfallen.
Cloud-Überschreibung (Dashboard oder öffentliche API): Ändern Sie die Kanal-ID eines Geräts im Dashboard oder über die öffentliche API schreibt eine Überschreibung, die an das Geräte-ID gebunden ist. Wenn Sie die App neu installieren, bleibt sie bestehen; wenn Sie die Überschreibung löschen, wird sie entfernt. Die gleiche 90-Tage-Rückhalteregelung gilt. Plugin (lokal)
: Bei aktuellen Plugin-Versionen speichert es die Kanal-ID auf dem Gerät nach Hintergrundvalidierung. Es handelt sich nicht um eine Dashboard-Überschreibung. Wenn Sie die App neu installieren, wird sie entfernt; die App muss erneut aufgerufen werden, wenn Sie die Kanal-ID noch einmal einrichten möchten. setChannel() __CAPGO_KEEP_0__-Konfiguration (Standard für Testversionen) setChannel() : Für interne / Beta / Testversionen können Sie die Kanal-ID festlegen setChannel() __CAPGO_KEEP_0__
Capacitor defaultChannel __CAPGO_KEEP_0____CAPGO_KEEP_0__ defaultChannel (Legacy-Schlüssel) channel) in capacitor.config.* so Testgeräte starten auf einem Vorabkanal (z.B. beta, pr-123). Wenn dieser fehlt, wird das Gerät auf den Cloud-Standard weitergeleitet. Produktionsbuilds lassen diesen normalerweise ungesetzt.
Cloud-Standardkanal (Hauptschwerpunkt für etwa 99% der Nutzer): Der Hauptproduktionskanal, auf den sich fast alle echten Nutzer landen. Jedes neue Gerät ohne Zwang, ohne Übertragung, ohne lokale setChannel(), und ohne Konfiguration defaultChannel verwendet diesen. Eine Änderung wirkt sich (oder zurück) für alle in Sekunden aus, ohne neue Binärdatei.

Warum der Cloud-Standardkanal der Hauptweg ist:

Schnelle Ausrollung oder Zurücksetzung ohne Neubau oder Neuveröffentlichung von nativen Binärdateien.
Ein Ort, um iOS, Android und Electron-Verhalten zu verwalten.
Sicherer: Sie können Bundles bestätigen und Einstellungen überprüfen, bevor Sie die Standardumgebung ändern.
Nachvollziehbare Änderungen (Mitarbeiter können im Benutzeroberfläche oder in den Protokollen sehen, wer was geändert hat). Designprinzip: Schichten oben (zwingen / überschreiben / Konfiguration) sind Ausnahmen

Einzelne Benutzer (Debug, QA-Switching, Test-Build-Standard). Normale Benutzer fließen in die Cloud-Standardumgebung. Die Änderung der Cloud-Standardumgebung beeinflusst neue

normale Geräte, die:
Zwanglos sind und
Verwenden Sie keine App-Ebene defaultChannel definiert

Wenn ein Testbuild mit defaultChannel: 'beta' und Sie später die Cloud-Standard-Einstellung auf productiongerätet, die auf beta durch die Konfiguration verbleiben, bis eine höherprioritäre Zuweisung gilt oder bis Sie ein Binärdatei ohne defaultChannelentfernen. Die Löschung einer Zwangs-, Cloud-Überprüfung oder lokalen setChannel() Zuweisung entfernt nicht die Konfigurationswerte; diese Fallbacks bleiben bis zur neuen Binärdatei.

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

Sie zwingen sie auf einen anderen Kanal (Console oder Public API).
Sie ändern die Cloud-Überprüfung in der Konsole oder Public API.
Anrufen Sie setChannel() (lokale Zuweisung auf aktuellen Plugin-Versionen).
Entfernen oder 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).
Warten Sie, bis ein Konsolen/API-Übertrag nach 90 Tagen abläuft.
Reinstallieren Sie die App, was eine lokale setChannel() Zuweisung, aber nicht einen Konsolen/API-Übertrag, löscht.

Wenn 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 das nächste Regel zurück.

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

Capacitor-Konfigurationsexample

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

Wenn Sie das Dashboard-Standard später ändern productionGeräte, die bereits auf einem anderen Kanal (über Konfiguration, Überschreibung oder Zwang) sind, werden NICHT automatisch umgestellt; nur frische Geräte (oder solche, deren Überschreibung/Zwang Sie aufheben) fassen es auf.

Kanalverwaltung

Zuerst schauen wir uns die Kanal-Seite an. Sie können sie erreichen, indem Sie auf Ihr App-Konto klicken und dann auf den Kanal-Tab klicken Kanal-Liste.

Abschnitt mit dem Titel “Ein Kanal erstellen”

channel list1 Klicken Sie auf das Bild, um ein Modalfenster zu öffnen, in dem Sie einen neuen Kanal erstellen können.

Dann erscheint nach dem Klicken auf Add Ein neuer Kanal sollte in der Liste erscheinen.

Was bedeutet misconfigured?

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

Löschung eines Kanals

Um einen Kanal aus der Webanwendung zu löschen, öffnen Sie das Kanäle Kanal Spalte Aktion Kanal Wenn das Müllsymbol nicht sichtbar ist, haben Sie für das entsprechende App keine Berechtigung. Fordern Sie einen Organisation- oder App-Administrator auf, eine Rolle zu erteilen, die Kanäle löschen kann, oder löschen Sie den Kanal mit einem __CAPGO_KEEP_0__-Schlüssel, der Berechtigungen hat:

Berechtigung channel.delete permission for that app. Ask an organization or app admin to grant a role that can delete channels, or delete the channel with an API key that has permission:

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

Eine Organisation- und App-gesicherte App-Vorschau Eine Schlüssel kann nur die nicht öffentliche Vorschaukanal und das mit ihr erstellte Bundle atomisch löschen. Sie kann einen bestehenden Standard-/Hauptkanal, einen anderen Vorschau-Schlüssels Kanal oder ein anderes Schlüssels Bundle nicht ändern oder löschen. Siehe channel delete <preview-channel> <app-id> --delete-bundleSchlüssel API Keys Kanal verwalten

Abschnitt mit dem Titel „Kanal verwalten“

Kanal-Einstellungen

protectedTokens

Zentrale OberflächeAktualisierung der aktuellen Bundle und Installationsstatistiken für diesen Kanal.
InformationenEinstellungen für den Kanal, einschließlich progressiver Rollout und Test-Update API.
GeräteZwingende Zuweisungen, die aus der Konsole oder öffentlichen API erstellt wurden. Es listet nicht alle Geräte auf, die sich auf diesem Kanal befinden, und es listet auch keine Geräte auf, die API verwendet haben. setChannel()Siehe Console- und API-Überschreibungen erlöschen.
HistorieEinstellungen und Bundle-Änderungen für diesen Kanal.
Vorschau: In-Browser- und native Voransicht des verknüpften Bundles. Aktivieren Sie die Voransicht des Bundles in App-Informationen erstens.

Einstellungen für Informationen

bleiben Sie auf der Informationen Registerkarte. Die Einstellungen erscheinen in dieser Reihenfolge:

Zuerst, Standard-Download-Channel ist ein Status-Indikator, kein Schalter. Aktiv bedeutet, dass diese Kanal die Cloud-Standard ist für neue Geräte. Klicken Sie Um in der App-Einstellungen zu ändern in App-Informationen . Für plattformspezifische Standards (eine für iOS, eine für Android und eine für Electron) siehe dieselbe Abschnitt.Zweitens die

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

Einstellung. Wenn dies falsch ist, werden Android-Geräte nicht erlaubt, Updates von diesem Kanal herunterzuladen. Android Viertens ist die

Einstellung. Wenn dies falsch ist, werden Electron-Anwendungen nicht erlaubt, Updates von diesem Kanal herunterzuladen. Electron Fünftes ist die

Einstellung. Wenn dies falsch ist, werden iOS-Geräte nicht erlaubt, Updates von diesem Kanal herunterzuladen. Disable auto downgrade under native Einrichtung. Wenn dies wahr ist, dann ist es unmöglich, von einer nativen Version herunterzustellen. Dies bedeutet, dass, wenn Sie eine Version auf das App-Store oder Play-Store hochgeladen haben und versuchen, die Kanalversion auf zu setzen, dann wird die Aktualisierung (Herunterstufe) fehlschlagen. 1.2.0 Sechstes ist die 1.1.0 Diese Einstellung ist ziemlich komplex, und Sie können mehr darüber erfahren

Siebtes ist die Disable auto updateEinstellung. Sie wählt aus, ob Geräte ein volles Zip-Datei, eine Delta der geänderten Dateien oder beide herunterladen. Siehe Update-Paket

Achtes ist die Update package Einstellung. Wenn dies wahr ist, dann werden Entwicklungsbuilds erlaubt, Updates von diesem Kanal herunterzuladen. Wenn nicht, dann werden alle Aktualisierungsanfragen, die auf falsch gesetzt sind, abgelehnt. Dies ist vor allem für Testzwecke nützlich. Neunte ist die .

Einstellung. Wenn dies wahr ist, dann wird es nicht möglich sein, von einer nativen Version herunterzustellen. Dies bedeutet, dass, wenn Sie eine Version auf das App-Store oder Play-Store hochgeladen haben und versuchen, die Kanalversion auf zu setzen, dann wird die Aktualisierung (Herunterstufe) fehlschlagen. Allow development buildZehntes ist die prod Einstellung. Sie wählt aus, ob Geräte ein volles Zip-Datei, eine Delta der geänderten Dateien oder beide herunterladen. Siehe

Neunter ist Allow production build. Wenn dies falsch ist, erhalten Produktions- (Laden-) Builds keine Updates von diesem Kanal. Lassen Sie dies für Kanäle an, die echte Benutzer bedienen.

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

Elfter ist Allow physical devices. Wenn dies falsch ist, wird Capgo Aktualisierungsanforderungen von echten Smartphones und Tablets ablehnen. Lassen Sie dies für Produktionskanäle an.

Zwölfter ist Allow devices to self dissociate/associate. Wenn dies wahr ist, ist die setChannel -Methode verfügbar. Wenn dies auf falsch gesetzt wird und Sie versuchen, setChannel mit diesem Kanal aufzurufen, wird die Anfrage fehlschlagen.

Test Update API

Unten auf der Seite Informationen Erweitern Sie Test Update API. Capgo zeigt eine cURL-Kommandozeile gegenüber /updates für ein Beispielgerät auf diesem Kanal.

Änderungen können bis zu 60 Sekunden dauern, um im API zu erscheinen, weil von der Caching-Einstellung abhängig.

Wenn der Kanal nicht getestet werden kann, warnt der Konsole Sie: Der Kanal benötigt mindestens eine Plattform (iOS oder Android), Produktionsbuilds, physische Geräte und entweder muss er der Standard-Download-Kanal sein oder Geräte selbst zuweisen lassen.

Abschnitt mit dem Titel „Benachrichtigung über Update senden“ Benachrichtigung über Update senden. Das stellt eine stille Push-Anfrage, damit die Geräte auf dem Kanal nach dem neuen Bundle suchen. Konfigurieren Sie zunächst die Android- und iOS-Push-Zertifikate auf der Benachrichtigungsseite der App.

Console und API-Überschreibungen erlöschen

Gewaltsame Zuweisungen und Dashboard/Öffentliche API-Kanal-Überschreibungen werden entfernt 90 Tage nach dem letzten Überschreibungs-Schreiben. Der letzte Geräte-Check-in setzt diesen Zeitpunkt nicht zurück. Für eine Zuweisung, die diesen Reinigungsvorgang überlebt, setzen Sie defaultChannel im Capacitor-Konfiguration (überlebt eine Wiederinstallation, benötigt eine neue Binärdatei, um geändert zu werden) oder rufen Sie setChannel() von der App auf (vermeidet den 90-Tage-Reinigungsvorgang, aber eine Wiederinstallation löscht ihn, sodass die App erneut aufrufen muss) setChannel() .

Capgo-Kanal-Geräte-Registerkarte mit dem Popover für die Überschreibungs-Retention: Console-Überschreibungen erlöschen nach 90 Tagen — Überschreibungs-Retention auf der Geräte-Registerkarte des Kanals. Das gleiche Hinweis erscheint, wenn Sie einem Gerät eine Zwangs-ID auf den Kanal zwingen

Dies ist getrennt von GeräteinventarbeibehaltungInventar entfernt Geräte, die sich in den letzten 90 Tagen nicht mit Capgo verbunden haben. Die Überprüfung der Reinigung entfernt auch die Zuordnung, wenn das Gerät noch aktiv ist. Vollständige Details: Console und API-Überprüfungen erlöschen nach 90 Tagen.

Aktualisierungs-Paket

Öffnen Sie ein Kanal und bleiben Sie auf der Information Registerkarte. Das Aktualisierungs-Paket ist in der Einstellungsliste, unter Deaktivieren automatische Aktualisierung.

Diese Einstellung bestimmt, was Capgo sendet, wenn ein Gerät auf diesem Kanal nach einer Aktualisierung sucht. Lassen Sie es Zip und Delta nur, wenn Sie eine bestimmte Art zwingen müssen.

Bezeichnung in der Konsole	CLI / API-Wert	Was die Geräte herunterladen
Zip und Delta	`all`	Ein vollständiges Zip-Paket und ein Delta, wenn beide existieren. Dies ist die Standard-Einstellung.
Zip nur	`zip`	Nur das vollständige Zip-Paket.
Delta nur	`delta`	Nur die geänderten Dateien. Plugins, die kein Delta anwenden können, erhalten immer noch ein Zip.
Zip nur von builtin	`zip_from_builtin`	Zip nur, solange das Gerät noch am Store-Binary ist. Nach dem ersten Live-Update dient Capgo wieder Zip und Delta.
Delta nur von builtin	`delta_from_builtin`	Delta nur, solange das Gerät noch am Store-Binary ist. Nach dem ersten Live-Update dient Capgo wieder Zip und Delta.

Builtin ist die Web-Assets, die innerhalb der App Store oder Play Store-Binary geschifft werden, bevor irgendein Capgo-Update. Verwenden Sie einen from builtin Modus, wenn die erste Update aus dem Store-Build Zip-only oder Delta-only sein sollte und später Updates beide verwenden können.

Capgo wird kein Zip-only-Kanal mit einem Delta-only-Paket pairen oder umgekehrt. Die Konsole, CLI, und Kanäle API weigern sich, zu speichern, und sagen Ihnen, das fehlende Paket hochzuladen oder den Modus zu ändern.

Sie können denselben Wert von der CLI setzen. Der Kanal muss bereits existieren:

npx @capgo/cli@latest channel set production com.example.app --update-package zip

Gültige Werte: all, zip, delta, zip_from_builtin, delta_from_builtin.

Schrittweise Bereitstellung

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

Lesen Progressive Rollouts bevor Sie eine aktivieren. Es erklärt sich sticky Cohort, sichere Prozentsatzänderungen und das automatische Pausieren.

Fortsetzen von Kanälen

Wenn Sie Kanäle verwenden Kanäle Kanäle Kanäle Kanäle Kanäle Kanäle Beta-Testlösung für das Produktworkflow in Beta-Testlösung Versionziel-Lösung für das 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.