Zum Hauptinhalt springen
Tutorial

Aktualisieren Sie Ihre Capacitor-Anwendungen problemlos mithilfe des Capacitor-Updater

Hallo Capacitor Ionic-Gemeinschaft, heute helfe ich Ihnen dabei, den Capacitor-Updater in Ihre App einzurichten. Damit können Sie Release ohne Probleme durchführen.

Martin Donadieu

Martin Donadieu

Content-Marketing-Spezialist

Aktualisieren Sie Ihre Capacitor-Anwendungen problemlos mithilfe des Capacitor-Updater

Was ist der Capacitor-Updater?

Der Capacitor-Updater ist eine Technologie, die dabei hilft, Updates und Verbesserungen für die Endnutzer sofort bereitzustellen.

Dies 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 vorstellen, 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 Semantic Versioning mit __CAPGO_KEEP_0__.

Capgo verwendet die semantische Versionsnummerierung (semver), um zu bestimmen, wann und wie Updates auf Ihr App-Programm angewendet werden sollten. Dies stellt sicher, dass Ihre Benutzer nur kompatible Updates erhalten und verhindert, dass automatisch neue Funktionen bereitgestellt werden.

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
  • 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 würde eine Aktualisierung von 1.0.0 auf 2.0.0 (eine Hauptversion) einen native App-Store-Release erfordern, da dies aufgrund von Änderungen, die die Kompatibilität beeinträchtigen, erfolgen muss.

Capgo’s Kanal-Einstellungen ermöglichen es Ihnen, die Arten von Aktualisierungen zu konfigurieren, die automatisch angewendet werden:

  • Majors-Strategie: Erlaubt alle Aktualisierungen (mit Vorsicht verwenden)
  • Mins-Strategie: Erstellt nur Minor- und Patch-Updates
  • Patch-Strategie: Erstellt nur Patch-Updates
  • Metadaten-Strategie: Erfordert, dass die Mindestversionserfordernisse erfüllt werden

Sie können mit der Capgo-Update-Logik verschiedene Versionenkombinationen testen, indem Sie unser Semver-Tester-Tool verwenden. 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-Updatesnur mit Web-Bundles funktionieren. Sie denken vielleicht, dass dies nicht wirklich eine große Einschränkung ist, weil wir in Capacitor JS fast alle code in JS, CSS und HTML schreiben. Während dies möglicherweise wahr ist, gibt es immer noch native Module, die wir in unsere App installieren. Wenn ein Modul Ihre Android- oder iOS-Ordner ändert, können Sie OTA nicht verwenden, um Ihre App zu aktualisieren. Das liegt daran, dass die Inhalte dieser Ordner zum Kompilieren von Native-Binären verwendet werden, was OTA nicht aktualisieren kann. Selbst native Apps können diese Teile nicht aktualisieren.

But Sie können Ihre CI/CD einrichten, um diese Aufgabe zu erledigen, ich habe ein Tutorial erstellt, wie Sie es machen können 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.

Once you’re logged into Capgo, You will have an onboarding page

Onboarding-Seite

Folgen Sie den Schritten auf der Onboarding-Seite, um Ihre erste App hinzuzufügen.

Folgen Sie der CLI-Anleitung

Von einer Befehlszeile direkt in das Verzeichnis Ihrer Capacitor-App, führen Sie Folgendes aus:

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 machen möchten, können Sie die folgenden Schritte befolgen.

Handbuch Capgo Konfiguration

Installieren Sie das Plugin

Sie sollten sich mit diesem code in Ihrer App befinden:

npm i @capgo/capacitor-updater && npx cap sync Um das Plugin in Ihrer Capacitor-App zu installieren.

Und fügen Sie dann dieser code in Ihrer App hinzu, um dem 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()

Das 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

Hinzufügen Sie Ihre erste App

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 package.json Datei sein.

Überprüfen Sie in Capgo ob die Veröffentlichung erfolgreich war.

Sie können es sogar mit meinem mobilen Sandbox-App testen.

Machen Sie den Kanal standardmäßig

Nachdem Sie Ihr App an Capgo gesendet haben, müssen Sie Ihren Kanal anpassen, um Apps Updates von Capgo zu erhalten. default Um Apps Updates von Capgo zu erhalten, müssen Sie Ihren Kanal anpassen.

npx @capgo/cli@latest channel set production -s default

Empfangen Sie eine Live-Update auf einem Gerät

Damit Ihre Anwendung Live-Updates von Deploy empfangen kann, 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 den Update durchgeführt hat.

Glückwunsch! 🎉 Sie haben erfolgreich Ihre erste Live-Update veröffentlicht. 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 aufhören möchten, Updates lokal zu empfangen, führen Sie diesen Befehl aus npx @capgo/cli@latest channel set

Fortsetzen Sie, Ihre Capacitor-Apps ohne Unterbrechung mit Capacitor-Updater zu aktualisieren

Wenn Sie Aktualisieren Sie Ihre Capacitor-Apps ohne Unterbrechung mit Capacitor-Updater für die Planung der Migration und Unternehmensoperationen, verbinden Sie es mit Capgo Enterprise für den Produktworkflow in Capgo Enterprise Ionic Enterprise Plugin Alternativen für den Produktworkflow in Ionic Enterprise Plugin Alternativen Capgo Alternativen für den Produktworkflow in Capgo Alternativen Capgo Consulting für den Produktworkflow in Capgo Consulting und Capgo Premium Support für den Produktworkflow in Capgo Premium Support

Live-Updates für Capacitor-Apps

Wenn ein Web-Schicht-Bug aktiv ist, liefern Sie den Fix über Capgo anstatt Tage zu warten, bis die App-Store-Zulassung vorliegt. Die Benutzer erhalten die Aktualisierung im Hintergrund, während native Änderungen im normalen Review-Prozess bleiben.

Los geht's

Neuestes aus unserem Blog

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