Zum Hauptinhalt springen

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

Erhalten Sie Informationen, wie Sie mobile Apps effizient einrichten und bereitstellen können, indem Sie Capacitor verwenden, von der Installation bis hin zu plattform-spezifischen Konfigurationen.

Martin Donadieu

Martin Donadieu

Inhaltsmarketer

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

Möchten Sie mit einer einzigen Codebasis mobile Apps entwickeln? Capacitor ermöglicht es Ihnen, leicht iOS-, Android- und Web-Apps mit Frameworks wie React, Angular, oder Vue zu erstellen. Diese Anleitung erklärt, wie Sie die Einrichtung von Capacitor, die Plattformkonfiguration und die effiziente Bereitstellung von Updates durchführen können.

Schritte zum Starten:

  • Tools installieren: Node.js, npm, Git und ein code-Editor wie VS Code.
  • Einrichtung von Capacitor: Installieren Sie das Capacitor- CLI und initialisieren Sie Ihr Projekt.
  • Plattformen konfigurieren: iOS- und Android-Unterstützung hinzufügen, Einstellungen anpassen und Ihre code synchronisieren.
  • Testen und Bereitstellen: Aufbauen, auf Geräten ausführen und Live-Update-Tools wie Capgo für reibungslose Updates.

Capacitor verbindet Web-Anwendungen mit nativen Gerätefunktionen, um eine glatte Leistung über alle Plattformen sicherzustellen. Folgen Sie dieser Anleitung, um Ihren Entwicklungsprozess zu vereinfachen!

5 Schritte zu NATIVEN APP mit CAPACITOR | Ionic Release Guide

CAPACITOR

Erforderliche Werkzeuge und Konfiguration

Hier erfahren Sie, wie Sie Ihre Entwicklungsumgebung mit den notwendigen Werkzeugen einrichten.

Entwicklungs-Werkzeuge-Installation

Um mit Capacitor zu arbeiten, benötigen Sie folgende Werkzeuge:

Werkzeug Zweck Mindestversion
Node.js JavaScript-Ausführungsumgebung 14.0.0 oder höher
npm Paketmanager 6.0.0 oder höher
IDE/Code Editor Entwicklungsumgebung Letzte stabile Version
Git Versionierung 2.0.0 oder höher

Folgen Sie diesen Schritten, um sie zu installieren:

  • Node.js und npmDownload und installieren Sie beide von der offiziellen Node.js-Website.
  • Code-EditorWählen Sie einen Editor wie VS Code, WebStorm, oder Sublime Text und installieren Sie die neueste stabile Version.
  • Git: Hole es auf git-scm.com.
  • Plattform-spezifische Werkzeuge: Installiere Werkzeuge, die spezifisch für deine Plattform sind, wie Xcode für macOS oder Android Studio für Android-Entwicklung.

Sobald diese installiert sind, bist du bereit, zum Einrichten der Capacitor CLI fortzufahren.

Capacitor CLI Einrichtung

Erhalte die Capacitor CLI mit diesen Schritten in Betrieb.

  1. Install 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 Folgendes aus:

    npx @capgo/cli init

    Dies wird die notwendigen Einstellungen konfigurieren, um Updates zu verwalten wirksam [1]. Es vereinfacht den Prozess für das Erstellen, Testen und Bereitstellen Ihrer App.

Ein neuer Capacitor-Projekt starten

Sobald Sie die notwendigen Tools installiert haben, sind Sie bereit, Ihr erstes Capacitor-Projekt einzurichten. Hier ist, wie Sie loslegen können.

Ihr Projekt erstellen

Um ein neues Capacitor-Projekt zu erstellen, öffnen Sie Ihr Terminal und verwenden Sie diesen Befehl:

npx @capacitor/cli create [projectDirectory] [appId] [appDisplayName]

Zum Beispiel:

npx @capacitor/cli create my-cap-app com.example.app "My Capacitor App"

Hier ist eine Beschreibung jedes Parameters:

  • projectDirectory: Der Name Ihres Projektordners (z.B. my-cap-app).
  • appId: Ein umgekehrter 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

Die 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 Auflistung der wichtigsten Optionen:

Einstellung Zweck Beispielwert
appId Eindeutiger Bezeichner für Ihre App com.example.app
appName Der Anzeigename der App My Capacitor App
webDir Verzeichnis für Ausgabedateien dist
bundledWebRuntime Whether to include Capacitor runtime 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

Abhängigkeiten installieren

Um die Konfiguration 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 Konfiguration und Entwicklung bereit.

Mobilplattformen einrichten

Nachdem Ihr Capacitor-Projekt initialisiert ist, ist der nächste Schritt, die iOS- und Android-Plattformen hinzuzufügen und zu konfigurieren, damit Ihre App nativ auf Mobilgeräten ausgeführt werden kann.

iOS- und Android-Einrichtung

Beginnen Sie, indem Sie die Plattformunterstützung mit folgenden Befehlen hinzufügen:

npx cap add ios
npx cap add android

Nachdem Sie die Plattformen hinzugefügt haben, synchronisieren Sie Ihre Web code mit:

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 Anforderungen Ihres Apps 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.
  • EntwicklerteamZuweisen Sie das geeignete Team für code-Signierung.
  • ZielsystemSetzen Sie die Mindestversion von iOS.
  • GeräteeinstellungAnpassen Sie wie erforderlich.
  • DatenschutzbeschreibungenFügen Sie erforderliche Beschreibungen in Info.plist.

Android

Öffnen Sie das Android-Projekt mit:

npx cap open android

Dann aktualisieren Sie diese Einstellungen:

  • Paketname: Stellt sicher, dass es mit Ihrer appId übereinstimmt.
  • Zugriffsrechte: Definieren Sie die notwendigen Zugriffsrechte in AndroidManifest.xml.
  • Orientierung der Bildschirm: 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-Ort Android-Ort
App Icons ios/App/App/Assets.xcassets android/app/src/main/res
Splash Screens ios/App/App/Assets.xcassets android/app/src/main/res
Deep Links ios/App/App/Info.plist AndroidManifest.xml
Permissions Info.plist AndroidManifest.xml

Mit diesen Einstellungen sind Sie bereit, Ihre App auf mobilen Geräten zu erstellen und zu testen.

Building and Testing

Mit der im Voraus beschriebenen Konfiguration können Sie Ihre App jetzt erstellen und testen. Capacitor App um sicherzustellen, dass sie auf verschiedenen Geräten korrekt funktioniert.

Build and Run Commands

Sobald Ihre App für mobile Plattformen konfiguriert ist, ist es Zeit, Tests zu erstellen und auszuführen. Beginnen Sie mit der Aktualisierung Ihrer Web-Assets:

npm run build
npx cap sync

Next, verwenden Sie die entsprechenden Befehle für Ihre Zielplattform:

Für iOS:

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.

Capacitor-Plugins hinzufügen

Capacitor-Plugins ermöglichen Ihnen, native Funktionen in Ihre App zu integrieren. Zum Beispiel, um die Kamera-, Geolokations- und Speicherkapazitäten zu beinhalten, 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 der Anforderungen für die Einrichtung:

Plugin iOS-Konfiguration Android-Konfiguration
Kamera Hinzufügen Datenschutzbeschreibung Zugriffsrechte zur Manifest hinzufügen
Geolocation Zugriffsbeschreibung für Standort hinzufügen Standortzugriffsrechte hinzufügen
Speicherung 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 Nutzer innerhalb von 24 Stunden Updates erhalten und ein globales Erfolgsrate von 82% erreicht haben [1].

To fügen Sie Capgo zu Ihrer App:

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.
  • Pushen Sie sofortige Fehlerbehebungen während der Testphase.
  • Verfolgen Sie die Erfolgsraten von Updates mit integrierten Analysen.
  • Rollen Sie Updates schnell zurück, wenn Probleme auftreten.

Capgo sichert auch die sichere Lieferung von Updates mit Ende-zu-Ende-Verschlüsselung. Sein Kanal-System ermöglicht es Ihnen, Updates mit ausgewählten Benutzergruppen zu testen, bevor Sie sie allen zugänglich machen.

Zusammenfassung

Diese Anleitung hat alle Phasen des Einrichtens und Bereitstellens einer Capacitor-App abgedeckt, einschließlich aller notwendigen Schritte, um loszulegen und eine glatte Funktion zu gewährleisten.

Hauptschwerpunkte

Die Erstellung einer Capacitor-App erfordert sorgfältige Aufmerksamkeit bei der Einrichtung, Konfiguration und plattformspezifischen Anpassungen. Die Einrichtung Ihres Entwicklungsumgebungen - einschließlich Werkzeuge wie Node.js und das Capacitor CLI - ist ein entscheidender Ausgangspunkt. Die Konfiguration von Plattformen wie iOS und Android sichert die reibungslose Funktion der App auf nativen Systemen.

Mit einem Update-System wie Capgo kann die Veröffentlichungsverwaltung vereinfacht und die App-Stabilität erhalten werden [1].

Hier ist eine Übersicht der wichtigsten Phasen:

Phase Schritte Tipps
Initial Setup Installationswerkzeuge, CLI einrichten Benutzen Sie die neuesten stabilen Versionen
Konfiguration Passen Sie Plattform-Einstellungen an, fügen Sie Plugins hinzu Beachten Sie plattform-spezifische Richtlinien
Testen Bauen und testen auf Geräten Priorisieren Sie das Testen auf echten Geräten
Veröffentlichung Verwalten Sie Updates, Versionskontrolle Nutzen Sie automatisierte Pipelines für Effizienz

Fortsetzen Sie von Capacitor App-Initialisierung: Schritt-für-Schritt-Anleitung

Wenn Sie Cloudflare verwenden Capacitor App-Initialisierung: Schritt-für-Schritt-Anleitung um die CI/CD-Automatisierung zu planen, mit ihr zu verbinden Capgo CI/CD für den Produktworkflow 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 die Reparatur über Capgo anstatt Tage zu warten, bis die App-Store-Zulassung vorliegt. Die Benutzer erhalten die Aktualisierung im Hintergrund, während native Änderungen im normalen Review-Verfahren bleiben.

Los geht's jetzt

Neuestes aus unserem Blog

Capgo gibt Ihnen die besten Einblicke, die Sie benötigen, um eine wirklich professionelle mobile App zu erstellen.