Getting Started

Kopieren Sie einen Setup-Prompt mit den Installationsanweisungen und der vollständigen Markdown-Guideline für diesen 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.

Das Paket installieren
Terminal-Fenster
```
npm i @capgo/capacitor-auto
```
Synchronisiere native Projekte
Terminalfenster
```
npx cap sync
```

Setze die Root-Car-Vorlage

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' },
        },
      ],
    },
  ],
});

Behandle Fahrzeugaktionen

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

Verfolge den Verbindungszustand

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);
});

Leerzustand

Setzen emptyText wenn das Template keine Zeilen hat:

await Auto.setRootTemplate({
  title: 'Garage',
  emptyText: 'No actions are available right now.',
  sections: [],
});

Bridgemeldungen senden

Verwenden sendMessage für anwendungsdefinierte native Bridgemeldungen:

await Auto.sendMessage({
  type: 'status',
  payload: { online: true },
});

Plattformseinstellungen

Folgen Sie den iOS-Einrichtung Seite für CarPlay-Szenario und Berechtigungsnotizen.
Folgen Sie den Android-Einrichtung Seite für Android-Auto-Kategorie und Manifestnotizen.

Weitermachen von Getting Started

Wenn Sie native Plugin-Arbeit mit Getting Started planen, verbinden Sie es mit Using @capgo/capacitor-auto für die native Fähigkeit in Verwendung von @capgo/capacitor-auto, Capgo-Plugin-Verzeichnis für den Produktworkflow in Capgo-Plugin-Verzeichnis, Capacitor-Plugins von Capgo für die Implementierungsdetail in Capacitor-Plugins von Capgo, Hinzufügen oder Aktualisieren von Plugins für die Implementierungsdetail in Hinzufügen oder Aktualisieren von Plugins, und Ionic Enterprise-Plugin-Alternativen für den Produktworkflow in Ionic Enterprise-Plugin-Alternativen.