跳转到正文

Android 配置

GitHub

Android 车机支持使用 AndroidX Car App Library 和模板化的 CarAppService.

插件自带服务声明, template capability,以及默认的 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 类别,请在应用 manifest 中覆盖服务声明,并使用 Google 针对您的用例要求的类别。

终端窗口
npx cap sync android
  • setRootTemplate 更新 Android Auto 列表屏幕。
  • Android Auto 行选择会发出 carAction 到 JavaScript。
  • 在 Android Auto 上,章节会被扁平化;行标题、副标题、id 和 payload 均会保留。
  • Debug 构建允许所有主机;Release 构建使用 AndroidX 的示例主机白名单。

Android Auto 不会渲染您的 Capacitor WebView。车载主机将渲染来自 AndroidX Car App Library 的已批准模板。

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