Zum Inhalt springen

Befehle

Diese Seite ist eine geführte Übersicht. Verwenden Sie die aktuelle Befehlsreferenz für genaue Flags: Anwendung, Bündel, Kanalund Bauen.

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

npx @capgo/cli@latest init [apikey]

Dieser Methoden ist hier, um Sie Schritt für Schritt einzuführen.

Es wird Ihre App zu Capgo hinzufügen. Es wird code zu Ihrer App hinzufügen, um die Aktualisierung zu validieren. Ebenso wird es Ihre App erstellen. Darüber hinaus wird es Ihre App auf Capgo hochladen. Und es wird Ihnen helfen, zu überprüfen, ob die Aktualisierung funktioniert.

npx @capgo/cli login [apikey]

Dieser Methoden ist hier, um Ihre apikey zurückzuerinnern.

Optional können Sie auch geben:

--local Dies wird Ihren apikey in der lokalen Repo speichern und es ignoriert in Git.

npx @capgo/cli doctor

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

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

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.
  • --name [test] eine benutzerdefinierte Bezeichnung in der Liste.
  • --apikey [key] API-Schlüssel, um auf Ihr Konto zu verlinken.
  • --retention [retention] Die Aufbewahrungsfrist der App-Bundle in Tagen, 0 durch Standard = unendlich.

Beispiel für capacitor.config.json Für appId und AppName wird der Icon im Ressourcenordner erraten.

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

npx @capgo/cli app set [appId]

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

Optional können Sie auch:

  • --icon [/path/to/my/icon] um eine benutzerdefinierte Icon-Anzeige in der Capgo Webanwendung zu haben.
  • --name [test] um einen benutzerdefinierten Namen in der Liste zu haben.
  • --retention [retention] Die Aufbewahrungsfrist der App-Bundle in Tagen, 0 durch Standard = unendlich.
  • --expose-metadata [true|false] um die Bundle-Metadaten (Link und Kommentar) an das Plugin auszuliefern.
  • --preview oder --no-preview Alternativen: Wie wählen Sie die richtige Lösung?
  • --allow-device-custom-id um die Bundle- und Kanal-Vorschau-QR-Codes zu aktivieren oder zu deaktivieren. --no-allow-device-custom-id oder
  • --block-provider-infra-requests um die Blockierung von bekannten Google- und Apple-Datencenter-Anfragen zu steuern. --no-block-provider-infra-requests um die native Build-Zeit auszuliefern.
  • --build-timeout-minutes [5-360] oder
  • --ios-store-url [url] um die native Build-Zeit festzulegen. --android-store-url [url] um die native Build-Zeit festzulegen.
  • --default-upload-channel [channel] um die native Build-Zeit festzulegen.
  • --default-download-channel [channel] um die native Build-Zeit festzulegen. --disable-download-channels alle Download-Canäle nicht öffentlich zu machen.
  • --apikey [key] API-Schlüssel, um auf Ihr Konto zu verlinken.

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"

Ihre App-ID in der Formatierung

npx @capgo/cli app delete [appId]

[appId] erklärt hier com.test.app 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.

npx @capgo/cli app debug [appId]

[appId] ihre App-ID in der Format com.test.app 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

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 appId. Wenn Sie die automatische Aktualisierung deaktivieren möchten in dem capacitor-updatergeben Sie 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: Vergleich von Capgo-Live-Update-Alternativen. Rolle: Langen Marketing- oder Rechtsparagraphen. Gesehen in: Seite alternatives.astro. Bewahren Sie Capgo-Produkt- und -Marken- sowie Entwicklertitel genau. 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-Vergleich/ Migration-Marketing-Text. Rolle: Langen Marketing- oder Rechtsparagraphen. Gesehen in: Seite ionic-appflow.astro. Bewahren Sie Capgo-Produkt- und -Marken- sowie Entwicklertitel genau. 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: Langen Marketing- oder Rechtsparagraphen. Gesehen in: Seite capwesome.astro. Bewahren Sie Capgo-Produkt- und -Marken- sowie Entwicklertitel genau. Nachrichtenschlüssel `capwesome_cta_questions` (Capwesome-CTA-Fragen). | HTML-Textfragment aus einem längeren Capgo-UI-String (Elternschlüssel `consulting_faq_subtitle`). Seite/Bereich: Beratungsdienste-Seite. Rolle: Abschnittstitel oder -Slogan. Gesehen in: Seite consulting.astro. Bewahren Sie Capgo-Produkt- und -Marken- sowie Entwicklertitel genau. Nachrichtenschlüssel `consulting_faq_subtitle` (Beratungsdienste-Faq-Untertitel). | Seite/Bereich: Appflow-Vergleich/ Migration-Marketing-Text. 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

npx @capgo/cli bundle upload [appId]

[appId] ist Ihre App-ID, die Formatierung wird hier 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 zu verlinken.
  • --external <url> Link auf externe URL anstatt Upload auf Capgo Cloud.
  • --iv-session-key <key> Setze die IV und Sitzungsschlüssel für die Bundle-URL extern.
  • --s3-endpoint <s3Endpoint> URL des S3-Endpunkts. Funktioniert nicht mit Delta-Uploads oder der externen Option.
  • --s3-region <region> Region für deinen S3-Bucket.
  • --s3-apikey <apikey> API-Schlüssel für deinen S3-Endpunkt.
  • --s3-apisecret <apisecret> API-Geheimnis für deinen S3-Endpunkt.
  • --s3-bucket-name <bucketName> Name für deinen AWS-S3-Bucket.
  • --s3-port <port> Höhe für deinen S3-Endpunkt.
  • --no-s3-ssl Deaktiviere SSL für S3-Upload.
  • --key <key> Benutzerdefinierte Pfad für öffentliche Signierungskey (v1-System).
  • --key-data <keyData> Öffentlicher Signierungskey (v1-System).
  • --key-v2 <key> Benutzerdefinierte Pfad für privaten Signierungskey (v2-System).
  • --key-data-v2 <keyData> Privater Signierungskey (v2-System)
  • --bundle-url Druckt die Bundle-URL in die Konsole aus.
  • --no-key Ignoriere den Signierungskey und sende ein klares Update.
  • --no-code-check Ignoriere die Überprüfung, ob notifyAppReady() in der Quelldatei code und der Index im Root-Ordner vorhanden ist.
  • --display-iv-session Zeige im Konsolen die IV- und Sitzungskey an, die zum Verschlüsseln des Updates verwendet werden.
  • --bundle <bundle> Bundle-Version des zu hochladenden Bundles.
  • --auto-bump [level] Automatische Inkrementierung von der im Kanal verknüpften Bundle-Version, andernfalls die aktuelle Remote-App-Version. Ebene: major, minor (Standard) patch (Alias) fix), metadata, oder ai Arbeitet der Workers-AI-Algorithmus mit den lokalen Dateien und dem vorherigen Capgo/Kanal-Delta-Manifest, schließt die Ebene ab und gibt einen kurzen Grund an; ignoriert den AI und springt auf die nächste Ebene, wenn keine vorherige Capgo-Version vorhanden ist. Springt bis eine freie Bezeichnung gefunden ist (gelöschte Namen bleiben belegt). Kann nicht mit patch if no previous Capgo version). Bumps until a free name is found (deleted names stay occupied). Cannot be combined with --bundle.
  • --min-update-version <minUpdateVersion> Minimal erforderliche Version zum Update auf diese Version. Wird nur verwendet, wenn die automatische Aktualisierung in der Kanal-Einstellung deaktiviert 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 Upload-Prozess in Sekunden.
  • --delta Hochlädt Delta- (Manifest-) Dateien neben der vollständigen Bundle.
  • --delta-only Hochlädt nur Delta- (Manifest-) Updates, überspringt die vollständige Bundle.
  • --no-delta Deaktiviert die Hochladen von Delta- (Manifest-) Dateien (wird nützlich, wenn ein Instant-Apply-Modus aktiviert ist, aber eine vollständige Bundle gewünscht wird). autoUpdate Hochlädt die Bundle mithilfe des tus-Protokolls.
  • --tus Verwendet das multipart-Protokoll, um Daten an S3 hochzuladen. Veraltet, verwenden Sie stattdessen TUS.
  • --multipart Ein verschlüsselter Prüfsummenwert (Signatur). Wird nur verwendet, wenn ein externes Bundle hochgeladen wird.
  • --encrypted-checksum <encryptedChecksum> Deaktiviert die automatische Aktualisierung in der Kanal-Einstellung.
  • --package-json <packageJson> Einen Pfad zu package.json. Nützlich für Monorepos.
  • --auto-set-bundle Setze die Bundle in capacitor.config.json.
  • --node-modules <nodeModules> Eine Liste von Pfaden zu node_modules. Nützlich für Monorepos (komma getrennt, z.B. ../../node_modules,./node_modules)

⭐️ Die externe Option hilft dabei, 2 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 Capgo nichts sehen oder ändern, es wird “vertrauenswürdig”.

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 zu aktualisieren, wenn Sie eine neue senden, die Versionsnummer kann nicht überschrieben oder nach der Löschung wiederverwendet werden, aus Sicherheitsgründen.

npx @capgo/cli bundle list [appId]

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

Optional kannst du geben:

  • --apikey [key] API-Schlüssel, um auf Dein Konto zu verlinken.

npx @capgo/cli bundle delete [appId]

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

Optional kannst du geben:

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

in einer SemVer-Rangfolge für eine Hauptversion zu Cloud

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

[appId] Ihre App-ID ist in der folgenden 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 Pakete, die Sie behalten möchten (Standard 4). numberToKeep.
  • --keep [numberToKeep] Cleanup

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 beibehalten.

Diese Anweisung wird eine Bestätigung anfordern und eine Tabelle anzeigen, was beibehalten und entfernt wird.

Warnung: Diese Anweisung ist veraltet und wird in der nächsten großen Version 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 für Testzwecke.

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. Die Anweisung wird Ihre ivSessionKeyy und generiert einen verschlüsselten Zip, um ihn mit dem Upload-Befehl oder dem Entschlüsselungsbefehl zu verwenden.

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

Diese Anweisung wird verwendet, wenn Sie einen externen Speicherort verwenden, um Ihre code zu speichern, oder für Testzwecke. Der Prüfsummenwert ist der sha256-Wert des Pakets (erzeugt durch —key-v2), er wird verwendet, um die Integrität des Dateis nach der Entschlüsselung zu überprüfen. Er wird mit dem privaten Schlüssel verschlüsselt und zusammen mit dem Paket gesendet. Bei der Verschlüsselung V2 wird der Prüfsummenwert auf ein “Zeichen” des Pakets aufgewertet.

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. --json um Informationen als JSON auszugeben. Die Anweisung wird Ihre ivSessionKeyy und generieren Sie ein verschlüsseltes Zip, um es mit dem Upload-Befehl oder dem Entschlüsselungsbefehl zu verwenden.

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 wird das Zip-Datei entschlüsseln und die Base64-entschlüsselte Sitzungsschlüssel im Konsolenfenster ausgeben.

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 wird das Zip-Datei entschlüsseln und die Base64-entschlüsselte Sitzungsschlüssel im Konsolenfenster ausgeben. --checksum [checksum] den Prüfsumme der Datei, es wird die Prüfsumme nach der Entschlüsselung überprüfen.

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 Ordnermap zu 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.

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

[appId] Ihre App-ID, die Formatierung wird erklärt hier. [channelName] der Name des Kanals, den Sie überprüfen möchten

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> Ein Pfad 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)

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

[channelName] den Namen Ihres neuen Kanals, wie z.B. production oder beta. [appId] wie Sie Ihren App-Id in der Formatierung angeben, ist hier erklärt com.test.app Entfernen Sie Abschnitt mit dem Titel „Entfernen Sie“.

den Namen des Kanals, den Sie löschen möchten

wie Sie Ihren App-Id in der Formatierung angeben, ist hier erklärt

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

[channelName] Fügen Sie [appId] Abschnitt mit dem Titel „Fügen Sie hinzu“ com.test.app den Namen Ihres neuen Kanals, wie z.B. Hier.

npx @capgo/cli channel list [appId]

[appId] Deine App-ID in der Formatierung com.test.app erläutert Hier.

Optional kannst du folgendes angeben:

  • --apikey [key] API-Schlüssel, um auf Dein Konto zu verlinken.

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

[appId] Deine App-ID, die Formatierung wird erläutert Hier. [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] ihre App-Bundle, die bereits an den Cloud gesendet wurde, um es mit einem Kanal zu verbinden.
  • --latest herauszufinden package.json:version, kann nicht mit --bundle.
  • --state [ normal | default ] setzen, kann 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 dem Kanal, eine (große) Versionsaktualisierung an Geräte zu senden.
  • --ios Erstellt den Kanal, der Versionen an iOS-Geräte senden kann.
  • --no-ios Verhindert dem Kanal, Versionen an iOS-Geräte zu senden.
  • --android Erstellt den Kanal, der Versionen an Android-Geräte senden kann.
  • --no-android Verhindert dem Kanal, Versionen an Android-Geräte zu senden.
  • --self-assign Erstellt es Geräten ermöglicht, sich selbst diesem Kanal zuzuweisen.
  • --no-self-assign Verhindert es Geräten, sich selbst diesem Kanal zuzuweisen.
  • --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.

Es gibt einige Möglichkeiten, um Aktualisierungen für zu alte Versionen zu deaktivieren.
Capgo kann die native code nicht aktualisieren, daher sollte eine Aktualisierung von einer Version mit der alten native code auf eine Version mit der aktualisierten native code nicht möglich sein. Es gibt mehrere Möglichkeiten, dies zu erreichen.

Zuerst, die major Strategie. Sie verhindert eine Aktualisierung von der native Basislinie 0.0.0 -> Ziel-Bundle 1.0.0. Die Hauptversion ist die hervorgehobene Zahl (1.0.0 und 0.0.0).
Zweitens ist die minor Strategie. Sie verhindert eine Aktualisierung, wenn das Ziel-Bundle eine andere Haupt- oder Minor-Version als die native Basislinie des Geräts hat, wie z.B. 0.0.0 -> 1.1.0 oder 1.1.0 -> 1.2.0.

context:HTML-Textfragment aus einem längeren Capgo-UI-String (Elternschlüssel `alternatives_cta_questions`). Seite/Bereich: Capacitor-Live-Update-Vergleichsseite. Rolle: Langer Marketing- oder Rechtsparagraph. Gesehen in: Seite alternatives.astro. Produkt- und Markenbezeichnungen sowie Entwicklertitel von Capgo werden genau beibehalten. 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-Marketing-Text. Rolle: Langer Marketing- oder Rechtsparagraph. Gesehen in: Seite ionic-appflow.astro. Produkt- und Markenbezeichnungen sowie Entwicklertitel von Capgo werden genau beibehalten. 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: Langer Marketing- oder Rechtsparagraph. Gesehen in: Seite capwesome.astro. Produkt- und Markenbezeichnungen sowie Entwicklertitel von Capgo werden genau beibehalten. Nachrichtenschlüssel `capwesome_cta_questions` (Capwesome-CTA-Fragen). | Seite/Bereich: Beratungsdienste-Seite. Rolle: Untertitel oder Slogan. Gesehen in: Seite consulting.astro. Produkt- und Markenbezeichnungen sowie Entwicklertitel von Capgo werden genau beibehalten. Nachrichtenschlüssel `consulting_faq_subtitle` (Beratungsdienste-Faq-Untertitel). | Seite/Bereich: Appflow-Vergleichs- und Migration-Marketing-Text. 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) patch strategy. It was added into capgo as a very strict mode. It’s not recommended to be used unless you fully understand how it works. In order for it to accept an update, the following conditions must be met:

  • Strategie. Sie wurde in __CAPGO_KEEP_0__ als sehr strenger Modus hinzugefügt. Es wird nicht empfohlen, sie zu verwenden, wenn Sie nicht vollständig verstehen, wie sie funktioniert. Um eine Aktualisierung akzeptieren zu können, müssen die folgenden Bedingungen erfüllt sein: Die Hauptversion ist die gleiche zwischen dem Ziel-Bundle und version_build
  • Die Minderversion ist zwischen dem Zielbundle und version_build
  • Die Patchversion ist zwischen dem Zielbundle und version_build
  • Nur die Versionspräfix kann sich unterscheiden, wie z.B. Präreläse (-beta.2) oder Build-Metadaten (+build.2)

Hier sind einige Beispiele, in welchen Szenarien die Aktualisierung zugelassen oder abgelehnt wird

  • 1.0.0-beta.1 -> 1.0.0-beta.2 zugelassen
  • 1.0.0+build.1 -> 1.0.0+build.2 zugelassen
  • 1.0.0 -> 1.0.1 abgelehnt
  • 1.0.0 -> 1.1.0 abgelehnt
  • 1.0.0 -> 2.0.0 abgelehnt

Die Strategie-Vergleich verwendet die native Basislinie, die als version_buildnicht 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: Kurze Benutzeroberflächenschaltfläche oder Navigationselement. Nachrichtenschlüssel `native_build_builder_credit_first` (Native Build Builder Credit First) WIRD
fehlschlagen

da der Kanal die erforderliche Metadaten fehlt.

Wenn der Kanal Metadaten fehlt, sehen Sie eine Nachricht wie diese:
Kann keine Metadaten finden misconfigured 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.

Zuerst müssen Sie herausfinden, welcher Kanal fehlschlägt. Sie können das tun, indem Sie auf die

Spalte schauen und die Tabelle mit Fehlkonfigurationen ansehen. Dann gehen Sie zum fehlgeschlagenen Kanal und klicken Sie auf Bundle number. Dies sollte Sie zur Bundle-Seite bringen.

Der fehlende Kanal finden

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: Mindestversion setzen.
Jetzt, Sie werden wahrscheinlich nicht jede Aktualisierung manuell diese Daten setzen wollen. Glücklicherweise wird der __CAPGO_KEEP_0__ verhindern, dass Sie eine Aktualisierung ohne diese Metadaten senden.

__CAPGO_KEEP_0__ fehlerhaft ohne Metadaten

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

CLI fail no metadata

passen. metadata pagePath --min-update-version protectedTokens gültige SemverEtwas wie das:

CLI hochladen mit Metadaten

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

Zuerst überprüft es die aktuell hochgeladene Version im Kanal. Es überprüft die Kompatibilität genauso wie der bundle compatibility Befehl es tun 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:

Mindestupdateversion

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

Mindestupdateversion nicht kompatibel

Capgo unterstützt die End-to-End-Verschlüsselung, das 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 eine RSA-Schlüsselpaar erzeugen, Sie können den folgenden Befehl verwenden, um es zu erzeugen.

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.

Wie funktioniert das Kryptosystem?

Verschlüsselungsschema

npx @capgo/cli key create

Optional können Sie: --force Um das bestehende Schlüsselpaar zu überschreiben. Diese Anweisung erstellt für Sie ein Schlüsselpaar in Ihrer App und fragt Sie nach, wo Sie den privaten Schlüssel sicher speichern möchten. Es wird empfohlen, den privaten Schlüssel nicht in der Git-Datenbank zu speichern und ihn nicht mit anderen zu teilen.

Nachdem Sie Ihre lokale Testphase abgeschlossen haben, entfernen Sie den Schlüssel aus der Konfigurationsdatei und fügen Sie ihn auf der CI-Schritt ein mit key save

npx @capgo/cli key save

Optional können Sie:

--key [/path/to/my/public_key] den Pfad Ihres öffentlichen Schlüssel-Dateis.

--key-data [publicKey] die öffentliche Schlüssel-Daten, wenn Sie inline verwenden möchten. Diese Anweisung ist nützlich, wenn Sie die Empfehlung befolgt haben und den Schlüssel nicht in Ihrer App-Konfiguration gespeichert haben.

Um Ihre Arbeit zu automatisieren, empfehle ich Ihnen, die GitHub-Aktion die Arbeit von der Übertragung an unseren Server zu übernehmen

GitHub-Aktion-Tutorial

GitHub - Cap-go/demo-app

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

Wenn Sie “Commands” verwenden Befehle um einen Dashboard und API-Operationen zu planen, verbinden Sie es mit API-Übersicht für die Implementierungsdetails in der 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 Pakete für die Implementierungsdetails in Paketen.