Zum Hauptinhalt springen

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

Lernen Sie, wie Sie mobile Apps effizient einrichten und bereitstellen können, indem Sie Capacitor verwenden, wobei alles von der Installation bis hin zu plattform-spezifischen Konfigurationen abgedeckt wird.

Martin Donadieu

Martin Donadieu

Content-Marketing-Manager

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

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

CAPACITOR

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:

  1. Installieren Sie Capacitor CLI global

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

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

    Wenn Sie das noch nicht getan haben, führen Sie:

    npx @capgo/cli init

    Dies 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

Capgo Live-Update-Dashboard-Interface

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

Live-Updates für Capacitor-Apps

Wenn ein Web-Schicht-Bug live ist, versenden Sie den Fix über Capgo anstatt Tage für die Genehmigung des App-Store zu warten. Die Benutzer erhalten die Aktualisierung im Hintergrund, während native Änderungen im normalen Review-Prozess bleiben.

Los geht's jetzt

Neueste aus unserem Blog

Capgo bietet Ihnen die besten Einblicke, die Sie benötigen, um ein wirklich professionelles mobiles App zu erstellen.