Was ist Capacitor-Updater?
Capacitor-Updater, eine Technologie, die dabei hilft, Updates und Verbesserungen für die Endnutzer sofort bereitzustellen.
Das ist besonders großartig, wenn Sie kritische Fehlerbehebungen durchführen und sofort ohne die App Store-Bewertung liefern möchten.
Sie können es sich als „webartige“ Agilität der Seitenladung von Updates denken, sobald sie verfügbar sind.
Darüber hinaus bietet es Rollbacks, wenn der neue Update den App abstürzt
Wie funktioniert es?
Capgo keeps your app’s JavaScript bundle in sync with the Capgo server, and every time the user opens the app, it checks with the Capgo server if a new update is available to the bundle. And of course, it comes with tons of awesome configurations which can help you fine-tune your user’s experience.
Ich verwende Capgo in allen Projekten, die ich baue. Das ermöglicht es mir, weniger Zeit in der App Store-Bewertungsprozess zu investieren.
Sie können mehr darüber lesen hier.
Semantic Versioning mit Capgo verstehen
Capgo verwendet semantische Versionierung (semver), um zu bestimmen, wann und wie Updates auf Ihre App angewendet werden sollten. Dies stellt sicher, dass Ihre Benutzer nur kompatible Updates erhalten und verhindert, dass automatisch deployierte Änderungen die App abstürzen lassen.
Semantic versioning folgt der Formatvorlage MAJOR.MINOR.PATCH:
- MAJOR: Änderungen, die eine native App-Store-Veröffentlichung erfordern
- MINOR: Neue Funktionen, die backwards kompatibel sind
- PATCH: Fehlerbehebungen, die backwards kompatibel sind
Beispiel: Wenn Ihre App der Version 1.0.0 und Sie möchten auf 1.0.1 (eine Patchesversion), Capgo wird diese Aktualisierung automatisch anwenden. Allerdings erfordert eine Aktualisierung von 1.0.0 auf 2.0.0 (eine MAJOR-Version), eine native App-Store-Veröffentlichung, da es sich um Änderungen handelt, die eine native App-Store-Veröffentlichung erfordern.
Capgo’s Kanal-Einstellungen ermöglichen Ihnen, die Art von Updates zu konfigurieren, die automatisch angewendet werden:
- Hauptstrategie: Erlaubt alle Updates (mit Vorsicht verwenden)
- Kleinststrategie: Erlaubt nur kleine und Patches-Updates
- Patches-Strategie: Erstellt nur Patches-Updates
- Metadaten-Strategie: Erfordert, dass die Mindestanforderungen an die Version erfüllt werden
Sie können mit Capgo’s Update-Logic verschiedene Version kombinieren, um zu testen, wie sie funktionieren, mit unserem Semver-Tester-Tool. Dieses Tool hilft Ihnen, genau zu verstehen, wann Updates auf der Grundlage Ihrer Kanal-Konfiguration angewendet werden.
Gibt es Einschränkungen?
Wie gut es auch klingen mag, es gibt ein paar Dinge, die wir im Auge behalten müssen. Die erste Sache ist, dass OTA-Updates nur mit Web-Bundles funktionieren. Man könnte denken, dass dies nicht wirklich ein großer Einschränkung ist, weil wir in Capacitor JS fast alle code in JS, CSS und HTML schreiben. Während dies wahr sein mag, gibt es noch native Module, die wir in unsere App installieren. Wenn ein Modul die Android- oder iOS-Ordner ändert, kann man OTA nicht verwenden, um die App zu aktualisieren. Das liegt daran, dass die Inhalte dieser Ordner zum Kompilieren von Native-Binären verwendet werden, was OTA nicht aktualisieren kann. Even native Apps können diese Teile nicht aktualisieren.
Aber Sie können Ihre CI/CD einrichten, um diese Teile zu handhaben, ich habe ein Tutorial darüber erstellt hier für IOS.
Auto Capgo Konfiguration
Es ist Zeit, sich anzumelden und Ihre API-Schlüssel zu erhalten, um Ihre erste Version hochzuladen! Beginnen Sie damit, sich für ein API-Konto anzumelden signing up for a Capgo account.
Once you’re logged into Capgo, You will have an onboarding page
]}
Befolgen Sie die CLI-Richtlinie
Aus einer Befehlszeile, direkt in das Verzeichnis Ihres Capacitor-Apps, führen Sie:
npx @capgo/cli@latest init
Um die Capgo in Ihr Capacitor-App zu installieren, wird die CLI Ihnen durch den Prozess der Einrichtung Ihrer App mit Capgo führen.
Wenn Sie es manuell machen möchten, können Sie die folgenden Schritte befolgen.
Manuelle Capgo-Konfiguration
Installieren Sie das Plugin
Sie sollten mit diesem code in Ihrem App landen:
npm i @capgo/capacitor-updater && npx cap sync
Um das Plugin in Ihr Capacitor-App zu installieren.
Und fügen Sie dann diesem code zu Ihrer App hinzu, um der native Plugin mitzuteilen, dass die JS-Bundle gesund ist (wenn Sie dies nicht tun, wird das native Plugin auf die vorherige Version zurückrollen):
import { CapacitorUpdater } from '@capgo/capacitor-updater'
CapacitorUpdater.notifyAppReady()Dies wird dem native Plugin mitteilen, dass die Installation erfolgreich war.
Dann führen Sie ein npm run build && npx cap copy um Ihre App zu aktualisieren.
Anmelden bei Capgo CLOUD
Zunächst verwenden Sie den all apikey die in Ihrem Konto vorhanden ist, um sich mit dem CLI anzumelden:
npx @capgo/cli@latest login YOU_KEY
Fügen Sie Ihre erste App
Lassen Sie uns mit der Erstellung einer App in Capgo Cloud beginnen, die mit dem CLI erstellt wird.
npx @capgo/cli@latest app add
Diese Kommandozeilenanweisung wird alle in der Capacitor Konfigurationsdatei definierten Variablen verwenden, um die App zu erstellen.
Hochladen der ersten Version
Führen Sie den Befehl aus, um Ihre code zu erstellen und es an Capgo zu senden:
npx @capgo/cli@latest bundle upload
Standardmäßig wird der Versionsname der im package.json Datei sein.
Überprüfen Capgo wenn das Build vorhanden ist.
Sie können es sogar mit meinem mobil-Sandbox-App testen.
Machen Sie den Kanal standardmäßig
Nachdem Sie Ihre App an Capgo gesendet haben, müssen Sie Ihren Kanal default um Apps zu ermöglichen, Updates von Capgo zu empfangen.
npx @capgo/cli@latest channel set production -s default
Empfangen Sie ein Live-Update auf einem Gerät
Um Ihre Anwendung ein Live-Update von Deploy zu empfangen, müssen Sie die App auf einem Gerät oder einem Emulator ausführen. Der einfachste Weg, dies zu tun, besteht darin, einfach die folgende Kommandozeilenanweisung auszuführen, um Ihre lokale App in einem Emulator oder einem mit Ihrem Computer verbundenen Gerät zu starten.
npx cap run [ios | android]Öffnen Sie die App, stellen Sie sie in den Hintergrund und öffnen Sie sie erneut, Sie sollten im Protokoll sehen, dass die App das Update durchgeführt hat.
Glückwunsch! 🎉 Sie haben Ihre erste Live-Update erfolgreich bereitgestellt. Dies ist nur der Anfang dessen, was Sie mit Live-Updates erreichen können. Um mehr zu erfahren, besuchen Sie die vollständigen Live-Updates-Dokumentation.
If Sie die Aktualisierungen auf Ihrem lokalen System unterbrechen müssen, führen Sie diesen Befehl aus.
npx @capgo/cli@latest channel set
Fortsetzen Sie, Ihre Capacitor-Anwendungen problemlos mit dem Capacitor-Updater zu aktualisieren.
Wenn Sie __CAPGO_KEEP_0__ verwenden Fortsetzen Sie, Ihre Capacitor-Anwendungen problemlos mit dem Capacitor-Updater zu aktualisieren. um die Migration und die Unternehmensoperationen zu planen und zu verbinden, wenden Sie sich an Capgo Enterprise zur Produktionsablaufplanung in Capgo Enterprise Ionic Enterprise Plugin Alternativen zur Produktionsablaufplanung in Ionic Enterprise Plugin Alternativen Capgo Alternativen zur Produktionsablaufplanung in Capgo Alternativen Capgo Consulting für den Produktworkflow in Capgo Consulting, und Capgo Premium Support für den Produktworkflow in Capgo Premium Support.
