按应用替换大屏设备用户

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

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