Android 配置

Android 车载支持采用 AndroidX Car App Library 和模板化 CarAppService.

该插件会发布服务声明、 template 功能以及默认的 Android Auto 分类，以便主机在同步后能够发现它。

包含的清单文件

该插件提供了以下原生服务：

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

它还包含：

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

类别

默认类别为 IOT。您的应用在发布前必须符合该类别要求。

如果您的应用属于其他 Android Auto 类别，请覆盖应用清单中的服务声明，并使用 Google 要求您对应场景的类别。

同步

npx cap sync android

行为

• setRootTemplate 更新 Android Auto 列表界面。
• Android Auto 行选择会触发 carAction 至 JavaScript。
• 在 Android Auto 上，Section 会被扁平化处理；行标题、副标题、id 和 payload 均会被保留。
• Debug 构建允许所有 host；release 构建则使用 AndroidX 的示例 host 白名单。

限制

Android Auto 不会渲染你的 Capacitor WebView。车载 host 会渲染来自 AndroidX Car App Library 的已批准模板。

从 Android 配置继续

如果你正在使用 Android 配置 要规划原生插件工作，请将其与 使用 @capgo/capacitor-auto 用于“使用 @capgo/capacitor-auto”中的原生能力， Capgo 插件目录 查看 Capgo 插件目录中的产品工作流， Capgo 提供的 Capacitor 插件 查看由 Capgo 提供的 Capacitor 插件中的实现细节， 添加或更新插件 关于“添加或更新插件”中的实现细节，以及 Ionic Enterprise 插件替代方案 关于“Ionic Enterprise 插件替代方案”中的产品工作流。