Background refresh status platform specific implementations (#1282)

* Fix/1174 background refresh status (#1176)

* Update project files

* Add a new background refresh permission check for iOS

* versions

* cleanups

* version bumps

* missing constants

* Revert to platforms to main

---------

Co-authored-by: Sebastian Roth <sebastian.roth@gmail.com>

Author: mvanbeusekom

permission_handler_android/android/src/main/java/com/baseflow/permissionhandler/PermissionConstants.java

@@ -61,6 +61,7 @@ final class PermissionConstants {
     static final int PERMISSION_GROUP_CALENDAR_WRITE_ONLY = 36;
     static final int PERMISSION_GROUP_CALENDAR_FULL_ACCESS = 37;
     static final int PERMISSION_GROUP_ASSISTANT = 38;
+    static final int PERMISSION_GROUP_BACKGROUND_REFRESH = 39;
 
     @Retention(RetentionPolicy.SOURCE)
     @IntDef({

permission_handler_android/example/lib/main.dart

@@ -42,7 +42,8 @@ class _PermissionHandlerWidgetState extends State<PermissionHandlerWidget> {
                     permission != Permission.bluetooth &&
                     permission != Permission.appTrackingTransparency &&
                     permission != Permission.criticalAlerts &&
-                    permission != Permission.assistant;
+                    permission != Permission.assistant &&
+                    permission != Permission.backgroundRefresh;
               })
               .map((permission) => PermissionWidget(permission))
               .toList()),

permission_handler_android/pubspec.yaml

@@ -18,7 +18,7 @@ flutter:
 dependencies:
   flutter:
     sdk: flutter
-  permission_handler_platform_interface: ^4.1.0
+  permission_handler_platform_interface: ^4.2.0
 
 dev_dependencies:
   flutter_lints: ^1.0.4

permission_handler_apple/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 9.4.0
+
+* Adds a new permission `Permission.backgroundRefresh` to check the background refresh permission status.
+
 ## 9.3.1
 
 * Updates plist key from `NSPhotoLibraryUsageDescription` to `NSPhotoLibraryAddUsageDescription`.

permission_handler_apple/ios/Classes/PermissionHandlerEnums.h

@@ -162,7 +162,8 @@ typedef NS_ENUM(int, PermissionGroup) {
     PermissionGroupSensorsAlways,
     PermissionGroupCalendarWriteOnly,
     PermissionGroupCalendarFullAccess,
-    PermissionGroupAssistant
+    PermissionGroupAssistant,
+    PermissionGroupBackgroundRefresh
 };
 
 typedef NS_ENUM(int, PermissionStatus) {

permission_handler_apple/ios/Classes/PermissionManager.h

@@ -11,6 +11,7 @@
 
 #import "AudioVideoPermissionStrategy.h"
 #import "AppTrackingTransparencyPermissionStrategy.h"
+#import "BackgroundRefreshStrategy.h"
 #import "BluetoothPermissionStrategy.h"
 #import "ContactPermissionStrategy.h"
 #import "EventPermissionStrategy.h"

permission_handler_apple/ios/Classes/PermissionManager.m

@@ -149,6 +149,8 @@ + (id)createPermissionStrategy:(PermissionGroup)permission {
             return [CriticalAlertsPermissionStrategy new];
         case PermissionGroupAssistant:
             return [AssistantPermissionStrategy new];
+        case PermissionGroupBackgroundRefresh:
+            return [BackgroundRefreshStrategy new];
         default:
             return [UnknownPermissionStrategy new];
     }

permission_handler_apple/ios/Classes/strategies/BackgroundRefreshStrategy.h

@@ -0,0 +1,17 @@
+//
+//  BackgroundRefreshStrategy.h
+//  permission_handler_apple
+//
+//  Created by Sebastian Roth on 28/09/2023.
+//
+
+#import <Foundation/Foundation.h>
+#import "PermissionStrategy.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface BackgroundRefreshStrategy : NSObject<PermissionStrategy>
+
+@end
+
+NS_ASSUME_NONNULL_END

permission_handler_apple/ios/Classes/strategies/BackgroundRefreshStrategy.m

@@ -0,0 +1,38 @@
+//
+//  BackgroundRefreshStrategy.m
+//  permission_handler_apple
+//
+//  Created by Sebastian Roth on 28/09/2023.
+//
+
+#import "BackgroundRefreshStrategy.h"
+
+@implementation BackgroundRefreshStrategy
+
+- (PermissionStatus)checkPermissionStatus:(PermissionGroup)permission { 
+    return [BackgroundRefreshStrategy permissionStatus];
+}
+
+- (void)checkServiceStatus:(PermissionGroup)permission completionHandler:(ServiceStatusHandler)completionHandler { 
+    completionHandler(ServiceStatusNotApplicable);
+}
+
+- (void)requestPermission:(PermissionGroup)permission completionHandler:(PermissionStatusHandler)completionHandler { 
+    completionHandler([BackgroundRefreshStrategy permissionStatus]);
+}
+
++ (PermissionStatus) permissionStatus {
+    UIBackgroundRefreshStatus status = UIApplication.sharedApplication.backgroundRefreshStatus;
+    switch (status) {
+        case UIBackgroundRefreshStatusDenied:
+            return PermissionStatusDenied;
+        case UIBackgroundRefreshStatusRestricted:
+            return PermissionStatusRestricted;
+        case UIBackgroundRefreshStatusAvailable:
+            return PermissionStatusGranted;
+        default:
+            return PermissionStatusDenied;
+    }
+}
+
+@end

permission_handler_apple/pubspec.yaml

@@ -2,7 +2,7 @@ name: permission_handler_apple
 description: Permission plugin for Flutter. This plugin provides the iOS API to request and check permissions.
 repository: https://github.com/baseflow/flutter-permission-handler
 issue_tracker: https://github.com/Baseflow/flutter-permission-handler/issues
-version: 9.3.1
+version: 9.4.0
 
 
 environment:
@@ -19,7 +19,7 @@ flutter:
 dependencies:
   flutter:
     sdk: flutter
-  permission_handler_platform_interface: ^4.1.0
+  permission_handler_platform_interface: ^4.2.0
 
 dev_dependencies:
   flutter_lints: ^1.0.4