Zum Hauptinhalt springen

Einrichtung des lokalen Capacitor Umfelds

Erhalten Sie eine umfassende Anleitung, um schnell ein lokales Capacitor Umfeld für die Entwicklung von iOS- und Android-Anwendungen mit Webtechnologien einzurichten.

Martin Donadieu

Martin Donadieu

Content-Marketing-Manager

Einrichtung des lokalen Capacitor Umfelds

Wollen Sie iOS- und Android-Anwendungen mit Webtechnologien entwickeln? Hier erfahren Sie, wie Sie ein lokales __CAPGO_KEEP_0__ Umfeld einrichten. Capacitor Umgebung schnell und effizient zu erstellen.

Schritte:

  1. Installieren Sie erforderliche Software:

    • Node.js (v20.0.0+), npm (v9.0.0+), Git (v2.40.0+), und ein modernes IDE (z.B. VS Code).
    • Systemanforderungen: 8 GB RAM, 256 GB Speicher, Intel i5/AMD Ryzen 5-Prozessor.
  2. iOS-Einrichtung (macOS nur):

    • macOS 13.0+ (Ventura), Xcode 16.0+, CocoaPods 1.12.0+, und ein aktives Apple-Entwicklerkonto.
  3. Android-Einrichtung:

    • Android Studio Hedgehog (2023.1.1)+, Android SDK API Level 23+, JDK 17, und Gradle 8.0+.
    • Setze Umgebungsvariablen für Android-Tools.
  4. Installiere Capacitor:

    npm install @capacitor/core @capacitor/cli @capacitor/ios @capacitor/android
  5. Initialisiere ein Projekt:

    • Erstellen Sie ein neues Projekt oder integrieren Sie Capacitor in eine bestehende App mithilfe von npx cap init.
  6. Hinzufügen von Plattformen:

    npx cap add ios
    npx cap add android
  7. Erstellen und Synchronisieren:

    • Erstellen Sie Web-Assets (npm run build und synchronisieren Sie sie mit nativen Plattformen (npx cap sync).
  8. Aktivieren Sie Live-Updates:

    • Verwenden Sie Capgo für Echtzeit-Updates mit:

      npx @capgo/cli init
  9. Testen Sie Ihre App:

    • Verwenden Sie den iOS-Simulator (npx cap open ios oder den Android-Emulator (npx cap open android).

Ratgeber:

aktualisieren capacitor.config.ts um Umgebungen zu verwalten und Live-Updates zu aktivieren. Zum Beispiel:

const config: CapacitorConfig = {
  server: {
    url: process.env.NODE_ENV === 'development' ? 'http://localhost:3000' : 'https://production-url.com',
    cleartext: true
  }
};

Diese Konfiguration sichert eine glatte Entwicklung, Testung und Bereitstellung für Ihre Capacitor-Anwendungen.

Ionic Capacitor - Neues Projekt erstellen - in Android & iOS …

Benötigte Konfiguration

Stellen Sie sicher, dass Ihr System die erforderlichen Spezifikationen erfüllt, bevor Sie fortfahren.

Grundlegende Softwareanforderungen

Installieren Sie die folgenden Tools:

Software Mindestversion Hinweise
Node.js v20.0.0+ Die LTS-Version wird empfohlen
npm v9.0.0+ Kommmt mit Node.js
Git v2.40.0+ Für die Versionskontrolle erforderlich
VS CodeWebStorm Neueste Jeder moderne IDE funktioniert

Ihr Gerät sollte mindestens 8 GB RAM, 256 GB Speicherund einen Intel i5/AMD Ryzen 5 (oder gleichwertigen) Prozessor.

iOS- und Android-Einrichtung

Anforderungen für iOS (nur macOS):

  • macOS 13.0 (Ventura) oder neuer
  • Xcode 16.0 oder später (herunterladen Sie es vom Mac App Store)
  • CocoaPods 1.12.0 oder höher (installieren Sie mit sudo gem install cocoapods)
  • Eine aktive Apple-Entwicklerkonto

Android Anforderungen (Windows/macOS/Linux):

  • Android Studio Hedgehog (2023.1.1) oder später
  • Android SDK API level 23 (Android 6.0) or above
  • Gradle 8.0+
  • Stellen Sie die Android-Umgebungsvariablen ein, indem Sie diese Zeilen in Ihre Shell-Konfigurationsdatei einfügen:

Installieren Sie __CAPGO_KEEP_0__

export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/tools
export PATH=$PATH:$ANDROID_HOME/platform-tools

Installieren Sie Capacitor mit __CAPGO_KEEP_1__:

Install Capacitor using npm:

npm install @capacitor/core @capacitor/cli
npm install @capacitor/ios @capacitor/android

If you’re using a framework like Vue, React, or Angular, install the corresponding Capacitor plugins. For Vue, run:

npm install @capacitor/vue

To bestätigen, dass die Installation erfolgreich war, überprüfen Sie die Capacitor Version, indem Sie Folgendes ausführen:

npx cap --version

Sie sollten die aktuelle Capacitor Version sehen (z.B. 5.x.x ab April 2025).

Schließlich initialisieren Sie Capacitor in Ihrem Projektverzeichnis:

npx cap init

Einmal abgeschlossen, können Sie diese Komponenten für Ihr spezifisches Projekt anpassen.

Einstellungen für die Einrichtung

Projekt-Einrichtung

Um loszulegen, erstellen Sie entweder ein neues Capacitor Projekt oder integrieren Sie Capacitor in eine bestehende Web-App:

npm init @capacitor/app
cd my-cap-app
npm install

Wenn Sie Capacitor in eine bestehende Web-App hinzufügen, initialisieren Sie es in Ihrem Projektverzeichnis:

cd your-web-app
npm install @capacitor/core @capacitor/cli
npx cap init [appName] [appId]

Einmal initialisiert, müssen Sie die notwendigen Plattformen für die native Entwicklung hinzufügen.

Einstellungen für die Plattform

iOS- und Android-Plattformen zu Ihrem Projekt hinzufügen:

npm install @capacitor/ios @capacitor/android
npx cap add ios
npx cap add android

Aktualisieren Sie Ihr capacitor.config.ts Datei, um die erforderlichen Konfigurationen zu enthalten:

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
    appId: 'com.example.app',
    appName: 'My Capacitor App',
    webDir: 'dist',
    bundledWebRuntime: false,
    plugins: {
      // Add plugin settings here
    }
};

export default config;

Build-Prozess

  1. Ihre Web-Assets aufbauen indem Sie
npm run build
  1. Ihre Projekt mit nativen Plattformen synchronisieren:
npx cap sync

Nachdem Sie gesynchronisiert haben, stellen Sie sicher, dass Sie Ihre Umgebungen und Live-Update-Einstellungen konfigurieren.

Umgebungs-Einstellungen

Um Umgebungen zu verwalten, aktualisieren Sie Ihr capacitor.config.ts Datei:

const config: CapacitorConfig = {
    server: {
      url: process.env.NODE_ENV === 'development'
        ? 'http://localhost:3000'
        : 'https://production-url.com',
      cleartext: true
    }
};

Live-Updates aktivieren mit Capgo für eine glattere Aktualisierungsbereitstellung:

npx @capgo/cli init

Testumgebung einrichten

Stellen Sie Ihre Testumgebung mit diesen Befehlen ein:

Umgebung Befehl Anforderungen
iOS-Simulator npx cap open ios Xcode installiert
Android-Emulator npx cap open android Android Studio konfiguriert
Live Reload npx cap run [platform] Entwicklungs-Server läuft

Für die Testung auf physischen Geräten:

  • Stellen Sie sicher, dass iOS-Geräte bei Ihrem Apple-Entwicklerkonto registriert sind.
  • Aktivieren Sie die USB-Debugging-Funktion auf Android-Geräten.
  • Überprüfen Sie, ob die Entwicklungszertifikate korrekt eingerichtet sind.

“Wir praktizieren agiles Entwicklung und @Capgo ist mission-kritisch bei der kontinuierlichen Lieferung an unsere Benutzer!” – Rodrigo Mantica [1]

Capgo’s Kanal-System ist ein großartiges Werkzeug für die Beta-Testung und die gezielte Veröffentlichung. Es ermöglicht Ihnen, bestimmte Benutzergruppen mit verschiedenen Versionen anzusprechen, wodurch Sie Probleme identifizieren und beheben können, bevor eine breitere Veröffentlichung erfolgt [1].

Zusätzliche Funktionen

Erweitern Sie Ihre Capacitor-Einrichtung mit Werkzeugen, die die Update-Lieferung verbessern, die Automatisierung vereinfachen und individuelle Konfigurationen ermöglichen.

Capgo Einrichtung

Capgo Live-Update-Dashboard-Interface

Simplifizieren Sie Ihren Workflow mit Capgo’s Live-Update-System. Um loszulegen, führen Sie Folgendes aus:

npx @capgo/cli init

Dann passen Sie Ihren capacitor.config.ts Datei an, um Live-Updates zu aktivieren:

{
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      statsUrl: 'https://your-stats-endpoint.com'
    }
  }
}

Capgo’s globale CDN liefert beeindruckende Geschwindigkeiten, mit 5MB-Bundles, die in nur 114ms heruntergeladen werden [1]Sobald Live-Updates eingerichtet sind, können Sie Ihre Builds automatisieren, um glattere Bereitstellungen zu ermöglichen.

Build-Automatisierung

Integrieren Sie Capgo in Ihren CI/CD-Pipeline, um Builds und Bereitstellungen zu automatisieren. Es unterstützt beliebte Plattformen wie:

CI/CD-Plattform Integrationmethode Hauptvorteile
GitHub-Aktionen Direkter Workflow Automatisierte Bereitstellung auslösen
GitLab CI Pipeline-Integration Synchronisierung der Versionskontrolle
Jenkins Unterstützung für Plugins Benutzerdefinierte Build-Schritte

Hier ist ein Beispiel für eine CI/CD-Pipeline-Konfiguration:

build_and_deploy:
  steps:
    - run: npm run build
    - run: npx cap sync
    - run: npx @capgo/cli deploy

Benutzerdefinierte Einstellungen

Passen Sie die Konfiguration Ihrer App an, um spezifische Einstellungen außerhalb von Live-Updates und Automatisierung zu nutzen:

const config: CapacitorConfig = {
  ios: {
    contentInset: 'automatic',
    preferredContentMode: 'mobile'
  },
  android: {
    backgroundColor: '#ffffff',
    allowMixedContent: true
  },
  plugins: {
    SplashScreen: {
      launchAutoHide: true,
      backgroundColor: '#ffffffff',
      androidScaleType: 'CENTER_CROP'
    }
  }
};

Für eine bessere Leistung sollten Sie diese Optionen in Betracht ziehen:

  • End-to-End-Verschlüsselung aktivieren
  • Konfigurieren Sie die Benutzerzuweisung
  • Analysen-Tracking einrichten
  • Rückgängigmachungsfunktionen verwenden

Diese Werkzeuge tragen zu einem Erfolg von 82% bei 750 Produktionsanwendungen weltweit bei [1].

Problem Lösung

Hier erfahren Sie, wie Sie häufige Probleme angehen und Ihre Einrichtung verbessern, um einen reibungslosen Workflow zu gewährleisten.

Häufige Probleme

Abhängigkeitskonflikte
Wenn Sie Konflikte mit Abhängigkeiten auftreten, versuchen Sie diese Befehle:

npm ls @capacitor/core
rm -rf node_modules
npm install

Plattform-spezifische Probleme

Plattform Problem Fix
iOS Xcode build fehlt Update CocoaPods und ausführen pod install
Android Gradle-Synchronisierungsfehler Leere den Gradle-Cache und aktualisiere Android Studio
Beide Live-Reload funktioniert nicht Entwicklermodus in aktivieren capacitor.config.ts

Versionen-Kompatibilität
Stelle sicher, dass deine Konfiguration mit dem folgenden Beispiel übereinstimmt:

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'My App',
  webDir: 'dist',
  bundledWebRuntime: false,
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true
    }
  }
};

Indem Sie diese Probleme frühzeitig angehen, können Sie unnötige Hürden vermeiden.

Setup-Tipps

Hier sind einige Möglichkeiten, die Stabilität zu verbessern und wiederkehrende Probleme zu vermeiden.

Best Practices

  • Verwenden Sie die integrierte Fehlerüberwachung, um Probleme schnell zu identifizieren und zu beheben. [1].
  • Einrichten Sie Update-Kanäle zur Kontrolle von Rollouts:
{
  channels: {
    beta: {
      percentage: 25,
      deviceId: ['test-device-1']
    },
    production: {
      percentage: 100
    }
  }
}

Automatisierte Wartung

  • Regelmäßig aktualisieren Sie Ihre Abhängigkeiten.
  • Konfigurieren Sie die Rollback-Einstellungen, um fehlgeschlagene Updates zu handhaben:
{
  rollback: {
    enabled: true,
    maxVersions: 3,
    timeout: 300000
  }
}

Zusammenfassung

Hier ist eine kurze Zusammenfassung, wie eine optimierte Capacitor-Umgebung Ihr Entwicklungsprozess verbessern kann. Die richtige Einrichtung Ihrer lokalen Capacitor-Umgebung beschleunigt die Entwicklung, vereinfacht die Builds und vereinfacht die Updates.

Vorteile einer ordnungsgemäßen Einrichtung

  • Schnelle Updates beschleunigen die Entwicklungszyklen.
  • Automatisierte und zuverlässige Build-Prozesse sparen Zeit und Mühe.

Diese Verbesserungen resultieren aus der Einhaltung der im vorherigen Abschnitt diskutierten Einrichtungs- und Integrationspraktiken.

Hervorhebungen der Leistung

Capgo-verbesserte Capacitor-Umgebungen zeigen beeindruckende Ergebnisse, einschließlich schneller Antwortzeiten, schnellen Downloads und hohen Erfolgsraten bei Updates [1].

Vorteile für Entwickler

Eine ordnungsgemäße Umgebung ermöglicht es Entwicklern, sich auf die Erstellung von Funktionen zu konzentrieren und nicht mit der Infrastruktur zu kämpfen. Die im Rahmen dieser Anleitung dargestellte Einrichtung stellt sicher, dass Sie diese Vorteile voll ausnutzen können, während gleichzeitig die Anforderungen der Plattform erfüllt werden.

Bleiben Sie bei der Einrichtung von Capacitor lokalem Umfeld weiterhin auf dem Laufenden

Wenn Sie Die Einrichtung von Capacitor lokalem Umfeld um native Plugin-Arbeit zu planen, verbinden Sie es mit Capgo Plugin-Ordner für den Produktworkflow in Capgo Plugin-Ordner, Capacitor Plugins von Capgo für die Implementierungsdetails in Capacitor Plugins von Capgo, Hinzufügen oder Aktualisieren von Plugins für die Implementierungsdetails in Hinzufügen oder Aktualisieren von Plugins, Ionic Enterprise Plugin Alternativen für den Produktworkflow in Ionic Enterprise Plugin Alternativen, und Capgo Native Builds für das Produktworkflow in Capgo Native Builds.

Echtzeit-Updates für Capacitor-Anwendungen

Wenn ein Web-Schicht-Bug live ist, liefern Sie die Reparatur über Capgo anstatt Tage zu warten, bis die App-Store-Zulassung genehmigt ist. Die Benutzer erhalten das Update 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.