Befehle

Diese Seite ist eine geführte Übersicht. Verwenden Sie die aktuelle Befehlsreferenz für genaue Flags: Anwendung, Paket, Kanal, und Erstellen.

Verwendung

Alle Befehle sollten in Ihrem App-Ordner ausgeführt werden, mit capacitor Projekt angemessen eingerichtet.

Capacitor Plattformübergreifende native Laufzeit für Web-Anwendungen

Init

npx @capgo/cli@latest init [apikey]

Diese Methode dient dazu, Sie Schritt für Schritt einzuführen.

Es wird Ihr App zu Capgo hinzugefügt. Es wird code zu Ihrer App hinzugefügt, um die Aktualisierung zu validieren. Ebenso wird Ihre App erstellt. Darüber hinaus wird Ihre App auf Capgo hochgeladen. Und es hilft Ihnen, zu überprüfen, ob die Aktualisierung funktioniert.

Anmeldung

npx @capgo/cli login [apikey]

Diese Methode dient dazu, die apikey für Sie zu speichern.

Hinweis

verwende --apikey=******** um es in jeder Kommando zu überschreiben

Optional kannst du auch geben:

--local Dies wird deine apikey im lokalen Repository speichern und es ignoriert in Git.

Arzt

npx @capgo/cli doctor

Befehl, um zu überprüfen, ob du mit den Capgo Paketen auf dem neuesten Stand bist.

Dieser Befehl wird auch bei der Fehlerberichterstattung nützlich sein.

App

Hinzufügen

npx @capgo/cli app add [appId]

[appId] Ihre App-ID im Format com.test.app erklärt hier hier.

💡 Alle Optionen werden in Ihrer Konfiguration erraten, wenn nicht angegeben.

Sie können optional Folgendes angeben:

• --icon [/path/to/my/icon] eine benutzerdefinierte Schaltflächensymbolik in der Capgo Webanwendung anzeigen.
• --name [test] einen benutzerdefinierten Namen in der Liste.
• --apikey [key] API-Schlüssel, um auf Ihr Konto zu verlinken.
• --retention [retention] Die Aufbewahrungsfrist des App-Bundles in Tagen, 0 durch Standard = unendlich.

Beispiel von capacitor.config.json für appId und AppName, wird die Icon im Ressourcenordner erraten.

{
  "appId": "ee.forgr.capacitor_go",
  "appName": "Capgo",
  "webDir": "dist"
}

Setzen

npx @capgo/cli app set [appId]

[appId] Ist Ihre App-ID, die Formatierung wird hier erklärt. hier.

Optional können Sie geben:

• --icon [/path/to/my/icon] um eine benutzerdefinierte Icon in der Capgo Webanwendung anzuzeigen.
• --name [test] um eine benutzerdefinierte Bezeichnung in der Liste zu haben.
• --retention [retention] Die Aufbewahrungsfrist des App-Bundles in Tagen, 0 durch Standard = unendlich.
• --expose-metadata [true|false] um die Bundle-Metadaten (Link und Kommentar) für das Plugin zu offenlegen.
• --preview oder --no-preview oder
• --allow-device-custom-id um die eigenen Geräte-IDs zu steuern. --no-allow-device-custom-id oder
• --block-provider-infra-requests um das Blockieren von bekannten Google- und Apple-Datencenter-Anfragen zu steuern. --no-block-provider-infra-requests um die native Build-Zeit auszusetzen.
• --build-timeout-minutes [5-360] um die Store-URL festzulegen.
• --ios-store-url [url] um die Standard-Upload-Channel festzulegen. --android-store-url [url] um die Standard-Download-Channel festzulegen, oder
• --default-upload-channel [channel] oder
• --default-download-channel [channel] oder --disable-download-channels um alle Download-Kanäle nicht öffentlich zu machen.
• --apikey [key] API-Schlüssel, um auf Ihr Konto zu verlinken.

Liste

npx @capgo/cli app list [appId]

[appId] ihre App-ID in der Formatierung com.test.app erklärt hier Optional können Sie geben:.

__CAPGO_KEEP_0__-Schlüssel, um auf Ihr Konto zu verlinken.

• --apikey [key] API key to link to your account.

Abschnitt mit dem Titel „Löschen“

npx @capgo/cli app delete [appId]

[appId] Delete com.test.app wird erklärt hier.

Optionell können Sie geben:

• --apikey [key] API-Schlüssel, um auf Ihr Konto zu verlinken.
• --bundle Mit der Versionsnummer wird nur diese Version gelöscht.

Debug

npx @capgo/cli app debug [appId]

[appId] Ihre App-ID im Format com.test.app wird erklärt hier.

Optionell können Sie geben:

• --apikey [key] API-Schlüssel, um auf Ihr Konto zu verlinken.
• --device mit dem spezifischen Gerät, das Sie debuggen möchten

Einstellungen

npx @capgo/cli app setting [path]

Bearbeiten Sie die Capacitor-Konfiguration.

[path] - Pfad der Einstellung, die Sie ändern möchten. Zum Beispiel, um die appIdgeben Sie an appId. Wenn Sie die automatische Aktualisierung deaktivieren möchten in der capacitor-updatergeben Sie an plugins.CapacitorUpdater.autoUpdate mit --string off.

Sie MÜSSEN entweder --string oder --bool!

context:HTML-Textfragment aus einem längeren Capgo-UI-String (Elternschlüssel `alternatives_cta_questions`). Seite/Bereich: Vergleichsseite für lebendige Capacitor-Updates. Rolle: Langes Marketing- oder Rechtsparagraph. Gesehen in: Seite alternatives.astro. Bewahren Sie Capgo-Produkt- und -Markenbegriffe sowie Entwicklertitel genau auf. Nachrichtenschlüssel `alternatives_cta_questions` (Alternativen-CTA-Fragen). | HTML-Textfragment aus einem längeren Capgo-UI-String (Elternschlüssel `appflow_cta_questions`). Seite/Bereich: Appflow-Vergleichs- und -Migration-Marketingtext. Rolle: Langes Marketing- oder Rechtsparagraph. Gesehen in: Seite ionic-appflow.astro. Bewahren Sie Capgo-Produkt- und -Markenbegriffe sowie Entwicklertitel genau auf. Nachrichtenschlüssel `appflow_cta_questions` (Appflow-CTA-Fragen). | HTML-Textfragment aus einem längeren Capgo-UI-String (Elternschlüssel `capwesome_cta_questions`). Seite/Bereich: Capawesome-Vergleichsseite. Rolle: Langes Marketing- oder Rechtsparagraph. Gesehen in: Seite capwesome.astro. Bewahren Sie Capgo-Produkt- und -Markenbegriffe sowie Entwicklertitel genau auf. Nachrichtenschlüssel `capwesome_cta_questions` (Capwesome-CTA-Fragen). | HTML-Textfragment aus einem längeren Capgo-UI-String (Elternschlüssel `consulting_faq_subtitle`). Seite/Bereich: Seite für Beratungsdienste. Rolle: Untertitel oder Slogan. Gesehen in: Seite consulting.astro. Bewahren Sie Capgo-Produkt- und -Markenbegriffe sowie Entwicklertitel genau auf. Nachrichtenschlüssel `consulting_faq_subtitle` (Beratungsdienste-Faq-Untertitel). | Seite/Bereich: Appflow-Vergleichs- und -Migration-Marketingtext. Rolle: Kurzer UI-Label oder Navigationselement. Gesehen in: Seite ionic-appflow.astro, Seite ionic-enterprise-plugins.astro, Seite solutions/ionic-enterprise-plugins.astro. Nachrichtenschlüssel `appflow_plugins_or` (Appflow-Plugins-oder).

• --string <string> - setzt die Einstellung auf einen String
• --bool <true | false> - setzt die Einstellung auf einen Boolean

Bundle

Hochladen

npx @capgo/cli bundle upload [appId]

[appId] Ihre App-ID ist hier, die Formatierung wird erklärt hier.

Optional können Sie geben:

• --apikey <apikey> API Schlüssel, um auf Ihr Konto zu verlinken.
• --path <path> Pfad des Ordners zum Hochladen.
• --channel <channel> Kanal, um sich zu verbinden.
• --external <url> Link auf externe URL anstatt Upload auf Capgo Cloud.
• --iv-session-key <key> IV und Sitzungsschlüssel für die Bundle-URL extern setzen.
• --s3-endpoint <s3Endpoint> URL des S3-Endpunkts. Funktioniert nicht mit Delta-Uploads oder der externen Option.
• --s3-region <region> S3-Bucket-Region.
• --s3-apikey <apikey> API-Schlüssel für Ihren S3-Endpunkt.
• --s3-apisecret <apisecret> API-Geheimnis für Ihren S3-Endpunkt.
• --s3-bucket-name <bucketName> Name Ihres AWS-S3-Buckets.
• --s3-port <port> Hafen für Ihren S3-Endpunkt.
• --no-s3-ssl SSL für S3-Upload deaktivieren.
• --key <key> Benutzerdefinierter Pfad für öffentliche Signierungschlüssel (v1-System).
• --key-data <keyData> Öffentlicher Signierungschlüssel (v1-System).
• --key-v2 <key> Benutzerdefinierter Pfad für privaten Signierungschlüssel (v2-System).
• --key-data-v2 <keyData> Privater Signierungskey (v2-System).
• --bundle-url Bündel-URL in die Konsole ausgeben.
• --no-key Übergehen Sie den Signierungskey und senden Sie ein klares Update.
• --no-code-check Übergehen Sie die Überprüfung, ob notifyAppReady() in der Quelldatei code und der Index im Root-Ordner vorhanden ist.
• --display-iv-session Zeigen Sie im Konsole die IV- und Sitzungskey an, die zum Verschlüsseln des Updates verwendet werden.
• --bundle <bundle> Bündelversion des zu hochladenden Bündels.
• --auto-bump [level] Automatische Inkrementierung vom Kanal verbundenes Bündel, andernfalls die aktuelle Remote-Anwendungsversion. Ebene: major, minor Standardmäßig. patch Alias für fix), metadataoder ai Arbeitnehmer AI vergleicht lokale Dateien mit der vorherigen Capgo/Kanal-Delta-Manifest, schließt die Ebene ab und gibt einen kurzen Grund an; ignoriert AI und erhöht patch wenn keine vorherige Capgo-Version vorhanden ist. Erhöht, bis ein freier Name gefunden ist (gelöschte Namen bleiben belegt). Kann nicht mit --bundle.
• --min-update-version <minUpdateVersion> Minimal erforderliche Version, um auf diese Version zu aktualisieren. Wird nur verwendet, wenn die automatische Aktualisierung in den Kanal gesetzt ist.
• --auto-min-update-version Setzt die Mindestaktualisierungsversion basierend auf native Paketen.
• --ignore-metadata-check Ignoert die Überprüfung der Metadaten (node_modules) bei der Hochladen.
• --ignore-checksum-check Ignoert die Überprüfung der Prüfsumme bei der Hochladen.
• --timeout <timeout> Zeitüberschreitung für den Uploadprozess in Sekunden.
• --delta Hochlädt Delta (Manifest)-Dateien neben dem vollständigen Bundle.
• --delta-only Hochlädt nur Delta (Manifest)-Updates, das vollständige Bundle überspringt.
• --no-delta Deaktiviert die Hochladen von Delta (Manifest)-Dateien (nützlich, wenn ein Instant-Apply-Modus aktiviert ist, aber ein vollständiges Bundle gewünscht wird). autoUpdate Hochlädt das Bundle mit dem tus-Protokoll.
• --tus Verwendet das multipart-Protokoll, um Daten an S3 hochzuladen, veraltet, verwenden Sie TUS stattdessen.
• --multipart Ein verschlüsselter Prüfsummenwert (Signatur). Wird nur verwendet, wenn ein externes Bundle hochgeladen wird.
• --encrypted-checksum <encryptedChecksum> __CAPGO_KEEP_0__
• --package-json <packageJson> Einen Pfad zu package.json. Nützlich für Monorepos.
• --auto-set-bundle Die Bundle-Einstellung in capacitor.config.json setzen.
• --node-modules <nodeModules> Eine Liste von Pfaden zu node_modules. Nützlich für Monorepos (getrennt durch Kommata, z.B. ../../node_modules,./node_modules)

⭐️ Die externe Option hilft dabei, zwei Fälle zu lösen: Unternehmen mit Datenschutzbedenken, die den code nicht an eine dritte Partei senden möchten, und Apps größer als 200 MB. Mit dieser Einstellung speichert Capgo nur den Link zur Zip-Datei und sendet den Link an alle Apps.

👀 Der Capgo-Cloud sieht nie, was in dem Link (bei externer Option) oder im code-Speicher ist.

🔑 Sie können eine zweite Sicherheitsstufe durch Verschlüsselung erreichen, dann kann der Capgo nichts sehen oder ändern, es wird “vertrauenslos”.

Beispiel von package.json Für Version

{
  "version": "1.0.2"
}

⛔ Die Version sollte größer als “0.0.0” sein.

💡 Vergessen Sie nicht, die Versionsnummer bei jedem Senden zu aktualisieren, die Versionsnummer kann nicht überschrieben oder nach der Löschung wiederverwendet werden, aus Sicherheitsgründen.

Liste

npx @capgo/cli bundle list [appId]

[appId] Ihre App-ID in der Formatierung com.test.app erklärt hier.

Sie können optional angeben:

• --apikey [key] API Schlüssel, um auf Ihr Konto zuzugreifen.

Löschen

npx @capgo/cli bundle delete [appId]

[appId] Ihre App-ID in der Formatierung com.test.app erklärt hier.

Sie können optional angeben:

• --apikey [key] API Schlüssel, um auf Ihr Konto zuzugreifen.
• --bundle Mit der Versionsnummer wird nur diese Version gelöscht.

Säubern

für eine Hauptversion in einem SemVer-Range nach Cloud

npx @capgo/cli bundle cleanup [appId] --bundle=[majorVersion] --keep=[numberToKeep]

[appId] Ihre App-ID ist in diesem Format com.test.app erklärt hier Optional können Sie geben:.

__CAPGO_KEEP_0__ Schlüssel, um auf Ihr Konto zuzugreifen.

• --apikey [key] API key to link to your account.
• --bundle [majorVersion] die Anzahl der zu behaltenden Pakete (Standard 4). numberToKeep.
• --keep [numberToKeep] Cleanup

Zum Beispiel: Wenn Sie 10 Versionen von 10.0.1 bis 10.0.11 haben und Sie npx @capgo/cli cleanup [appId] --bundle=10.0.0 Es wird 10.0.1 bis 10.0.6 entfernen. 10.0.7 bis 10.0.11 werden beibehalten.

Wenn Sie insgesamt 20 Versionen haben und keine Bundle-Nummer wie folgt angeben: npx @capgo/cli cleanup [appId] --keep=2 Es werden 18 Versionen entfernt, und die letzten 2 werden beibehalten.

Diese Anweisung wird nach Bestätigung gefragt, sie zeigt eine Tabelle an, was beibehalten und was entfernt wird.

Hinweis

Diese Anweisung ignoriert Bundles, die derzeit in jedem Kanal verwendet werden.

Verschlüsseln

Warnung: Diese Anweisung ist veraltet und wird in der nächsten großen Veröffentlichung entfernt. Bitte verwenden Sie das neue Verschlüsselungssystem. npx @capgo/cli bundle encrypt [path/to/zip]

Diese Anweisung wird verwendet, wenn Sie einen externen Speicherort verwenden, um Ihre code zu speichern oder zum Testen.

Optional können Sie geben:

--key [/path/to/my/private_key] den Pfad Ihres privaten Schlüssels. --key-data [privateKey] die private Schlüsseldaten, wenn Sie inline verwenden möchten. ivSessionKeyDer Befehl wird Ihre

y generieren und einen verschlüsselten Zip erstellen, um ihn mit dem Upload-Befehl oder dem Entschlüsselungsbefehl zu verwenden.

npx @capgo/cli bundle encrypt [path/to/zip] [checksum]

This command is used when you use external source to store your code or for test purpose. The checksum is the sha256 of the bundle (generated by —key-v2), it is used to verify the integrity of the file after decryption. It will be enncrypted with the private key and sent along with the bundle. In encryption v2 the checksum is upgraded to become a “signature” of the bundle.

Diese Anweisung wird verwendet, wenn Sie einen externen Speicherort verwenden, um Ihre __CAPGO_KEEP_0__ zu speichern oder zum Testen.

--key [/path/to/my/private_key] Der Prüfsummenwert ist der sha256-Wert des Pakets (erzeugt durch —key-v2), er wird verwendet, um die Integrität des Dateisystems nach der Entschlüsselung zu überprüfen. --key-data [privateKey] Er wird mit dem privaten Schlüssel verschlüsselt und zusammen mit dem Paket gesendet. --json Bei der Verschlüsselung V2 wird der Prüfsummenwert auf ein “Zeichen” des Pakets aufgewertet. ivSessionKeyy und generieren Sie ein verschlüsseltes Zip, um es mit dem Upload-Befehl oder dem Entschlüsselungsbefehl zu verwenden.

Entschlüsseln

npx @capgo/cli bundle decrypt [path/to/zip] [ivSessionKey]

Optional können Sie geben:

--key [/path/to/my/private_key] den Pfad Ihres privaten Schlüssels.

--key-data [privateKey] den privaten Schlüsseldaten, wenn Sie inline verwenden möchten. Dieser Befehl wird hauptsächlich für Testzwecke verwendet, er entschlüsselt das Zip und druckt die bas64-entschlüsselte Sitzungsschlüssel in der Konsole aus.

Entschlüsseln V2

npx @capgo/cli bundle decryptV2 [path/to/zip] [ivSessionKey]

Optional können Sie geben:

--key [/path/to/my/private_key] den Pfad Ihres privaten Schlüssels. --key-data [privateKey] den privaten Schlüsseldaten, wenn Sie inline verwenden möchten. Dieser Befehl wird hauptsächlich für Testzwecke verwendet, er entschlüsselt das Zip und druckt die bas64-entschlüsselte Sitzungsschlüssel in der Konsole aus. --checksum [checksum] den Prüfsumme des Dateis, es wird die Prüfsumme nach der Entschlüsselung überprüfen.

Zip

npx @capgo/cli bundle zip [appId]

[appId] Ihre App-ID ist Zip, die Formatierung wird hier erklärt hier.

Sie können optional auch folgendes angeben:

• --path [/path/to/my/bundle] um eine bestimmte Ordnerstruktur hochzuladen.
• --bundle [1.0.0] um die Versionsnummer des Bundle im Dateinamen zu setzen.
• --name [myapp] um den Dateinamen zu überschreiben.
• --json um Informationen als JSON auszugeben.
• --no-code-check um die code-Überprüfung zu ignorieren und das Bundle trotzdem zu senden.
• --key-v2 um das neue Verschlüsselungssystem zu verwenden. Dies ist erforderlich, da das neue Verschlüsselungssystem bessere Prüfsummen verwendet, um die Integrität der Datei zu überprüfen.

Kompatibilität

npx @capgo/cli bundle compatibility [appId] -c [channelName]

[appId] ist Ihre App-ID, die Formatierung wird erklärt hier. [channelName] der Name des Kanals, mit dem die Kompatibilität überprüft werden soll

Optionell können Sie geben:

• --apikey [key] API-Schlüssel, um auf Ihr Konto zu verlinken
• --text verwenden Sie Text anstelle von Emojis in der Tabelle
• --channel [channel] den Kanal, mit dem die Kompatibilität überprüft werden soll
• --package-json <packageJson> Eine Pfade zu package.json. Nützlich für Monorepos
• --node-modules <nodeModules> Eine Liste von Pfaden zu node_modules. Nützlich für Monorepos (komma getrennt, z.B. ../../node_modules,./node_modules)

Kanal

Fügen Sie

npx @capgo/cli channel add [channelName] [appId]

[channelName] den Namen Ihres neuen Kanals, wie z.B. production oder beta. [appId] oder com.test.app den Namen Ihres neuen Kanals, wie z.B. oder.

den Namen Ihres neuen Kanals, wie z.B.

npx @capgo/cli channel delete [channelName] [appId]

[channelName] den Namen Ihres neuen Kanals, wie z.B. [appId] oder com.test.app den Namen Ihres neuen Kanals, wie z.B. ist erklärt hier hier.

Liste

npx @capgo/cli channel list [appId]

[appId] Ihre App-ID ist in der folgenden Form com.test.app erklärt hier.

Sie können optional einen Schlüssel angeben:

• --apikey [key] API

Zuweisung

npx @capgo/cli channel set [channelName] [appId]

[appId] Ihre App-ID ist in der folgenden Form erklärt. [channelName] den Namen des Kanals, den Sie konfigurieren möchten, wie z.B. production oder beta.

Optionally, Sie können auch:

• --bundle [1.2.3] geben Sie Ihr bereits an den Cloud gesendetes App-Bundle an, um es mit einem Kanal zu verbinden.
• --latest bekommen Sie die Versionsnummer des Bundles von package.json:version, kann nicht mit --bundle.
• --state [ normal | default ] setzen Sie den Kanalstatus, kann auch normal oder default. Ein Kanal muss default.
• --downgrade erlaubt dem Kanal, Downgrade-Versionen an Geräten zu senden.
• --no-downgrade verhindert dem Kanal, Downgrade-Versionen an Geräten zu senden.
• --upgrade erlaubt dem Kanal, Upgrade (große) Versionen an Geräte zu senden.
• --no-upgrade Verhindert, dass der Kanal einer Geräteaktualisierung (große Version) sendet.
• --ios Erstellt den Kanal, der eine Version an iOS-Geräte senden kann.
• --no-ios Verhindert, dass der Kanal eine Version an iOS-Geräte senden kann.
• --android Erstellt den Kanal, der eine Version an Android-Geräte senden kann.
• --no-android Verhindert, dass der Kanal eine Version an Android-Geräte senden kann.
• --self-assign Erstellt den Kanal, der es Geräten ermöglicht, sich selbst diesem Kanal zuzuweisen.
• --no-self-assign Verhindert, dass Geräte sich selbst diesem Kanal zuweisen können.
• --disable-auto-update STRATEGY Deaktiviert die automatische Aktualisierungsstrategie für diesen Kanal. Die möglichen Optionen sind: major, minor, patch, metadata, none.
• --apikey [key] API-Schlüssel, um auf Ihr Konto zuzugreifen.

Deaktiviert die Aktualisierungsstrategie

Es gibt einige Möglichkeiten, um Aktualisierungen für zu alte Versionen zu deaktivieren.
Capgo kann keine native code aktualisieren, daher sollte ein Update von einer Version mit dem alten native code zu einer Version mit dem aktualisierten native code nicht möglich sein. Es gibt mehrere Möglichkeiten, das zu erreichen.

Zuerst, die major Strategie. Sie verhindert ein Update von der native Basislinie 0.0.0 -> Zielbundle 1.0.0. Der Hauptversion ist die hervorgehobene Zahl (1.0.0 und 0.0.0).
Zweitens ist die minor Strategie. Sie verhindert ein Update, wenn das Zielbundle eine andere Haupt- oder Minorversion als die native Basislinie des Geräts hat, wie z.B. 0.0.0 -> 1.1.0 oder 1.1.0 -> 1.2.0.

Drittens ist die patch Strategie. Sie wurde in capgo als sehr strenger Modus hinzugefügt. Es wird nicht empfohlen, sie zu verwenden, wenn Sie nicht vollständig verstehen, wie sie funktioniert. Um ein Update zu akzeptieren, müssen die folgenden Bedingungen erfüllt sein:

• Die Hauptversion ist die gleiche zwischen dem Zielbundle und version_build
• Der Minor ist zwischen dem Zielbundle und version_build
• Der Patch ist zwischen dem Zielbundle und version_build
• Nur der Versionssuffix kann sich unterscheiden, wie z.B. Prärelase (-beta.2) oder Build-Metadaten (+build.2)

Hier sind einige Beispiele, in welchen Szenarien die Aktualisierung erlaubt oder verweigert wird

• 1.0.0-beta.1 -> 1.0.0-beta.2 erlaubt
• 1.0.0+build.1 -> 1.0.0+build.2 erlaubt
• 1.0.0 -> 1.0.1 blockiert
• 1.0.0 -> 1.1.0 blockiert
• 1.0.0 -> 2.0.0 blockiert

Die Strategie-Vergleich verwendet die native Basislinie, die als version_build, nicht die aktuell heruntergeladene Bundle, die als version_name.

Zuletzt die komplizierteste Strategie. Das metadata Strategie
Zuerst müssen Sie wissen, dass die Aktualisierungen context: Capgo Builder / native cloud build Produktseite. Rolle: Kurzer Benutzerschnittstelle-Label oder Navigationselement. Nachrichten Schlüssel `native_build_builder_credit_first` (Native Build Builder Credit First) WIRD
fehlschlagen

Kann keine Metadaten finden
Wenn Sie etwas wie das sehen, wissen Sie, dass Sie zum aktuellen Bundle für den fehlgeschlagenen Kanal gehen und die Metadaten einrichten müssen. misconfigured Zuerst müssen Sie herausfinden, welcher Kanal fehlschlägt. Sie können das tun, indem Sie auf die

fehlerhaft konfigurierte Tabelle blicken und dann auf die fehlgeschlagene Tabelle klicken Bundle number. Dies sollte Sie zur Bundle-Seite führen.

Füllen Sie das Feld. Dies sollte ein Minimal update version Wenn der Wert, den Sie übergeben, kein ist, erhalten Sie einen Fehler, aber wenn alles korrekt verläuft, sollten Sie etwas wie das folgende sehen: Setzen Sie die Mindestversion.
Jetzt möchten Sie wahrscheinlich nicht jedes Mal diese Daten manuell setzen. Glücklicherweise wird der __CAPGO_KEEP_0__ verhindern, dass Sie ein Update ohne diese Metadaten senden.

Now, you likely do not want to set this data manually every time you update. Fortunately, the CLI will prevent you from sending an update without this metadata

with the metadata Set min version --min-update-version Once there fill the gültige SemverEtwas wie das:

Das --min-update-version ist nicht die EINZIGE Möglichkeit, Kompatibilität zu gewährleisten. Es gibt auch die --auto-min-update-versionMethode. Hier ist, wie es funktioniert.

Zuerst überprüft es die aktuelle Version, die auf dem Kanal hochgeladen wurde. Es überprüft die Kompatibilität genauso wie die bundle compatibility Befehlszeile würde. Zweitens, wenn die neue Version 100% kompatibel ist, verwendet es die min_update_version aus der letzten Version im Kanal. Wenn nicht, dann setzt es die min_update_version auf die Bundle-Nummer der neu hochgeladenen Version.

Sie erhalten immer eine Information, was die min_update_version ist, wenn Sie diese Option verwenden. Es wird etwas wie das aussehen:

Wenn die neue Version nicht kompatibel ist, sollte es so aussehen

End-to-End-Verschlüsselung (Vertrauenslos)

Capgo unterstützt die End-to-End-Verschlüsselung, was bedeutet, dass Ihr Bundle (code) vor dem Senden an den Cloud-Server verschlüsselt wird und auf dem Gerät entschlüsselt wird. Dazu müssen Sie ein RSA-Schlüsselpaar generieren, Sie können den folgenden Befehl verwenden, um es zu generieren.

Das Verschlüsselungssystem ist eine Combination aus RSA und AES, der RSA-Schlüssel wird verwendet, um den AES-Schlüssel zu verschlüsseln, und der AES-Schlüssel wird verwendet, um das Datei zu verschlüsseln.

Siehe unten für weitere Informationen über das Verschlüsselungssystem.

Verschlüsselungsschema

Schlüssel für Ihre App erstellen

npx @capgo/cli key create

Optionell kannst du: --force Um das bestehende Schlüsselpaar zu überschreiben. Diese Anweisung erstellt für dich ein Schlüsselpaar in deiner App und fragt dich nach dem Speichern des privaten Schlüssels an einem sicheren Ort. Es wird empfohlen, den privaten Schlüssel nicht in deinem Git-Repository zu speichern und ihn nicht mit anderen zu teilen.

Nach deiner lokalen Testphase entferne den Schlüssel aus der Konfigurationsdatei und füge ihn im CI-Schritt hinzu mit key save

Schlüssel in deiner App-Konfiguration speichern

npx @capgo/cli key save

Optionell kannst du:

--key [/path/to/my/public_key] den Pfad deiner öffentlichen Schlüsseldatei angeben.

--key-data [publicKey] die öffentliche Schlüsseldaten, wenn du inline verwenden möchtest. Diese Anweisung ist nützlich, wenn du die Empfehlung befolgt hast und den Schlüssel nicht in deiner App-Konfiguration gespeichert hast.

CI-Integration

Um deine Arbeit zu automatisieren, empfehle ich dir, die GitHub-Aktion zu verwenden, um auf unseren Server zu pushen

GitHub-Aktion-Tutorial

Unsere Demo-Anwendung

GitHub - Cap-go/demo-app

Vergessen Sie nicht, die CI-Umgebungsvariable mit Ihrem API-Schlüssel zu konfigurieren

Fortsetzen Sie mit Befehlen

Wenn Sie “Befehle” verwenden Befehle um einen Dashboard und API-Operationen zu planen, verbinden Sie es mit API-Übersicht für die Implementierungsdetails in API-Übersicht Einführung für die Implementierungsdetails in Einführung API Schlüssel für die Implementierungsdetails in API Schlüssel Geräte für die Implementierungsdetails in Geräten und Bundles für die Implementierungsdetails in Bundles.