Zum Hauptinhalt springen
Tutorial

Wie funktionieren Capgo-Versionen?

Erfassen Sie, wie Capgo die Versionen in Ihrer Capacitor-Anwendung verwaltet und nutzen Sie es optimal. Lernen Sie die Bedeutung von Major, Minor und Patch.

Martin Donadieu

Martin Donadieu

Content-Marketing-Manager

Wie funktionieren Capgo-Versionen?

Capgo verwendet 2 Hauptvariablen, um die Versionen in Ihrer Capacitor-Anwendung zu verwalten:

  • Native Version
  • JavaScript-Versionen
Capacitor-Update-System

Alle Versionen werden serverseitig durch Capgo bestimmt.

Versionsverwaltungssystem

Um die Version Capgo zu verwalten, verwenden Sie das SemVer-System, mehr erfahren Sie dazu hier.

Versions

Wo Capgo finden Sie die Version zum Vergleichen

Sie können diese Verhaltensweise überschreiben, indem Sie die Versionsnummer im capacitor.config.json Datei Dokumentation hier Die native Version wird für alle Plattformen ignoriert.

iOS

In iOS wird die Variable auf Ihrem Projekt hier gesetzt. ios/App/App/Info.plist unter der SchlüsselCFBundleShortVersionString oder ios/App/App.xcodeproj/project.pbxproj unter der Schlüssel MARKETING_VERSION wenn MARKETING_VERSION wurde in Ihrem Info.plist Datei gesetzt.

Android

In Android wird die var auf Ihrem Projekt hier android/app/build.gradle unter der Schlüssel defaultConfig.versionName

JavaScript ( Capgo Bundleversion )

In JavaScript kann die var in Ihrem package.json unter der Schlüssel version Sie müssen es sonst in der Upload-Befehl angeben.

Standardverhalten

Dies ist das Verhalten des Capgo-Kanals, wenn Sie keine Einstellungen geändert haben.

Dieses Verhalten wird auf der einzigartigen Standardkanal basieren, die Sie erstellt haben.

Bei einer frischen Installation Ihrer Capacitor-Anwendung

Wenn der Benutzer Ihre Ionic-Anwendung zum ersten Mal herunterlädt und die App öffnet, kontaktiert sie den Capgo-Server.

Aktuell können 4 Ausgänge auftreten:

  • Die native Bundle-Version (1.2.3) ist niedriger als die Capgo-Bundle-Version (1.2.4), Capgo sendet die Bundle an den Benutzer.
  • Die native Bundle-Version (1.2.3) ist gleich der Capgo-Bundle-Version (1.2.3), Capgo sendet „keine Aktualisierung erforderlich“.
  • Die native Bundle-Version (1.2.4) ist höher als die Capgo-Bundle-Version (1.2.3), Capgo sendet „keine Aktualisierung erforderlich“.
  • Die native Bundle-Version (1.2.3) ist MAJOR niedriger als die Capgo-Bundle-Version (2.2.3), Capgo sendet „keine Aktualisierung erforderlich“.

Andere Einstellungen

Automatische Downgrade unter Native deaktivieren

Wenn Sie diese Einstellung auf false ändern, wird Capgo immer als vertrauenswürdige Quelle der Version betrachtet.

  • The native version (1.2.4) is higher than Capgo version (1.2.3)

Die native Version (1.2.4) ist höher als die Capgo Version (1.2.3)

__CAPGO_KEEP_0__ sendet seine Version an den Benutzer.

Automatische Upgrade-Strategie deaktivieren Es gibt ein paar Strategien, die Sie auswählen können. Sie können mehr darüber erfahren

hier

JavaScript-Bundle-Version npx @capgo/cli@latest bundle upload --channel production

Die JavaScript-Bundle-Version ist die, die Sie senden, wenn Sie --bundle 1.2.3, Capgo will get the bundle version from your package.json __CAPGO_KEEP_0__ wird die Bundle-Version aus Ihrem

Nachdem Ihre Ionic-App eine Version von Capgo installiert hat, wird diese Version für den Vergleich verwendet:

  • Ihre JavaScript-Bundle-Version (1.2.3) ist niedriger als die Capgo-Bundle-Version (1.2.4), Capgo sendet daher sein Bundle an den Benutzer.

Mit einigen Wächterbedingungen:

  • Wenn die native Bundle-Version höher ist als die Capgo-Version, wird die Bedingung angewendet. Disable auto downgrade under native Wenn die native Bundle-Version MAJOR niedriger ist als die __CAPGO_KEEP_0__-Version, wird die Bedingung angewendet.
  • If native bundle version is MAJOR lower than Capgo version, the Disable auto upgrade above major Wenn Sie Ihre __CAPGO_KEEP_0__-JS-Anwendung im App Store veröffentlichen, passiert Folgendes:

Ihr Benutzer erhält die neue Version aus dem Store und entfernt alle lokalen Updates in ihrer App standardmäßig.

When you publish your Capacitor JS app on the App Store, what happens is simple.

lesen Sie mehr darüber

read more about it resetWhenUpdate If native bundle version is higher than __CAPGO_KEEP_0__ version, the condition is applied. hier

Dies kann nur auf der App-Seite geändert werden, nicht wie andere Einstellungen von der Cloud.

Andere Einstellungen

Nachdem diese Verhaltensweise erfolgt ist, können Sie oben noch spezifische Einstellungen für das Geräte-ID vornehmen.

In Capgo, können Sie entscheiden, das Verhalten für jede Geräte-ID zu überschreiben.

Sie können eine Geräte-ID mit:

  • einer bestimmten Bundle-Version
  • einem bestimmten Kanal

Dies überspringt alle oben getroffenen Einstellungen.

Mehr erfahren Sie in dem Artikel unten.

Live-Updates für Capacitor-Anwendungen

Wenn ein Bug im Weblayer live ist, versenden Sie die Reparatur über Capgo anstatt Tage zu warten, bis der App-Store genehmigt hat. Die Benutzer erhalten das Update im Hintergrund, während native Änderungen im normalen Review-Verfahren bleiben.

Los geht's

Neueste aus unserem Blog

Capgo bietet Ihnen die besten Einblicke, die Sie benötigen, um eine wirklich professionelle mobile App zu erstellen.