Large screen device manufacturer per-app overrides

Android provides overrides that change the configured behavior of apps. For example, the FORCE_RESIZE_APP override instructs the system to resize the app to fit display dimensions even if resizeableActivity="false" is set in the app manifest.

Device manufacturers apply overrides to apps on select large screen devices.

Per-app overrides are intended to improve the user experience on large screen devices. Apps can disable some overrides.

For more information about per-app overrides, see Large screen compatibility mode.

Device manufacturer overrides

Device manufacturers apply overrides to apps to improve the user experience on tablets, foldables, and other large screen devices. For a complete list of overrides, see Large screen compatibility mode

Disable the overrides

PackageManager.Property tags enable apps to disable device manufacturer overrides. Android 14 introduces the following tags:

• PROPERTY_COMPAT_ALLOW_RESIZEABLE_ACTIVITY_OVERRIDES

  To disable the FORCE_RESIZE_APP and FORCE_NON_RESIZE_APP overrides, set the property to false in your app manifest:

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

  Optimize your app for large screens: Make your app resizable and implement responsive/adaptive layouts for an optimal user experience on displays of all sizes.

  
  

• PROPERTY_COMPAT_ALLOW_MIN_ASPECT_RATIO_OVERRIDE

  To disable OVERRIDE_MIN_ASPECT_RATIO, set the property to false in your app manifest:

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

  The property also disables the following device manufacturer overrides:

  • OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY: Restricts configurations that force a given minimum aspect ratio for activities with portrait‑only orientation.
  • OVERRIDE_MIN_ASPECT_RATIO_MEDIUM: Sets the activity's minimum aspect ratio to a medium value (3:2).
  • OVERRIDE_MIN_ASPECT_RATIO_LARGE: Sets the activity's minimum aspect ratio to a large value (16:9).
  • OVERRIDE_MIN_ASPECT_RATIO_TO_ALIGN_WITH_SPLIT_SCREEN: Enables the use of split‑screen aspect ratio. Allows an app to use all the available space in split‑screen mode, avoiding letterboxing.
  • OVERRIDE_MIN_ASPECT_RATIO_EXCLUDE_PORTRAIT_FULLSCREEN: Disables the minimum aspect ratio override in portrait full screen to use all available screen space.

  Optimize your app for large screens: Don't set aspect ratio restrictions in your app. Create app layouts that support different screen sizes and multi‑window mode.