大屏设备用户按应用替换项

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

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