Möchten Sie mobile Apps mit einem einzigen Codebase erstellen? Capacitor macht es leicht, iOS-, Android- und Web-Apps mit Frameworks wie React, Angular, oder Vue. Diese Anleitung erklärt, wie Sie Capacitor, Plattformen einrichten, und Updates effizient bereitstellen.
Schritte, um loszulegen:
- Installieren Sie Werkzeuge: Node.js, npm, Git und einen code-Editor wie VS Code.
- Einstellung von Capacitor: Installieren Sie die Capacitor CLI und initialisieren Sie Ihr Projekt.
- Konfigurieren von Plattformen: Fügen Sie iOS- und Android-Unterstützung hinzu, passen Sie Einstellungen an und synchronisieren Sie Ihr code.
- Testen und Bereitstellen: Erstellen Sie, fahren Sie auf Geräten und verwenden Sie Live-Update-Tools wie Capgo für reibungslose Updates.
Capacitor verbindet Web-Anwendungen mit nativen Gerätefunktionen, um eine glatte Leistung über Plattformen sicherzustellen. Folgen Sie dieser Anleitung, um Ihren Entwicklungsprozess zu vereinfachen!
5 Schritte zum NATIVEN APP mit CAPACITOR | Ionic Release Guide

Erforderliche Werkzeuge und Konfiguration
Hier erfahren Sie, wie Sie Ihre Entwicklungsumgebung mit den notwendigen Werkzeugen einrichten.
Installation von Entwicklungswerkzeugen
Um mit Capacitor zu arbeiten, benötigen Sie folgende Werkzeuge:
| Werkzeug | Zweck | Mindestversion |
|---|---|---|
| Node.js | JavaScript- Laufzeitumgebung | 14.0.0 oder höher |
| npm | Paketmanager | 6.0.0 oder höher |
| IDE/Code-Editor | Entwicklungsumgebung | Letzte stabile Version |
| Git | Versionkontrolle | 2.0.0 oder höher |
Folgen Sie diesen Schritten, um sie zu installieren:
- Node.js und npm: Herunterladen und installieren Sie beide von der offiziellen Node.js Website.
- Code Editor: Wählen Sie einen Editor wie VS Code WebStorm, oder Sublime Text und installieren Sie die neueste stabile Version.
- Git: Holen Sie es von git-scm.com.
- Plattform-spezifische Tools: Install die für Ihre Plattform spezifischen Werkzeuge, wie Xcode für macOS oder Android Studio für die Android-Entwicklung.
Einmal diese installiert sind, sind Sie bereit, sich auf die Einrichtung der Capacitor CLI zu konzentrieren.
Capacitor CLI Einrichtung
Richten Sie die Capacitor CLI mit diesen Schritten auf:
-
Installieren Sie Capacitor CLI global
Öffnen Sie Ihr Terminal und führen Sie den folgenden Befehl aus:
npm install -g @capacitor/cli -
Initialisieren Sie das Capgo-Plugin
Wenn Sie das noch nicht getan haben, führen Sie:
npx @capgo/cli initDies wird die notwendigen Einstellungen konfigurieren, um Updates effektiv zu verwalten . Es vereinfacht den Prozess für das Erstellen, Testen und Bereitstellen Ihrer App. [1]Ein neues Projekt starten
Starting a New Capacitor Project
Once you’ve installed the necessary tools, you’re ready to set up your first Capacitor project. Here’s how to get started.
Um ein neues Projekt zu erstellen, öffnen Sie Ihr Terminal und verwenden Sie diesen Befehl:
To create a new Capacitor project, open your terminal and use this command:
npx @capacitor/cli create [projectDirectory] [appId] [appDisplayName]
Hier ist, was jeder Parameter bedeutet:
npx @capacitor/cli create my-cap-app com.example.app "My Capacitor App"
projectDirectory
- : Der Name Ihres Projektordners (z.B.__CAPGO_KEEP_0__
my-cap-app). - appId: Eine umgekehrte Domänen-Identifikator für Ihre App (z.B.
com.example.app). - appDisplayName: Der Name, der für Ihre App angezeigt wird (z.B.
My Capacitor App).
Nachdem Sie diesen Befehl ausgeführt haben, müssen Sie Ihre Projekt-Einstellungen in der capacitor.config.json datei anpassen.
Configuring capacitor.config.json
Konfigurieren Sie __CAPGO_KEEP_0__.config.json capacitor.config.json Die
{
"appId": "com.example.app",
"appName": "My Capacitor App",
"webDir": "dist",
"bundledWebRuntime": false,
"server": {
"hostname": "app.example.com",
"androidScheme": "https",
"iosScheme": "https"
}
}
datei ist der Ort, an dem Sie die Schlüssel-Einstellungen für Ihr Projekt definieren. Hier ist ein Beispiel für eine grundlegende Konfiguration:
| Hier ist eine Auflistung der wichtigsten Optionen: | Einstellung (Setting) und Zweck (Purpose) | Beispielwert |
|---|---|---|
| __CAPGO_KEEP_0__ | Eindeutige Kennung für Ihre App | com.example.app |
| Anzeigename der App | Der Anzeigename der App | My Capacitor App |
| Verzeichnis für Ausgabedateien | Ob das __CAPGO_KEEP_0__-Laufzeitumgebung eingeschlossen werden soll | dist |
| Hostname für den Entwicklungs-Server | Whether to include Capacitor runtime | false |
| __CAPGO_KEEP_0__ | __CAPGO_KEEP_0__ | app.example.com |
| __CAPGO_KEEP_0__ | URL-Schema für Android | https |
| __CAPGO_KEEP_0__-iOS-Schema | URL-Schema für iOS | https |
Abhängigkeiten installieren
Um die Einrichtung abzuschließen, installieren Sie die erforderlichen Abhängigkeiten und initialisieren Sie Ihr Projekt mit diesen Befehlen:
npm install @capacitor/core
npm install @capacitor/cli --save-dev
npx cap init
Mit diesen Schritten ist Ihr Projekt bereit für die Plattform-spezifische Einrichtung und Entwicklung.
Einrichtung von Mobilplattformen
Nachdem Ihr Capacitor-Projekt initialisiert ist, ist der nächste Schritt die Hinzufügung und Konfiguration der iOS- und Android-Plattformen, damit Ihre App nativ auf Mobilgeräten ausgeführt werden kann.
iOS- und Android-Einrichtung
Beginnen Sie mit der Hinzufügung von Plattformunterstützung mit folgenden Befehlen:
npx cap add ios
npx cap add android
Nachdem die Plattformen hinzugefügt wurden, synchronisieren Sie Ihr Web code mit:
npx cap sync
Bevor Sie diese Befehle ausführen, stellen Sie sicher, dass Ihre Webanwendung erstellt ist und dass die webDir in capacitor.config.json ist korrekt eingestellt. Sobald das erledigt ist, passen Sie die Einstellungen jeder Plattform an, um sie Ihren Anwendungsbedürfnissen anzupassen.
Plattform-Spezifische Einstellungen
iOS
Öffnen Sie das iOS-Projekt mit:
npx cap open ios
Dann konfigurieren Sie die folgenden Einstellungen:
- Bundle-Identifier: Stellen Sie sicher, dass es mit Ihrem appId übereinstimmt.
- Entwicklungsteam: Zuweisen Sie das entsprechende Team für code-Signierung.
- Zielgruppe für die Bereitstellung: Legen Sie die Mindestversion von iOS fest.
- Geräteorientierung: Anpassen Sie wie nötig.
- Datenschutzbeschreibungen: Fügen Sie erforderliche Beschreibungen in
Info.plist.
Android
Öffnen Sie das Android-Projekt mit:
npx cap open android
Dann aktualisieren Sie diese Einstellungen:
- Paketname: Stellen Sie sicher, dass es mit Ihrer appId übereinstimmt.
- Zugriffsrechte: Definieren Sie notwendige Zugriffsrechte in
AndroidManifest.xml. - Bildschirmorientierung: Konfigurieren Sie dies in
AndroidManifest.xml. - Ziel SDK: Legen Sie die entsprechende Version in
android/app/build.gradle.
Asset- und Konfigurationsorte
Hier finden Sie die Schlüsseldateien für App-Ikons, Splash-Screens, tiefe Links und Berechtigungen:
| Konfiguration | iOS-Ort | Android-Ort |
|---|---|---|
| App-Ikons | ios/App/App/Assets.xcassets |
android/app/src/main/res |
| Splash-Screens | ios/App/App/Assets.xcassets |
android/app/src/main/res |
| Tiefe Links | ios/App/App/Info.plist |
AndroidManifest.xml |
| Berechtigungen | Info.plist |
AndroidManifest.xml |
Mit diesen Konfigurationen sind Sie bereit, Ihre App auf Mobilgeräten zu erstellen und zu testen.
Erstellung und Test
Mit der im Voraus beschriebenen Konfiguration können Sie Ihre App jetzt erstellen und testen, um sicherzustellen, dass sie auf verschiedenen Geräten korrekt funktioniert. Capacitor-Anwendung Befehle zum Erstellen und Ausführen
Bauen Sie Ihre App für mobile Plattformen konfiguriert, ist es Zeit, Tests zu erstellen und auszuführen. Beginnen Sie damit, Ihre Web-Assets zu aktualisieren:
Nutzen Sie dann die entsprechenden Befehle für Ihre Zielplattform:
npm run build
npx cap sync
Für iOS:
Für Android:
npx cap run ios
Diese Befehle erstellen und starten Ihre App auf einem Simulator oder einem verbundenen Gerät. Die Testung auf beiden realen Geräten und Simulatoren ist entscheidend, um Plattform-spezifische Probleme zu identifizieren.
npx cap run android
Hinzufügen von __CAPGO_KEEP_0__-Plugins
Adding Capacitor Plugins
Capacitor Plugins erlauben Ihnen, native Funktionen zu Ihrem App hinzuzufügen. Zum Beispiel, um die Kamera, die Standortbestimmung und die Speicherkapazitäten einzubeziehen, führen Sie Folgendes aus:
npm install @capacitor/camera @capacitor/geolocation @capacitor/storage
npx cap sync
Nach der Installation konfigurieren Sie die Plugins in Ihren native Projekten. Hier ist eine kurze Übersicht über die Anforderungen für die Einrichtung:
| Plugin | iOS-Konfiguration | Android-Konfiguration |
|---|---|---|
| Kamera | Hinzufügen Datenschutzbeschreibung | Zugriffsrechte zur Manifest hinzufügen |
| Standortbestimmung | Standortnutzungsbeschreibung hinzufügen | Füge Standortberechtigungen hinzu |
| Speicher | Keine weitere Einrichtung erforderlich | Keine weitere Einrichtung erforderlich |
Live-Updates mit Capgo

Um die Bereitstellung und Testung zu vereinfachen, können Sie Live-Update-Tools wie Capgo integrieren. Diese Dienst hat bereits über 23,5 Millionen Updates geliefert, wobei 95 % der Benutzer innerhalb von 24 Stunden Updates erhalten und ein globales Erfolgsrate von 82 % erreicht haben [1].
Um Capgo zu Ihrem App hinzuzufügen:
npm install @capgo/capacitor-updater
npx cap sync
Capgo bietet mehrere Vorteile während der Testphase:
- Erstelle separate Kanäle für die Entwicklung, Staging- und Produktionsumgebungen.
- Drücke sofortige Fehlerbehebungen während der Testphase.
- Erfolgssätze bei Updates mit integrierter Analytik verfolgen.
- Updates schnell rückgängig machen, wenn Probleme auftreten.
Capgo sichert auch sicherere Update-Lieferungen mit Ende-zu-Ende-Verschlüsselung. Sein Kanal-System ermöglicht Ihnen, Updates mit ausgewählten Benutzergruppen zu testen, bevor Sie sie allen zugänglich machen.
Zusammenfassung
Diese Anleitung hat alle Phasen der Einrichtung und Bereitstellung einer Capacitor-Anwendung durchgegangen, alle wesentlichen Schritte abgedeckt, um loszulegen und eine glatte Funktion zu gewährleisten.
Hauptpunkte
Die Erstellung einer Capacitor-Anwendung erfordert sorgfältige Aufmerksamkeit bei der Einrichtung, Konfiguration und plattformspezifischen Anpassungen. Die Einrichtung Ihres Entwicklungsumgebungen - einschließlich Werkzeuge wie Node.js und dem Capacitor CLI - ist ein entscheidender Ausgangspunkt. Die Konfiguration von Plattformen wie iOS und Android stellt sicher, dass die Anwendung reibungslos auf nativen Systemen läuft.
Mit einem Update-System wie Capgo Kann die Verwaltung von Releases vereinfachen und dabei die Stabilität der App aufrechterhalten [1].
Hier ist eine detaillierte Auflistung der wichtigsten Phasen:
| Phase | Schritte | Tipps |
|---|---|---|
| Initialisierung | Installieren Sie Werkzeuge, CLI einrichten | Verwenden Sie die neuesten stabilen Versionen |
| Konfiguration | Anpassen Sie die Plattform-Einstellungen, fügen Sie Plugins hinzu | Beachten Sie die spezifischen Richtlinien der Plattform |
| Testen | Auf Geräten bauen und testen | Priorisieren Sie das Testen auf echten Geräten |
| Durchführung | Aktualisierungen verwalten, Versionskontrolle | Verwenden Sie automatisierte Pipelines für Effizienz |
Fahren Sie mit der Anleitung "Schritt-für-Schritt-Anleitung zur App-Initialisierung: Capacitor" fort
Wenn Sie "Schritt-für-Schritt-Anleitung zur App-Initialisierung: __CAPGO_KEEP_0__" verwenden Capacitor App Initialization: Step-by-Step Guide Cloudflare Capgo CI/CD for the product workflow in Capgo CI/CD, Capgo Native Builds für den Produktworkflow in Capgo Native Builds Capgo Integrations für den Produktworkflow in Capgo Integrations CI/CD-Integration für die Implementierungsdetails in CI/CD-Integration und GitHub Actions-Integration für die Implementierungsdetails in GitHub Actions-Integration