大屏用户按应用替换项

Android 提供可用于更改已配置的应用行为的替换项。

设备制造商可以将替换项应用于部分大屏设备上的应用。Android 14 QPR1 引入了用户替换项，让用户能够通过设备设置对应用应用替换项。

按应用替换项旨在改善大屏设备上的用户体验。应用可以停用某些替换项。

如需详细了解按应用替换项，请参阅设备兼容性模式。

注意 ：为了让您的应用能够在不依赖设备制造商或用户替换项的情况下提供最佳用户体验，请遵循大屏设备应用质量指南。

用户替换值

Android 14 QPR1 引入了一个新的配置菜单，让用户能够更改应用的宽高比，以改善应用在大屏设备上的显示方式。此菜单在部分大屏设备的设备设置中实现。

在已实现配置菜单的设备上，用户可以从应用列表中进行选择，然后将应用宽高比设置为各种值，例如 4:3、16:9 和全屏（宽高比值由设备制造商配置）。用户还可以将宽高比重置为应用默认值，即设备制造商按应用替换项指定的值（请参阅 OVERRIDE_MIN_ASPECT_RATIO）；如果未应用替换值或应用已停用替换值，则重置为应用清单中的值。

停用替换项

Android 14 QPR1 支持以下 PackageManager.Property 标记，可让您在已实现替换项的设备上停用或修改宽高比配置菜单：

注意 ：属性标记是 Jetpack WindowManager WindowProperties 常量，可能并非适用于所有设备或在所有设备上都经过测试。

• PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE

  如需停用用户宽高比兼容性替换项，请将该属性添加到应用清单中，并将值设置为 false：

  <application>
      <property
          android:name="android.window.PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE"
          android:value="false"/>
  </application>
  

  在已实现配置菜单的设备上，您的应用会从设备设置中的应用列表中排除；因此，用户无法替换应用的宽高比。

  将该属性设置为 true 不会产生任何影响。

  
  

• PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_FULLSCREEN_OVERRIDE

  如需停用用户宽高比兼容性替换项的全屏选项，请将该属性添加到应用清单中，并将值设置为 false：

  <application>
      <property
          android:name="android.window.PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_FULLSCREEN_OVERRIDE"
          android:value="false"/>
  </application>
  

  在已实现配置菜单的设备上，系统会从设备设置中的宽高比选项列表中移除全屏选项。用户无法将全屏替换项应用于您的应用。

  将此属性设置为 true 不会产生任何影响。

  注意： 如果 PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE 设置为 false，此属性将无效。

注意： 如需实现属性标记，您的应用必须包含 Jetpack WindowManager 库依赖项。

针对大屏设备优化应用：请勿在应用中设置宽高比限制。根据可用的显示空间大小，使用窗口大小类别支持不同的布局。