Zum Hauptinhalt springen

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

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

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

Wollen Sie mobile Apps mit einer einzigen Codebasis erstellen? Capacitor erleichtert die Erstellung von iOS-, Android- und Web-Apps mit Frameworks wie React, Angular, oder Vue. Diese Anleitung erklärt, wie Sie die Plattform einrichten, Konfigurationen vornehmen und Updates effizient bereitstellen können. CapacitorInstallationswerkzeuge

__CAPGO_KEEP_0__

  • __CAPGO_KEEP_0__: Node.js, npm, Git, und ein code Editor wie VS Code.
  • Einrichten von Capacitor: Installieren Sie das Capacitor CLI und initialisieren Sie Ihr Projekt.
  • Konfigurieren von Plattformen: Fügen Sie iOS- und Android-Unterstützung hinzu, passen Sie die Einstellungen an und synchronisieren Sie Ihr code.
  • Testen und Bereitstellen: Erstellen Sie, führen Sie auf Geräten aus und verwenden Sie Live-Update-Tools wie Capgo __CAPGO_KEEP_0__ verbindet Web-Apps mit nativen Gerätefunktionen, um eine glatte Leistung über Plattformen sicherzustellen. Folgen Sie dieser Anleitung, um Ihren Entwicklungsprozess zu vereinfachen!

Capacitor für reibungslose Updates.

5 Schritte zu einer NATIVEN APP mit CAPACITOR | Ionic Release Guide

CAPACITOR

Erforderliche Werkzeuge und Konfiguration

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

Entwicklungswerkzeug-Installation

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

Werkzeug Zweck Mindestversion
Node.js JavaScript-Umgebung zum Ausführen von Skripten 14.0.0 oder höher
npm Paketmanager 6.0.0 oder höher
IDE/Code-Editor Entwicklungs-Umgebung Letzte stabile Version
Git Versionskontrolle 2.0.0 oder höher

Folgen Sie 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 Werkzeuge: Installieren Sie Werkzeuge, die für Ihre Plattform spezifisch sind, wie Xcode für macOS oder Android Studio für die Android-Entwicklung.

Installieren Sie diese, dann sind Sie bereit, die Capacitor CLI zu konfigurieren.

Capacitor CLI-Konfiguration

Richten Sie die Capacitor CLI mit diesen Schritten ein:

  1. Installieren Sie Capacitor CLI global

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

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

    Wenn du das noch nicht getan hast, führe folgenden Befehl aus:

    npx @capgo/cli init

    Dies konfiguriert die notwendigen Einstellungen, um Updates zu verwalten effektiv [1]. Es vereinfacht den Prozess für das Erstellen, Testen und Bereitstellen deiner App.

Ein neuer Capacitor-Projekt starten

Einmal die notwendigen Tools installiert hast, bist du bereit, dein erstes Capacitor-Projekt zu erstellen. Hier ist, wie du loslegst.

Ihr Projekt erstellen

Um ein neues Capacitor-Projekt zu erstellen, öffne dein Terminal und führe diesen Befehl aus:

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:

  • Projektordner: 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 Konfigurieren Sie

Configuring 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: capacitor.config.json Hier ist eine Übersicht der wichtigsten Optionen:

{
  "appId": "com.example.app",
  "appName": "My Capacitor App",
  "webDir": "dist",
  "bundledWebRuntime": false,
  "server": {
    "hostname": "app.example.com",
    "androidScheme": "https",
    "iosScheme": "https"
  }
}

__CAPGO_KEEP_0__.config.json

Einstellung Zweck Beispielwert
appId Einziger Identifikator für Ihre App com.example.app
appName Anzeigename der App My Capacitor App
webDir Verzeichnis für Ausgabedateien dist
bundledWebRuntime Ob die Capacitor-Laufzeit enthalten soll false
server.hostname Hostname für den Entwicklungs-Server app.example.com
__CAPGO_KEEP_0__ URL-Schema für Android https
URL-Schema für iOS Abhängigkeiten installieren https

Um die Einrichtung abzuschließen, installieren Sie die erforderlichen Abhängigkeiten und initialisieren Sie Ihr Projekt mit diesen Befehlen:

Mit diesen Schritten ist Ihr Projekt für die Plattform-spezifische Einrichtung und Entwicklung bereit.

npm install @capacitor/core
npm install @capacitor/cli --save-dev
npx cap init

Einrichtung von Mobilplattformen

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

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.

Fangen Sie mit der Hinzufügung der Plattformunterstützung mit folgenden Befehlen an:

URL-Schema für iOS

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 an Ihre App 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 mit Ihrem appId übereinstimmt.
  • Entwicklungsteam: Zuweisen Sie das geeignete Team für code-Signierung.
  • Zielsystem: Legen Sie die Mindestversion für iOS fest.
  • Geräteeinstellung: Anpassen Sie wie erforderlich.
  • Datenschutzhinweise: 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 er mit Ihrer appId übereinstimmt.
  • Erlaubnisse: Definieren Sie die erforderlichen Berechtigungen in AndroidManifest.xml.
  • Bildschirmorientierung: Konfigurieren Sie dies in AndroidManifest.xml.
  • Target SDK: Setzen Sie die richtigen Versionen in android/app/build.gradle.

Orte für Assets und Konfigurationen

Hier finden Sie die Schlüsseldateien für App-Icons, Splash-Screens, tiefere Links und Berechtigungen:

Konfiguration iOS-Location Android-Location
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
Berechtigungen 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 im vorigen Abschnitt beschriebenen Konfiguration können Sie Ihre App jetzt auf verschiedenen Geräten testen. Capacitor-App context: Seite/ Bereich: Capgo-Lösungen-Marketingseite. Rolle: Kurzer UI-Label oder Navigationspunkt. Gesehen in: Seite Lösungen/White-Label.astro. Capgo-Produkt/Marke und Entwicklertrems genau beibehalten. Nachrichtenschlüssel `solutions_white_label_visual_cell1_value` (Solutions White Label Visual Cell1 Value).

um sicherzustellen, dass sie auf verschiedenen Geräten korrekt funktioniert.

Erstellung und Ausführungsbefehle

npm run build
npx cap sync

Einmal Ihre App für mobile Plattformen konfiguriert, ist es Zeit, Tests durchzuführen. Beginnen Sie mit der Aktualisierung Ihrer Web-Assets:

Als Nächstes verwenden Sie die entsprechenden Befehle für Ihre Zielplattform:

npx cap run ios

Für iOS: 1. Für Android: 1.

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, 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 über die Anforderungen für die Einrichtung:

Plugin iOS-Konfiguration Android-Konfiguration
Kamera Hinzufügen Datenschutzbeschreibung Zugriffsrechte zur Manifest hinzufügen
Geolocation Hinzufügen von Standortnutzungsbeschreibung Hinzufügen von Standortberechtigungen
Speicherung Keine zusätzliche Einrichtung erforderlich Keine 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 Nutzer innerhalb von 24 Stunden Updates erhalten und ein globales Erfolgsrate von 82 % erreicht haben [1].

Um Capgo zu Ihrer App hinzuzufügen:

npm install @capgo/capacitor-updater
npx cap sync

Capgo bietet mehrere Vorteile während des Testens:

  • Erstellen Sie separate Kanäle für die Entwicklungsumgebung, die Staging-Umgebung und die Produktionsumgebung.
  • Pushen Sie sofortige Fehlerkorrekturen 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 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 Ihrer Entwicklungsumgebung – einschließlich Werkzeuge wie Node.js und der 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 Verwaltung von Releases und die Gewährleistung der App-Stabilität erleichtert werden. [1].

Hier ist eine Übersicht der wichtigsten Phasen:

Phase Schritte Hinweise
Initialisierung Install tools, CLI setup __CAPGO_KEEP_0__
Verwenden Sie die neuesten stabilen Versionen Plattform-Einstellungen anpassen, Plugins hinzufügen Plattform-spezifische Richtlinien befolgen
Testen Auf Geräten bauen und testen Realgeräte für die Tests priorisieren
Veröffentlichung Updates verwalten, Versionskontrolle Automatisierte Pipelines für Effizienz nutzen

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

Wenn Sie __CAPGO_KEEP_0__ App-Initialisierung: Schritt-für-Schritt-Anleitung Capacitor App Initialization: Step-by-Step Guide Bauen und testen auf Geräten 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 Actions-Integration zur Implementierungsdetail in GitHub Actions-Integration

Live-Updates für Capacitor-Apps

Wenn ein Fehler im Web-Schicht lebt, schicken Sie die Reparatur über Capgo anstatt Tage zu warten, bis die App-Store-Zulassung genehmigt ist. Die Benutzer erhalten die Aktualisierung im Hintergrund, während native Änderungen im normalen Review-Verfahren bleiben.

Unterstützung von Menschen von Martin

Jetzt loslegen

Neueste Nachrichten aus unserem Blog

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