Kanäle

Einen Einrichtungsvorschlag mit den Installationsanweisungen und der vollständigen Markdown-Guideline für diesen Plugin kopieren.

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):

Zwangsmapping für Geräte: Wenn der Geräte-Id explizit auf einen Kanal gezwungen wird (die Geräte Seite auf der Kanal-Seite), gewinnt dieser Kanal immer. Zwangsmappen sind console/API-Überladungen. Capgo entfernt sie 90 Tage nach dem letzten Überladungsschreiben. Siehe Console 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, wird sie nicht gelöscht; die Überschreibung wird jedoch gelöscht, wenn Sie sie manuell löschen. Die gleiche 90-Tage-Rückhalteregelung gilt. Plugin
(lokal) setChannel() : 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 gelöscht; die App muss erneut aufgerufen werden, wenn Sie die Kanal-ID noch einmal einrichten möchten.__CAPGO_KEEP_0__-Konfiguration setChannel() (Standard für Testversionen) setChannel() : Für interne / Beta- / Testversionen können Sie die Kanal-ID
Capacitor config defaultChannel (test build default) is not used in the translation as it is a navigation label and does not need to be translated(Dashboard or Public __CAPGO_KEEP_0__) is not used in the translation as it is a navigation label and does not need to be translated defaultChannel (veraltete Schlüssel) channelin capacitor.config.* so starten Geräte zum Testen 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 Übernahme, ohne lokale setChannel(), und ohne Konfiguration defaultChannel verwendet diesen. Eine Änderung wirkt sich (oder rollt zurück) für alle in Sekunden aus, ohne neue Binärdatei.

Weshalb der Cloud-Standardkanal der Hauptweg ist:

Welche Vorteile der
Ein Ort, an dem Sie die iOS-, Android- und Electron-Verhalten verwalten können.
Sicherer: Sie können die Bundles bestätigen und die 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: Ebenen oben (zwingen / überschreiben / Konfiguration) sind Ausnahmen Entsprechend (Debug einzelner Benutzer, QA-Switching, Test-Standardmäßigkeiten). Normale Benutzer fließen in die Cloud-Standardumgebung.

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

Nicht gezwungen werden
Bereits eine Cloud-Übernahme haben
Verwenden Sie keine App-Ebene defaultChannel definiert

Wenn ein Testbuild mit defaultChannel: 'beta' und Sie später die Cloud-Standard-Einstellung auf productiongerichtet, bleiben die Geräte, die auf beta durch die Konfiguration, bis eine höherprioritäre Zuweisung gilt oder bis Sie ein Binärdatei ohne defaultChannellöschen. Die Löschung einer Zwangs-, Cloud-Überprüfung oder lokalen setChannel() Zuweisung entfernt nicht die Konfigurationswerte; diese Fallbacks bleiben, bis die neue Binärdatei bereitgestellt wird.

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 / 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, bis ein Konsolen/API-Übertrag nach 90 Tagen abläuft.
Die App neu installieren, was eine lokale Zuweisung, aber nicht einen Konsolen/__CAPGO_KEEP_0__-Übertrag löscht. setChannel() assignment but not a console/API override.

Hinweis: Die Änderung

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

Abschnitt mit dem Titel “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 löschen) fassen es auf.

Kanalverwaltung

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

Abschnitt mit dem Titel “Ein Kanal erstellen”

__CAPGO_KEEP_0__1 klicken Sie auf das Bild (in der Abbildung) Klicken Sie darauf, um ein Modalfenster 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 die Misconfigured Spalte wird angezeigt Yes für einen oder mehrere der Kanäle. Sie können mehr über es hier

einen Kanal löschen

Um einen Kanal aus der Webanwendung zu löschen, öffnen Sie das Kanäle context Kanal Kanal Aktion Aktion

Löschen 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

__CAPGO_KEEP_0__

Übersichtaktuelle Kanal- und Installationsstatistiken
Informationen: Channel settings listed below, plus progressive rollout and Test Update API.
Geräte: Forced mappings created from the console or Public API only. It does not list every device currently on the channel, and it does not list devices that used setChannel()Siehe Console and API overrides expire.
Übersichtsdaten verfallenGeschichte
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 Verwalten in App-Einstellungen um die Standard auf App-Informationen. Für plattformspezifische Standards (eine für iOS, eine für Android und eine für Electron) siehe dieselbe Abschnitt.

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

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

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

Fünftes ist die Disable auto downgrade under native Einrichtung. Wenn dies wahr ist, dann ist es unmöglich, von einer nativen Version herunterzustufen. Das 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 (Herunterstufung) fehlschlagen. 1.2.0 Version auf das App-Store oder Play-Store hochgeladen haben und versuchen, die Kanalversion auf zu setzen. 1.1.0 Dann wird die Aktualisierung (Herunterstufung) fehlschlagen.

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

Siebentes ist die Update package Einstellung. Sie wählt, ob Geräte ein volles Zip-Datei, eine Delta der geänderten Dateien oder beide herunterladen sollen. Siehe Update-Paket.

Achtes ist Allow development buildEinstellung. 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. prod set to false will be rejected. This is mostly useful for testing purposes.

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 Update-Anfrage, die von einem Emulator kommt, ablehnen. Dies ist vor allem für Testzwecke nützlich.

Elfter ist Allow physical devices. Wenn dies falsch ist, wird Capgo Update-Anfragen 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, wird die setChannel -Methode verfügbar sein. Wenn dies auf falsch gesetzt wird und Sie versuchen, setChannel mit diesem Kanal aufzurufen, wird der Aufruf fehlschlagen.

Test Update API

Unten am Ende des Informationen Erweitern Test Update API. Capgo zeigt eine cURL-Anweisung gegenüber /updates für ein Beispielgerät auf diesem Kanal.

Änderungen können bis zu 60 Sekunden dauern, um im API sichtbar zu werden, weil von der Caching. 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 der Standarddownloadkanal sein oder das Gerät selbst zuweisen lassen.

Benachrichtigung über Update senden

Nachdem Sie das verknüpfte Bundle geändert haben, kann die Konsole Sie auffordern Benachrichtigung über Update senden. Das stellt eine stille Push-Anfrage, damit die Geräte auf dem Kanal nach dem neuen Bundle suchen. Konfigurieren Sie zuerst die Android- und iOS-Push-Zertifikate auf der Benachrichtigungsseite der App.

Console und API-Überschreibungen erlöschen

Zwangszuweisungen und Dashboard/Öffentliche API-Kanal-Überschreibungen werden entfernt 90 Tage nach dem letzten Überschreibungsdatum. Der letzte Geräte-Check-in setzt diesen Zeitpunkt nicht zurück. Für eine Zuweisung, die diesem Reinigungsvorgang überlebt, setzen Sie defaultChannel im Ihren Capacitor-Konfiguration (überlebt eine Wiederinstallation, benötigt eine neue Datei, um geändert zu werden) oder rufen Sie setChannel() von der App auf (vermeidet den 90-Tage-Reinigungsvorgang, aber eine Wiederinstallation löscht ihn, daher muss die App erneut aufgerufen werden). setChannel() __CAPGO_KEEP_0__-Kanal-Geräte-Registerkarte mit dem Popover für die Überschreibungsverlängerung: Console-Überschreibungen erlöschen nach 90 Tagen

Capgo channel Devices tab showing the Override retention popover: console overrides expire after 90 days — Benachrichtigung über Update senden

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 die Zuordnung, selbst wenn das Gerät noch aktiv ist. Vollständige Details: Der Console und API-Überprüfungstermin läuft nach 90 Tagen ab.

Aktualisierungs-Paket

Öffnen Sie einen Kanal und bleiben Sie auf der Informationen Registerkarte. 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 dies Zip und Delta nur dann stehen, wenn Sie eine bestimmte Art zwingen müssen.

Beschriftung in der Konsole	CLI / API-Wert	Was die Geräte herunterladen
Zip und Delta	`all`	Ein vollständiges Zip-Archiv und ein Delta, wenn beide existieren. Dies ist die Standard-Einstellung.
Zip nur	`zip`	Nur das vollständige Zip-Archiv.
Delta nur	`delta`	Nur die geänderten Dateien. Plugins, die ein Delta nicht 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 der ersten Live-Update, Capgo stellt wieder Zip und Delta bereit.
Delta nur von builtin	`delta_from_builtin`	Delta nur, solange das Gerät noch am Store-Binary ist. Nach der ersten Live-Update, Capgo stellt wieder Zip und Delta bereit.

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

Capgo wird kein Zip-only-Kanal mit einem Delta-only-Paket pairen oder umgekehrt. Die Konsole, CLI, und Kanäle API weigern sich, das Speichern abzulehnen 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 Information Ein Reiter enthält ein Schrittweise Bereitstellung Abschnitt mit Zielsystem und Stabile Fallback, Ziel für die Änderungsrollout ändern, Prozentsatz anwenden, und Aktionen Rollout abgeschlossen, Rollout rückgängig machen, Rollout aktivieren, Rollout deaktivieren, Rollout aussetzen, und Rollout fortsetzen.

Progressive Rollout-Kontrollen in einem Capgo-Kanal — Progressive Rollout-Kontrollen erscheinen oben auf der Kanal-Informationen-Seite.

Lese Progressive Rollouts Bevor Sie eines aktivieren, lesen Sie diese Anleitung. Sie behandelt die Upload-Routing-Konfiguration (Auto (empfohlen) / Zielsystem für die Rollout / Stabile Version ersetzen; CLI --stable / API target: "stable" Dieser Kanal verwendet progressive Rollouts bundle-Link-Dialog und einen sicheren Workflow mit Read Beobachten und Log-Insights.

Fortsetzung von Kanälen

Kanäle Kanäle Kanäle Kanäle Kanäle Kanäle Kanäle Beta-Testlösung für den 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.