Was ist der Capacitor-Updater?
Der Capacitor-Updater ist eine Technologie, die dabei hilft, Updates und Verbesserungen für die Endnutzer sofort bereitzustellen.
Das ist besonders großartig, wenn Sie kritische Fehler beheben und sofort ohne die App-Store-Überprüfung liefern möchten.
Sie können es sich als “webartige” Agilität von Seitenladungen von Updates denken, sobald sie verfügbar sind.
Darüber hinaus bietet es Rollbacks, wenn die neue Aktualisierung das App-Programm 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 den App-Store-Bewertungsprozess zu investieren.
Mehr erfahren Sie hier Verständnis von Semantic Versioning mit __CAPGO_KEEP_0__.
Capgo verwendet die semantische Versionsnummerierung (semver), um zu bestimmen, wann und wie Updates auf Ihre App angewendet werden sollten. Dies sichert sicher, dass Ihre Benutzer nur kompatible Updates erhalten und verhindert, dass automatisch deployierte Änderungen die App abstürzen lassen.
Capgo uses semantic versioning (semver) to determine when and how updates should be applied to your app. This ensures that your users only receive compatible updates and prevents breaking changes from being automatically deployed.
MAJOR MAJOR.MINOR.PATCH:
- : Änderungen, die eine native App-Store-Veröffentlichung erfordernMINOR
- __CAPGO_KEEP_2__: Neue Funktionen, die kompatibel mit früheren Versionen sind
- PATCH: Fehlerbehebungen, die kompatibel mit früheren Versionen sind
Beispiel: Wenn Ihre App der Version 1.0.0 und Sie möchten sie auf 1.0.1 (eine Patchesversion), wird Capgo diese Aktualisierung automatisch anwenden. Allerdings würde eine Aktualisierung von 1.0.0 auf 2.0.0 (eine Hauptversion) eine native App-Store-Veröffentlichung erfordern, da dies aufgrund von Änderungen mit Auswirkungen auf die Kompatibilität steht.
Capgo’s Kanal-Einstellungen ermöglichen es Ihnen, die Arten von Aktualisierungen zu konfigurieren, die automatisch angewendet werden:
- Hauptstrategie: Zulässt alle Aktualisierungen (mit Vorsicht verwenden)
- Minderstrategie: Nur Minor- und Patch-Updates zulassen
- Patch-Strategie: Zulässt nur Patch-Updates
- Metadaten-Strategie: Erfordert, dass die Mindestversionserfordernisse erfüllt werden
You can test how different version combinations work with Capgo’s update logic using our Semver-Tester-Tool prüfen, wie verschiedene Versionenkombinationen mit der Update-Logik von __CAPGO_KEEP_0__ funktionieren. Dieses Tool hilft Ihnen, genau zu verstehen, wann Updates auf der Grundlage Ihrer Kanal-Konfiguration angewendet werden.
Gibt es Einschränkungen?
Als gut, wie es klingt, gibt es ein paar Dinge, die wir im Auge behalten müssen. Die erste Sache ist, dass OTA-Updates. You may think that this isn’t really a big limitation because, in Capacitor JS, we write almost all code in JS CSS and HTML. While this may be true, there still are native modules that we install to our app. If a module changes your android or iOS directories, you can’t use OTA to update your app. That’s because these directories’ contents are used to compile Native binaries, which OTA can’t update. Even native app cannot update this part.
Aber Sie können Ihre CI/CD einrichten, um diese Aufgabe zu erledigen, ich habe ein Tutorial erstellt, um es zu tun 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 Capgo-Konto anzumelden.
Einmal angemeldet bei Capgo, werden Sie eine Onboarding-Seite erhalten
Folgen Sie den Schritten auf der Onboarding-Seite, um Ihre erste App hinzuzufügen.
Folgen Sie der CLI-Anleitung
Aus einer Befehlszeile direkt in das Verzeichnis Ihrer Capacitor-App, führen Sie:
npx @capgo/cli@latest init
Um die Capgo in Ihre Capacitor-App zu installieren, wird der CLI Ihnen durch den Prozess der Einrichtung Ihrer App mit Capgo führen.
Wenn Sie es manuell tun möchten, können Sie die folgenden Schritte befolgen.
Benutzerhandbuch Capgo Konfiguration
Installieren Sie das Plugin
Sie sollten mit diesem code in Ihrer App landen:
npm i @capgo/capacitor-updater && npx cap sync
Installieren Sie das Plugin in Ihrer Capacitor-App.
Und fügen Sie dann dieser code in 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ückgerollt):
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.
Melden Sie sich bei Capgo CLOUD an
Zunächst verwenden Sie den all apikey in Ihrem Konto, um sich mit dem CLI anzumelden:
npx @capgo/cli@latest login YOU_KEY
Fügen Sie Ihre erste App hinzu
Lassen Sie uns mit der Erstellung einer App in Capgo Cloud mit der CLI beginnen.
npx @capgo/cli@latest app add
Diese Kommandozeilenanweisung wird alle in der Capacitor Konfigurationsdatei definierten Variablen verwenden, um die App zu erstellen.
Hochladen Sie Ihre erste Version
Führen Sie den Befehl aus, um Ihre code zu erstellen und es an Capgo zu senden mit:
npx @capgo/cli@latest bundle upload
Der Standardname der Version wird der im Ihrer Datei enthaltene sein. package.json Überprüfen Sie in
__CAPGO_KEEP_0__ Capgo Sie können es sogar mit meinem
mobilen Sandbox-App testen Sie können es sogar mit meiner mobilen Sandbox-App testen.
Machen Sie den Kanal standardmäßig
Nachdem Sie Ihr App an Capgo gesendet haben, müssen Sie Ihren Kanal default machen, um Apps Updates von Capgo zu erhalten.
npx @capgo/cli@latest channel set production -s default
Live-Update auf einem Gerät empfangen
Um Ihre Anwendung Live-Updates von Deploy zu erhalten, müssen Sie die App auf einem Gerät oder einem Emulator ausführen. Der einfachste Weg, dies zu tun, besteht darin, 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 die Aktualisierung durchgeführt hat.
Glückwunsch! 🎉 Sie haben Ihre erste Live-Update erfolgreich deployt. 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.
Wenn Sie die lokale Empfangsaktualisierung beenden müssen, führen Sie diesen Befehl aus
npx @capgo/cli@latest channel set
