Zum Inhalt springen

Erste Schritte

GitHub

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:

Terminalfenster
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Nutze 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:

  1. Paket installieren

    Terminalfenster
    npm i @capgo/capacitor-auto
  2. Native Projekte synchronisieren

    Terminalfenster
    npx cap sync
  3. 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' },
    },
    ],
    },
    ],
    });
  4. Car-Aktionen verarbeiten

    await Auto.addListener('carAction', async (event) => {
    if (event.id === 'open-main-door') {
    await openGarageDoor(event.payload?.doorId);
    }
    });
  5. 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);
    });
import { Auto } from '@capgo/capacitor-auto';
const result = await Auto.isAvailable();
console.log(result);
import { Auto } from '@capgo/capacitor-auto';
await Auto.setRootTemplate({
title: 'Hello from Capacitor',
sections: [
{
items: [
{
id: 'id-123',
title: 'Hello from Capacitor',
},
],
},
],
});
import { Auto } from '@capgo/capacitor-auto';
await Auto.setState({
key: 'key-123',
value: {},
});
  • Listener: Handles beim Unmounten von Screens entfernen.
  • Nativer Sync: ausführen npx cap sync nach Plugin-Upgrades.
  • Single Source of Truth: Vertrauen src/definitions.ts im GitHub Repo.

Setzen Sie emptyText wenn die Vorlage keine Zeilen enthält:

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

Nutzt sendMessage für von der App definierte native Bridge-Nachrichten:

await Auto.sendMessage({
type: 'status',
payload: { online: true },
});
  • 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.

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.