Was ist Capacitor-updater?
Capacitor-updater, eine Technologie, die App-Updates und Verbesserungen sofort an die Endnutzer ausliefert.
Das ist besonders praktisch, wenn du kritische Bugfixes sofort ausliefern möchtest, ohne den Review-Prozess im App Store durchlaufen zu müssen.
Sie können es sich als „web-ähnliche“ Agilität beim Sideloading von Updates vorstellen, sobald diese verfügbar sind.
Zudem bietet es Rollbacks, falls das neue Update die App zum Absturz bringt
Wie funktioniert das?
Capgo hält das JavaScript-Bundle deiner App synchron mit dem Capgo-Server. Jedes Mal, wenn ein Nutzer die App öffnet, wird beim Capgo-Server geprüft, ob ein neues Update für das Bundle verfügbar ist. Und natürlich gibt es jede Menge starke Konfigurationen, mit denen du das Nutzererlebnis fein abstimmen kannst.
Ich nutze Capgo in all meinen Projekten. Das spart mir wertvolle Zeit beim App Store Review-Prozess.
Hier erfährst du mehr darüber hier.
Semantic Versioning mit Capgo verstehen
Capgo nutzt Semantic Versioning (semver), um zu bestimmen, wann und wie Updates auf deine App angewendet werden. So erhalten deine Nutzer nur kompatible Updates und du verhinderst, dass Breaking Changes automatisch deployed werden.
Semantic Versioning folgt diesem Format MAJOR.MINOR.PATCH:
- MAJOR: Breaking Changes, die ein natives App Store Release erfordern
- MINOR: Neue Funktionen, die abwärtskompatibel sind
- PATCH: Bugfixes, die abwärtskompatibel sind
Zum Beispiel, wenn Ihre App in der Version 1.0.0 und Sie möchten auf 1.0.1 (ein Patch) aktualisieren möchten, wendet Capgo dieses Update automatisch an. Wenn Sie jedoch von 1.0.0 zu 2.0.0 (eine Major-Version), erfordert dies eine native App-Store-Veröffentlichung, da auf breaking changes hingewiesen wird.
Die Channel-Einstellungen von Capgo ermöglichen es, welche Arten von Updates automatisch angewendet werden:
- Major-Strategie: Erlaubt alle Updates (mit Vorsicht verwenden)
- Minor-Strategie: Erlaubt nur Minor- und Patch-Updates
- Patch-Strategie: Erlaubt nur Patch-Updates
- Metadaten-Strategie: Erfordert das Erfüllen von Mindestversionsanforderungen
Du kannst testen, wie verschiedene Versionskombinationen mit der Update-Logik von Capgo funktionieren – mit unserem Semver Tester. Dieses Tool hilft dir genau zu verstehen, wann Updates basierend auf deiner Channel-Konfiguration angewendet werden.
Gibt es Einschränkungen?
So gut es auch klingen mag, gibt es ein paar Dinge zu beachten. Das Erste ist, dass OTA-Updates nur mit Web-Bundles funktionieren. Du denkst vielleicht, dass das keine große Einschränkung ist, da wir in Capacitor JS fast alle code in JS, CSS und HTML schreiben. Das mag stimmen, aber es gibt immer noch native Module, die wir in unsere App installieren. Wenn ein Modul deine Android- oder iOS-Verzeichnisse ändert, kannst du deine App nicht per OTA aktualisieren. Das liegt daran, dass der Inhalt dieser Verzeichnisse zum Kompilieren von Native Binaries verwendet wird, die OTA nicht aktualisieren kann. Selbst eine native App kann diesen Teil nicht aktualisieren.
Aber du kannst deine CI/CD so einrichten, dass sie diesen Teil übernimmt. Ich habe ein Tutorial dazu erstellt. hier für iOS.
Automatische Capgo-Konfiguration
Melde dich an und hol dir deinen API Key, um deine erste Version hochzuladen! Starte hier: dich für einen Capgo-Account zu registrieren.
Sobald du bei Capgo angemeldet bist, siehst du eine Onboarding-Seite.
Folgen Sie den Schritten auf der Onboarding-Seite, um Ihre erste App hinzuzufügen.
Folgen Sie den Anweisungen von CLI
Führe in der Kommandozeile direkt im Root-Verzeichnis deiner Capacitor App aus:
npx @capgo/cli@latest init
Um das Capgo in Ihre Capacitor-App zu installieren, führt Sie das CLI durch den Prozess der Einrichtung Ihrer App mit Capgo.
Wenn Sie es manuell erledigen möchten, können Sie die folgenden Schritte befolgen.
Manuelle Capgo-Konfiguration
Plugin installieren
Am Ende sollte dieser code in Ihrer App hinzugefügt sein:
npm i @capgo/capacitor-updater && npx cap sync
Um das Plugin in deine Capacitor App zu installieren.
Fügen Sie dann diesen code zu Ihrer App hinzu, um das Native-Plugin zu benachrichtigen, dass das JS-Bundle gesund ist (wenn Sie dies nicht tun, rollt das Native-Plugin auf die vorherige Version zurück):
import { CapacitorUpdater } from '@capgo/capacitor-updater'
CapacitorUpdater.notifyAppReady()Dies teilt dem Native Plugin mit, dass die Installation erfolgreich war.
Dann führe eine npm run build && npx cap copy aus, um deine App zu aktualisieren.
Login bei Capgo CLOUD
Zuerst verwendest du all API-Key in Ihrem Konto vorhanden, um sich mit CLI anzumelden:
npx @capgo/cli@latest login YOU_KEY
Erste App hinzufügen
Los geht's: Erstelle zuerst eine App in der Capgo Cloud mit dem CLI.
npx @capgo/cli@latest app add
Dieser Befehl nutzt alle in der Capacitor Config-Datei definierten Variablen, um die App zu erstellen.
Erste Version hochladen
Führe folgenden Befehl aus, um dein code zu builden und es an Capgo zu senden:
npx @capgo/cli@latest bundle upload
Standardmäßig entspricht der Versionsname dem in deiner package.json Datei.
Check-in Capgo falls der Build vorhanden ist.
Du kannst es sogar mit meiner Mobile Sandbox-App.
Channel als Standard festlegen
Nachdem du deine App an Capgo gesendet hast, musst du deinen Channel default damit Apps Updates von Capgo erhalten.
npx @capgo/cli@latest channel set production -s default
Live Update auf einem Gerät empfangen
Damit deine App ein live update von Deploy erhält, musst du sie auf einem Gerät oder Emulator ausführen. Am einfachsten geht das mit dem folgenden Befehl, um deine lokale App in einem Emulator oder auf einem mit deinem Computer verbundenen Gerät zu starten.
npx cap run [ios | android]Öffne die App, schicke sie in den Hintergrund und öffne sie erneut; in den Logs solltest du sehen, dass die App das Update ausgeführt hat.
Glückwunsch! 🎉 Du hast dein erstes Live Update erfolgreich bereitgestellt. Das ist erst der Anfang von dem, was du mit Live Updates machen kannst. Um mehr zu erfahren, lies die vollständige Live Updates-Dokumentation.
Wenn du den Empfang des Updates lokal stoppen willst, führe diesen Befehl aus:
npx @capgo/cli@latest channel set
Weiterlesen: Deine Capacitor Apps nahtlos mit Capacitor-updater updaten
Wenn du es nutzt Aktualisiere deine Capacitor-Apps nahtlos mit Capacitor-updater um Migration und Enterprise-Betrieb zu planen, verbinde es mit Capgo Enterprise für den Produkt-Workflow in Capgo Enterprise, Ionic Enterprise Plugin-Alternativen für den Produkt-Workflow in Ionic Enterprise Plugin-Alternativen, Capgo Alternativen für den Produkt-Workflow in Capgo Alternativen, Capgo Beratung für den Produkt-Workflow in Capgo Consulting und Capgo Premium-Support für den Produkt-Workflow in Capgo Premium Support.
