Added AppTrackingTransparency permission

permission_handler/CHANGELOG.md

+## 7.3.0
+
+* Added support for the "AppTrackingTransparency" permission on iOS.
+
 ## 7.2.0
 
 * Added support for the "REQUEST_INSTALL_PACKAGES" permission on Android.

permission_handler/example/ios/Runner/Info.plist

@@ -41,54 +41,35 @@
 	</array>
 	<key>UIViewControllerBasedStatusBarAppearance</key>
 	<false/>
-
-	<!-- Permission options for the `location` group -->
-    <key>NSLocationWhenInUseUsageDescription</key>
-    <string>Need location when in use</string>
-    <key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
-    <string>Always and when in use!</string>
-    <key>NSLocationUsageDescription</key>
-    <string>Older devices need location.</string>
-    <key>NSLocationAlwaysUsageDescription</key>
-    <string>Can I have location always?</string>
-
-    <!-- Permission options for the `mediaLibrary` group -->
-    <key>NSAppleMusicUsageDescription</key>
-    <string>Music!</string>
-    <key>kTCCServiceMediaLibrary</key>
-    <string>media</string>
-
-    <!-- Permission options for the `calendar` group -->
-    <key>NSCalendarsUsageDescription</key>
-    <string>Calendars</string>
-
-    <!-- Permission options for the `camera` group -->
-    <key>NSCameraUsageDescription</key>
-    <string>camera</string>
-
-    <!-- Permission options for the `contacts` group -->
-    <key>NSContactsUsageDescription</key>
-    <string>contacts</string>
-
-    <!-- Permission options for the `microphone` group -->
-    <key>NSMicrophoneUsageDescription</key>
-    <string>microphone</string>
-
-    <!-- Permission options for the `speech` group -->
-    <key>NSSpeechRecognitionUsageDescription</key>
-    <string>speech</string>
-
-    <!-- Permission options for the `sensors` group -->
-    <key>NSMotionUsageDescription</key>
-    <string>motion</string>
-
-    <!-- Permission options for the `photos` group -->
-    <key>NSPhotoLibraryUsageDescription</key>
-    <string>photos</string>
-
-    <!-- Permission options for the `reminder` group -->
-    <key>NSRemindersUsageDescription</key>
-    <string>reminders</string>
-
+	<key>NSLocationWhenInUseUsageDescription</key>
+	<string>Need location when in use</string>
+	<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
+	<string>Always and when in use!</string>
+	<key>NSLocationUsageDescription</key>
+	<string>Older devices need location.</string>
+	<key>NSLocationAlwaysUsageDescription</key>
+	<string>Can I have location always?</string>
+	<key>NSAppleMusicUsageDescription</key>
+	<string>Music!</string>
+	<key>kTCCServiceMediaLibrary</key>
+	<string>media</string>
+	<key>NSCalendarsUsageDescription</key>
+	<string>Calendars</string>
+	<key>NSCameraUsageDescription</key>
+	<string>camera</string>
+	<key>NSContactsUsageDescription</key>
+	<string>contacts</string>
+	<key>NSMicrophoneUsageDescription</key>
+	<string>microphone</string>
+	<key>NSSpeechRecognitionUsageDescription</key>
+	<string>speech</string>
+	<key>NSMotionUsageDescription</key>
+	<string>motion</string>
+	<key>NSPhotoLibraryUsageDescription</key>
+	<string>photos</string>
+	<key>NSRemindersUsageDescription</key>
+	<string>reminders</string>
+	<key>NSUserTrackingUsageDescription</key>
+	<string>appTrackingTransparency</string>
 </dict>
 </plist>

permission_handler/example/lib/main.dart

@@ -50,7 +50,8 @@ class _PermissionHandlerWidgetState extends State<PermissionHandlerWidget> {
                       permission != Permission.mediaLibrary &&
                       permission != Permission.photos &&
                       permission != Permission.photosAddOnly &&
-                      permission != Permission.reminders;
+                      permission != Permission.reminders &&
+                      permission != Permission.appTrackingTransparency;
                 }
               })
               .map((permission) => PermissionWidget(permission))

permission_handler/ios/Classes/PermissionHandlerEnums.h

@@ -95,6 +95,13 @@
     #define PERMISSION_BLUETOOTH 1
 #endif
 
+// ios: PermissionGroupAppTrackingTransparency
+// Info.plist: [NSUserTrackingUsageDescription]
+// dart: PermissionGroup.appTrackingTransparency
+#ifndef PERMISSION_APP_TRACKING_TRANSPARENCY
+    #define PERMISSION_APP_TRACKING_TRANSPARENCY 1
+#endif
+
 typedef NS_ENUM(int, PermissionGroup) {
     PermissionGroupCalendar = 0,
     PermissionGroupCamera,
@@ -119,7 +126,9 @@ typedef NS_ENUM(int, PermissionGroup) {
     PermissionGroupUnknown,
     PermissionGroupBluetooth,
     PermissionGroupManageExternalStorage,
-    PermissionGroupSystemAlertWindow
+    PermissionGroupSystemAlertWindow,
+    PermissionGroupRequestInstallPackages,
+    PermissionGroupAppTrackingTransparency
 };
 
 typedef NS_ENUM(int, PermissionStatus) {

permission_handler/ios/Classes/PermissionManager.h

@@ -10,6 +10,7 @@
 #import <UIKit/UIKit.h>
 
 #import "AudioVideoPermissionStrategy.h"
+#import "AppTrackingTransparencyPermissionStrategy.h"
 #import "BluetoothPermissionStrategy.h"
 #import "ContactPermissionStrategy.h"
 #import "EventPermissionStrategy.h"

permission_handler/ios/Classes/PermissionManager.m

@@ -125,6 +125,8 @@
             return [StoragePermissionStrategy new];
         case PermissionGroupBluetooth:
             return [BluetoothPermissionStrategy new];
+        case PermissionGroupAppTrackingTransparency:
+            return [AppTrackingTransparencyPermissionStrategy new];
         default:
             return [UnknownPermissionStrategy new];
     }

permission_handler/ios/Classes/strategies/AppTrackingTransparencyPermissionStrategy.h

+//
+//  AppTrackingTransparency.h
+//  permission_handler
+//
+//  Created by Jan-Derk on 21/05/2021.
+//
+
+#import <Foundation/Foundation.h>
+#import "PermissionStrategy.h"
+
+#if PERMISSION_APP_TRACKING_TRANSPARENCY
+
+#import <AppTrackingTransparency/AppTrackingTransparency.h>
+
+@interface AppTrackingTransparencyPermissionStrategy : NSObject <PermissionStrategy>
+@end
+
+#else
+
+#import "UnknownPermissionStrategy.h"
+
+@interface AppTrackingTransparencyPermissionStrategy : UnknownPermissionStrategy
+@end
+
+#endif

permission_handler/ios/Classes/strategies/AppTrackingTransparencyPermissionStrategy.m

+//
+//  AppTrackingTransparency.m
+//  permission_handler
+//
+//  Created by Jan-Derk on 21/05/2021.
+//
+
+#import "AppTrackingTransparencyPermissionStrategy.h"
+
+#if PERMISSION_APP_TRACKING_TRANSPARENCY
+
+@implementation AppTrackingTransparencyPermissionStrategy
+
+- (PermissionStatus)checkPermissionStatus:(PermissionGroup)permission {
+    if (@available(iOS 14, *)) {
+        ATTrackingManagerAuthorizationStatus attPermission = [ATTrackingManager trackingAuthorizationStatus];
+        return [AppTrackingTransparencyPermissionStrategy parsePermission:attPermission];
+    }
+    
+    return PermissionStatusGranted;
+}
+
+- (ServiceStatus)checkServiceStatus:(PermissionGroup)permission {
+    return ServiceStatusNotApplicable;
+}
+
+- (void)requestPermission:(PermissionGroup)permission completionHandler:(PermissionStatusHandler)completionHandler {
+    PermissionStatus status = [self checkPermissionStatus:permission];
+    if (status != PermissionStatusDenied) {
+        completionHandler(status);
+        return;
+    }
+    
+    if (@available(iOS 14, *)){
+        [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {
+            PermissionStatus permissionStatus = [AppTrackingTransparencyPermissionStrategy parsePermission:status];
+            completionHandler(permissionStatus);
+        }];
+    } else {
+        completionHandler(PermissionStatusGranted);
+    }
+}
+
++ (PermissionStatus)parsePermission:(ATTrackingManagerAuthorizationStatus)attPermission API_AVAILABLE(ios(14)){
+    switch(attPermission){
+        case ATTrackingManagerAuthorizationStatusAuthorized:
+            return PermissionStatusGranted;
+        case ATTrackingManagerAuthorizationStatusRestricted:
+            return PermissionStatusRestricted;
+        case ATTrackingManagerAuthorizationStatusDenied:
+            return PermissionStatusPermanentlyDenied;
+        case ATTrackingManagerAuthorizationStatusNotDetermined:
+            return PermissionStatusDenied;
+    }
+}
+@end
+
+#else
+
+@implementation AppTrackingTransparencyPermissionStrategy
+@end
+
+#endif
+

permission_handler/pubspec.yaml

 name: permission_handler
 description: Permission plugin for Flutter. This plugin provides a cross-platform (iOS, Android) API to request and check permissions.
-version: 7.2.0
+version: 7.3.0
 homepage: https://github.com/baseflowit/flutter-permission-handler
 
 flutter:
@@ -16,7 +16,7 @@ dependencies:
   flutter:
     sdk: flutter
   meta: ^1.3.0
-  permission_handler_platform_interface: ^3.4.0
+  permission_handler_platform_interface: ^3.5.0
 
 dev_dependencies:
   flutter_test: