DEV Community

loading...

Handling Requesting for Permissions Like a Pro in Flutter

mainawycliffe profile image Maina Wycliffe Originally published at codinglatte.com ・4 min read

In this lesson, we are going to look at how to request and check permissions on Android and IOS in Flutter.

Package(s)

Installation

The process of installing a flutter package is quite simple, just open the pubspec file and add the package into your dependency bloc section.

dependencies:
  permission_handler:
Enter fullscreen mode Exit fullscreen mode

TIP: You can use caret versioning to restrict the package version to a specific major version. For instance, permission_handler: ^3.0.0 restricts it to version 3, but you will get both minor updates and patches.
You can learn more about how dart pub package manager works here if you are interested.

Permissions

First, we need to determine which permissions we need, because your app needs to publicly declare the permissions it needs. Some less-sensitive permissions such as the internet, etc. are granted automatically. While other more sensitive permissions, think of Location, Contacts, etc. require user authorization before your app can use them.

iOS permissions

In iOS, this done by adding the permissions to Information Property List File i.e. info.plist, with the Permission you need being the Key, accompanied by the reason why your app needs to use the feature.

<key>NSPhotoLibraryUsageDescription</key>
<string>This app requires to save your images user gallery</string>
Enter fullscreen mode Exit fullscreen mode

In Flutters’ case, the info.plist in the iOS/Runner directory at the root of your project. You can learn more about the info.plist here.

You can find the complete list of permissions here and guidelines for asking permission on iOS here.

Android permissions

In Android, you can achieve the same by adding the <uses-permission> tag to the android manifest, this in the android/src/main/AndroidManifest.xml directory.

<manifest ...>
    <uses-permission android:name="android.permission.SEND_SMS"/>
    <application ...>
        ...
    </application>
</manifest>
Enter fullscreen mode Exit fullscreen mode

You can learn more about permission on Android here and the best practices here.

Requesting for Permission

To request permission, first you need to import the package:

import 'package:permission_handler/permission_handler.dart';
Enter fullscreen mode Exit fullscreen mode

And then, let say you want to request contact permission, you can do it like this. You pass a list of permissions you are requesting for, which allows you to ask for multiple permissions you need at once.

final PermissionHandler _permissionHandler = PermissionHandler();
var result = await _permissionHandler.requestPermissions([PermissionGroup.contacts]);
Enter fullscreen mode Exit fullscreen mode

And finally, you can inspect the result to see if the user granted permission or not. The results object is an array of PermissionStatus. The key of the array is the permission you were asking.

The possible permission statuses are:

Status Why
Granted Your app has been given permission to use the feature in question
Denied Your app has been given permission to use the feature in question
Disabled Feature in question is disabled i.e. when the Location feature is disabled.
Restricted (iOS only) OS has restricted access to a specific feature due to something like parental controls.
Unknown Unknown state of permissions.

For instance, in our example above, we can check if permission to access contacts was granted like this:

if (result[PermissionGroup.contacts] == PermissionStatus.granted) {
  // permission was granted
}
Enter fullscreen mode Exit fullscreen mode

You can also use a switch statement to react to the results of your request.

switch (result[PermissionGroup.contacts]) {
  case PermissionStatus.granted:
    // do something
    break;
  case PermissionStatus.denied:
    // do something
    break;
  case PermissionStatus.disabled:
    // do something
    break;
  case PermissionStatus.restricted:
    // do something
    break;
  case PermissionStatus. Unknown:
    // do something
    break;
  default:
}
Enter fullscreen mode Exit fullscreen mode

Checking if your App has been Given Permission

It is important that your app can check if it has permission to access certain features. This allows your app to decide based on if the user has granted permission or not. On top of that, it can help you determine if a feature is available or disabled on the users' device.

You can check for permission by using the checkPermissionStatus function, which accepts the Permission as a parameter.

final PermissionHandler _permissionHandler = PermissionHandler();

var permissionStatus = await _permissionHandler.checkPermissionStatus(PermissionGroup.location);
Enter fullscreen mode Exit fullscreen mode

This returns a PermissionStatus class – we saw it above – which details the status of the permission.

switch (permissionStatus) {
  case PermissionStatus.granted:
    // do something
    break;
  case PermissionStatus.denied:
    // do something
    break;
  case PermissionStatus.disabled:
    // do something
    break;
  case PermissionStatus.restricted:
    // do something
    break;
  case PermissionStatus.unknown:
    // do something
    break;
  default:
}
Enter fullscreen mode Exit fullscreen mode

Tip

Some permissions such as contacts, calendar, microphone, location, etc. are common across iOS and Android. On the other hand, there are some permissions that either do not match up on both OSs. While others are just on one OS, i.e. storage, SMS, phone, etc. are only on android. You might want to determine which platform it is before requesting permission from the user.

Take a camera app, for instance, if you wanted photos to appear in the gallery, on iOS, you need photos permission while in android you need external storage permission.

var permission = Platform.isAndroid ? PermissionGroup.storage : PermissionGroup.photos;
Enter fullscreen mode Exit fullscreen mode

And then, you can check if the user has granted your app permission:

await _permissionHandler.checkPermissionStatus(permission);
Enter fullscreen mode Exit fullscreen mode

Or request for permission:

await _permissionHandler.requestPermissions([permission]);
Enter fullscreen mode Exit fullscreen mode

Resources

  • Requesting for Permission on IOS – Link.
  • Requesting for Permission on Android – Link.
  • Permission Best Practices on Android – Link.
  • About Information Property List Files – Link.
  • Android App Manifest – Link.

Discussion (0)

pic
Editor guide