commit a2385ac3994881b58fa06c96387868821ce5c7d8
author Chris Li <lihongyu@google.com> Wed Jul 27 22:28:27 2022 +0800
committer Chris Li <lihongyu@google.com> Thu Jul 28 09:10:57 2022 +0800
tree d9dff84dfb1c1cce285bad7a92d33fb8d0c82a25
parent 2553bf5060672305272fb3116e51c1f66586f1b9

Update ActivityEmbedding Property Javadoc

Bug: 240387168
Test: Javadoc change only
Change-Id: I65d2cbbd5039a3bcc023ad1c344ecff1e0991998

core/java/android/view/WindowManager.java

diff --git a/core/java/android/view/WindowManager.java b/core/java/android/view/WindowManager.java
index 70a690c..e56c43e 100644
--- a/core/java/android/view/WindowManager.java
+++ b/core/java/android/view/WindowManager.java
@@ -824,16 +824,20 @@
      * provide consent for their app to allow OEMs to manually provide ActivityEmbedding split
      * rule configuration on behalf of the app.
      *
-     * <p>If {@code true}, the system CAN override the windowing behaviors for the app, such as
+     * <p>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.
      *
-     * <p>If {@code false}, the system MUST NOT override the window behavior for the app. It should
+     * <p>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.
      *
      * <p>Default is {@code false}.
      *
+     * <p>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.
+     *
      * <p>Example usage:
      * <pre>
      * &lt;application&gt;