diff --git a/core/java/android/view/WindowManager.java b/core/java/android/view/WindowManager.java index 70a690c3f264a..e56c43e57aa0e 100644 --- a/core/java/android/view/WindowManager.java +++ b/core/java/android/view/WindowManager.java @@ -824,16 +824,20 @@ public interface WindowManager extends ViewManager { * provide consent for their app to allow OEMs to manually provide ActivityEmbedding split * rule configuration on behalf of the app. * - *

If {@code true}, the system CAN override the windowing behaviors for the app, such as + *

If {@code true}, the system can override the windowing behaviors for the app, such as * showing some activities side-by-side. In this case, it will report that ActivityEmbedding * APIs are disabled for the app to avoid conflict. * - *

If {@code false}, the system MUST NOT override the window behavior for the app. It should + *

If {@code false}, the system can't override the window behavior for the app. It should * be used if the app wants to provide their own ActivityEmbedding split rules, or if the app * wants to opt-out of system overrides for any other reason. * *

Default is {@code false}. * + *

The system enforcement will be added in Android 14, but some devices may start following + * the requirement before that. The best practice for apps is to always explicitly set this + * property in AndroidManifest instead of relying on the default value. + * *

Example usage: *

      * <application>