Getting Started

Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo 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.

Installazione

Puoi utilizzare la nostra configurazione assistita dall'IA per installare il plugin. Aggiungi le Capgo competenze al tuo strumento di AI utilizzando il seguente comando:

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

Usa poi la seguente riga di comando:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-auto` plugin in my project.

Se preferisci l'installazione manuale, installa il plugin eseguendo i seguenti comandi e segui le istruzioni specifiche per la piattaforma riportate di seguito:

Installa il pacchetto
Finestra del terminale
```
npm i @capgo/capacitor-auto
```
Sincronizza progetti nativi
Finestra del terminale
```
npx cap sync
```

Imposta il modello root car

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

Gestisci azioni del veicolo

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

Segui lo stato di connessione

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

Stato vuoto

Imposta emptyText quando il template non ha righe:

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

Invia messaggi del ponte

Usa sendMessage per messaggi del ponte definiti dall'applicazione:

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

Configurazione della piattaforma

Segui le iOS setup pagina per note sullo scenario di CarPlay e le autorizzazioni.
Segui le Configurazione Android pagina per la categoria Android Auto e note sul manifesto.

Keep going from Getting Started

Se stai utilizzando Getting Started per pianificare il lavoro di plugin nativo, connettilo con Utilizza @capgo/capacitor-auto per la capacità nativa in Utilizza @capgo/capacitor-auto, Directory dei plugin Capgo per il workflow del prodotto nella Capgo Directory dei Plugin Plugin Capacitor di Capgo per i dettagli di implementazione in Capacitor Plugin da Capgo Aggiungere o aggiornare Plugin per i dettagli di implementazione in Aggiungere o Aggiornare Plugin, e Alternative Plugin per l'Impresa Ionic per il workflow del prodotto in Alternative Plugin per l'Impresa Ionic.