Update PI docs (#1133)

permission_handler_platform_interface/CHANGELOG.md

+## 3.11.4
+* Clarifies the documentation on requesting background location permission
+through `Permission.locationAlways` on Android 10+ (API 29+).
+
 ## 3.11.3
 ## 3.11.3
 
 
 * Updates the documentation for the `Permission.bluetooth` permission regarding the limitations of the permission on iOS.
 * Updates the documentation for the `Permission.bluetooth` permission regarding the limitations of the permission on iOS.

permission_handler_platform_interface/lib/src/permissions.dart

@@ -56,15 +56,16 @@ class Permission {
   /// different:
   /// different:
   ///
   ///
   /// **Android:**
   /// **Android:**
-  /// - When running on Android Q and above: Background Location Permission
+  /// - When running on Android Q and above: Background Location Permission.
+  /// <br>**Please note**: To request this permission, the user needs to grant foreground
+  /// location permissions first. You can do this by using either
+  /// [Permission.location] or [Permission.locationWhenInUse]. Then, requesting
+  /// [Permission.locationAlways] will show an additional dialog or open the
+  /// location permission app settings, allowing the user to change the location
+  /// access to 'allow all the time'.
   /// - When running on Android < Q: Fine and Coarse Location
   /// - When running on Android < Q: Fine and Coarse Location
   ///
   ///
   /// **iOS:** CoreLocation - Always
   /// **iOS:** CoreLocation - Always
-  /// - When requesting this permission, the user needs to grant permission for
-  /// the `locationWhenInUse` permission first, clicking on the
-  /// `Allow While Using App` option on the popup. After allowing the
-  /// permission, the user can request the `locationAlways` permission and can
-  /// click on the `Change To Always Allow` option.
   static const locationAlways = PermissionWithService._(4);
   static const locationAlways = PermissionWithService._(4);
 
 
   /// Permission for accessing the device's location when the app is running in
   /// Permission for accessing the device's location when the app is running in

permission_handler_platform_interface/pubspec.yaml

@@ -3,7 +3,7 @@ description: A common platform interface for the permission_handler plugin.
 homepage: https://github.com/baseflow/flutter-permission-handler/tree/master/permission_handler_platform_interface
 homepage: https://github.com/baseflow/flutter-permission-handler/tree/master/permission_handler_platform_interface
 # NOTE: We strongly prefer non-breaking changes, even at the expense of a
 # NOTE: We strongly prefer non-breaking changes, even at the expense of a
 # less-clean API. See https://flutter.dev/go/platform-interface-breaking-changes
 # less-clean API. See https://flutter.dev/go/platform-interface-breaking-changes
-version: 3.11.3
+version: 3.11.4
 
 
 dependencies:
 dependencies:
   flutter:
   flutter: