🚀 permission_manager #

A modern, federated Flutter plugin to manage app permissions across all platforms with a simple, unified API.

This plugin helps you check, request, and listen to permission states without dealing with platform-specific complexity.

📱 Supported Platforms #

✨ Features #

• 🏗 Federated Architecture: Built using a modern structure for future-proof multi-platform support.
• ✅ Multiple Permissions: Request or check multiple permissions simultaneously.
• 🖼 Android 13 Media: Granular support for Images, Video, and Audio (with backward compatibility).
• ⚡ Real-time Updates: Listen to permission status changes via a stream.
• 🤖 Android Specialized: Support for Battery Optimization, Overlay, and Exact Alarms.
• 🍏 iOS Parity: Handles restricted, limited, and not-determined states gracefully.
• 📦 SPM Support: Fully compatible with Swift Package Manager for iOS and macOS.
• 📚 100% Documented: Every public API element is fully documented with dartdoc comments.
• 🛠 Simple API: Single unified class for all operations.

📦 Installation #

Add this to your pubspec.yaml:

dependencies:
  permission_manager: ^2.0.4

Usage #

🔐 Request a Permission #

import 'package:permission_manager/permission_manager.dart';

final status = await PermissionManager.request(
  PermissionManagerPermission.camera,
);

if (status == PermissionManagerStatus.granted) {
  // Permission granted
} else if (status == PermissionManagerStatus.permanentlyDenied) {
  // Open app settings
  await PermissionManager.openAppSettings();
}

Request Multiple Permissions #

final statuses = await PermissionManager.requestMultiple([
  PermissionManagerPermission.camera,
  PermissionManagerPermission.location,
  PermissionManagerPermission.contacts,
]);

print(statuses[PermissionManagerPermission.camera]);

📡 Listen to Status Changes #

PermissionManager.statusStream(PermissionManagerPermission.camera).listen((status) {
  print('Camera status changed to: $status');
});

🔍 Supported Permissions #

🤖 Android Setup #

Add required permissions to your AndroidManifest.xml:

<!-- General -->
<uses-permission android:name="android.permission.CAMERA"/>
<uses-permission android:name="android.permission.RECORD_AUDIO"/>
<uses-permission android:name="android.permission.READ_CONTACTS"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<uses-permission android:name="android.permission.READ_CALENDAR" />
<uses-permission android:name="android.permission.WRITE_CALENDAR" />

<!-- Bluetooth & Connectivity -->
<uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE" />
<uses-permission android:name="android.permission.NEARBY_WIFI_DEVICES" />

<!-- SMS -->
<uses-permission android:name="android.permission.READ_SMS" />
<uses-permission android:name="android.permission.SEND_SMS" />

<!-- Media & Activity -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
<uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />
<uses-permission android:name="android.permission.ACTIVITY_RECOGNITION" />
<uses-permission android:name="android.permission.ACCESS_MEDIA_LOCATION" />

<!-- Specialized -->
<uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS"/>
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW"/>
<uses-permission android:name="android.permission.SCHEDULE_EXACT_ALARM"/>

🍎 iOS Setup #

Add usage descriptions to your Info.plist:

<key>NSCameraUsageDescription</key>
<string>Camera access is required</string>
<key>NSMicrophoneUsageDescription</key>
<string>Microphone access is required</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>Photo library access is required</string>
<key>NSContactsUsageDescription</key>
<string>Contacts access is required</string>
<key>NSBluetoothAlwaysUsageDescription</key>
<string>Bluetooth access is required</string>
<key>NSCalendarsUsageDescription</key>
<string>Calendar access is required</string>
<key>NSMotionUsageDescription</key>
<string>Activity recognition is required</string>

🖥 macOS Setup #

macOS requires both Info.plist usage descriptions and App Sandbox entitlements for permissions to work correctly.

Info.plist Usage Descriptions #

Add the same usage descriptions as iOS to your macos/Runner/Info.plist:

<key>NSCameraUsageDescription</key>
<string>Camera access is required</string>
<key>NSMicrophoneUsageDescription</key>
<string>Microphone access is required</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>Photo library access is required</string>
<key>NSContactsUsageDescription</key>
<string>Contacts access is required</string>
<key>NSCalendarsUsageDescription</key>
<string>Calendar access is required</string>
<key>NSBluetoothAlwaysUsageDescription</key>
<string>Bluetooth access is required</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>Location access is required</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>Background location access is required</string>
<key>NSMotionUsageDescription</key>
<string>Activity recognition is required</string>

App Sandbox Entitlements #

Add required entitlements to both macos/Runner/DebugProfile.entitlements and macos/Runner/Release.entitlements:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>com.apple.security.app-sandbox</key>
	<true/>
	
	<!-- Device Access -->
	<key>com.apple.security.device.camera</key>
	<true/>
	<key>com.apple.security.device.audio-input</key>
	<true/>
	
	<!-- Personal Information -->
	<key>com.apple.security.personal-information.photos-library</key>
	<true/>
	<key>com.apple.security.personal-information.addressbook</key>
	<true/>
	<key>com.apple.security.personal-information.calendars</key>
	<true/>
	<key>com.apple.security.personal-information.location</key>
	<true/>
	
	<!-- File Access (if needed) -->
	<key>com.apple.security.files.user-selected.read-write</key>
	<true/>
	
	<!-- Network (usually needed for Flutter apps) -->
	<key>com.apple.security.network.client</key>
	<true/>
</dict>
</plist>

Troubleshooting macOS Permissions #

If permissions are always denied without prompts:

1. ✅ Verify all required NSxxxUsageDescription keys are in Info.plist
2. ✅ Verify all required entitlements are in both .entitlements files
3. ✅ Clean build folder: flutter clean then rebuild
4. ✅ Reset permissions: tccutil reset All com.your.bundle.identifier
5. ✅ Check Console.app for permission-related errors

🪟 Windows Setup #

Windows doesn't require manifest changes for most permissions. The plugin handles permissions at the OS level.

🐧 Linux Setup #

Linux permissions are typically handled at the OS level through system policies.

🌐 Web Setup #

Web permissions use the browser's native Permissions API and are requested automatically.

Requirements #

• HTTPS Required: Most permissions (camera, microphone, location) require a secure context (HTTPS)
• User Gesture: Some permissions must be requested in response to user interaction

Supported Permissions on Web #

📝 License #

This package is available under the MIT License.

👨‍💻 Author #

Manoj Patadiya 📧 Email: patadiyamanoj4@gmail.com