Getting Started

Instalación

Puede utilizar nuestra configuración asistida por IA para instalar el plugin. Agregue las Capgo habilidades a su herramienta de IA utilizando el siguiente comando:

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

Luego utilice la siguiente solicitud:

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

Si prefiere la configuración manual, instale el complemento ejecutando los siguientes comandos y siga las instrucciones específicas de la plataforma a continuación:

1. Instalar el paquete

   npm i @capgo/capacitor-auto

2. Sincronizar proyectos nativos

   npx cap sync

3. Establecer la plantilla de automóvil raíz

   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. Administrar acciones de automóvil

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

5. Seguir el estado de conexión

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

Los UI de automóvil están controlados por políticas

CarPlay y Android Auto no permiten reflejar WebView arbitrario. Mantenga las acciones de automóvil cortas, seguras para el conductor y alineadas con la categoría de la aplicación aprobada por Apple o Google.

Estado vacío

Set emptyText cuando el template no tiene filas:

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

Enviar mensajes de puente

Usar sendMessage para mensajes de puente definidos por la aplicación:

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

Configuración de plataforma

• Siga las iOS setup página para notas de escenario de CarPlay y permisos.
• Sigue los Configuración de Android página para la categoría y notas de manifest de Android Auto.

Sigue adelante desde Getting Started

Si estás utilizando Getting Started para planificar el trabajo de plugin nativo, conecta con Usando @capgo/capacitor-auto para la capacidad nativa en Usando @capgo/capacitor-auto, Capgo Directorio de Plugin para el flujo de trabajo del producto en Capgo Directorio de Plugin, Capacitor Plugins por Capgo para el detalle de implementación en Capacitor Plugins por Capgo Agregar o Actualizar Plugins para el detalle de implementación en Agregar o Actualizar Plugins, y Alternativas de Plugins de Ionic Enterprise para el flujo de trabajo del producto en Ionic Enterprise Plugin Alternativas.