Zum Hauptinhalt springen

Einstellung der lokalen Capacitor Umgebung

Lernen Sie, wie Sie schnell eine lokale Capacitor-Umgebung für die Entwicklung von iOS- und Android-Anwendungen mit Webtechnologien mit dieser umfassenden Anleitung einrichten können.

Martin Donadieu

Martin Donadieu

Inhaltsmarketer

Einstellung der lokalen Capacitor-Umgebung

Möchten Sie iOS- und Android-Anwendungen mit Webtechnologien entwickeln? Hier erfahren Sie, wie Sie eine lokale __CAPGO_KEEP_0__-Umgebung schnell und effizient einrichten können. Capacitor Umgebung

Schritte:

  1. Installieren von erforderlichem Software:

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

    • 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+.
    • Umgebungsvariablen für Android-Tools festlegen.
  4. Installieren Sie Capacitor:

    npm install @capacitor/core @capacitor/cli @capacitor/ios @capacitor/android
  5. Einen Projekt initialisieren:

    • Einen neuen Projekt erstellen oder Capacitor in einem bestehenden App integrieren, indem Sie npx cap init.
  6. Hinzufügen von Plattformen:

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

    • Web-Assets erstellen (npm run buildund synchronisiere sie mit nativen Plattformen (npx cap sync).
  8. Lebendliche Updates aktivieren:

    • Verwende Capgo zur Echtzeit-Übermittlung mit:

      npx @capgo/cli init
  9. Teste deine App:

    • Verwende iOS-Simulator (npx cap open ios) oder Android-Emulator (npx cap open android).

Tippschnell:

aktualisieren capacitor.config.ts um Umgebungen zu verwalten und lebendliche 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 deine Capacitor-Apps.

Ionisch Capacitor - Eine neue App erstellen - Ausführen auf Android & iOS …

Vorausgesetzte Einstellungen

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

Grundlegende Softwarebedürfnisse

Installieren Sie die folgenden Tools:

Software Mindestversion Hinweise
Node.js v20.0.0+ Die LTS-Version wird empfohlen
npm v9.0.0+ Kommt mit Node.js ausgeliefert
Git v2.40.0+ Für die Versionskontrolle erforderlich
VS Code/WebStorm Aktuellste Jeder moderne IDE wird funktionieren

Ihr Rechner sollte mindestens 8GB RAM haben, 256 GB Speicher, und ein Intel i5/AMD Ryzen 5 (oder gleichwertiger) Prozessor.

Einstellungen für iOS und Android

Anforderungen für iOS (nur macOS):

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

Anforderungen für Android (Windows/macOS/Linux):

  • Android Studio Hedgehog (2023.1.1) oder höher
  • Android SDK API Level 23 (Android 6.0) oder höher
  • Java Development Kit (JDK) 17
  • Gradle 8.0+

Stellen Sie die Android-Umgebungsvariablen ein, indem Sie diese Zeilen in Ihre Shell-Konfigurationsdatei einfügen:

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

Installation von Capacitor

Installieren Sie Capacitor mit npm:

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

Wenn Sie ein Framework wie Vue, React oder Angular verwenden, installieren Sie die entsprechenden Capacitor-Plugins. Für Vue ausführen:

npm install @capacitor/vue

Um die Installation zu bestätigen, überprüfen Sie die Capacitor-Version, indem Sie Folgendes ausführen:

npx cap --version

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

Schließlich initialisieren Sie Capacitor in Ihrem Projektverzeichnis:

npx cap init

Nach Abschluss können Sie diese Komponenten für Ihr spezifisches Projekt konfigurieren.

Setup Anleitung

Projektsetup

Um loszulegen, erstellen Sie entweder ein neues __CAPGO_KEEP_0__-Projekt oder integrieren Sie __CAPGO_KEEP_0__ in eine bestehende Web-App: Wenn Sie Capacitor in eine bestehende Web-App hinzufügen, initialisieren Sie es in Ihrem Projektverzeichnis: or integrate Capacitor into an existing web app:

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

If you’re adding Capacitor to an existing web app, initialize it in your project directory:

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

Fügen Sie iOS- und Android-Plattformen Ihrem Projekt hinzu:

Aktualisieren Sie Ihr

Datei, um die erforderlichen Konfigurationen einzubeziehen:

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

Bauvorgang capacitor.config.ts __CAPGO_KEEP_0__

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;

__CAPGO_KEEP_0__

  1. Ihre Web-Assets erstellen durch Ausführung von:
npm run build
  1. Synchronisieren Sie Ihr Projekt mit nativen Plattformen:
npx cap sync

Nachdem Sie synchronisiert haben, stellen Sie sicher, dass Sie Ihre Umgebungs- und Live-Update-Einstellungen konfigurieren.

Umgebungs-Setup

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

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

Aktivieren Sie Live-Updates mit Capgo für eine glattere Update-Übermittlung:

npx @capgo/cli init

Test-Setup

Richten 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 auf Android-Geräten.
  • Überprüfen Sie, ob die Entwicklungs-Zertifikate 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 Beta-Testungen und geplante Rollouts. Es ermöglicht Ihnen, bestimmte Benutzergruppen mit verschiedenen Versionen zu targetieren, 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 für individuelle Konfigurationen ermöglichen

Capgo Einrichtung

Capgo Live Update Dashboard Interface

Vereinfachen Sie Ihre Arbeitsabläufe mit Capgo’s Live-Update-System. Um loszulegen, führen Sie:

npx @capgo/cli init

Dann passen Sie Ihre 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, wobei 5MB-Bundles in nur 114ms heruntergeladen werden [1]. Sobald live Updates eingerichtet sind, können Sie Ihre Builds automatisieren, um die Bereitstellung zu erleichtern.

Build-Automatisierung

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

CI/CD-Plattform Integrationmethode Vorteile
GitHub-Aktionen Direkter Workflow Automatisierte Bereitstellungstrigger
GitLab CI Pipeline-Integration Versionskontrolle-Synchronisierung
Jenkins Plugin-Unterstützung 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
  • Benutzerzuweisung konfigurieren
  • Analyse-Tracking einrichten
  • Rückgängigmachungsfunktionen einrichten

Diese Tools 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.

Gemeinsame 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 Lösung
iOS Xcode-Build fehlschlägt Aktualisieren Sie CocoaPods und führen Sie sie aus pod install
Android Gradle-Synchronisierungsfehler Stellen Sie sicher, dass Sie die Gradle-Cache leeren und Android Studio aktualisieren
Beide Live-Reload funktioniert nicht Entwicklermodus in aktivieren in capacitor.config.ts

Versionen-Kompatibilität
Stellen Sie sicher, dass Ihre Konfiguration mit den folgenden Beispielen ü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.

Einstellungen-Tipps

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

Best Practices

{
  channels: {
    beta: {
      percentage: 25,
      deviceId: ['test-device-1']
    },
    production: {
      percentage: 100
    }
  }
}

Regelmäßig aktualisieren Sie Ihre Abhängigkeiten.

  • Einstellungen für Rollover konfigurieren, um fehlgeschlagene Updates zu handhaben:
  • Verwenden Sie Ende-zu-Ende-Verschlüsselung, um Updates zu sichern
{
  rollback: {
    enabled: true,
    maxVersions: 3,
    timeout: 300000
  }
}

Vorteile einer ordnungsgemäßen Einrichtung

Here’s a quick recap of how an optimized Capacitor environment can improve your development process. Setting up your local Capacitor environment the right way speeds up development, streamlines builds, and simplifies updates.

Vereinfachte Builds

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

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

Leistungshighlights

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äß konfigurierte Umgebung ermöglicht es Entwicklern, sich auf die Erstellung von Funktionen zu konzentrieren und sich nicht mit der Infrastruktur abzugeben. Die im Rahmen dieser Anleitung dargestellte Einrichtung sichert Ihnen den vollen Nutzen dieser Vorteile und ermöglicht Ihnen, die Plattformanforderungen zu erfüllen.

Weitermachen Sie mit der Einrichtung einer lokalen Capacitor-Umgebung

Wenn Sie native Plugin-Arbeiten planen, verbinden Sie es mit Einrichtung einer lokalen Capacitor-Umgebung um native Plugin-Arbeiten zu planen Capgo Plugin-Verzeichnis für den Produktworkflow in Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für die Implementierungsdetails in Capacitor Plugins von Capgo, Plugins hinzufügen oder aktualisieren für die Implementierungsdetails in Plugins hinzufügen oder aktualisieren, Ionic Enterprise Plugin Alternativen für den Produktworkflow in Ionic Enterprise Plugin Alternativen, und Capgo Native Builds für den Produktworkflow in Capgo Native Builds.

Live-Updates für Capacitor-Anwendungen

Wenn ein Fehler im Web-Schicht lebt, liefern Sie die Reparatur über Capgo anstatt Tage für die Genehmigung des App-Store abzuwarten. 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 gibt Ihnen die besten Einblicke, die Sie benötigen, um eine wirklich professionelle mobile App zu erstellen.