From 8523b022e80b3d6b26a4e7e122ef62532652e0c8 Mon Sep 17 00:00:00 2001 From: Pedro Bilro Date: Wed, 18 Dec 2024 09:33:44 +0000 Subject: [PATCH] docs: Android 15 - Private Space (#2283) --- local-notifications/README.md | 7 +++++++ push-notifications/README.md | 6 ++++++ 2 files changed, 13 insertions(+) diff --git a/local-notifications/README.md b/local-notifications/README.md index 3ed442a0f..be9fd303d 100644 --- a/local-notifications/README.md +++ b/local-notifications/README.md @@ -10,6 +10,7 @@ npx cap sync ``` ## Android + Android 13 requires a permission check in order to send notifications. You are required to call `checkPermissions()` and `requestPermissions()` accordingly. On Android 12 and older it won't show a prompt and will just return as granted. @@ -24,6 +25,12 @@ Note that even if the permission is present, users can still disable exact notif On Android 14, there is a new permission called `USE_EXACT_ALARM`. Use this permission to use exact alarms without needing to request permission from the user. This should only be used if the use of exact alarms is central to your app's functionality. Read more about the implications of using this permission [here](https://developer.android.com/reference/android/Manifest.permission#USE_EXACT_ALARM). +From Android 15 onwards, users can install an app in the [Private space](https://developer.android.com/about/versions/15/features#private-space). Users can lock their private space at any time, which means that push notifications are not shown until the user unlocks it. + +It is not possible to detect if an app is installed in the private space. Therefore, if your app shows any critical notifications, inform your users to avoid installing the app in the private space. + +For more information about the behavior changes of your app related to the private space, refer to [Android documentation](https://developer.android.com/about/versions/15/behavior-changes-all#private-space-changes). + ## Configuration diff --git a/push-notifications/README.md b/push-notifications/README.md index 22d5fe7dd..ad6b9ff18 100644 --- a/push-notifications/README.md +++ b/push-notifications/README.md @@ -31,6 +31,12 @@ The Push Notification API uses [Firebase Cloud Messaging](https://firebase.googl Android 13 requires a permission check in order to receive push notifications. You are required to call `checkPermissions()` and `requestPermissions()` accordingly, when targeting SDK 33. +From Android 15 onwards, users can install an app in the [Private space](https://developer.android.com/about/versions/15/features#private-space). Users can lock their private space at any time, which means that push notifications are not shown until the user unlocks it. + +It is not possible to detect if an app is installed in the private space. Therefore, if your app shows any critical notifications, inform your users to avoid installing the app in the private space. + +For more information about the behavior changes of your app related to the private space, refer to [Android documentation](https://developer.android.com/about/versions/15/behavior-changes-all#private-space-changes). + ### Variables This plugin will use the following project variables (defined in your app's `variables.gradle` file):