docs(screen-orientation): Android 16 large screen restrictions (#2414)

Author: OS-pedrogustavobilro

screen-orientation/README.md

@@ -69,6 +69,12 @@ lock(options: OrientationLockOptions) => Promise<void>
 
 Locks the screen orientation.
 
+Starting in Android targetSdk 36, this method has no effect for large screens (e.g. tablets) on Android 16 an higher.
+You may opt-out of this behavior in your app by adding `&lt;property android:name="android.window.PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY" android:value="true" /&gt;` to your `AndroidManifest.xml` inside `&lt;application&gt;` or `&lt;activity&gt;`.
+Keep in mind though that this opt-out is temporary will no longer work for Android 17. Android discourages setting specific orientations for large screens.
+Regular Android phones are unaffected by this change.
+For more information check the Android docs at https://developer.android.com/about/versions/16/behavior-changes-16#adaptive-layouts
+
 | Param         | Type                                                                      |
 | ------------- | ------------------------------------------------------------------------- |
 | **`options`** | <code><a href="#orientationlockoptions">OrientationLockOptions</a></code> |

screen-orientation/src/definitions.ts

@@ -32,6 +32,12 @@ export interface ScreenOrientationPlugin {
   /**
    * Locks the screen orientation.
    *
+   * Starting in Android targetSdk 36, this method has no effect for large screens (e.g. tablets) on Android 16 an higher.
+   * You may opt-out of this behavior in your app by adding `<property android:name="android.window.PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY" android:value="true" />` to your `AndroidManifest.xml` inside `<application>` or `<activity>`.
+   * Keep in mind though that this opt-out is temporary will no longer work for Android 17. Android discourages setting specific orientations for large screens.
+   * Regular Android phones are unaffected by this change.
+   * For more information check the Android docs at https://developer.android.com/about/versions/16/behavior-changes-16#adaptive-layouts
+   *
    * @since 4.0.0
    */
   lock(options: OrientationLockOptions): Promise<void>;