From 216e01ded9248f404071f846a4aa5740538a0cce Mon Sep 17 00:00:00 2001 From: David Britch Date: Tue, 7 Nov 2023 15:14:05 +0000 Subject: [PATCH 1/3] Android animations respect power saving. --- docs/user-interface/animation/basic.md | 6 ++++++ docs/user-interface/animation/custom.md | 6 ++++++ docs/user-interface/includes/animation-android.md | 10 ++++++++++ docs/whats-new/dotnet-8.md | 1 + 4 files changed, 23 insertions(+) create mode 100644 docs/user-interface/includes/animation-android.md diff --git a/docs/user-interface/animation/basic.md b/docs/user-interface/animation/basic.md index 304d3a608a..0869a1b30e 100644 --- a/docs/user-interface/animation/basic.md +++ b/docs/user-interface/animation/basic.md @@ -31,6 +31,12 @@ The animation extension methods in the class implements a single animation operation that progressively changes a property from one value to another value over a period of time. diff --git a/docs/user-interface/animation/custom.md b/docs/user-interface/animation/custom.md index acc06feb5c..1b6cf8f9ff 100644 --- a/docs/user-interface/animation/custom.md +++ b/docs/user-interface/animation/custom.md @@ -15,6 +15,12 @@ Running an animation created with the c > [!NOTE] > The class has an property that can be examined to determine if animations have been disabled by the operating system, such as when power saving mode is activated. +::: moniker range=">=net-maui-8.0" + +[!INCLUDE [Android animation system settings](../includes/android-animation.md)] + +::: moniker-end + ## Create an animation When creating an object, typically, a minimum of three parameters are required, as demonstrated in the following code example: diff --git a/docs/user-interface/includes/animation-android.md b/docs/user-interface/includes/animation-android.md new file mode 100644 index 0000000000..35170d2976 --- /dev/null +++ b/docs/user-interface/includes/animation-android.md @@ -0,0 +1,10 @@ +--- +ms.topic: include +ms.date: 11/07/2023 +--- + +On Android, animation classes respect the system animation settings: + +- If the system's animations are disabled (either by accessibility features or developer features), new animations will jump immediately to their finished state. +- If the device's power saving mode is activated while animations are in progress, the animations will immediately jump to their finished state. +- If the device's animation durations is set to zero (disabled) while animations are in progress and the API version is 33 or greater, the animations will immediately jump to their finished state. diff --git a/docs/whats-new/dotnet-8.md b/docs/whats-new/dotnet-8.md index 86c25b81a4..1a4f2f379b 100644 --- a/docs/whats-new/dotnet-8.md +++ b/docs/whats-new/dotnet-8.md @@ -98,6 +98,7 @@ The following behavior has changed from the previous release: - It's not required to specify a value for the `$(ApplicationIdGuid)` build property in your app's project file. This is because .NET MAUI Windows apps no longer require a GUID as an app ID, and instead use the value of the `$(ApplicationId)` build property as the app ID. Therefore, the same reverse domain format app ID is now used across all platforms, such as com.mycompany.myapp. - .NET MAUI Mac Catalyst apps are no longer limited to 50 menu items on the menu bar. - The `PlatformImage.FromStream` method, in the `Microsoft.Maui.Graphics` namespace, can now be used to load images on Windows instead of having to use the `W2DImageLoadingService` class. +- On Android, animations respect the system animation settings. For more information, see [Basic animation](~/user-interface/animation/basic.md). ## Performance From dee51bff0972b20b0876cded1c56c8e1533b37b8 Mon Sep 17 00:00:00 2001 From: David Britch Date: Tue, 7 Nov 2023 15:18:03 +0000 Subject: [PATCH 2/3] Fix include file link. --- docs/user-interface/animation/basic.md | 2 +- docs/user-interface/animation/custom.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/user-interface/animation/basic.md b/docs/user-interface/animation/basic.md index 0869a1b30e..8010e8bb80 100644 --- a/docs/user-interface/animation/basic.md +++ b/docs/user-interface/animation/basic.md @@ -33,7 +33,7 @@ If there's a requirement to let an animation complete in the background, then th ::: moniker range=">=net-maui-8.0" -[!INCLUDE [Android animation system settings](../includes/android-animation.md)] +[!INCLUDE [Android animation system settings](../includes/animation-android.md)] ::: moniker-end diff --git a/docs/user-interface/animation/custom.md b/docs/user-interface/animation/custom.md index 1b6cf8f9ff..bf86755c5a 100644 --- a/docs/user-interface/animation/custom.md +++ b/docs/user-interface/animation/custom.md @@ -17,7 +17,7 @@ Running an animation created with the c ::: moniker range=">=net-maui-8.0" -[!INCLUDE [Android animation system settings](../includes/android-animation.md)] +[!INCLUDE [Android animation system settings](../includes/animation-android.md)] ::: moniker-end From d9197bd0073fc0a8466a5facedb1c74ddfe5fae5 Mon Sep 17 00:00:00 2001 From: David Britch Date: Tue, 7 Nov 2023 15:25:13 +0000 Subject: [PATCH 3/3] Edit. --- docs/user-interface/includes/animation-android.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/user-interface/includes/animation-android.md b/docs/user-interface/includes/animation-android.md index 35170d2976..74385e1e64 100644 --- a/docs/user-interface/includes/animation-android.md +++ b/docs/user-interface/includes/animation-android.md @@ -3,7 +3,7 @@ ms.topic: include ms.date: 11/07/2023 --- -On Android, animation classes respect the system animation settings: +On Android, animations respect the system animation settings: - If the system's animations are disabled (either by accessibility features or developer features), new animations will jump immediately to their finished state. - If the device's power saving mode is activated while animations are in progress, the animations will immediately jump to their finished state.