Zum Hauptinhalt springen

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

Erhalten Sie einen effizienten Überblick über die Einrichtung und Bereitstellung von mobilen Apps mit Capacitor – von der Installation bis hin zu plattform-spezifischen Einstellungen.

Martin Donadieu

Martin Donadieu

Content-Marketing-Spezialist

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

Möchten Sie mobile Apps mit einer einzigen Codebasis erstellen? Capacitor ermöglicht es Ihnen, iOS-, Android- und Web-Apps mit Frameworks wie React zu erstellen, Deutschoder VueDiese Anleitung erklärt, wie Sie eine Capacitor einrichten, Plattformen konfigurieren und Updates effizient bereitstellen.

Schritte, um loszulegen:

  • Installationswerkzeuge: Node.js, npm, Git, and a code editor like Code.
  • , Git und einen __CAPGO_KEEP_1__ Editor wie "Visual Studio Capacitor": Install the Capacitor CLI und initialisiere dein Projekt.
  • Konfiguriere Plattformen: Füge iOS- und Android-Unterstützung hinzu, passe Einstellungen an und synchronisiere dein code.
  • Testen und Bereitstellen: Erstelle, laufe auf Geräten und nutze Live-Update-Tools wie Capgo für reibungslose Updates.

Capacitor verbindet Web-Apps mit nativen Gerätefunktionen, um eine glatte Leistung über Plattformen sicherzustellen. Folge dieser Anleitung, um dein 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.

Installation der Entwicklungswerkzeuge

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

WerkzeugZweckMindestversion
Node.jsJavaScript-Umgebung14.0.0 oder höher
npmPaketmanager6.0.0 oder höher
IDE/Code EditorEntwicklungsumgebungLetzte stabile Version
GitVersionkontrolle2.0.0 oder höher

Folge diesen Schritten, um sie zu installieren:

  • Node.js und npm: Laden 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: Installieren Sie Tools, die spezifisch für Ihre Plattform sind, wie Xcode Für macOS oder Android Studio Für die Android-Entwicklung.

Einstellungen 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 dies noch nicht getan haben, führen Sie Folgendes aus:

    npx @capgo/cli init

    Dies wird die notwendigen Einstellungen konfigurieren, um Updates zu verwalten effektiv [1]. Es vereinfacht den Prozess für die Erstellung, Testung und Bereitstellung Ihrer App.

Ein neuer Capacitor Projekt starten

Einmal die notwendigen Tools installiert, bist du bereit, dein erstes Capacitor Projekt einzurichten. Hier ist, wie du loslegst.

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]

Beispiel:

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

Hier ist, was jeder Parameter bedeutet:

  • 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).
  • Anwendungsbezeichnung: Die angezeigte Bezeichnung für Ihre App (z.B., My Capacitor App).

Nachdem Sie diese Anweisung ausgeführt haben, müssen Sie Ihre Projekt-Einstellungen in der capacitor.config.json Datei anpassen.

Konfiguration von capacitor.config.json

Die capacitor.config.json 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 wichtigsten Optionen:

EinstellungZweckBeispielwert
appIdEindeutige Identifikationsnummer für Ihre Appcom.example.app
__CAPGO_KEEP_0__Der Anzeigename der AppMy Capacitor App
__CAPGO_KEEP_0__Verzeichnis für Ausgabedateiendist
__CAPGO_KEEP_0__Ob die Capacitor-Laufzeit einschließen sollfalse
__CAPGO_KEEP_0__Hostname für den Entwicklungs-Serverapp.example.com
__CAPGO_KEEP_0__URL-Schema für Androidhttps
__CAPGO_KEEP_0__URL-Schema für iOShttps

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 für die plattform-spezifische Einrichtung und Entwicklung bereit.

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 auf Mobilgeräten nativ ausgeführt werden kann.

iOS- und Android-Einrichtung

Fangen Sie damit an, die Plattformunterstützung mit folgenden Befehlen hinzuzufügen:

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 das webDir in capacitor.config.json ist korrekt eingestellt. Sobald das getan ist, passen Sie die Einstellungen jeder Plattform an, um sie Ihren Anforderungen anzupassen.

Plattform-spezifische Einstellungen

iOS

Öffnen Sie das iOS-Projekt mit:

npx cap open ios

Konfigurieren Sie dann die folgenden Einstellungen:

  • Bundle-Identifier: Stellen Sie sicher, dass es mit Ihrer appId übereinstimmt.
  • Entwicklungsteam: Zuweisen Sie das geeignete Team für code-Signierung.
  • Zielsystem: Legen Sie die Mindestversion von iOS fest.
  • Geräteorientierung: Anpassen Sie wie erforderlich.
  • Datenschutzbeschreibungen: Fügen Sie erforderliche Beschreibungen hinzu 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 Ihrem appId übereinstimmt.
  • Zugriffsrechte: Definieren Sie notwendige Zugriffsrechte in AndroidManifest.xml.
  • Bildschirmorientierung: Konfigurieren Sie dies in AndroidManifest.xml.
  • Ziel SDK: Setze die entsprechende Version ein android/app/build.gradle.

Asset- und Konfigurationsorte

Hier findest du wichtige Dateien für App-Icons, Splash-Screens, tiefere Links und Berechtigungen:

KonfigurationiOS-OrtAndroid-Ort
App-Iconsios/App/App/Assets.xcassetsandroid/app/src/main/res
Splash-Screensios/App/App/Assets.xcassetsandroid/app/src/main/res
Tiefere Linksios/App/App/Info.plistAndroidManifest.xml
BerechtigungenInfo.plistAndroidManifest.xml

Mit diesen Konfigurationen bist du bereit, deine App auf mobilen Geräten zu bauen und zu testen.

Entwicklung und Testen

Mit der im vorigen Abschnitt beschriebenen Konfiguration können Sie nun Ihr Capacitor Anwendungsprogramm erstellen und testen, um sicherzustellen, dass es auf verschiedenen Geräten korrekt funktioniert.

Build- und Ausführungsbefehle

Sobald Ihre Anwendung für mobile Plattformen konfiguriert ist, ist es Zeit, Build- und Ausführungstests durchzuführen. Beginnen Sie damit, Ihre Web-Assets zu aktualisieren:

npm run build
npx cap sync

Als Nächstes 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 erstellen und starten Ihr Anwendungsprogramm 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, native Funktionen zu Ihrem Anwendungsprogramm hinzuzufügen. 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 schnelle Übersicht über die Anforderungen für die Einrichtung:

PluginiOS-KonfigurationAndroid-Konfiguration
KameraHinzufügen DatenschutzbeschreibungZugriffsrechte zur Manifestdatei hinzufügen
StandortHinzufügen von StandortnutzungsbeschreibungZugriffsrechte zum Standort hinzufügen
SpeicherungKeine zusätzliche Einrichtung erforderlichKeine zusätzliche 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:

  • Erstellen Sie separate Kanäle für Entwicklung, Staging- und Produktionsumgebungen.
  • Drücken 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-Anwendung durchgegangen, alle notwendigen Schritte abgedeckt, um loszulegen und eine glatte Funktion zu gewährleisten.

Hauptschritte

Das Erstellen einer Capacitor-Anwendung erfordert sorgfältige Aufmerksamkeit bei der Einrichtung, Konfiguration und plattformspezifischen Anpassungen. Die Einrichtung Ihres Entwicklungsumfelds - einschließlich Werkzeugen 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 funktioniert.

Das Einsatz eines Updatesystems wie Capgo kann die Verwaltung von Releases vereinfachen und die Anwendungsstabilität aufrechterhalten. [1].

Hier ist eine Übersicht der wichtigsten Phasen:

PhaseSchritteHinweise
InitialisierungInstallieren Sie Werkzeuge, CLI-EinrichtungBenutzen Sie die neuesten stabilen Versionen
KonfigurationPassen Sie Plattform-Einstellungen an, fügen Sie Plugins hinzuBeachten Sie plattform-spezifische Richtlinien
TestenErstellen und testen auf GerätenPriorisieren Sie die Tests auf echten Geräten
BereitstellungVerwalten Sie Updates, VersionskontrolleNutzen Sie automatisierte Pipelines für Effizienz

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

Wenn Sie Capacitor App-Initialisierung: Schritt-für-Schritt-Anleitung zur Planung der CI/CD-Automatisierung verwenden, verbinden Sie es mit Capgo CI/CD für den Produktworkflow in Capgo CI/CD, Capgo Native Builds für den Produktworkflow in Capgo Native Builds, Capgo Integrations zur Produktworkflow in Capgo Integrations, CI/CD-Integration zur Implementierungsdetail in CI/CD-Integration, und GitHub Actions-Integration zur Implementierungsdetail in GitHub Actions-Integration.

Live-Updates für Capacitor-Anwendungen

Wenn ein Fehler im Web-Schicht lebt, liefern Sie die Reparatur über Capgo anstatt Tage auf die Genehmigung des App-Stores zu warten. Die Benutzer erhalten die Aktualisierung im Hintergrund, während native Änderungen im normalen Review-Verfahren bleiben.

Los geht's jetzt

Aktuelle Beiträge aus unserem Blog

Capgo bietet Ihnen die besten Einblicke, die Sie benötigen, um eine echte professionelle Mobil-App zu erstellen.