Migrieren einer Web-App mit Cordova zu Capacitor: Ein Schritt-für-Schritt-Leitfaden
Dieses Leitfaden wird Ihnen helfen, Ihre Web-App von Cordova zu Capacitor zu migrieren, wodurch es einfacher wird, ihn zu lesen und zu folgen. Wir werden alle Abschnitte abdecken und einen Schritt-für-Schritt-Ansatz bereitstellen.
Einführung in Cordova und Capacitor
Cordova und Capacitor sind beide Werkzeuge, mit denen Webentwickler native Anwendungen für verschiedene Plattformen mit HTML, CSS und JavaScript erstellen können. Obwohl sie Ähnlichkeiten aufweisen, gibt es wesentliche Unterschiede in ihrer Herangehensweise an native Projektverwaltung, Pluginverwaltung und CLI/Versionsverwaltung.
Migration Strategie
Die Migration von Cordova zu Capacitor kann schrittweise oder als vollständige Ersetzung erfolgen, je nach Komplexität Ihrer App. Capacitor ist rückwärtskompatibel zu Cordova, sodass Sie Ihre bestehenden Web-Apps jederzeit auf Capacitor umstellen können.
Um die Migration zu erleichtern, sollten Sie die Verwendung des Ionic VS Code-Erweiterung und die Überprüfung Ihrer bestehenden Cordova-Plugins in Betracht ziehen. Sie können weiterhin Cordova-Plugins verwenden, wenn nötig, oder sie durch Capacitor-Äquivalente ersetzen.
Schritt-für-Schritt-Migrationshandbuch
Folgen Sie diesen Schritten, um Ihre Web-App von Cordova zu Capacitor zu migrieren:
-
Arbeiten Sie in einer separaten code-Zweig: Es wird empfohlen, in einer separaten code-Zweig zu arbeiten, wenn diese Änderungen anwenden.
-
Initialisieren Sie Ihre App mit Capacitor: Öffnen Sie Ihr Projekt im Terminal und folgen Sie den Anleitungen für die Hinzufügung von Capacitor zu einer Web-App oder Capacitor zu einem Ionic-App hinzufügen Verwenden Sie die Informationen aus Ihrem Cordova-
config.xmlDatei für den App-Namen und Bundle-ID. -
Ihre Web-App erstellen: Erstellen Sie Ihre Web-Projekt mindestens einmal, bevor Sie native Plattformen hinzufügen. Dies stellt sicher, dass der
wwwOrdner ordnungsgemäß in der Capacitor-Konfigurationsdatei konfiguriert ist. -
Plattformen hinzufügen: Ausführen
npx cap add iosundnpx cap add androidum die iOS- und Android-Plattformen hinzuzufügen. Diese werden separate native Projekt-Ordner am Root Ihres Projekts erstellen. -
Icons und Splash-Screens generieren: Wenn Sie bereits vorhandene Icon- und Splash-Screen-Bilder haben, verwenden Sie das Werkzeug, um sie zu generieren und in die native Projekte einzufügen.
cordova-resAudit and migrate existing Cordova plugins -
: Überprüfen Sie Ihre bereits vorhandenen Cordova-Plugins und ersetzen Sie sie durch __CAPGO_KEEP_0__-Äquivalente, wenn möglich. Entfernen Sie alle unnötigen Plugins.: Review your existing Cordova plugins and replace them with Capacitor equivalents if possible. Remove any unnecessary plugins.
-
: Nachdem Sie ein Cordova-Plugin ersetzt oder entfernt haben, deinstallieren Sie das Plugin und führen Sieto remove the plugin __CAPGO_KEEP_0__ from the native project.
npx cap syncto remove the plugin code from the native project. -
: Mappen Sie zwischenund erforderlichen Einstellungen auf iOS und Android, um alle notwendigen Berechtigungen anzuwenden.
plugin.xmlConfigure preferences -
: Fügen Sie manuell Vorlieben vonhinzugefügt.
config.xmlzum Capacitor Konfigurationsdatei. -
Plattform-spezifische Konfigurationen anpassen: Konfigurieren Sie Elemente von
config.xmlfür jede Plattform (iOS und Android) anpassen, wie erforderlich. -
Ändern Sie den Scheme für die Inhaltslieferung: Ändern Sie den Scheme, der für die Inhaltslieferung in Ihrer App verwendet wird, wenn nötig, um Datenverlust zu vermeiden.
-
Testen und Cordova entfernen: Testen Sie Ihre migrierte App, um sicherzustellen, dass alle Änderungen korrekt angewendet wurden. Sobald Sie zufrieden sind, können Sie Cordova aus Ihrem Projekt entfernen oder es lassen, wenn Sie beabsichtigen, weiterhin Cordova-Plugins zu verwenden.
Herzlichen Glückwunsch! Sie haben Ihre Web-App erfolgreich von Cordova zu Capacitor migriert. Um mehr über die Verwendung von Cordova-Plugins in einem Capacitor-Projekt oder dem Capacitor-Entwicklungsworkflow zu erfahren, besuchen Sie die offizielle Capacitor-Dokumentation.
Live-Updates mit unserem Capgo-Dienst
Wir freuen uns, Capgo anbieten zu können, unsere Lösung, die Live-Updates für Ihre Capacitor-Apps ermöglicht, sodass Sie Over-The-Air (OTA)-Updates zu einem fairen Preis bereitstellen können. Diese Funktion ist besonders nützlich für schnelle Reparaturen, die Bereitstellung neuer Funktionen und die Gewährleistung, dass Ihre Benutzer immer die neueste Version Ihrer App haben, ohne auf die Genehmigung durch den App-Store warten zu müssen.
Wie unser Capgo-Dienst funktioniert
Capgo ist ein cloudbasierter Dienst, der Ihnen ermöglicht, live-Updates für Ihre Capacitor-Anwendungen bereitzustellen. Er besteht aus einem Web-Dashboard und einer nativen SDK-Implementierung, die Sie in Ihre App integrieren können. Die SDK überprüft Updates bei der Startzeit oder zu bestimmten Zeitpunkten und lädt sie im Hintergrund herunter. Wenn ein Update verfügbar ist, wird die SDK den Benutzer auffordern, es zu installieren. Wenn der Benutzer zustimmt, wird das Update sofort installiert und angewendet.
Vorteile von Capgo-Live-Updates
- Schnellere Updates: Deploy Updates sofort ohne auf die Genehmigung des App-Store zu warten.
- Geringere Abhängigkeit vom Apple-Store: Bypassen Sie die Einschränkungen und Beschränkungen des App-Stores.
- Verbesserte Benutzererfahrung: Bleiben Sie die Benutzer mit den neuesten Funktionen und Bugfixes ohne dass sie die App manuell aktualisieren müssen.
Wie Capgo-Live-Updates in Ihrer __CAPGO_KEEP_1__-Projekt umzusetzen
Um Capgo-Live-Updates in Ihrem Capacitor-Projekt umzusetzen, folgen Sie diesen Schritten:
- Registrieren Sie sich für ein __CAPGO_KEEP_0__-Konto Capgo Konto.
- Installieren Sie das Capgo SDK in Ihrem Projekt.
- Konfigurieren Sie Ihre App, um auf Start oder auf bestimmten Intervallen nach Updates zu suchen.
- Deployen Sie Updates für Ihre App mithilfe der Capgo-Oberfläche.
Zusammenfassung
Wir hoffen, dass diese Anleitung Ihnen geholfen hat, Ihre Web-App von Cordova zu Capacitor zu migrieren. Wenn Sie Fragen haben oder bei der Migration benötigen, zögern Sie nicht, uns auf unserem Discord-Server zu kontaktieren. Von