Permissions Configuration

dependencies:
  permission_handler: ^12.0.1  # Runtime permission management
  image_picker: ^1.2.1         # Camera and gallery access
  path_provider: ^2.1.5        # File system access

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- Internet access for API communication -->
    <uses-permission android:name="android.permission.INTERNET"/>
    
    <!-- Camera access for taking photos -->
    <uses-permission android:name="android.permission.CAMERA"/>
    
    <!-- Storage access for Android 12 and below -->
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
    
    <!-- Storage access for Android 13+ -->
    <uses-permission android:name="android.permission.READ_MEDIA_IMAGES"/>
</manifest>

import 'package:permission_handler/permission_handler.dart';
import 'package:device_info_plus/device_info_plus.dart';

Future<bool> requestStoragePermission() async {
  if (Platform.isAndroid) {
    final androidInfo = await DeviceInfoPlugin().androidInfo;
    
    if (androidInfo.version.sdkInt >= 33) {
      // Android 13+: Request granular media permission
      final status = await Permission.photos.request();
      return status.isGranted;
    } else {
      // Android 12 and below: Request legacy storage permission
      final status = await Permission.storage.request();
      return status.isGranted;
    }
  }
  return true;
}

<?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>
    <!-- Camera Access -->
    <key>NSCameraUsageDescription</key>
    <string>App Courier needs access to your camera to take photos of deliveries and documents.</string>
    
    <!-- Photo Library Access -->
    <key>NSPhotoLibraryUsageDescription</key>
    <string>App Courier needs access to your photo library to select images for deliveries.</string>
    
    <!-- Photo Library Add (Save Photos) -->
    <key>NSPhotoLibraryAddUsageDescription</key>
    <string>App Courier needs permission to save photos to your library.</string>
    
    <!-- Existing configuration -->
    <key>CFBundleDisplayName</key>
    <string>Courier</string>
    <!-- ... other keys ... -->
</dict>
</plist>

import 'package:permission_handler/permission_handler.dart';

Future<bool> requestCameraPermission() async {
  final status = await Permission.camera.request();
  
  if (status.isGranted) {
    // Permission granted, proceed with camera
    return true;
  } else if (status.isDenied) {
    // Permission denied, show explanation
    showPermissionDeniedDialog();
    return false;
  } else if (status.isPermanentlyDenied) {
    // User permanently denied, open app settings
    openAppSettings();
    return false;
  }
  
  return false;
}

import 'package:permission_handler/permission_handler.dart';

Future<bool> requestStoragePermission() async {
  final status = await Permission.photos.request();
  
  if (status.isGranted) {
    return true;
  } else if (status.isPermanentlyDenied) {
    // Open app settings
    await openAppSettings();
    return false;
  }
  
  return false;
}

Future<void> checkCameraPermission() async {
  final status = await Permission.camera.status;
  
  if (status.isGranted) {
    // Permission already granted
  } else if (status.isDenied) {
    // Permission not yet requested or denied
  } else if (status.isPermanentlyDenied) {
    // User permanently denied permission
  } else if (status.isRestricted) {
    // iOS only: Permission restricted by device policy
  }
}

import 'package:permission_handler/permission_handler.dart';
import 'package:image_picker/image_picker.dart';

class CameraService {
  final ImagePicker _picker = ImagePicker();
  
  Future<XFile?> takePicture() async {
    // Check current permission status
    final status = await Permission.camera.status;
    
    if (status.isGranted) {
      // Permission already granted, take picture
      return await _picker.pickImage(source: ImageSource.camera);
    }
    
    // Show explanation dialog
    final shouldRequest = await _showPermissionRationale();
    
    if (!shouldRequest) {
      return null;
    }
    
    // Request permission
    final result = await Permission.camera.request();
    
    if (result.isGranted) {
      // Permission granted, take picture
      return await _picker.pickImage(source: ImageSource.camera);
    } else if (result.isPermanentlyDenied) {
      // Show settings dialog
      await _showSettingsDialog();
      return null;
    }
    
    // Permission denied
    return null;
  }
  
  Future<bool> _showPermissionRationale() async {
    // Show dialog explaining why camera is needed
    // Return true if user wants to proceed
    return true;
  }
  
  Future<void> _showSettingsDialog() async {
    // Show dialog with option to open settings
    await openAppSettings();
  }
}

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>

<key>NSLocationWhenInUseUsageDescription</key>
<string>We need your location to show nearby delivery points.</string>

final status = await Permission.location.request();

<uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>

final status = await Permission.notification.request();