Zum Hauptinhalt springen

Capacitor App-Initialisierung: Schritt-für-Schritt-Anleitung

Lernen Sie, wie Sie effizient mobile Apps einrichten und bereitstellen können, indem Sie Capacitor nutzen, von der Installation bis hin zu plattform-spezifischen Einstellungen.

Capacitor App-Initialisierung: Schritt-für-Schritt-Anleitung

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

CAPACITOR

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:

  1. Installiere die Capacitor CLI global

    Öffnen Sie Ihr Terminal und führen Sie den folgenden Befehl aus:

    npm install -g @capacitor/cli
  2. Initialisieren Sie den Capgo-Plugin

    If you haven’t done this yet, run:

    npx @capgo/cli init

    Dies 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

Capgo Live Update Dashboard-Interface

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.

Live-Updates für Capacitor-Apps

When a web-layer bug is live, ship the fix through Capgo instead of waiting days for app store approval. Users get the update in the background while native changes stay in the normal review path.

Menschliche Unterstützung von Martin

Capgo gives you the best insights you need to create a truly professional mobile app.