大屏用户按应用替换项

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 库依赖项。

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