Loading core/java/android/app/Activity.java +6 −0 Original line number Diff line number Diff line Loading @@ -7555,6 +7555,12 @@ public class Activity extends ContextThemeWrapper * the activity to be restarted). Otherwise, this will be used the next * time the activity is visible. * * <aside class="note"><b>Note:</b> Device manufacturers can configure devices to override * (ignore) calls to this method to improve the layout of orientation-restricted apps. See * <a href="{@docRoot}guide/practices/device-compatibility-mode"> * Device compatibility mode</a>. * </aside> * * @param requestedOrientation An orientation constant as used in * {@link ActivityInfo#screenOrientation ActivityInfo.screenOrientation}. */ Loading core/java/android/view/WindowManager.java +48 −53 Original line number Diff line number Diff line Loading @@ -963,7 +963,7 @@ public interface WindowManager extends ViewManager { * true: * <ul> * <li>Activity has requested orientation more than two times within one-second timer * <li>Activity is not letterboxed for fixed orientation * <li>Activity is not letterboxed for fixed-orientation apps * </ul> * * <p>Setting this property to {@code false} informs the system that the app must be Loading Loading @@ -1055,22 +1055,22 @@ public interface WindowManager extends ViewManager { * for an app to inform the system that the app should be excluded from the camera compatibility * force rotation treatment. * * <p>The camera compatibility treatment aligns orientations of portrait app window and natural * orientation of the device and set opposite to natural orientation for a landscape app * window. Mismatch between them can lead to camera issues like sideways or stretched * <p>The camera compatibility treatment aligns portrait app windows with the natural * orientation of the device and landscape app windows opposite the device natural orientation. * Mismatch between the orientations can lead to camera issues like a sideways or stretched * viewfinder since this is one of the strongest assumptions that apps make when they implement * camera previews. Since app and natural display orientations aren't guaranteed to match, the * rotation can cause letterboxing. The forced rotation is triggered as soon as app opens to * camera previews. Since app and device natural orientations aren't guaranteed to match, the * rotation can cause letterboxing. The forced rotation is triggered as soon as an app opens the * camera and is removed once camera is closed. * * <p>The camera compatibility can be enabled by device manufacturers on displays that have the * ignore requested orientation display setting enabled (enables compatibility mode for fixed * orientation on Android 12 (API level 31) or higher; see * <a href="https://developer.android.com/guide/practices/enhanced-letterboxing">Enhanced * letterboxing</a> for more details). * <p>Camera compatibility can be enabled by device manufacturers on displays that have the * ignore requested orientation display setting enabled, which enables compatibility mode for * fixed-orientation apps on Android 12 (API level 31) or higher. See * <a href="{@docRoot}guide/practices/device-compatibility-mode">Device compatibility mode</a> * for more details. * * <p>With this property set to {@code true} or unset, the system may apply the force rotation * treatment to fixed orientation activities. Device manufacturers can exclude packages from the * treatment to fixed-orientation activities. Device manufacturers can exclude packages from the * treatment using their discretion to improve display compatibility. * * <p>With this property set to {@code false}, the system will not apply the force rotation Loading @@ -1093,12 +1093,12 @@ public interface WindowManager extends ViewManager { * for an app to inform the system that the app should be excluded from the activity "refresh" * after the camera compatibility force rotation treatment. * * <p>The camera compatibility treatment aligns orientations of portrait app window and natural * orientation of the device and set opposite to natural orientation for a landscape app * window. Mismatch between them can lead to camera issues like sideways or stretched * <p>The camera compatibility treatment aligns portrait app windows with the natural * orientation of the device and landscape app windows opposite the device natural orientation. * Mismatch between the orientations can lead to camera issues like a sideways or stretched * viewfinder since this is one of the strongest assumptions that apps make when they implement * camera previews. Since app and natural display orientations aren't guaranteed to match, the * rotation can cause letterboxing. The forced rotation is triggered as soon as app opens to * camera previews. Since app and device natural orientations aren't guaranteed to match, the * rotation can cause letterboxing. The forced rotation is triggered as soon as an app opens the * camera and is removed once camera is closed. * * <p>Force rotation is followed by the "Refresh" of the activity by going through "resumed -> Loading @@ -1109,10 +1109,10 @@ public interface WindowManager extends ViewManager { * rotation. * * <p>The camera compatibility can be enabled by device manufacturers on displays that have the * ignore requested orientation display setting enabled (enables compatibility mode for fixed * orientation on Android 12 (API level 31) or higher; see * <a href="https://developer.android.com/guide/practices/enhanced-letterboxing">Enhanced * letterboxing</a> for more details). * ignore requested orientation display setting enabled, which enables compatibility mode for * fixed-orientation apps on Android 12 (API level 31) or higher. See * <a href="{@docRoot}guide/practices/device-compatibility-mode">Device compatibility mode</a> * for more details. * * <p>With this property set to {@code true} or unset, the system may "refresh" activity after * the force rotation treatment. Device manufacturers can exclude packages from the "refresh" Loading Loading @@ -1140,12 +1140,11 @@ public interface WindowManager extends ViewManager { * "stopped -> resumed". * * <p>The camera compatibility treatment aligns orientations of portrait app window and natural * orientation of the device and set opposite to natural orientation for a landscape app * window. Mismatch between them can lead to camera issues like sideways or stretched * viewfinder since this is one of the strongest assumptions that apps make when they implement * camera previews. Since app and natural display orientations aren't guaranteed to match, the * rotation can cause letterboxing. The forced rotation is triggered as soon as app opens to * camera and is removed once camera is closed. * orientation of the device. Mismatch between the orientations can lead to camera issues like a * sideways or stretched viewfinder since this is one of the strongest assumptions that apps * make when they implement camera previews. Since app and natural display orientations aren't * guaranteed to match, the rotation can cause letterboxing. The forced rotation is triggered as * soon as app opens the camera and is removed once camera is closed. * * <p>Force rotation is followed by the "Refresh" of the activity by going through "resumed -> * ... -> stopped -> ... -> resumed" cycle (by default) or "resumed -> paused -> resumed" cycle Loading @@ -1154,10 +1153,10 @@ public interface WindowManager extends ViewManager { * to sideways or stretching issues persisting even after force rotation. * * <p>The camera compatibility can be enabled by device manufacturers on displays that have the * ignore requested orientation display setting enabled (enables compatibility mode for fixed * orientation on Android 12 (API level 31) or higher; see * <a href="https://developer.android.com/guide/practices/enhanced-letterboxing">Enhanced * letterboxing</a> for more details). * ignore requested orientation display setting enabled, which enables compatibility mode for * fixed-orientation apps on Android 12 (API level 31) or higher. See * <a href="{@docRoot}guide/practices/device-compatibility-mode">Device compatibility mode</a> * for more details. * * <p>Device manufacturers can override packages to "refresh" via "resumed -> paused -> resumed" * cycle using their discretion to improve display compatibility. Loading Loading @@ -1203,7 +1202,7 @@ public interface WindowManager extends ViewManager { * <p>With this property set to {@code true} or unset, device manufacturers can override * orientation for the app using their discretion to improve display compatibility. * * <p>With this property set to {@code false}, device manufactured per-app override for * <p>With this property set to {@code false}, device manufacturer per-app override for * orientation won't be applied. * * <p><b>Syntax:</b> Loading @@ -1227,15 +1226,15 @@ public interface WindowManager extends ViewManager { * <p>When this compat override is enabled and while display is fixed to the landscape natural * orientation, the orientation requested by the activity will be still respected by bounds * resolution logic. For instance, if an activity requests portrait orientation, then activity * will appear in the letterbox mode for fixed orientation with the display rotated to the * lanscape natural orientation. * appears in letterbox mode for fixed-orientation apps with the display rotated to the lanscape * natural orientation. * * <p>The treatment is disabled by default but device manufacturers can enable the treatment * using their discretion to improve display compatibility on displays that have the ignore * orientation request display setting enabled by OEMs on the device (enables compatibility mode * for fixed orientation on Android 12 (API level 31) or higher; see * <a href="https://developer.android.com/guide/practices/enhanced-letterboxing">Enhanced * letterboxing</a> for more details). * orientation request display setting enabled by OEMs on the device, which enables * compatibility mode for fixed-orientation apps on Android 12 (API level 31) or higher. See * <a href="{@docRoot}guide/practices/device-compatibility-mode">Device compatibility mode</a> * for more details. * * <p>With this property set to {@code true} or unset, the system wiil use landscape display * orientation when the following conditions are met: Loading @@ -1246,7 +1245,7 @@ public interface WindowManager extends ViewManager { * <li>Device manufacturer enabled the treatment. * </ul> * * <p>With this property set to {@code false}, device manufactured per-app override for * <p>With this property set to {@code false}, device manufacturer per-app override for * display orientation won't be applied. * * <p><b>Syntax:</b> Loading Loading @@ -1344,13 +1343,11 @@ public interface WindowManager extends ViewManager { * see {@link #PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_FULLSCREEN_OVERRIDE} to * disable the full-screen option only. * * <p>The user override is intended to improve the app experience on devices * that have the ignore orientation request display setting enabled by OEMs * (enables compatibility mode for fixed orientation on Android 12 (API * level 31) or higher; see * <a href="https://developer.android.com/guide/topics/large-screens/large-screen-compatibility-mode"> * Large screen compatibility mode</a> * for more details). * <p>The user override is intended to improve the app experience on devices that have the * ignore orientation request display setting enabled by OEMs, which enables compatibility mode * for fixed-orientation apps on Android 12 (API level 31) or higher. See * <a href="{@docRoot}guide/practices/device-compatibility-mode">Device compatibility mode</a> * for more details. * * <p>To opt out of the user aspect ratio compatibility override, add this property * to your app manifest and set the value to {@code false}. Your app will be excluded Loading Loading @@ -1383,13 +1380,11 @@ public interface WindowManager extends ViewManager { * <p>When users apply the full-screen compatibility override, the orientation * of the activity is forced to {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_USER}. * * <p>The user override is intended to improve the app experience on devices * that have the ignore orientation request display setting enabled by OEMs * (enables compatibility mode for fixed orientation on Android 12 (API * level 31) or higher; see * <a href="https://developer.android.com/guide/topics/large-screens/large-screen-compatibility-mode"> * Large screen compatibility mode</a> * for more details). * <p>The user override is intended to improve the app experience on devices that have the * ignore orientation request display setting enabled by OEMs, which enables compatibility mode * for fixed-orientation apps on Android 12 (API level 31) or higher. See * <a href="{@docRoot}guide/practices/device-compatibility-mode">Device compatibility mode</a> * for more details. * * <p>To opt out of the full-screen option of the user aspect ratio compatibility * override, add this property to your app manifest and set the value to {@code false}. Loading core/res/res/values/attrs_manifest.xml +44 −19 Original line number Diff line number Diff line Loading @@ -851,7 +851,12 @@ of the screen. <p>This attribute is supported by the <a href="{@docRoot}guide/topics/manifest/activity-element.html">{@code <activity>}</a> element. --> element. <aside class="note"><b>Note:</b> Device manufacturers can configure devices to override (ignore) this attribute to improve the layout of apps. See <a href="{@docRoot}guide/practices/device-compatibility-mode"> Device compatibility mode</a>. </aside> --> <attr name="screenOrientation"> <!-- No preference specified: let the system decide the best orientation. This will either be the orientation selected Loading Loading @@ -1447,13 +1452,23 @@ no other apps in multi-window visible on screen (e.g. picture-in-picture) or on other displays. Therefore, this flag cannot be used to assure an exclusive resource access. <p>NOTE: A task's root activity value is applied to all additional activities launched in <p>A task's root activity value is applied to all additional activities launched in the task. That is if the root activity of a task is resizeable then the system will treat all other activities in the task as resizeable and will not if the root activity isn't resizeable. <p>NOTE: The value of {@link android.R.attr#screenOrientation} is ignored for resizeable activities when in multi-window mode before Android 12. --> <aside class="note"><b>Note:</b> <ul> <li>On Android 11 (API level 30) and lower, the value of {@link android.R.attr#screenOrientation} is ignored for resizeable activities in multi-window mode. <li>Device manufacturers can configure devices to override (ignore) this attribute to force apps to resize. The override does not affect the app's support for multi-window mode. See <a href="{@docRoot}guide/practices/device-compatibility-mode"> Device compatibility mode</a>. </ul> </aside> --> <attr name="resizeableActivity" format="boolean" /> <!-- Indicates that the activity specifically supports the picture-in-picture form of Loading @@ -1470,27 +1485,37 @@ <!-- This value indicates the maximum aspect ratio the activity supports. If the app runs on a device with a wider aspect ratio, the system automatically letterboxes the app, leaving portions of the screen unused so the app can run at its specified maximum aspect ratio. <p> Maximum aspect ratio, expressed as (longer dimension / shorter dimension) in decimal <p>Maximum aspect ratio, expressed as (longer dimension / shorter dimension) in decimal form. For example, if the maximum aspect ratio is 7:3, set value to 2.33. <p> Value needs to be greater or equal to 1.0, otherwise it is ignored. <p> NOTE: This attribute is ignored if the activity has {@link android.R.attr#resizeableActivity} set to true. --> <p>Value needs to be greater or equal to 1.0, otherwise it is ignored. <aside class="note"><b>Note:</b> <ul> <li>This attribute is ignored if the activity has {@link android.R.attr#resizeableActivity} set to {@code true}. <li>Device manufacturers can configure devices to override (ignore) this attribute to improve the layout of apps. See <a href="{@docRoot}guide/practices/device-compatibility-mode"> Device compatibility mode</a>. </ul> </aside> --> <attr name="maxAspectRatio" format="float" /> <!-- This value indicates the minimum aspect ratio the activity supports. If the app runs on a device with a narrower aspect ratio, the system automatically letterboxes the app, leaving portions of the screen unused so the app can run at its specified minimum aspect ratio. <p> Minimum aspect ratio, expressed as (longer dimension / shorter dimension) in decimal <p>Minimum aspect ratio, expressed as (longer dimension / shorter dimension) in decimal form. For example, if the minimum aspect ratio is 4:3, set value to 1.33. <p> Value needs to be greater or equal to 1.0, otherwise it is ignored. <p> NOTE: This attribute is ignored if the activity has {@link android.R.attr#resizeableActivity} set to true. --> <p>Value needs to be greater or equal to 1.0, otherwise it is ignored. <aside class="note"><b>Note:</b> <ul> <li>This attribute is ignored if the activity has {@link android.R.attr#resizeableActivity} set to {@code true}. <li>Device manufacturers can configure devices to override (ignore) this attribute to improve the layout of apps. See <a href="{@docRoot}guide/practices/device-compatibility-mode"> Device compatibility mode</a>. </ul> </aside> --> <attr name="minAspectRatio" format="float" /> <!-- This value indicates how tasks rooted at this activity will behave in lockTask mode. Loading Loading
core/java/android/app/Activity.java +6 −0 Original line number Diff line number Diff line Loading @@ -7555,6 +7555,12 @@ public class Activity extends ContextThemeWrapper * the activity to be restarted). Otherwise, this will be used the next * time the activity is visible. * * <aside class="note"><b>Note:</b> Device manufacturers can configure devices to override * (ignore) calls to this method to improve the layout of orientation-restricted apps. See * <a href="{@docRoot}guide/practices/device-compatibility-mode"> * Device compatibility mode</a>. * </aside> * * @param requestedOrientation An orientation constant as used in * {@link ActivityInfo#screenOrientation ActivityInfo.screenOrientation}. */ Loading
core/java/android/view/WindowManager.java +48 −53 Original line number Diff line number Diff line Loading @@ -963,7 +963,7 @@ public interface WindowManager extends ViewManager { * true: * <ul> * <li>Activity has requested orientation more than two times within one-second timer * <li>Activity is not letterboxed for fixed orientation * <li>Activity is not letterboxed for fixed-orientation apps * </ul> * * <p>Setting this property to {@code false} informs the system that the app must be Loading Loading @@ -1055,22 +1055,22 @@ public interface WindowManager extends ViewManager { * for an app to inform the system that the app should be excluded from the camera compatibility * force rotation treatment. * * <p>The camera compatibility treatment aligns orientations of portrait app window and natural * orientation of the device and set opposite to natural orientation for a landscape app * window. Mismatch between them can lead to camera issues like sideways or stretched * <p>The camera compatibility treatment aligns portrait app windows with the natural * orientation of the device and landscape app windows opposite the device natural orientation. * Mismatch between the orientations can lead to camera issues like a sideways or stretched * viewfinder since this is one of the strongest assumptions that apps make when they implement * camera previews. Since app and natural display orientations aren't guaranteed to match, the * rotation can cause letterboxing. The forced rotation is triggered as soon as app opens to * camera previews. Since app and device natural orientations aren't guaranteed to match, the * rotation can cause letterboxing. The forced rotation is triggered as soon as an app opens the * camera and is removed once camera is closed. * * <p>The camera compatibility can be enabled by device manufacturers on displays that have the * ignore requested orientation display setting enabled (enables compatibility mode for fixed * orientation on Android 12 (API level 31) or higher; see * <a href="https://developer.android.com/guide/practices/enhanced-letterboxing">Enhanced * letterboxing</a> for more details). * <p>Camera compatibility can be enabled by device manufacturers on displays that have the * ignore requested orientation display setting enabled, which enables compatibility mode for * fixed-orientation apps on Android 12 (API level 31) or higher. See * <a href="{@docRoot}guide/practices/device-compatibility-mode">Device compatibility mode</a> * for more details. * * <p>With this property set to {@code true} or unset, the system may apply the force rotation * treatment to fixed orientation activities. Device manufacturers can exclude packages from the * treatment to fixed-orientation activities. Device manufacturers can exclude packages from the * treatment using their discretion to improve display compatibility. * * <p>With this property set to {@code false}, the system will not apply the force rotation Loading @@ -1093,12 +1093,12 @@ public interface WindowManager extends ViewManager { * for an app to inform the system that the app should be excluded from the activity "refresh" * after the camera compatibility force rotation treatment. * * <p>The camera compatibility treatment aligns orientations of portrait app window and natural * orientation of the device and set opposite to natural orientation for a landscape app * window. Mismatch between them can lead to camera issues like sideways or stretched * <p>The camera compatibility treatment aligns portrait app windows with the natural * orientation of the device and landscape app windows opposite the device natural orientation. * Mismatch between the orientations can lead to camera issues like a sideways or stretched * viewfinder since this is one of the strongest assumptions that apps make when they implement * camera previews. Since app and natural display orientations aren't guaranteed to match, the * rotation can cause letterboxing. The forced rotation is triggered as soon as app opens to * camera previews. Since app and device natural orientations aren't guaranteed to match, the * rotation can cause letterboxing. The forced rotation is triggered as soon as an app opens the * camera and is removed once camera is closed. * * <p>Force rotation is followed by the "Refresh" of the activity by going through "resumed -> Loading @@ -1109,10 +1109,10 @@ public interface WindowManager extends ViewManager { * rotation. * * <p>The camera compatibility can be enabled by device manufacturers on displays that have the * ignore requested orientation display setting enabled (enables compatibility mode for fixed * orientation on Android 12 (API level 31) or higher; see * <a href="https://developer.android.com/guide/practices/enhanced-letterboxing">Enhanced * letterboxing</a> for more details). * ignore requested orientation display setting enabled, which enables compatibility mode for * fixed-orientation apps on Android 12 (API level 31) or higher. See * <a href="{@docRoot}guide/practices/device-compatibility-mode">Device compatibility mode</a> * for more details. * * <p>With this property set to {@code true} or unset, the system may "refresh" activity after * the force rotation treatment. Device manufacturers can exclude packages from the "refresh" Loading Loading @@ -1140,12 +1140,11 @@ public interface WindowManager extends ViewManager { * "stopped -> resumed". * * <p>The camera compatibility treatment aligns orientations of portrait app window and natural * orientation of the device and set opposite to natural orientation for a landscape app * window. Mismatch between them can lead to camera issues like sideways or stretched * viewfinder since this is one of the strongest assumptions that apps make when they implement * camera previews. Since app and natural display orientations aren't guaranteed to match, the * rotation can cause letterboxing. The forced rotation is triggered as soon as app opens to * camera and is removed once camera is closed. * orientation of the device. Mismatch between the orientations can lead to camera issues like a * sideways or stretched viewfinder since this is one of the strongest assumptions that apps * make when they implement camera previews. Since app and natural display orientations aren't * guaranteed to match, the rotation can cause letterboxing. The forced rotation is triggered as * soon as app opens the camera and is removed once camera is closed. * * <p>Force rotation is followed by the "Refresh" of the activity by going through "resumed -> * ... -> stopped -> ... -> resumed" cycle (by default) or "resumed -> paused -> resumed" cycle Loading @@ -1154,10 +1153,10 @@ public interface WindowManager extends ViewManager { * to sideways or stretching issues persisting even after force rotation. * * <p>The camera compatibility can be enabled by device manufacturers on displays that have the * ignore requested orientation display setting enabled (enables compatibility mode for fixed * orientation on Android 12 (API level 31) or higher; see * <a href="https://developer.android.com/guide/practices/enhanced-letterboxing">Enhanced * letterboxing</a> for more details). * ignore requested orientation display setting enabled, which enables compatibility mode for * fixed-orientation apps on Android 12 (API level 31) or higher. See * <a href="{@docRoot}guide/practices/device-compatibility-mode">Device compatibility mode</a> * for more details. * * <p>Device manufacturers can override packages to "refresh" via "resumed -> paused -> resumed" * cycle using their discretion to improve display compatibility. Loading Loading @@ -1203,7 +1202,7 @@ public interface WindowManager extends ViewManager { * <p>With this property set to {@code true} or unset, device manufacturers can override * orientation for the app using their discretion to improve display compatibility. * * <p>With this property set to {@code false}, device manufactured per-app override for * <p>With this property set to {@code false}, device manufacturer per-app override for * orientation won't be applied. * * <p><b>Syntax:</b> Loading @@ -1227,15 +1226,15 @@ public interface WindowManager extends ViewManager { * <p>When this compat override is enabled and while display is fixed to the landscape natural * orientation, the orientation requested by the activity will be still respected by bounds * resolution logic. For instance, if an activity requests portrait orientation, then activity * will appear in the letterbox mode for fixed orientation with the display rotated to the * lanscape natural orientation. * appears in letterbox mode for fixed-orientation apps with the display rotated to the lanscape * natural orientation. * * <p>The treatment is disabled by default but device manufacturers can enable the treatment * using their discretion to improve display compatibility on displays that have the ignore * orientation request display setting enabled by OEMs on the device (enables compatibility mode * for fixed orientation on Android 12 (API level 31) or higher; see * <a href="https://developer.android.com/guide/practices/enhanced-letterboxing">Enhanced * letterboxing</a> for more details). * orientation request display setting enabled by OEMs on the device, which enables * compatibility mode for fixed-orientation apps on Android 12 (API level 31) or higher. See * <a href="{@docRoot}guide/practices/device-compatibility-mode">Device compatibility mode</a> * for more details. * * <p>With this property set to {@code true} or unset, the system wiil use landscape display * orientation when the following conditions are met: Loading @@ -1246,7 +1245,7 @@ public interface WindowManager extends ViewManager { * <li>Device manufacturer enabled the treatment. * </ul> * * <p>With this property set to {@code false}, device manufactured per-app override for * <p>With this property set to {@code false}, device manufacturer per-app override for * display orientation won't be applied. * * <p><b>Syntax:</b> Loading Loading @@ -1344,13 +1343,11 @@ public interface WindowManager extends ViewManager { * see {@link #PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_FULLSCREEN_OVERRIDE} to * disable the full-screen option only. * * <p>The user override is intended to improve the app experience on devices * that have the ignore orientation request display setting enabled by OEMs * (enables compatibility mode for fixed orientation on Android 12 (API * level 31) or higher; see * <a href="https://developer.android.com/guide/topics/large-screens/large-screen-compatibility-mode"> * Large screen compatibility mode</a> * for more details). * <p>The user override is intended to improve the app experience on devices that have the * ignore orientation request display setting enabled by OEMs, which enables compatibility mode * for fixed-orientation apps on Android 12 (API level 31) or higher. See * <a href="{@docRoot}guide/practices/device-compatibility-mode">Device compatibility mode</a> * for more details. * * <p>To opt out of the user aspect ratio compatibility override, add this property * to your app manifest and set the value to {@code false}. Your app will be excluded Loading Loading @@ -1383,13 +1380,11 @@ public interface WindowManager extends ViewManager { * <p>When users apply the full-screen compatibility override, the orientation * of the activity is forced to {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_USER}. * * <p>The user override is intended to improve the app experience on devices * that have the ignore orientation request display setting enabled by OEMs * (enables compatibility mode for fixed orientation on Android 12 (API * level 31) or higher; see * <a href="https://developer.android.com/guide/topics/large-screens/large-screen-compatibility-mode"> * Large screen compatibility mode</a> * for more details). * <p>The user override is intended to improve the app experience on devices that have the * ignore orientation request display setting enabled by OEMs, which enables compatibility mode * for fixed-orientation apps on Android 12 (API level 31) or higher. See * <a href="{@docRoot}guide/practices/device-compatibility-mode">Device compatibility mode</a> * for more details. * * <p>To opt out of the full-screen option of the user aspect ratio compatibility * override, add this property to your app manifest and set the value to {@code false}. Loading
core/res/res/values/attrs_manifest.xml +44 −19 Original line number Diff line number Diff line Loading @@ -851,7 +851,12 @@ of the screen. <p>This attribute is supported by the <a href="{@docRoot}guide/topics/manifest/activity-element.html">{@code <activity>}</a> element. --> element. <aside class="note"><b>Note:</b> Device manufacturers can configure devices to override (ignore) this attribute to improve the layout of apps. See <a href="{@docRoot}guide/practices/device-compatibility-mode"> Device compatibility mode</a>. </aside> --> <attr name="screenOrientation"> <!-- No preference specified: let the system decide the best orientation. This will either be the orientation selected Loading Loading @@ -1447,13 +1452,23 @@ no other apps in multi-window visible on screen (e.g. picture-in-picture) or on other displays. Therefore, this flag cannot be used to assure an exclusive resource access. <p>NOTE: A task's root activity value is applied to all additional activities launched in <p>A task's root activity value is applied to all additional activities launched in the task. That is if the root activity of a task is resizeable then the system will treat all other activities in the task as resizeable and will not if the root activity isn't resizeable. <p>NOTE: The value of {@link android.R.attr#screenOrientation} is ignored for resizeable activities when in multi-window mode before Android 12. --> <aside class="note"><b>Note:</b> <ul> <li>On Android 11 (API level 30) and lower, the value of {@link android.R.attr#screenOrientation} is ignored for resizeable activities in multi-window mode. <li>Device manufacturers can configure devices to override (ignore) this attribute to force apps to resize. The override does not affect the app's support for multi-window mode. See <a href="{@docRoot}guide/practices/device-compatibility-mode"> Device compatibility mode</a>. </ul> </aside> --> <attr name="resizeableActivity" format="boolean" /> <!-- Indicates that the activity specifically supports the picture-in-picture form of Loading @@ -1470,27 +1485,37 @@ <!-- This value indicates the maximum aspect ratio the activity supports. If the app runs on a device with a wider aspect ratio, the system automatically letterboxes the app, leaving portions of the screen unused so the app can run at its specified maximum aspect ratio. <p> Maximum aspect ratio, expressed as (longer dimension / shorter dimension) in decimal <p>Maximum aspect ratio, expressed as (longer dimension / shorter dimension) in decimal form. For example, if the maximum aspect ratio is 7:3, set value to 2.33. <p> Value needs to be greater or equal to 1.0, otherwise it is ignored. <p> NOTE: This attribute is ignored if the activity has {@link android.R.attr#resizeableActivity} set to true. --> <p>Value needs to be greater or equal to 1.0, otherwise it is ignored. <aside class="note"><b>Note:</b> <ul> <li>This attribute is ignored if the activity has {@link android.R.attr#resizeableActivity} set to {@code true}. <li>Device manufacturers can configure devices to override (ignore) this attribute to improve the layout of apps. See <a href="{@docRoot}guide/practices/device-compatibility-mode"> Device compatibility mode</a>. </ul> </aside> --> <attr name="maxAspectRatio" format="float" /> <!-- This value indicates the minimum aspect ratio the activity supports. If the app runs on a device with a narrower aspect ratio, the system automatically letterboxes the app, leaving portions of the screen unused so the app can run at its specified minimum aspect ratio. <p> Minimum aspect ratio, expressed as (longer dimension / shorter dimension) in decimal <p>Minimum aspect ratio, expressed as (longer dimension / shorter dimension) in decimal form. For example, if the minimum aspect ratio is 4:3, set value to 1.33. <p> Value needs to be greater or equal to 1.0, otherwise it is ignored. <p> NOTE: This attribute is ignored if the activity has {@link android.R.attr#resizeableActivity} set to true. --> <p>Value needs to be greater or equal to 1.0, otherwise it is ignored. <aside class="note"><b>Note:</b> <ul> <li>This attribute is ignored if the activity has {@link android.R.attr#resizeableActivity} set to {@code true}. <li>Device manufacturers can configure devices to override (ignore) this attribute to improve the layout of apps. See <a href="{@docRoot}guide/practices/device-compatibility-mode"> Device compatibility mode</a>. </ul> </aside> --> <attr name="minAspectRatio" format="float" /> <!-- This value indicates how tasks rooted at this activity will behave in lockTask mode. Loading
