Erste Schritte
Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses Plugin.
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-auto`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/auto/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
Installation
Abschnitt mit dem Titel „Installation“Du kannst unser KI-gestütztes Setup nutzen, um das Plugin zu installieren. Füge die Capgo Skills mit dem folgenden Befehl deinem KI-Tool hinzu:
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-pluginsNutze dann diesen Prompt:
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-auto` plugin in my project.Wenn du ein manuelles Setup bevorzugst, installiere das Plugin mit den folgenden Befehlen und befolge die plattformspezifischen Anweisungen unten:
-
Paket installieren
Terminalfenster npm i @capgo/capacitor-auto -
Native Projekte synchronisieren
Terminalfenster npx cap sync -
Root-Car-Template festlegen
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' },},],},],}); -
Car-Aktionen verarbeiten
await Auto.addListener('carAction', async (event) => {if (event.id === 'open-main-door') {await openGarageDoor(event.payload?.doorId);}}); -
Verbindungsstatus tracken
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);});
Quickstart
Abschnitt „Quick start“import { Auto } from '@capgo/capacitor-auto';
const result = await Auto.isAvailable();console.log(result);Beispiel: setRootTemplate
Abschnitt mit dem Titel „Beispiel: setRootTemplate“import { Auto } from '@capgo/capacitor-auto';
await Auto.setRootTemplate({ title: 'Hello from Capacitor', sections: [ { items: [ { id: 'id-123', title: 'Hello from Capacitor', }, ], }, ],});Beispiel: setState
Abschnitt mit dem Titel „Beispiel: setState“import { Auto } from '@capgo/capacitor-auto';
await Auto.setState({ key: 'key-123', value: {},});Häufige Stolperfallen
Abschnitt „Häufige Fallstricke“- Listener: Handles beim Unmounten von Screens entfernen.
- Nativer Sync: ausführen
npx cap syncnach Plugin-Upgrades. - Single Source of Truth: Vertrauen
src/definitions.tsim GitHub Repo.
Leerer Zustand
Abschnitt mit dem Titel „Leerer Zustand“Setzen Sie emptyText wenn die Vorlage keine Zeilen enthält:
await Auto.setRootTemplate({ title: 'Garage', emptyText: 'No actions are available right now.', sections: [],});Bridge-Nachrichten senden
Abschnitt mit dem Titel „Bridge-Nachrichten senden“Nutzt sendMessage für von der App definierte native Bridge-Nachrichten:
await Auto.sendMessage({ type: 'status', payload: { online: true },});Plattform-Setup
Abschnitt mit dem Titel „Plattform-Setup“- Folge dem iOS-Setup Seite mit Hinweisen zu CarPlay-Szene und Entitlements.
- Folge dem Android-Setup Seite für die Android-Auto-Kategorie und Manifest-Hinweise.
Weiter geht's nach Getting Started
Abschnitt: „Weiter geht’s mit Getting Started“Wenn du es nutzt Erste Schritte Um die Arbeit an nativen Plugins zu planen, verbinde sie mit Verwendung von @capgo/capacitor-auto für die native Funktion bei der Nutzung von @capgo/capacitor-auto, Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für das Implementierungsdetail in Capacitor Plugins von Capgo, Plugins hinzufügen oder aktualisieren für das Implementierungsdetail beim Hinzufügen oder Aktualisieren von Plugins, und Ionic Enterprise Plugin-Alternativen für den Produkt-Workflow bei den Ionic Enterprise Plugin-Alternativen.