Skip to content
pubscout

permission_handler

13.0.2, released 3 months ago by baseflow.com

Cross-platform API to check and request permissions on iOS, Android, Web, and Windows.

WASM-ready
$ flutter pub add permission_handler
Source repository

What it does

Provides a unified cross-platform API to request and check runtime permissions such as camera, contacts, location, and storage. It also allows developers to open the device's app settings and handle rationales on Android.

AI-written summary of version 13.0.2, based on the package's README and metadata. Report an inaccuracy

Use it when

  • Your app needs to access device features requiring runtime permissions (camera, location, contacts, etc.)
  • You need to check permission status or send users to the system settings page to grant permissions manually.

Skip it when

  • You are targeting platforms where permissions are entirely handled automatically at install time without runtime checks.

Strengths

  • Supports multiple platforms including iOS, Android, Web, and Windows.
  • Provides granular permission control and status checking.
  • Handles OS-specific permission macros and requirements.

Weaknesses

  • Requires manual configuration in native files like AndroidManifest.xml and iOS Info.plist / Podfile / SPM settings.
  • Changes in native platform permission behavior require careful handling of request-driven patterns.

Setup

Kind
Plugin (native code)
Effort
Medium
Code generation
No
Direct dependencies
6

Requires adding specific permission configurations and usage descriptions to AndroidManifest.xml and iOS Info.plist, along with optional Podfile preprocessor definitions or Swift Package Manager settings.

Map<Permission, PermissionStatus> statuses = await [
  Permission.camera,
  Permission.speech,
].request();
print(statuses[Permission.camera]);

Alternatives

Packages that do the same job and could replace permission_handler.

  • app_settings

    If you only need to open specific application settings screens rather than a full permission management solution.

Works with

Packages commonly used together with permission_handler: ones it builds on, ones built on it, and its own family.