Android setup

Android car support uses AndroidX Car App Library and a templated CarAppService.

The plugin ships the service declaration, template capability, and a default Android Auto category so the host can discover it after sync.

Included manifest

The plugin contributes this native service:

<service
  android:name="app.capgo.auto.AutoCarAppService"
  android:exported="true">
  <intent-filter>
    <action android:name="androidx.car.app.CarAppService" />
    <category android:name="androidx.car.app.category.IOT" />
  </intent-filter>
</service>

It also includes:

<automotiveApp>
  <uses name="template" />
</automotiveApp>

Category

The default category is IOT. Your app must qualify for that category before publishing.

If your app belongs to another Android Auto category, override the service declaration in your app manifest and use the category required by Google for your use case.

Sync

npx cap sync android

Behavior

• setRootTemplate updates the Android Auto list screen.
• Android Auto row selection emits carAction to JavaScript.
• Sections are flattened on Android Auto; row title, subtitle, id, and payload are preserved.
• Debug builds allow all hosts; release builds use AndroidX’s sample host allowlist.

Limits

Android Auto does not render your Capacitor WebView. The car host renders approved templates from the AndroidX Car App Library.