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

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

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