构建适用于 Android Automotive OS 的停车状态下使用的应用

除了支持专为在驾车时使用而构建的应用外，Android Automotive OS 还支持在停车状态下使用的浏览器、游戏和视频应用。您可以像以其他大屏设备为对象那样，面向汽车发布相同的应用，只需进行一些细微更改即可。

Codelab

构建和测试适用于 Android Automotive OS 的停车状态下使用的应用

支持汽车的移动应用

了解您现有的移动应用如何很快符合直接分发到汽车的条件

在 Android Automotive OS 模拟器上测试现有应用

如需开始构建 Android Automotive OS 应用，请先在 Android Automotive OS 模拟器上测试您的现有应用。如需设置模拟器，请按照使用 Android Automotive OS 模拟器进行测试中的步骤操作。然后，您可以按照在模拟器上运行应用中的说明运行该应用。

运行应用时，请注意兼容性问题，例如：

• 信息娱乐屏幕采用固定屏幕方向。为了符合汽车应用质量指南，应用必须同时支持竖屏和横屏方向。
• 适用于其他设备的 API 可能不适用于 Android Automotive OS。例如，某些 Google Play 服务 API 不适用于 Android Automotive OS。如需详细了解如何处理这些问题，请参阅停用功能部分。

配置应用的清单文件

如需以 Android Automotive OS 为目标平台，应用必须具有特定的清单条目。 有了这些条目，您便可以使用单独的 Automotive OS 版本类型将以 Android Automotive OS 为目标平台的应用提交到 Play 商店。我们会对所有这类应用进行人工审核，确保它们在汽车中使用是安全的。 如需了解详情，请参阅分发 Android 汽车应用。

必需的 Android Automotive OS 功能

若要在汽车上的 Play 商店中上架，专为 Android Automotive OS 构建的应用必须在 AndroidManifest.xml 文件中包含以下 <uses-feature> 元素：

<manifest ...>
    ...
    <uses-feature
        android:name="android.hardware.type.automotive"
        android:required="true" />
    ...
</manifest>

提交到非汽车轨道的应用无法声明上一个代码示例中显示的 <uses-feature> 元素，因为它们不能依赖于汽车专用硬件。因此，如需为汽车和非汽车设备提供相同的应用，您需要至少生成两个应用变种：一个用于汽车设备，另一个用于移动设备。如需详细了解如何创建这些单独的变种，请参阅以下文档：

• 配置产品变种
• 管理清单文件

应用的两个变种可以共用相同的软件包名称，但必须采用不同的版本代码，因为它们将分别上传到 Play 商店的不同轨道。

或者，也可以分别针对移动设备和汽车 APK 或 app bundle 使用单独的软件包名称，而不是使用单独的变种。如需了解每种方法的利弊，请参阅媒体应用开发者指南的软件包名称部分。

除了上一个代码示例中显示的元素之外，为 Android Automotive OS 构建的应用还必须在根 <manifest> 元素中包含以下 <uses-feature> 元素：

<uses-feature
  android:name="android.hardware.wifi"
  android:required="false"/>
<uses-feature
  android:name="android.hardware.screen.portrait"
  android:required="false"/>
<uses-feature
  android:name="android.hardware.screen.landscape"
  android:required="false"/>

通过将这些功能明确设置为非必需功能，有助于确保应用不会与 Android Automotive OS 设备中的可用硬件功能发生冲突。

确保没有任何经过防分心优化的 activity

为确保应用只能在停车状态下使用，请勿在清单中的任何 <activity> 元素中添加以下 <meta-data> 元素：

<!-- NOT ALLOWED -->
<meta-data
  android:name="distractionOptimized"
  android:value="true"/>

在没有这项元数据的情况下，当汽车进入驾车模式后，操作系统会自动阻止您应用的 activity，以减少让驾驶员分心的因素。此操作会作为 onPause 生命周期回调发生，在此期间，您必须暂停播放应用中的视频和音频。

重要提示：暂停音频和视频播放是满足汽车应用质量指南的必要条件；如果您向 Play 商店提交应用，我们会根据该指南审核您的应用。

特定于类别的清单条目

除了上述适用于所有停车后应用的要求外， 视频广告和游戏类别还有其他要求：

• 对于视频应用，请参阅将应用标记为视频应用。
• 对于游戏，请参阅将应用标记为游戏。

针对 Android Automotive OS 优化应用

为了尽可能向用户提供最佳体验，请在构建 Android Automotive OS 应用时牢记以下几点。

针对大屏设备进行优化

Android Automotive OS 车辆的现有屏幕在尺寸、分辨率和宽高比方面与平板电脑和可折叠设备（而非手机）更相似。因此，针对大屏设备优化应用对车载用户也大有裨益。

特别值得一提的是，请参阅支持不同的屏幕尺寸和将界面迁移到自适应布局指南以详细了解如何充分利用大显示屏尺寸，并查看媒体库和游戏库以获取设计灵感和指导。

注意： 虽然大屏幕媒体库包含视频和 音频应用，只能按照说明为 Android Automotive OS 构建视频应用 。如需构建适用于 Android Automotive OS 的音频应用，请参阅 构建车载媒体应用。

其他针对大屏设备的优化（例如输入兼容性）对 Android Automotive OS 没有直接益处，但仍然可以改善用户体验。例如，键盘导航会使用旋转导航所用的相同 API，因此通过键盘导航进行的优化对这两种设备规格都有益。

使用窗口边衬区和刘海屏

与其他外形规格的设备一样，Android Automotive OS 也包含系统界面 元素（例如状态栏和导航栏），并且支持非矩形 。

默认情况下，应用会在不与系统栏重叠的区域绘制 或刘海屏不过，您可能希望应用隐藏系统栏， 在背后绘制内容，或者按照说明在刘海屏中显示内容 在窗口边衬区内布置您的应用一文。如果 应用会执行上述任一操作，请参阅以下小节，详细了解 如何让您的应用在 Android Automotive OS 生态系统中正常运行 设备。

注意 ：在 Android 上，导航栏不一定包含返回功能 不支持 Automotive OS 和手势导航。汽车应用质量指南 AN-1 要求您的应用 可供用户导航，而无需提供系统或硬件返回功能。

系统栏、沉浸模式和无边框渲染

汽车中系统栏的尺寸和位置可能与其他界面中不同 设备规格。例如，导航栏可以放置在左侧， 屏幕右侧或底部即使该界面上有一个状态栏 （与大多数手机和移动设备一样） 平板电脑），这些元素在汽车中可能会更大。

此外，Android Automotive OS 允许原始设备制造商 (OEM) 控制是否 应用可以显示或隐藏系统栏以进入和退出沉浸式 模式。例如，通过阻止应用 隐藏系统栏，原始设备制造商 (OEM) 可以确保车辆控件（如空调） 控件，始终可以在屏幕上访问。如果 OEM 已禁止应用 控制系统栏时，应用调用 WindowInsetsController（或 WindowInsetsControllerCompat） 用于显示或隐藏系统栏的 API。请参阅 show 和 hide，详细了解如何检测您的应用能否修改 边衬区。

同样，OEM 也可以控制应用能否设置颜色和 应保持系统栏的半透明状态，以确保栏及其包含的元素 确保内容始终清晰可见如果您的应用在 确认只有非关键内容绘制在系统栏后面。 如果设备 OEM 阻止设置颜色，此内容可能不可见 条形的半透明性

<!-- Depending on OEM configuration, these style declarations
     (and the corresponding runtime calls) may be ignored -->
<style name="...">
  <item name="android:statusBarColor">...</item>
  <item name="android:navigationBarColor">...</item>
  <item name="android:windowTranslucentStatus">...</item>
  <item name="android:windowTranslucentNavigation">...</status>
</style>

如果您的应用采用全屏，请不要对尺寸、数量、 类型或位置。而是使用窗口边衬区 API 来设置布局 应用内容相对于系统栏的位置。请参阅 在应用中全屏显示内容 了解如何使用这些 API。硬编码填充值， 可能 在汽车上无法做到的

提示： 如需详细了解如何测试应用如何处理这些不同的 请参阅使用可配置的模拟器进行测试。

适应不规则形状的显示屏

除矩形显示屏外，某些车辆可能具有不规则形状 如图 1 所示：

<ph type="x-smartling-placeholder">

</ph> <ph type="x-smartling-placeholder">

</ph> 图 1：配有 形成一个弧形绿色区域是安全矩形， 与曲线刘海屏的边界框重叠。

如果您的应用无法全屏呈现，则无需执行任何操作。 以便在安全区域内呈现

如果您的应用采用全屏呈现，您可以选择希望采用的 与刘海屏的区别为此，您可以使用 方法是设置 android:windowLayoutInDisplayCutoutMode 属性。 修改窗口的 layoutInDisplayCutoutMode 属性。

因为 Android Automotive OS 设备上存在的刘海屏类型 不同于移动设备，请不要使用 LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT 或 LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES， 这种广告的行为针对移动设备上的刘海屏进行了优化。相反， 使用LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER 或 LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS 应始终避免或始终进入刘海屏如果选择后者 如需了解详情，请参阅支持刘海屏 与刘海屏相关的 API 的详细信息。

如果您的应用会呈现在刘海屏区域，并且您希望 Android Automotive OS 与移动设备之间的行为差异，请参阅 如果您的应用设置了此政策，请停用功能以获得相关指导 以及使用备用资源（如果您的 应用使用资源文件设置此行为。

提示： 如需详细了解如何测试应用如何处理刘海屏，请参阅 使用可配置的模拟器进行测试。

停用功能

如果您要将现有移动应用提供给 Android Automotive OS，某些特性和功能可能不相关或不可用。例如，汽车通常不提供对摄像头的访问权限。此外，只有部分 Google Play 服务适用于 Android Automotive OS；如需了解详情，请参阅适用于汽车的 Google Play 服务。

您可以使用 PackageManager.hasSystemFeature API，通过检查有无 FEATURE_AUTOMOTIVE 功能来检测应用是否正在 Android Automotive OS 上运行，如以下示例所示：

Kotlin

val packageManager: PackageManager = ... // Get a PackageManager from a Context
val isCar = packageManager.hasSystemFeature(PackageManager.FEATURE_AUTOMOTIVE)
if (isCar) {
  // Enable or disable a given feature
}

Java

PackageManager packageManager = ... // Get a PackageManager from a Context
boolean isCar = packageManager.hasSystemFeature(PackageManager.FEATURE_AUTOMOTIVE)
if (isCar) {
  // Enable or disable a given feature
}

或者，如果您的应用还包含 Android Auto 组件，您可以使用 Android for Cars 应用库中的 CarConnection API 来检测应用是在 Android Automotive OS 或 Android Auto 上运行，还是根本未关联到汽车。

对于画中画 (PiP) 功能，请遵循既有的最佳实践来检查该功能是否可用并做出适当的回应。

处理离线场景

尽管汽车的联网程度越来越高，但我们建议应用具备在没有互联网连接的情况下处理运行的能力，例如以下情况：

• 用户可能会选择停用汽车制造商提供的订阅套餐中的移动流量服务。
• 在某些区域，使用移动流量可能会受到限制。
• 配有 Wi-Fi 无线装置的汽车可能不在 Wi-Fi 覆盖范围内，或者原始设备制造商 (OEM) 可能会停用 Wi-Fi，改为使用移动网络。

请优雅降级依赖于访问互联网的功能（例如提供离线内容），准备好在您的应用中处理这些场景。如需了解详情，请参阅网络优化最佳实践。

使用备用资源

为了有助于您的应用在汽车上运行，当在 Android Automotive OS 车辆上运行时，您可以使用 car 资源限定符提供备用资源。例如，如果您使用尺寸资源来存储内边距值，则可以为 car 资源集使用较大的值，以增大触摸目标。

重要提示：当 UiModeManager.getCurrentModeType() 返回的模式为 UI_MODE_TYPE_CAR 时，系统会匹配 car 资源限定符。在 Android Automotive OS 中，情况始终如此；但在其他设备上，这种情况偶尔也会出现（例如，当应用自行调用 UiModeManager.enableCarMode() 时）。

分发您的应用

根据应用所属类别的汽车应用质量指南测试您的应用、为其构建 Android Automotive OS build，并针对所属类别完成所有必要更改后，接下来便可将应用发布到 Play 商店的 Automotive OS 设备规格轨道。如需详细了解发布流程，请参阅分发 Android 汽车应用。

重要提示：为确保用户在运用停车状态下使用的应用时获得良好体验，Google 与 OEM 合作，修复会对在停车状态下使用的应用的使用体验产生负面影响的系统问题。作为这项合作的一部分，Play 商店中内置了额外的过滤机制，以防止将停车状态下使用的应用分发到缺少必要修复程序的设备。如果您的应用与某设备在其他方面兼容，这可能会导致该应用无法安装在相应设备上。

针对在停车状态下使用的应用提供反馈

如果您在针对 Android Automotive OS 开发在停车状态下使用的应用时遇到问题或有功能请求，可以使用 Google 问题跟踪器报告该问题。确保在问题模板中填写所需的所有信息。在提交新问题之前，请先查看问题列表，确认该问题是否已报告过。您可以在跟踪器中点击某个问题的星标，订阅该问题并为其投票。如需了解详情，请参阅订阅问题。

创建新问题