Zum Hauptinhalt springen

Einrichten des lokalen Capacitor-Umgebungen

Erfahren Sie, wie Sie schnell eine lokale Capacitor-Umgebung einrichten können, um mit Webtechnologien iOS- und Android-Apps zu erstellen, mit dieser umfassenden Anleitung.

Martin Donadieu

Martin Donadieu

Content-Marketing-Manager

Einrichten des lokalen Capacitor-Umgebungen

Möchten Sie mit Webtechnologien iOS- und Android-Apps erstellen? Hier erfahren Sie, wie Sie eine lokale __CAPGO_KEEP_0__-Umgebung einrichten können. 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).

Schnelltip:

Aktualisieren capacitor.config.ts zur Verwaltung von Umgebungen und zur Aktivierung von Live-Updates. 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 - Eine neue App erstellen - In Android und iOS …

Erforderliche Konfiguration

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

Grundlegende Softwarebedürfnisse

Installieren Sie die folgenden Tools:

SoftwareMindestversionHinweise
Node.jsv20.0.0+Die LTS-Version wird empfohlen
npmv9.0.0+Kommmt mit Node.js
Gitv2.40.0+Für die Versionskontrolle erforderlich
VS Code/WebStormNeuesteJeder moderne IDE funktioniert

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

iOS- und Android-Einrichtung

iOS-Anforderungen (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 Sie mit sudo gem install cocoapods)
  • Ein aktives Apple-Entwicklerkonto

Android Anforderungen (Windows/macOS/Linux):

  • Android Studio Hedgehog (2023.1.1) oder später
  • 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

Die 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 führen Sie Folgendes aus:

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 sehen (z.B. 5.x.x bis 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 konfigurieren.

Setup-Anweisungen

Projekt-Setup

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

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

Wenn Sie Capacitor einer bestehenden Web-Anwendung 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.

Plattform-Setup

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. Bauen Sie Ihre Web-Assets indem Sie:
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-Einrichtung

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

Richten Sie Ihre Testumgebung mit diesen Befehlen ein:

UmgebungBefehlAnforderungen
iOS-Simulatornpx cap open iosXcode installiert
Android-Emulatornpx cap open androidAndroid Studio konfiguriert
Live Reloadnpx 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.
  • Stellen Sie sicher, dass die Entwicklungszertifikate korrekt eingerichtet sind.

“We practice agile development and @Capgo is mission-critical in delivering continuously to our users!” – Rodrigo Mantica [1]

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

__CAPGO_KEEP_0__’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 zu targeten, wodurch Sie Probleme identifizieren und beheben können, bevor eine breitere Veröffentlichung erfolgt

Expand your Capacitor setup with tools that improve update delivery, streamline automation, and allow for tailored configurations.

Erweitern Sie Ihre Capgo-Einrichtung mit Werkzeugen, die die Update-Lieferung verbessern, die Automatisierung vereinfachen und eine anpassungsfähige Konfiguration ermöglichen. __CAPGO_KEEP_0__

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 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, 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 Ihre CI/CD-Pipeline, um Builds und Bereitstellungen zu automatisieren. Es unterstützt beliebte Plattformen wie:

CI/CD-PlattformIntegrationsschrittHauptvorteile
GitHub-AktionenDirekter WorkflowAutomatisierte Bereitstellungsanläufe
GitLab CIPipeline-IntegrationSynchronisierung der Versionskontrolle
JenkinsUnterstützung von Plugin-Add-onsBenutzerdefinierte 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

Anpassen Sie die Konfiguration Ihrer App mit spezifischen Einstellungen, die über Live-Updates und Automatisierung hinausgehen:

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:

  • Aktivieren Sie Ende-zu-Ende-Verschlüsselung
  • Benutzerzuweisung konfigurieren
  • Analyse-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

PlattformProblemFehler beheben
iOSXcode-Build fehlschlägtCocoaPods aktualisieren und ausführen pod install
AndroidGradle-SynchronisierungsfehlerGradle-Cache leeren und Android Studio aktualisieren
BeideEchtzeit-Übertragung funktioniert nichtEntwicklermodus in aktivieren capacitor.config.ts

Versionen kompatibel sein
Stellen Sie sicher, dass Ihre 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 aktualisieren Kanäle für kontrollierte Rollouts:
{
  channels: {
    beta: {
      percentage: 25,
      deviceId: ['test-device-1']
    },
    production: {
      percentage: 100
    }
  }
}

Automatisierte Wartung

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

Zusammenfassung

Ein schneller Überblick über die Möglichkeiten, mit einer optimierten Capacitor-Umgebung Ihre Entwicklung zu verbessern. Die richtige Einrichtung Ihrer lokalen Capacitor-Umgebung beschleunigt die Entwicklung, vereinfacht die Builds und erleichtert die Aktualisierungen.

Vorteile einer ordentlichen Einrichtung

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

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

Hervorhebungen zum Leistungsvorteil

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

Vorteile für Entwickler

Ein ordentlich konfiguriertes Umfeld ermöglicht Entwicklern, sich auf die Erstellung von Funktionen zu konzentrieren und sich nicht mit der Infrastruktur abzumühen. Die im Rahmen dieser Anleitung beschriebene Einrichtung sichert Ihnen den vollen Nutzen dieser Vorteile und ermöglicht Ihnen, die Plattformanforderungen zu erfüllen.

Weitermachen von Einstellung auf Capacitor Lokale Umgebung

Wenn Sie "__CAPGO_KEEP_0__ Lokale Umgebung" verwenden Einstellung auf Capacitor Lokale Umgebung Um native Plugin-Arbeit zu planen, verbinden Sie es mit Capgo Plugin-Verzeichnis für den Produktworkflow in Capgo Plugin-Verzeichnis 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 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 auf die Genehmigung der App-Stores zu warten. Die Benutzer erhalten die Aktualisierung im Hintergrund, während native Änderungen im normalen Review-Verfahren bleiben.

Los geht's

Neuestes aus unserem Blog

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