Wollen Sie mobile Apps mit einer einzigen Codebasis erstellen? Capacitor ermöglicht es Ihnen, iOS-, Android- und Web-Apps mit Frameworks wie React, Angular, oder VueDieses Handbuch erklärt, wie Sie einrichten Capacitor, Plattformen konfigurieren und Updates effizient bereitstellen.
Schritte zur Einstellung:
- Installieren von Tools: Node.js, npm, Git und ein code Editor wie VS Code.
- Einrichten von Capacitor: Installieren Sie die Capacitor CLI und initialisieren Sie Ihr Projekt.
- Konfigurieren von Plattformen: Add iOS and Android support, adjust settings, and sync your code.
- Testen und Bereitstellen: Erstellen, auf Geräten ausführen und verwenden Sie live update-Tools wie Capgo kontinuierlich aktualisieren.
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 zu NATIVER APP mit CAPACITOR | Ionic Release Guide

Benötigte Werkzeuge und Konfiguration
Hier erfahren Sie, wie Sie Ihre Entwicklungsumgebung mit den notwendigen Werkzeugen einrichten.
Entwicklungswerkzeuge installieren
Um mit Capacitor zu arbeiten, benötigen Sie folgende Werkzeuge:
| Werkzeug | Zweck | Mindestversion |
|---|---|---|
| Node.js | JavaScript runtime environment | 14.0.0 oder höher |
| npm | Paketmanager | 6.0.0 oder höher |
| IDE/Code-Editor | Entwicklungsumgebung | Letzte stabile Version |
| Git | Versionskontrolle | 2.0.0 oder höher |
Folgen Sie diesen Schritten, um sie zu installieren:
- Node.js und npm: Laden Sie 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: Hole es von git-scm.com.
- Plattform-spezifische Werkzeuge: Installiere Werkzeuge, die spezifisch für deine Plattform sind, wie Xcode zum Beispiel für macOS oder Android Studio zum Beispiel für Android-Entwicklung.
Sobald diese installiert sind, bist du bereit, zum Einrichten des Capacitor CLI fortzufahren.
Einrichtung der Capacitor CLI
Hole die Capacitor CLI in Betrieb, indem du diese Schritte befolgst:
-
Installiere die Capacitor CLI global
Öffnen Sie Ihr Terminal und führen Sie den folgenden Befehl aus:
npm install -g @capacitor/cli -
Initialisieren Sie den Capgo-Plugin
If you haven’t done this yet, run:
npx @capgo/cli initDies konfiguriert die notwendigen Einstellungen, um aktualisieren effektiv [1]Es vereinfacht den Prozess für die Erstellung, Testung und Bereitstellung Ihrer App.
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.
Erstellen Sie Ihr Projekt
To create a new Capacitor project, open your terminal and use this command:
npx @capacitor/cli create [projectDirectory] [appId] [appDisplayName]
Beispielweise
npx @capacitor/cli create my-cap-app com.example.app "My Capacitor App"
Hier ist die Bedeutung jeder Parameter.
- projectDirectory: Der Name Ihres Projektordners (z.B.
my-cap-app). - appId: Ein rückwärtsgeordneter Domänen-Bezeichner 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 im capacitor.config.json file.
Konfigurieren Sie capacitor.config.json
The capacitor.config.json Das 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:
{
"appId": "com.example.app",
"appName": "My Capacitor App",
"webDir": "dist",
"bundledWebRuntime": false,
"server": {
"hostname": "app.example.com",
"androidScheme": "https",
"iosScheme": "https"
}
}
Hier ist eine Übersicht der Schlüsseloptionen:
| Einstellung | Zweck | Beispielwert |
|---|---|---|
| Beispielwert | Eindeutiger Identifikator für Ihre App | com.example.app |
| appName | Die Anzeigename des Apps | My Capacitor App |
| webDir | Verzeichnis für Ausgabedateien | dist |
| bundledWebRuntime | Ob Sie die Capacitor-Laufzeit einbeziehen möchten | false |
| server.hostname | Hostname für den Entwicklungs-Server | app.example.com |
| server.androidScheme | URL-Schema für Android | https |
| server.iosScheme | URL-Schema für iOS | https |
Installieren von Abhängigkeiten
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 für die Plattform-spezifische Einrichtung und Entwicklung bereit.
Einstellungen für mobile Plattformen
Once your Capacitor project is initialized, the next step is to add and configure the iOS and Android platforms so your app can run natively on mobile devices.
Einstellungen für iOS und Android
Beginnen Sie mit der Hinzufügung von Plattformunterstützung mithilfe der folgenden Befehle:
npx cap add ios
npx cap add android
After adding the platforms, sync your web code with:
npx cap sync
Bevor Sie diese Befehle ausführen, stellen Sie sicher, dass Ihre Webanwendung erstellt ist und dass der 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.
Plattformspezifische 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 Ihren appId entspricht.
- Entwicklungsteam: Zuweisen Sie die entsprechende Team für code Signierung.
- Zielplattform: Legen Sie die Mindestversion für iOS fest.
- Geräteorientierung: Anpassen Sie wie erforderlich.
- Datenschutzzusammenfassungen: Fügen Sie erforderliche Beschreibungen in
Info.plist.
Android
Öffnen Sie das Android-Projekt mit:
npx cap open android
Dann aktualisieren Sie diese Einstellungen:
- PaketnameStellen Sie sicher, dass es mit Ihrer appId übereinstimmt.
- ZugriffsrechteDefinieren Sie notwendige Berechtigungen 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-Icons, Splash-Screens, tiefere Links und Zugriffsrechte:
| Konfiguration | iOS-Ortung | Android-Location |
|---|---|---|
| App-Icons | ios/App/App/Assets.xcassets |
android/app/src/main/res |
| Willkommensbilder | ios/App/App/Assets.xcassets |
android/app/src/main/res |
| Tiefenlinks | ios/App/App/Info.plist |
AndroidManifest.xml |
| Zugriffsrechte | Info.plist |
AndroidManifest.xml |
Mit diesen Einstellungen sind Sie bereit, Ihre App auf mobilen Geräten zu erstellen und zu testen.
Erstellung und Test
Mit der zuvor beschriebenen Konfiguration können Sie nun Ihr Projekt bauen und testen. Capacitor-App Erstellen und Ausführen von Befehlen
Befehle zum Bauen und Ausführen
Sobald Ihre App für mobile Plattformen konfiguriert ist, ist es Zeit, Ihre App zu bauen und Tests durchzuführen. Beginnen Sie mit der Aktualisierung Ihrer Web-Assets.
npm run build
npx cap sync
Nächsten, verwenden Sie die entsprechenden Befehle für Ihre Zielplattform:
Für Android:
npx cap run ios
Für Android:
npx cap run android
Diese Befehle bauen 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.
Hinzufügen von Capacitor-Plugins
Capacitor-Plugins ermöglichen Ihnen die Hinzufügung von nativen Funktionen zu Ihrer App. Zum Beispiel können Sie Kamera, Standort und Speicherkapazitäten mit folgendem Befehl hinzufügen:
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 der Anforderungen für die Einrichtung:
| Plugin | iOS-Konfiguration | Android-Konfiguration |
|---|---|---|
| Kamera | Hinzufügen Datenschutzbeschreibung | Zugriffsrechte zur Manifest hinzufügen |
| Ortung | Standortbeschreibung hinzufügen | Standortzugriffsrechte hinzufügen |
| Speicherung | Keine weitere Einstellung erforderlich | Keine weitere Einstellung erforderlich |
Live Updates mit Capgo

Um die Bereitstellung und den Test zu vereinfachen, können Sie live update-Tools wie Capgo integrieren. Diese Dienst hat bereits über 23,5 Millionen Updates geliefert, wobei 95 % der Nutzer innerhalb von 24 Stunden Updates erhalten und ein globales Erfolgsrate von 82 % erreicht haben [1].
Um Capgo in Ihre App hinzuzufügen:
npm install @capgo/capacitor-updater
npx cap sync
Capgo bietet mehrere Vorteile während der Testphase:
- Erstellen Sie separate Kanäle für die Entwicklung, Staging- und Produktionsumgebungen.
- Push immediate bug fixes during testing.
- Verfolgen Sie die Erfolgsraten von Updates mit integrierten Analysen.
- Rollen Sie Updates schnell zurück, wenn Probleme auftreten.
Capgo sichert auch eine sichere Update-Übermittlung 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 und alle notwendigen Schritte abgedeckt, um loszulegen und eine glatte Funktion zu gewährleisten.
Hauptschritte
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 sichert die reibungslose Funktion der App auf nativen Systemen.
Verwendung eines Updatesystems wie Capgo can simplify release management and help maintain app stability [1].
Hier ist eine Auflistung der wichtigsten Phasen:
| Phase | Schritte | Tipps |
|---|---|---|
| Initialisierung | Installieren Sie Werkzeuge, CLI einrichten | Benutzen Sie die neuesten stabilen Versionen |
| Einstellungen | Plattform-Einstellungen anpassen, Plugins hinzufügen | Plattform-spezifische Richtlinien befolgen |
| Testen | App auf Geräten erstellen und testen | Priorisieren Sie die Testung auf echten Geräten |
| Veröffentlichung | Updates verwalten, Versionskontrolle | Automatisierte Pipelines für Effizienz nutzen |
Fortsetzen von Capacitor App-Initialisierung: Schritt-für-Schritt-Anleitung
Wenn Sie __CAPGO_KEEP_0__ App-Initialisierung: Schritt-für-Schritt-Anleitung verwenden Capacitor App-Initialisierung: Schritt-für-Schritt-Anleitung um CI/CD-Automatisierung zu planen, verbinden Sie es mit Capgo CI/CD zur Produktworkflow in Capgo CI/CD, Capgo Native Builds zur Produktworkflow in Capgo Native Builds, Capgo Integrations zur Produktworkflow in Capgo Integrations, CI/CD-Integration zur Implementierungsdetail in CI/CD-Integration, und GitHub Aktionen-Integration zur Implementierungsdetail in GitHub Actions Integration.