Разрешения имеют решающее значение при создании мобильных приложений, которым требуется доступ к функциям устройства, таким как местоположение, камера, контакты и другие. В Flutter эффективная обработка этих разрешений гарантирует, что приложение обеспечивает бесперебойную работу пользователя, соблюдая при этом требования конфиденциальности и безопасности. Одним из популярных пакетов для управления разрешениями в Flutter является permission_handler.

Эта статья проведет вас через процесс запроса, проверки и обработки различных разрешений в Flutter с использованием permission_handler, с практическими примерами на основе permission_handler.

Установка `permission_handler` и `fluttertoast`

Сначала добавьте пакеты permission_handler и fluttertoast в ваш файл pubspec.yaml:

dependencies:
  permission_handler: ^11.3.1 
  fluttertoast: ^8.2.4

Затем выполните:

flutter pub get

Обработка разрешений в Flutter

Пакет permission_handler предоставляет простой способ запроса разрешений и проверки их статусов. Ниже представлено полное описание обработки различных разрешений, таких как телефонные звонки, контакты, местоположение, SMS и камера/микрофон.

Обработчик разрешений может обрабатывать все эти типы разрешений: Календарь, Камера, Контакты, Местоположение, Библиотека медиафайлов, Микрофон, Телефон, Фотографии, Напоминания, Сенсоры, SMS, Распознавание речи, Хранилище, Игнорировать оптимизацию батареи, Уведомления, Доступ к медиа-местоположению, Распознавание активности, Разрешения Bluetooth, Управление внешним хранилищем, Окно системного предупреждения, Запрос на установку пакетов, Прозрачность отслеживания приложения, Критические уведомления, Доступ к политике уведомлений, Устройства рядом по Wi-Fi, Аудио, Запланированный точный будильник, Постоянные сенсоры, Только чтение календаря и Полный доступ к календарю, но в этой статье мы рассмотрим лишь несколько из них

Ниже приведено подробное руководство по запросу каждого типа разрешения, обработке сценариев отказа или постоянного отказа и тому, к чему предоставляет доступ каждое разрешение.

1. Разрешения календаря

Разрешения: calendar, calendarReadOnly, calendarFullAccess
Сценарий использования: Доступ к календарю пользователя для чтения или записи событий.

Future<void> requestCalendarPermission() async {
  var status = await Permission.calendar.request();

  if (status.isGranted) {
    // Permission granted, proceed with calendar access
  } else if (status.isPermanentlyDenied) {
    ShowToast.showErrorText(
      text: 'Calendar permission permanently denied. Please enable it in the app settings.',
    );
    openAppSettings();
  } else {
    ShowToast.showErrorText(
      text: 'Calendar permission denied',
    );
  }
}

2. Разрешения камеры

Разрешение: camera
Сценарий использования: Доступ к камере устройства для создания фотографий или видео.

Future<void> requestCameraPermission() async {
  var status = await Permission.camera.request();

  if (status.isGranted) {
    // Permission granted, proceed with camera access
  } else if (status.isPermanentlyDenied) {
    ShowToast.showErrorText(
      text: 'Camera permission permanently denied. Please enable it in the app settings.',
    );
    openAppSettings();
  } else {
    ShowToast.showErrorText(
      text: 'Camera permission denied',
    );
  }
}

3. Разрешения на доступ к контактам

Разрешение: contacts
Случай использования: Доступ к контактному списку пользователя для чтения или изменения контактов.

Future<void> requestContactsPermission() async {
  var status = await Permission.contacts.request();

  if (status.isGranted) {
    // Permission granted, proceed with contacts access
  } else if (status.isPermanentlyDenied) {
    ShowToast.showErrorText(
      text: 'Contacts permission permanently denied. Please enable it in the app settings.',
    );
    openAppSettings();
  } else {
    ShowToast.showErrorText(
      text: 'Contacts permission denied',
    );
  }
}

4. Разрешения на доступ к местоположению

Разрешения: location, locationAlways, locationWhenInUse, accessMediaLocation
Случай использования: Доступ к местоположению пользователя для навигации, геозон или ближайших услуг.

Future<void> requestLocationPermission() async {
  var status = await Permission.location.request();

  if (status.isGranted) {
    // Permission granted, proceed with location access
  } else if (status.isPermanentlyDenied) {
    ShowToast.showErrorText(
      text: 'Location permission permanently denied. Please enable it in the app settings.',
    );
    openAppSettings();
  } else {
    ShowToast.showErrorText(
      text: 'Location permission denied',
    );
  }
}

5. Разрешения на доступ к медиатеке

Разрешение: mediaLibrary
Случай использования: Доступ к медиатеке пользователя (только iOS).

Future<void> requestMediaLibraryPermission() async {
  var status = await Permission.mediaLibrary.request();

  if (status.isGranted) {
    // Permission granted, proceed with media library access
  } else if (status.isPermanentlyDenied) {
    ShowToast.showErrorText(
      text: 'Media Library permission permanently denied. Please enable it in the app settings.',
    );
    openAppSettings();
  } else {
    ShowToast.showErrorText(
      text: 'Media Library permission denied',
    );
  }
}

6. Разрешения на доступ к микрофону

Разрешение: microphone
Сценарий использования: Доступ к микрофону устройства для записи аудио.

Future<void> requestMicrophonePermission() async {
  var status = await Permission.microphone.request();

  if (status.isGranted) {
    // Permission granted, proceed with microphone access
  } else if (status.isPermanentlyDenied) {
    ShowToast.showErrorText(
      text: 'Microphone permission permanently denied. Please enable it in the app settings.',
    );
    openAppSettings();
  } else {
    ShowToast.showErrorText(
      text: 'Microphone permission denied',
    );
  }
}

7. Разрешения на телефон

Разрешение: phone
Сценарий использования: Совершение телефонных звонков, чтение состояния телефона или доступ к журналу вызовов.

Future<void> requestPhonePermission() async {
  var status = await Permission.phone.request();

  if (status.isGranted) {
    // Permission granted, proceed with phone access
  } else if (status.isPermanentlyDenied) {
    ShowToast.showErrorText(
      text: 'Phone permission permanently denied. Please enable it in the app settings.',
    );
    openAppSettings();
  } else {
    ShowToast.showErrorText(
      text: 'Phone permission denied',
    );
  }
}

8. Разрешения на фото

Разрешения: photos, photosAddOnly
Сценарий использования: Доступ к фотогалерее пользователя для чтения или добавления фото.

Future<void> requestPhotosPermission() async {
  var status = await Permission.photos.request();

  if (status.isGranted) {
    // Permission granted, proceed with photos access
  } else if (status.isPermanentlyDenied) {
    ShowToast.showErrorText(
      text: 'Photos permission permanently denied. Please enable it in the app settings.',
    );
    openAppSettings();
  } else {
    ShowToast.showErrorText(
      text: 'Photos permission denied',
    );
  }
}

9. Разрешения на напоминания

Разрешение: reminders
Сценарий использования: Доступ и управление напоминаниями на устройстве пользователя.

Future<void> requestRemindersPermission() async {
  var status = await Permission.reminders.request();

  if (status.isGranted) {
    // Permission granted, proceed with reminders access
  } else if (status.isPermanentlyDenied) {
    ShowToast.showErrorText(
      text: 'Reminders permission permanently denied. Please enable it in the app settings.',
    );
    openAppSettings();
  } else {
    ShowToast.showErrorText(
      text: 'Reminders permission denied',
    );
  }
}

10. Разрешения на датчики

Разрешения: sensors, sensorsAlways
Сценарий использования: Доступ к датчикам устройства, таким как акселерометр и гироскоп.

Future<void> requestSensorsPermission() async {
  var status = await Permission.sensors.request();

  if (status.isGranted) {
    // Permission granted, proceed with sensors access
  } else if (status.isPermanentlyDenied) {
    ShowToast.showErrorText(
      text: 'Sensors permission permanently denied. Please enable it in the app settings.',
    );
    openAppSettings();
  } else {
    ShowToast.showErrorText(
      text: 'Sensors permission denied',
    );
  }
}

11. Разрешения на SMS

Разрешение: sms
Сценарий использования: Доступ к функциям SMS, включая чтение или отправку SMS-сообщений.

Future<void> requestSmsPermission() async {
  var status = await Permission.sms.request();

  if (status.isGranted) {
    // Permission granted, proceed with SMS access
  } else if (status.isPermanentlyDenied) {
    ShowToast.showErrorText(
      text: 'SMS permission permanently denied. Please enable it in the app settings.',
    );
    openAppSettings();
  } else {
    ShowToast.showErrorText(
      text: 'SMS permission denied',
    );
  }
}

12. Разрешения на распознавание речи

Разрешение: speech
Сценарий использования: Доступ к функциям преобразования речи в текст.

Future<void> requestSpeechPermission() async {
  var status = await Permission.speech.request();

  if (status.isGranted) {
    // Permission granted, proceed with speech recognition
  } else if (status.isPermanentlyDenied) {
    ShowToast.showErrorText(
      text: 'Speech recognition permission permanently denied. Please enable it in the app settings.',
    );
    openAppSettings();
  } else {
    ShowToast.showErrorText(
      text: 'Speech recognition permission denied',
    );
  }
}

13. Разрешения на хранение

Разрешения: storage, manageExternalStorage
Сценарий использования: Доступ к внутреннему или внешнему хранилищу пользователя для чтения или записи файлов.

Future<void> requestStoragePermission() async {
  var status = await Permission.storage.request();

  if (status.isGranted) {
    // Permission granted, proceed with storage access
  } else if (status.isPermanentlyDenied) {
    ShowToast.showErrorText(
      text: 'Storage permission permanently denied. Please enable it in the app settings.',
    );
    openAppSettings();
  } else {
    ShowToast.showErrorText(
      text: 'Storage permission denied',
    );
  }
}

14. Игнорировать оптимизацию батареи

Разрешение: ignoreBatteryOptimizations
Вариант использования: Запросить систему исключить приложение из мер оптимизации батареи.

Future<void> requestIgnoreBatteryOptimizationsPermission() async {
  var status = await Permission.ignoreBatteryOptimizations.request();

  if (status.isGranted) {
    // Permission granted, proceed with ignoring battery optimizations
  } else if (status.isPermanentlyDenied) {
    ShowToast.showErrorText(
      text: 'Battery optimization permission permanently denied. Please enable it in the app settings.',
    );
    openAppSettings();
  } else {
    ShowToast.showErrorText(
      text: 'Battery optimization permission denied',
    );
  }
}

15. Разрешения уведомлений

Разрешение: notification
Вариант использования: Разрешить вашему приложению отправлять уведомления.

Future<void> requestNotificationPermission() async {
  var status = await Permission.notification.request();

  if (status.isGranted) {
    // Permission granted, proceed with notifications access
  } else if (status.isPermanentlyDenied) {
    ShowToast.showErrorText(
      text: 'Notification permission permanently denied. Please enable it in the app settings.',
    );
    openAppSettings();
  } else {
    ShowToast.showErrorText(
      text: 'Notification permission denied',
    );
  }
}

16. Разрешения Bluetooth

Разрешения: bluetooth, bluetoothScan, bluetoothAdvertise, bluetoothConnect
Вариант использования: Доступ к функциям Bluetooth для подключения или управления устройствами Bluetooth.

Future<void> requestBluetoothPermission() async {
  var status = await Permission.bluetooth.request();

  if (status.isGranted) {
    // Permission granted, proceed with Bluetooth access
  } else if (status.isPermanentlyDenied) {
    ShowToast.showErrorText(
      text: 'Bluetooth permission permanently denied. Please enable it in the app settings.',
    );
    openAppSettings();
  } else {
    ShowToast.showErrorText(
      text: 'Bluetooth permission denied',
    );
  }
}

17. Прозрачность отслеживания приложения

Разрешение: appTrackingTransparency
Сценарий использования: Запрос на разрешение от пользователя, требование для отслеживания приложения в iOS.

Future<void> requestAppTrackingTransparencyPermission() async {
  var status = await Permission.appTrackingTransparency.request();

  if (status.isGranted) {
    // Permission granted, proceed with app tracking
  } else if (status.isPermanentlyDenied) {
    ShowToast.showErrorText(
      text: 'App tracking permission permanently denied. Please enable it in the app settings.',
    );
    openAppSettings();
  } else {
    ShowToast.showErrorText(
      text: 'App tracking permission denied',
    );
  }
}

Разрешения играют ключевую роль в обеспечении пользователей беспрепятственным опытом, соблюдая при этом их конфиденциальность. Важно обращаться с этими разрешениями бережно и объяснять пользователям, почему вашему приложению они необходимы.

Используя пакет permission_handler, вы можете запрашивать, проверять и управлять всеми необходимыми разрешениями для вашего приложения Flutter на обеих платформах Android и iOS. Всегда предоставляйте пользователям содержательную обратную связь и рассмотрите добавление альтернативных потоков в случае отказа или отзыва разрешений.

Конфигурации для Android и iOS

Необходимо включить необходимые конфигурации для Android и iOS. Для Android это означает обновление AndroidManifest.xml с правильными объявлениями разрешений. Для iOS описания использования разрешений должны быть добавлены в файл Info.plist, чтобы информировать пользователей, зачем запрашиваются определенные разрешения.

Конфигурация `AndroidManifest.xml` для Android

Для каждого разрешения из 17 примеров вам нужно добавить соответствующий тег <uses-permission> в AndroidManifest.xml. Вот как разрешения соотносятся с пакетом permission_handler:

Разрешение на камеру

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

Разрешение на контакты

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

Разрешения местоположения

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

Разрешение на доступ к медиабиблиотеке/хранилищу

 <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
 <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" tools:ignore="ScopedStorage"/>
 <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
 <uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />
 <uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />

Разрешение на доступ к микрофону

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

Разрешение на доступ к телефону

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

Разрешение на доступ к фотографиям

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

Разрешение на доступ к напоминаниям (нет явного разрешения Android)

Разрешение на доступ к датчикам

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

Разрешение на отправку SMS

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

Разрешение на распознавание речи

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

Игнорировать оптимизацию батареи

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

Разрешение на уведомления (Обрабатывается нативно в Android 13+)
Разрешение на доступ к местоположению медиа
```
<uses-permission android:name="android.permission.ACCESS_MEDIA_LOCATION" />
```

Разрешение на распознавание активности

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

Разрешения Bluetooth

<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
<uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

Разрешение на отслеживание приложений (только для iOS)

Конфигурация `Info.plist` для iOS

Для iOS вам необходимо предоставить описательные ключи в файле Info.plist, чтобы сообщить пользователям, зачем вашему приложению нужны определенные разрешения. Ниже приведены конфигурации для каждого примера разрешения:

Разрешение на использование камеры

 <key>NSCameraUsageDescription</key>
 <string>Нам нужен доступ к вашей камере для съемки фотографий.</string>

Разрешение на использование контактов

 <key>NSContactsUsageDescription</key>
 <string>Нам нужен доступ к вашим контактам для улучшения коммуникации.</string>

Разрешения на доступ к местоположению

 <key>NSLocationWhenInUseUsageDescription</key>
 <string>Нам нужен доступ к вашему местоположению для предоставления услуг на основе местоположения.</string>
 <key>NSLocationAlwaysUsageDescription</key>
 <string>Нам нужен доступ к вашему местоположению, чтобы отслеживать ваше движение, даже когда приложение не активно.</string>

Разрешение на доступ к медиабиблиотеке/хранилищу

 <key>NSPhotoLibraryUsageDescription</key>
 <string>Нам нужен доступ к вашим фотографиям для обмена или загрузки медиафайлов.</string>

Разрешение на использование микрофона

 <key>NSMicrophoneUsageDescription</key>
 <string>Нам нужен доступ к вашему микрофону для записи звука.</string>

Разрешение на использование телефона

 <key>NSPhoneUsageDescription</key>
 <string>Нам нужен доступ к телефонным услугам для совершения звонков.</string>

Разрешение на доступ к фотографиям

 <key>NSPhotoLibraryAddUsageDescription</key>
 <string>Нам нужно разрешение на добавление фотографий в вашу библиотеку.</string>

Разрешение на доступ к напоминаниям

 <key>NSRemindersUsageDescription</key>
 <string>Нам нужен доступ к вашим напоминаниям для управления задачами.</string>

Разрешение на датчики

 <key>NSSensorsUsageDescription</key>
 <string>Нам нужен доступ к вашим датчикам для отслеживания фитнеса.</string>

Разрешение на SMS (Обрабатывается автоматически iOS, если запрашиваются услуги SMS)
Разрешение на распознавание речи

<key>NSSpeechRecognitionUsageDescription</key>
<string>We need access to speech recognition for voice commands.</string>

Игнорировать оптимизацию батареи (Не применимо в iOS)
Разрешение на уведомления

<key>NSUserNotificationUsageDescription</key>
<string>We need permission to send notifications.</string>

Доступ к местоположению медиафайлов (Обрабатывается автоматически в iOS)
Разрешение на распознавание активности

<key>NSMotionUsageDescription</key>
<string>We need access to motion data for fitness tracking.</string>

Разрешения Bluetooth

<key>NSBluetoothPeripheralUsageDescription</key>
<string>We need access to Bluetooth for device connectivity.</string>

Прозрачность отслеживания приложений

<key>NSUserTrackingUsageDescription</key>
<string>We need permission to track your activity across apps and websites for personalized ads.</string>

Чтобы ваше приложение функционировало полностью и соответствовало последним нормам конфиденциальности, необходимо правильно управлять разрешениями. Обновив как AndroidManifest.xml, так и Info.plist, а также реализовав корректную логику обработки разрешений в вашем приложении Flutter, вы обеспечите пользователям бесшовный и прозрачный опыт при запросе доступа к чувствительным функциям.

Всегда проверяйте разрешения на обеих платформах и предоставляйте пользователям значимые объяснения о том, почему разрешения необходимы, чтобы избежать отказов во время проверки в магазинах приложений.

Для более глубокого изучения рассмотрите возможность ознакомления с официальной документацией по обработке разрешений, чтобы узнать о других типах разрешений. Убедитесь, что вы также обновили свои файлы для конкретных платформ (такие как AndroidManifest.xml и Info.plist) с необходимыми декларациями для каждого типа разрешения.

Установка permission_handler и fluttertoast

Обработка разрешений в Flutter

1. Разрешения календаря

2. Разрешения камеры

3. Разрешения на доступ к контактам

4. Разрешения на доступ к местоположению

5. Разрешения на доступ к медиатеке

6. Разрешения на доступ к микрофону

7. Разрешения на телефон

8. Разрешения на фото

9. Разрешения на напоминания

10. Разрешения на датчики

11. Разрешения на SMS

12. Разрешения на распознавание речи

13. Разрешения на хранение

14. Игнорировать оптимизацию батареи

15. Разрешения уведомлений

16. Разрешения Bluetooth

17. Прозрачность отслеживания приложения

Конфигурации для Android и iOS

Конфигурация AndroidManifest.xml для Android

Конфигурация Info.plist для iOS

Установка `permission_handler` и `fluttertoast`

Конфигурация `AndroidManifest.xml` для Android

Конфигурация `Info.plist` для iOS