Zum Hauptinhalt springen
@capgo/capacitor-auto Device-APIs Open Source

System Capacitor Plugin

Verbinde Capacitor-Apps über CarPlay- und Android Auto-Template-Oberflächen für bidirektionale Kommunikation mit dem Auto

Installieren

bun add @capgo/capacitor-auto bunx cap sync
npm, pnpm oder yarn
  • npm install @capgo/capacitor-auto
  • pnpm add @capgo/capacitor-auto
  • yarn add @capgo/capacitor-auto

Anleitung

So nutzt man Auto in Capacitor

Verwendung von @capgo/capacitor-auto

@capgo/capacitor-auto verbindet eine Capacitor-App mit freigegebenen CarPlay- und Android-Auto-Template-Oberflächen. Deine App sendet ein kleines Listen-Template an das Auto-Display, und das Auto-Display sendet ausgewählte Aktionen zurück an JavaScript.

Es wurde für fahrersichere, richtlinienbasierte Workflows entwickelt. Es spiegelt deine WebView nicht ins Auto.

Installieren und synchronisieren

npm install @capgo/capacitor-auto
npx cap sync

Ein Template an das Auto senden

import { Auto } from '@capgo/capacitor-auto';

await Auto.setRootTemplate({
  title: 'Garage',
  sections: [
    {
      header: 'Doors',
      items: [
        {
          id: 'open-main-door',
          title: 'Open main door',
          subtitle: 'Tap to send the action to the phone app',
          payload: { doorId: 'main' },
        },
      ],
    },
  ],
});

Auf Fahreraktionen lauschen

await Auto.addListener('carAction', async (event) => {
  if (event.id === 'open-main-door') {
    await openGarageDoor(event.payload?.doorId);
  }
});

Verbindungsstatus überwachen

const status = await Auto.isAvailable();
console.log(status.available, status.connected, status.platform);

await Auto.addListener('connectionChanged', (event) => {
  console.log('Car connected:', event.connected, event.platform);
});

iOS-Anforderungen

CarPlay erfordert ein von Apple genehmigtes Entitlement für deine App-Kategorie. Füge die CarPlay-Szenenkonfiguration hinzu, wie in den iOS-Setup-Docs beschrieben, und nutze für dein Car-UI ausschließlich Apple-konforme Templates.

Android-Anforderungen

Android Auto nutzt die AndroidX Car App Library. Das Plugin enthält ein CarAppService, deklariert die template -Fähigkeit und nutzt standardmäßig die IOT -Kategorie. Überprüfe die Android Setup-Docs falls deine App eine weitere Android Auto-Kategorie benötigt.

Design-Leitfaden

Nutze das Car-Interface für kurze, vorhersehbare Aktionen:

  • Statuszeilen
  • One-Tap-Befehle
  • fahrer-sichere Bestätigungen
  • einfacher State-Handoff von der Phone-App

Halte komplexe Flows in der Phone-UI und nutze carAction Events als native Intent-Trigger.

Weiter mit @capgo/capacitor-auto

Wenn du es nutzt Verwendung von @capgo/capacitor-auto , um natives Media- und Interface-Verhalten zu planen, verbinde es mit @capgo/capacitor-auto für die Implementierungsdetails in @capgo/capacitor-auto, Erste Schritte für die Implementierungsdetails in Erste Schritte, @capgo/capacitor-live-activities verwenden für die native Funktion in „@capgo/capacitor-live-activities verwenden“, @capgo/capacitor-live-activities für die Implementierungsdetails in @capgo/capacitor-live-activities und Verwendung von @capgo/capacitor-video-player für die native Funktionalität in „Verwendung von @capgo/capacitor-video-player.“

FAQ

Auto Plugin FAQ

Wie installiere ich das Auto-Plugin in einer Capacitor-App?

Führe "bun add @capgo/capacitor-auto" (oder "npm install @capgo/capacitor-auto") aus und danach "bunx cap sync", damit die iOS- und Android-Projekte das native code einbinden. Importiere es in deiner App code aus "@capgo/capacitor-auto".

Funktioniert @capgo/capacitor-auto mit React, Vue und Angular?

Ja. Auto ist ein Capacitor Package und funktioniert daher mit jedem Web-Framework, das in Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und reinem JavaScript.

Welche Capacitor-Version unterstützt @capgo/capacitor-auto?

Capgo Plugins folgen der Major-Version von Capacitor: Nutze die Plugin-Major-Version, die zu deiner Capacitor Major-Version passt (z. B. Plugin v8 bei Capacitor 8). Die Kompatibilitätstabelle im GitHub README listet die gepflegten Versionen auf.

Ist @capgo/capacitor-auto kostenlos und Open Source?

Ja. Der code-Code ist auf GitHub unter https://github.com/Cap-go/capacitor-auto/ öffentlich und das Package lässt sich kostenlos über npm installieren. Bug-Reports und Pull Requests sind willkommen.

Kann ich code mit Auto ohne App Store Review aktualisieren?

Die Installation oder ein Upgrade des Plugins ändert den nativen code, weshalb ein neuer Store-Build nötig ist. Danach können JavaScript-, HTML- und CSS-Änderungen, die das Plugin aufrufen, sofort per Capgo Live Updates ausgeliefert werden.

Veröffentliche Auto-Änderungen ohne auf den App-Review zu warten

Sobald das Plugin in deinem Store-Build ist, bringt Capgo mit Live-Updates deine JavaScript-, HTML- und CSS-Änderungen in Minuten zu den Nutzern.

Starte mit Capgo