From 63042b1ac7714e2d043a0a57ba9b542f49874999 Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Sat, 15 Aug 2026 09:38:34 -0500 Subject: [PATCH 1/5] Document Android.Window APIs Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- docs/xml/Android.Window/BackEvent.xml | 18 ++++---- .../InputTransferToken+InterfaceConsts.xml | 4 +- .../xml/Android.Window/InputTransferToken.xml | 34 +++++++------- docs/xml/Android.Window/SplashScreen.xml | 4 +- .../SplashScreenOnExitAnimationEventArgs.xml | 16 +++---- docs/xml/Android.Window/SplashScreenStyle.xml | 8 ++-- docs/xml/Android.Window/SplashScreenView.xml | 24 +++++----- docs/xml/Android.Window/SurfaceSyncGroup.xml | 34 +++++++------- .../SystemOnBackInvokedCallbacks.xml | 22 +++++----- ...PresentationThresholds+InterfaceConsts.xml | 4 +- .../TrustedPresentationThresholds.xml | 44 +++++++++---------- docs/xml/ns-Android.Window.xml | 4 +- 12 files changed, 108 insertions(+), 108 deletions(-) diff --git a/docs/xml/Android.Window/BackEvent.xml b/docs/xml/Android.Window/BackEvent.xml index ad930ee00..c79b4762a 100644 --- a/docs/xml/Android.Window/BackEvent.xml +++ b/docs/xml/Android.Window/BackEvent.xml @@ -356,9 +356,9 @@ Java.Interop.JniPeerMembers - To be added. - To be added. - To be added. + Gets the JNI metadata used to invoke members of this Java peer. + The JNI metadata for this Java peer. + Provides binding infrastructure for . @@ -481,9 +481,9 @@ System.IntPtr - To be added. - To be added. - To be added. + Gets the JNI class reference used when dispatching inherited members. + The JNI class reference for this Java peer. + Provides binding infrastructure for . @@ -510,9 +510,9 @@ System.Type - To be added. - To be added. - To be added. + Gets the managed type used when dispatching inherited members. + The managed type for this Java peer. + Provides binding infrastructure for . diff --git a/docs/xml/Android.Window/InputTransferToken+InterfaceConsts.xml b/docs/xml/Android.Window/InputTransferToken+InterfaceConsts.xml index c8c3f4b6a..b88a3b949 100644 --- a/docs/xml/Android.Window/InputTransferToken+InterfaceConsts.xml +++ b/docs/xml/Android.Window/InputTransferToken+InterfaceConsts.xml @@ -12,8 +12,8 @@ - To be added. - To be added. + Contains legacy constants inherited from the Android parcelable contract. + Use the corresponding values instead of deprecated generated fields. diff --git a/docs/xml/Android.Window/InputTransferToken.xml b/docs/xml/Android.Window/InputTransferToken.xml index 09d9e05c3..813f9b90a 100644 --- a/docs/xml/Android.Window/InputTransferToken.xml +++ b/docs/xml/Android.Window/InputTransferToken.xml @@ -90,9 +90,9 @@ Android.OS.IParcelableCreator - To be added. - To be added. - To be added. + Gets the factory Android uses to create input transfer tokens from a parcel. + A parcelable creator for input transfer tokens. + The creator reconstructs an input transfer token from its parcel representation. @@ -123,8 +123,8 @@ - To be added. - To be added. + Describes the special objects in this token's marshaled representation. + A bitmask of special object types in the marshaled representation. @@ -166,9 +166,9 @@ Java.Interop.JniPeerMembers - To be added. - To be added. - To be added. + Gets the JNI metadata used to invoke members of this Java peer. + The JNI metadata for this Java peer. + Provides binding infrastructure for . @@ -195,9 +195,9 @@ System.IntPtr - To be added. - To be added. - To be added. + Gets the JNI class reference used when dispatching inherited members. + The JNI class reference for this Java peer. + Provides binding infrastructure for . @@ -224,9 +224,9 @@ System.Type - To be added. - To be added. - To be added. + Gets the managed type used when dispatching inherited members. + The managed type for this Java peer. + Provides binding infrastructure for . @@ -267,9 +267,9 @@ - To be added. - To be added. - To be added. + The parcel that receives the token. + Additional flags describing how the token is written. + Flattens this token into a parcel. diff --git a/docs/xml/Android.Window/SplashScreen.xml b/docs/xml/Android.Window/SplashScreen.xml index d0b33ac41..e8ef0acc8 100644 --- a/docs/xml/Android.Window/SplashScreen.xml +++ b/docs/xml/Android.Window/SplashScreen.xml @@ -30,8 +30,8 @@ - To be added. - To be added. + Provides an application's interface to its activity-specific splash screen. + Use instead. Each splash screen instance is associated with an activity. diff --git a/docs/xml/Android.Window/SplashScreenOnExitAnimationEventArgs.xml b/docs/xml/Android.Window/SplashScreenOnExitAnimationEventArgs.xml index cef3c12d5..cc060df75 100644 --- a/docs/xml/Android.Window/SplashScreenOnExitAnimationEventArgs.xml +++ b/docs/xml/Android.Window/SplashScreenOnExitAnimationEventArgs.xml @@ -18,8 +18,8 @@ - To be added. - To be added. + Provides the splash screen view supplied when an exit animation begins. + The view can be used to customize the splash screen exit animation before it is removed. @@ -36,9 +36,9 @@ - To be added. - To be added. - To be added. + The splash screen view supplied to the exit animation listener. + Initializes event data for a splash screen exit animation. + The supplied view is displayed above the activity when the exit callback is invoked. @@ -55,9 +55,9 @@ Android.Window.SplashScreenView - To be added. - To be added. - To be added. + Gets the splash screen view supplied to the exit animation listener. + The view that can be used to customize the splash screen exit animation. + The view is displayed above the activity when the listener is invoked. diff --git a/docs/xml/Android.Window/SplashScreenStyle.xml b/docs/xml/Android.Window/SplashScreenStyle.xml index 3949ce8d2..14d216881 100644 --- a/docs/xml/Android.Window/SplashScreenStyle.xml +++ b/docs/xml/Android.Window/SplashScreenStyle.xml @@ -11,8 +11,8 @@ System.Enum - To be added. - To be added. + Specifies the visual style of a launched activity's splash screen. + Use these values with the splash screen style APIs on ActivityOptions. @@ -40,7 +40,7 @@ 1 - To be added. + Shows the launched activity's splash screen icon. @@ -68,7 +68,7 @@ 0 - To be added. + Uses a solid-color splash screen without showing the launched activity's icon. diff --git a/docs/xml/Android.Window/SplashScreenView.xml b/docs/xml/Android.Window/SplashScreenView.xml index 4615b928f..64ba0d731 100644 --- a/docs/xml/Android.Window/SplashScreenView.xml +++ b/docs/xml/Android.Window/SplashScreenView.xml @@ -76,7 +76,7 @@ Returns the duration of the icon animation if icon is animatable. - To be added. + The icon animation duration, or when the icon is not animatable. Returns the duration of the icon animation if icon is animatable. @@ -122,7 +122,7 @@ If the replaced icon is animatable, return the animation start time based on system clock. - To be added. + The icon animation start time, or when no animatable icon is available. If the replaced icon is animatable, return the animation start time based on system clock. @@ -163,7 +163,7 @@ Get the view containing the Splash Screen icon and its background. - To be added. + The view containing the splash screen icon and its background. Get the view containing the Splash Screen icon and its background. @@ -207,9 +207,9 @@ Java.Interop.JniPeerMembers - To be added. - To be added. - To be added. + Gets the JNI metadata used to invoke members of this Java peer. + The JNI metadata for this Java peer. + Provides binding infrastructure for . @@ -279,9 +279,9 @@ System.IntPtr - To be added. - To be added. - To be added. + Gets the JNI class reference used when dispatching inherited members. + The JNI class reference for this Java peer. + Provides binding infrastructure for . @@ -312,9 +312,9 @@ System.Type - To be added. - To be added. - To be added. + Gets the managed type used when dispatching inherited members. + The managed type for this Java peer. + Provides binding infrastructure for . diff --git a/docs/xml/Android.Window/SurfaceSyncGroup.xml b/docs/xml/Android.Window/SurfaceSyncGroup.xml index 3a164346c..2c6f57f6f 100644 --- a/docs/xml/Android.Window/SurfaceSyncGroup.xml +++ b/docs/xml/Android.Window/SurfaceSyncGroup.xml @@ -181,11 +181,11 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The surface package to add to this synchronization group. + An optional operation that updates the hosted surface while its rendering is paused. + Adds a surface package to this synchronization group. + if the surface package was added; otherwise, . + Rendering is paused while the optional operation executes so its changes can be included in the synchronized frame. @@ -215,9 +215,9 @@ - To be added. - To be added. - To be added. + The transaction to include in this synchronization group. + Adds a transaction to this synchronization group. + The transaction is synchronized with the group's other transactions. @@ -244,9 +244,9 @@ Java.Interop.JniPeerMembers - To be added. - To be added. - To be added. + Gets the JNI metadata used to invoke members of this Java peer. + The JNI metadata for this Java peer. + Provides binding infrastructure for . @@ -317,9 +317,9 @@ System.IntPtr - To be added. - To be added. - To be added. + Gets the JNI class reference used when dispatching inherited members. + The JNI class reference for this Java peer. + Provides binding infrastructure for . @@ -346,9 +346,9 @@ System.Type - To be added. - To be added. - To be added. + Gets the managed type used when dispatching inherited members. + The managed type for this Java peer. + Provides binding infrastructure for . diff --git a/docs/xml/Android.Window/SystemOnBackInvokedCallbacks.xml b/docs/xml/Android.Window/SystemOnBackInvokedCallbacks.xml index 1570752f1..805e4a60a 100644 --- a/docs/xml/Android.Window/SystemOnBackInvokedCallbacks.xml +++ b/docs/xml/Android.Window/SystemOnBackInvokedCallbacks.xml @@ -83,7 +83,7 @@ The associated Activity Get a callback to triggers Activity#finishAndRemoveTask() on the associated Activity. - To be added. + A callback that finishes the activity and removes its task when back is invoked. Get a callback to triggers Activity#finishAndRemoveTask() on the associated Activity. If the activity is the root activity of its task, the entire task @@ -126,9 +126,9 @@ Java.Interop.JniPeerMembers - To be added. - To be added. - To be added. + Gets the JNI metadata used to invoke members of this Java peer. + The JNI metadata for this Java peer. + Provides binding infrastructure for . @@ -161,7 +161,7 @@ The associated Activity Get a callback to triggers Activity#moveTaskToBack(boolean) on the associated Activity, moving the task containing the activity to the background. - To be added. + A callback that moves the activity's task to the background when back is invoked. Get a callback to triggers Activity#moveTaskToBack(boolean) on the associated Activity, moving the task containing the activity to the background. The system @@ -204,9 +204,9 @@ System.IntPtr - To be added. - To be added. - To be added. + Gets the JNI class reference used when dispatching inherited members. + The JNI class reference for this Java peer. + Provides binding infrastructure for . @@ -233,9 +233,9 @@ System.Type - To be added. - To be added. - To be added. + Gets the managed type used when dispatching inherited members. + The managed type for this Java peer. + Provides binding infrastructure for . diff --git a/docs/xml/Android.Window/TrustedPresentationThresholds+InterfaceConsts.xml b/docs/xml/Android.Window/TrustedPresentationThresholds+InterfaceConsts.xml index 4d7b6629b..f79e33c48 100644 --- a/docs/xml/Android.Window/TrustedPresentationThresholds+InterfaceConsts.xml +++ b/docs/xml/Android.Window/TrustedPresentationThresholds+InterfaceConsts.xml @@ -12,8 +12,8 @@ - To be added. - To be added. + Contains legacy constants inherited from the Android parcelable contract. + Use the corresponding values instead of deprecated generated fields. diff --git a/docs/xml/Android.Window/TrustedPresentationThresholds.xml b/docs/xml/Android.Window/TrustedPresentationThresholds.xml index 182afe94a..48e10a463 100644 --- a/docs/xml/Android.Window/TrustedPresentationThresholds.xml +++ b/docs/xml/Android.Window/TrustedPresentationThresholds.xml @@ -133,9 +133,9 @@ Android.OS.IParcelableCreator - To be added. - To be added. - To be added. + Gets the factory Android uses to create trusted presentation thresholds from a parcel. + A parcelable creator for trusted presentation thresholds. + The creator reconstructs threshold values from their parcel representation. @@ -166,9 +166,9 @@ - To be added. - To be added. - To be added. + Describes the special objects in this threshold object's marshaled representation. + A bitmask of special object types in the marshaled representation. + The bitmask indicates whether the parcel representation contains special objects such as file descriptors. @@ -198,9 +198,9 @@ Java.Interop.JniPeerMembers - To be added. - To be added. - To be added. + Gets the JNI metadata used to invoke members of this Java peer. + The JNI metadata for this Java peer. + Provides binding infrastructure for . @@ -229,7 +229,7 @@ The min alpha the Window is required to have to be considered inside the threshold. - To be added. + A value from 0.0 to 1.0, inclusive. The min alpha the Window is required to have to be considered inside the threshold. @@ -272,7 +272,7 @@ The min fraction of the Window that was presented to the user to be considered inside the threshold. - To be added. + A value from 0.0 to 1.0, inclusive. The min fraction of the Window that was presented to the user to be considered inside the threshold. @@ -314,7 +314,7 @@ The time in milliseconds required for the Window to be in the threshold. - To be added. + A value of at least 1 millisecond. The time in milliseconds required for the Window to be in the threshold. @@ -354,9 +354,9 @@ System.IntPtr - To be added. - To be added. - To be added. + Gets the JNI class reference used when dispatching inherited members. + The JNI class reference for this Java peer. + Provides binding infrastructure for . @@ -383,9 +383,9 @@ System.Type - To be added. - To be added. - To be added. + Gets the managed type used when dispatching inherited members. + The managed type for this Java peer. + Provides binding infrastructure for . @@ -426,10 +426,10 @@ - To be added. - To be added. - To be added. - To be added. + The parcel that receives the threshold values. + Additional flags describing how the threshold values are written. + Flattens these threshold values into a parcel. + The parcel representation can be used to transfer threshold values across process boundaries. diff --git a/docs/xml/ns-Android.Window.xml b/docs/xml/ns-Android.Window.xml index f85a67c54..a8cacc332 100644 --- a/docs/xml/ns-Android.Window.xml +++ b/docs/xml/ns-Android.Window.xml @@ -1,6 +1,6 @@ - To be added. - To be added. + Provides APIs for predictive back navigation, splash screens, surface synchronization, input transfer, and trusted presentation thresholds. + These APIs support Android window behavior that is coordinated with the system. From 97710188ee5e00a3eb7c85bd23d918800f922be3 Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Sat, 15 Aug 2026 09:55:36 -0500 Subject: [PATCH 2/5] Restrict Android.Window docs to source-backed APIs Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- docs/xml/Android.Window/BackEvent.xml | 18 +++++++------- .../InputTransferToken+InterfaceConsts.xml | 4 ++-- .../xml/Android.Window/InputTransferToken.xml | 24 +++++++++---------- docs/xml/Android.Window/SplashScreen.xml | 4 ++-- .../SplashScreenOnExitAnimationEventArgs.xml | 16 ++++++------- docs/xml/Android.Window/SplashScreenView.xml | 18 +++++++------- docs/xml/Android.Window/SurfaceSyncGroup.xml | 18 +++++++------- .../SystemOnBackInvokedCallbacks.xml | 18 +++++++------- ...PresentationThresholds+InterfaceConsts.xml | 4 ++-- .../TrustedPresentationThresholds.xml | 24 +++++++++---------- 10 files changed, 74 insertions(+), 74 deletions(-) diff --git a/docs/xml/Android.Window/BackEvent.xml b/docs/xml/Android.Window/BackEvent.xml index c79b4762a..ad930ee00 100644 --- a/docs/xml/Android.Window/BackEvent.xml +++ b/docs/xml/Android.Window/BackEvent.xml @@ -356,9 +356,9 @@ Java.Interop.JniPeerMembers - Gets the JNI metadata used to invoke members of this Java peer. - The JNI metadata for this Java peer. - Provides binding infrastructure for . + To be added. + To be added. + To be added. @@ -481,9 +481,9 @@ System.IntPtr - Gets the JNI class reference used when dispatching inherited members. - The JNI class reference for this Java peer. - Provides binding infrastructure for . + To be added. + To be added. + To be added. @@ -510,9 +510,9 @@ System.Type - Gets the managed type used when dispatching inherited members. - The managed type for this Java peer. - Provides binding infrastructure for . + To be added. + To be added. + To be added. diff --git a/docs/xml/Android.Window/InputTransferToken+InterfaceConsts.xml b/docs/xml/Android.Window/InputTransferToken+InterfaceConsts.xml index b88a3b949..c8c3f4b6a 100644 --- a/docs/xml/Android.Window/InputTransferToken+InterfaceConsts.xml +++ b/docs/xml/Android.Window/InputTransferToken+InterfaceConsts.xml @@ -12,8 +12,8 @@ - Contains legacy constants inherited from the Android parcelable contract. - Use the corresponding values instead of deprecated generated fields. + To be added. + To be added. diff --git a/docs/xml/Android.Window/InputTransferToken.xml b/docs/xml/Android.Window/InputTransferToken.xml index 813f9b90a..52062f205 100644 --- a/docs/xml/Android.Window/InputTransferToken.xml +++ b/docs/xml/Android.Window/InputTransferToken.xml @@ -90,9 +90,9 @@ Android.OS.IParcelableCreator - Gets the factory Android uses to create input transfer tokens from a parcel. - A parcelable creator for input transfer tokens. - The creator reconstructs an input transfer token from its parcel representation. + To be added. + To be added. + To be added. @@ -166,9 +166,9 @@ Java.Interop.JniPeerMembers - Gets the JNI metadata used to invoke members of this Java peer. - The JNI metadata for this Java peer. - Provides binding infrastructure for . + To be added. + To be added. + To be added. @@ -195,9 +195,9 @@ System.IntPtr - Gets the JNI class reference used when dispatching inherited members. - The JNI class reference for this Java peer. - Provides binding infrastructure for . + To be added. + To be added. + To be added. @@ -224,9 +224,9 @@ System.Type - Gets the managed type used when dispatching inherited members. - The managed type for this Java peer. - Provides binding infrastructure for . + To be added. + To be added. + To be added. diff --git a/docs/xml/Android.Window/SplashScreen.xml b/docs/xml/Android.Window/SplashScreen.xml index e8ef0acc8..d0b33ac41 100644 --- a/docs/xml/Android.Window/SplashScreen.xml +++ b/docs/xml/Android.Window/SplashScreen.xml @@ -30,8 +30,8 @@ - Provides an application's interface to its activity-specific splash screen. - Use instead. Each splash screen instance is associated with an activity. + To be added. + To be added. diff --git a/docs/xml/Android.Window/SplashScreenOnExitAnimationEventArgs.xml b/docs/xml/Android.Window/SplashScreenOnExitAnimationEventArgs.xml index cc060df75..cef3c12d5 100644 --- a/docs/xml/Android.Window/SplashScreenOnExitAnimationEventArgs.xml +++ b/docs/xml/Android.Window/SplashScreenOnExitAnimationEventArgs.xml @@ -18,8 +18,8 @@ - Provides the splash screen view supplied when an exit animation begins. - The view can be used to customize the splash screen exit animation before it is removed. + To be added. + To be added. @@ -36,9 +36,9 @@ - The splash screen view supplied to the exit animation listener. - Initializes event data for a splash screen exit animation. - The supplied view is displayed above the activity when the exit callback is invoked. + To be added. + To be added. + To be added. @@ -55,9 +55,9 @@ Android.Window.SplashScreenView - Gets the splash screen view supplied to the exit animation listener. - The view that can be used to customize the splash screen exit animation. - The view is displayed above the activity when the listener is invoked. + To be added. + To be added. + To be added. diff --git a/docs/xml/Android.Window/SplashScreenView.xml b/docs/xml/Android.Window/SplashScreenView.xml index 64ba0d731..e7f2381f6 100644 --- a/docs/xml/Android.Window/SplashScreenView.xml +++ b/docs/xml/Android.Window/SplashScreenView.xml @@ -207,9 +207,9 @@ Java.Interop.JniPeerMembers - Gets the JNI metadata used to invoke members of this Java peer. - The JNI metadata for this Java peer. - Provides binding infrastructure for . + To be added. + To be added. + To be added. @@ -279,9 +279,9 @@ System.IntPtr - Gets the JNI class reference used when dispatching inherited members. - The JNI class reference for this Java peer. - Provides binding infrastructure for . + To be added. + To be added. + To be added. @@ -312,9 +312,9 @@ System.Type - Gets the managed type used when dispatching inherited members. - The managed type for this Java peer. - Provides binding infrastructure for . + To be added. + To be added. + To be added. diff --git a/docs/xml/Android.Window/SurfaceSyncGroup.xml b/docs/xml/Android.Window/SurfaceSyncGroup.xml index 2c6f57f6f..4d0d860b4 100644 --- a/docs/xml/Android.Window/SurfaceSyncGroup.xml +++ b/docs/xml/Android.Window/SurfaceSyncGroup.xml @@ -244,9 +244,9 @@ Java.Interop.JniPeerMembers - Gets the JNI metadata used to invoke members of this Java peer. - The JNI metadata for this Java peer. - Provides binding infrastructure for . + To be added. + To be added. + To be added. @@ -317,9 +317,9 @@ System.IntPtr - Gets the JNI class reference used when dispatching inherited members. - The JNI class reference for this Java peer. - Provides binding infrastructure for . + To be added. + To be added. + To be added. @@ -346,9 +346,9 @@ System.Type - Gets the managed type used when dispatching inherited members. - The managed type for this Java peer. - Provides binding infrastructure for . + To be added. + To be added. + To be added. diff --git a/docs/xml/Android.Window/SystemOnBackInvokedCallbacks.xml b/docs/xml/Android.Window/SystemOnBackInvokedCallbacks.xml index 805e4a60a..e97fd9bf6 100644 --- a/docs/xml/Android.Window/SystemOnBackInvokedCallbacks.xml +++ b/docs/xml/Android.Window/SystemOnBackInvokedCallbacks.xml @@ -126,9 +126,9 @@ Java.Interop.JniPeerMembers - Gets the JNI metadata used to invoke members of this Java peer. - The JNI metadata for this Java peer. - Provides binding infrastructure for . + To be added. + To be added. + To be added. @@ -204,9 +204,9 @@ System.IntPtr - Gets the JNI class reference used when dispatching inherited members. - The JNI class reference for this Java peer. - Provides binding infrastructure for . + To be added. + To be added. + To be added. @@ -233,9 +233,9 @@ System.Type - Gets the managed type used when dispatching inherited members. - The managed type for this Java peer. - Provides binding infrastructure for . + To be added. + To be added. + To be added. diff --git a/docs/xml/Android.Window/TrustedPresentationThresholds+InterfaceConsts.xml b/docs/xml/Android.Window/TrustedPresentationThresholds+InterfaceConsts.xml index f79e33c48..4d7b6629b 100644 --- a/docs/xml/Android.Window/TrustedPresentationThresholds+InterfaceConsts.xml +++ b/docs/xml/Android.Window/TrustedPresentationThresholds+InterfaceConsts.xml @@ -12,8 +12,8 @@ - Contains legacy constants inherited from the Android parcelable contract. - Use the corresponding values instead of deprecated generated fields. + To be added. + To be added. diff --git a/docs/xml/Android.Window/TrustedPresentationThresholds.xml b/docs/xml/Android.Window/TrustedPresentationThresholds.xml index 48e10a463..fa01eb362 100644 --- a/docs/xml/Android.Window/TrustedPresentationThresholds.xml +++ b/docs/xml/Android.Window/TrustedPresentationThresholds.xml @@ -133,9 +133,9 @@ Android.OS.IParcelableCreator - Gets the factory Android uses to create trusted presentation thresholds from a parcel. - A parcelable creator for trusted presentation thresholds. - The creator reconstructs threshold values from their parcel representation. + To be added. + To be added. + To be added. @@ -198,9 +198,9 @@ Java.Interop.JniPeerMembers - Gets the JNI metadata used to invoke members of this Java peer. - The JNI metadata for this Java peer. - Provides binding infrastructure for . + To be added. + To be added. + To be added. @@ -354,9 +354,9 @@ System.IntPtr - Gets the JNI class reference used when dispatching inherited members. - The JNI class reference for this Java peer. - Provides binding infrastructure for . + To be added. + To be added. + To be added. @@ -383,9 +383,9 @@ System.Type - Gets the managed type used when dispatching inherited members. - The managed type for this Java peer. - Provides binding infrastructure for . + To be added. + To be added. + To be added. From 4a826d9134f6bbdfbe7e69c2537a458781012111 Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Sun, 16 Aug 2026 09:02:09 -0500 Subject: [PATCH 3/5] Correct Android.Window callback docs Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: ce92d4c9-4603-4d9d-9d0f-9b92d4314552 --- docs/xml/Android.Window/SplashScreenView.xml | 2 +- docs/xml/Android.Window/SystemOnBackInvokedCallbacks.xml | 7 ++++--- 2 files changed, 5 insertions(+), 4 deletions(-) diff --git a/docs/xml/Android.Window/SplashScreenView.xml b/docs/xml/Android.Window/SplashScreenView.xml index e7f2381f6..1199b7344 100644 --- a/docs/xml/Android.Window/SplashScreenView.xml +++ b/docs/xml/Android.Window/SplashScreenView.xml @@ -76,7 +76,7 @@ Returns the duration of the icon animation if icon is animatable. - The icon animation duration, or when the icon is not animatable. + The icon animation duration, or or a non-null zero duration when the icon is not animatable. Returns the duration of the icon animation if icon is animatable. diff --git a/docs/xml/Android.Window/SystemOnBackInvokedCallbacks.xml b/docs/xml/Android.Window/SystemOnBackInvokedCallbacks.xml index e97fd9bf6..56c6ae980 100644 --- a/docs/xml/Android.Window/SystemOnBackInvokedCallbacks.xml +++ b/docs/xml/Android.Window/SystemOnBackInvokedCallbacks.xml @@ -81,9 +81,10 @@ The associated Activity - Get a callback to triggers Activity#finishAndRemoveTask() on the associated - Activity. - A callback that finishes the activity and removes its task when back is invoked. + Get a callback that finishes the associated Activity, removing its task from + Recents when the activity is the task root. + A callback that finishes the activity when back is invoked and removes its task from + Recents only when the activity is the task root. Get a callback to triggers Activity#finishAndRemoveTask() on the associated Activity. If the activity is the root activity of its task, the entire task From 1f4d7b1d6d5fa6ecea1dcc1a8bef897ce5346cdb Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Sun, 16 Aug 2026 11:03:17 -0500 Subject: [PATCH 4/5] Correct Android.Window contract docs Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: ce92d4c9-4603-4d9d-9d0f-9b92d4314552 --- docs/xml/Android.Window/SplashScreenView.xml | 2 +- docs/xml/Android.Window/SurfaceSyncGroup.xml | 14 +++++++------- .../TrustedPresentationThresholds.xml | 15 +++++++-------- 3 files changed, 15 insertions(+), 16 deletions(-) diff --git a/docs/xml/Android.Window/SplashScreenView.xml b/docs/xml/Android.Window/SplashScreenView.xml index 1199b7344..149a53ee0 100644 --- a/docs/xml/Android.Window/SplashScreenView.xml +++ b/docs/xml/Android.Window/SplashScreenView.xml @@ -163,7 +163,7 @@ Get the view containing the Splash Screen icon and its background. - The view containing the splash screen icon and its background. + The view containing the splash screen icon and its background, or when no icon view exists. Get the view containing the Splash Screen icon and its background. diff --git a/docs/xml/Android.Window/SurfaceSyncGroup.xml b/docs/xml/Android.Window/SurfaceSyncGroup.xml index 4d0d860b4..bb5baa3df 100644 --- a/docs/xml/Android.Window/SurfaceSyncGroup.xml +++ b/docs/xml/Android.Window/SurfaceSyncGroup.xml @@ -120,12 +120,9 @@ The AttachedSurfaceControl that will be add to this SurfaceSyncGroup. - This is run on the same thread that the call was made on, but - after the rendering is paused and before continuing to render - the next frame. This method will not return until the - execution of the runnable completes. This can be used to make - changes to the AttachedSurfaceControl, ensuring that the - changes are included in the sync. + Runs synchronously on the calling thread after rendering is paused + and before the next frame is rendered. This method blocks until the runnable completes. + Use it to make changes to the AttachedSurfaceControl that are included in the sync. Add an AttachedSurfaceControl to the SurfaceSyncGroup. true if the AttachedSurfaceControl was successfully added to the SurfaceSyncGroup, false otherwise. @@ -182,7 +179,10 @@ The surface package to add to this synchronization group. - An optional operation that updates the hosted surface while its rendering is paused. + An optional operation that runs synchronously on the calling thread + after rendering is paused and before the next frame is rendered. This method blocks + until the operation completes, allowing its changes to the hosted surface to be + included in the sync. Adds a surface package to this synchronization group. if the surface package was added; otherwise, . Rendering is paused while the optional operation executes so its changes can be included in the synchronized frame. diff --git a/docs/xml/Android.Window/TrustedPresentationThresholds.xml b/docs/xml/Android.Window/TrustedPresentationThresholds.xml index fa01eb362..e93712143 100644 --- a/docs/xml/Android.Window/TrustedPresentationThresholds.xml +++ b/docs/xml/Android.Window/TrustedPresentationThresholds.xml @@ -85,12 +85,11 @@ - The min alpha the Window is required to - have to be considered inside the - threshold. - The min fraction of the Window that was presented - to the user to be considered - inside the threshold. + The minimum alpha the Window must have to be considered inside the + threshold. Must be greater than 0.0 and no greater than 1.0. + The minimum fraction of the Window presented to the + user to be considered inside the threshold. Must be greater than 0.0 and no greater + than 1.0. The time in milliseconds required for the Window to be in the threshold. Creates a new TrustedPresentationThresholds. @@ -229,7 +228,7 @@ The min alpha the Window is required to have to be considered inside the threshold. - A value from 0.0 to 1.0, inclusive. + A value greater than 0.0 and no greater than 1.0. The min alpha the Window is required to have to be considered inside the threshold. @@ -272,7 +271,7 @@ The min fraction of the Window that was presented to the user to be considered inside the threshold. - A value from 0.0 to 1.0, inclusive. + A value greater than 0.0 and no greater than 1.0. The min fraction of the Window that was presented to the user to be considered inside the threshold. From 49c3ede3c70c1498354caabde63045f1268ca864 Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Sun, 16 Aug 2026 15:43:12 -0500 Subject: [PATCH 5/5] Clarify Android.Window completion contracts Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: ce92d4c9-4603-4d9d-9d0f-9b92d4314552 --- docs/xml/Android.Window/SurfaceSyncGroup.xml | 11 ++++++++--- .../Android.Window/TrustedPresentationThresholds.xml | 5 +++-- 2 files changed, 11 insertions(+), 5 deletions(-) diff --git a/docs/xml/Android.Window/SurfaceSyncGroup.xml b/docs/xml/Android.Window/SurfaceSyncGroup.xml index bb5baa3df..59e0cddef 100644 --- a/docs/xml/Android.Window/SurfaceSyncGroup.xml +++ b/docs/xml/Android.Window/SurfaceSyncGroup.xml @@ -215,9 +215,14 @@ - The transaction to include in this synchronization group. - Adds a transaction to this synchronization group. - The transaction is synchronized with the group's other transactions. + The transaction to synchronize with the group's other + transactions while the group is active. If the group has completed, the transaction + is applied immediately. + Adds a transaction to an active synchronization group; applies it immediately + when the group has completed. + The transaction is synchronized with the group's other transactions only while + the group is active. Once the group has completed, Android applies the transaction + immediately. diff --git a/docs/xml/Android.Window/TrustedPresentationThresholds.xml b/docs/xml/Android.Window/TrustedPresentationThresholds.xml index e93712143..cce0e72fe 100644 --- a/docs/xml/Android.Window/TrustedPresentationThresholds.xml +++ b/docs/xml/Android.Window/TrustedPresentationThresholds.xml @@ -90,8 +90,9 @@ The minimum fraction of the Window presented to the user to be considered inside the threshold. Must be greater than 0.0 and no greater than 1.0. - The time in milliseconds required for the - Window to be in the threshold. + The time in milliseconds required for the Window to + be in the threshold. Must be at least 1 millisecond; zero or negative values cause + this constructor to throw IllegalArgumentException. Creates a new TrustedPresentationThresholds. Creates a new TrustedPresentationThresholds.