de.mrapp.android.util

Class PermissionUtil

java.lang.Object

de.mrapp.android.util.PermissionUtil

public final class PermissionUtil
extends java.lang.Object

An utility class, which provides static methods, which allow to handle runtime permissions.

Since:

1.3.0

Method Summary

Modifier and Type	Method and Description
static boolean	areAllPermissionsGranted(android.content.Context context, java.lang.String... permissions) Returns, whether all permissions, which are contained by a specific array, are granted, or not.
static java.lang.String[]	getNotGrantedPermissions(android.content.Context context, java.lang.String... permissions) Returns the subset of specific permissions, which are not granted.
static boolean	isPermissionGranted(android.content.Context context, java.lang.String permission) Returns, whether a specific permission is granted, or not.
static boolean	shouldShowRequestPermissionRationale(android.app.Activity activity, java.lang.String... permissions) Returns, whether an UI with a rationale for requesting one or multiple permissions should be shown, or not.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

isPermissionGranted

public static boolean isPermissionGranted(android.content.Context context,
                                          java.lang.String permission)

Returns, whether a specific permission is granted, or not.

Parameters:

context - The context, which should be used, as an instance of the class Context. The context may not be null

permission - The permission, which should be checked, as a String, e.g. android.Manifest.permission.CALL_PHONE. The permission may neither be null, nor empty

Returns:

True, if the given permission is granted, false otherwise

areAllPermissionsGranted

public static boolean areAllPermissionsGranted(android.content.Context context,
                                               java.lang.String... permissions)

Returns, whether all permissions, which are contained by a specific array, are granted, or not.

Parameters:

context - The context, which should be used, as an instance of the class Context. The context may not be null

permissions - An array, which contains the permissions, e.g. android.Manifest.permission.CALL_PHONE, which should be checked, as a String array. The array may not be null

Returns:

True, if all given permissions are granted, false otherwise

getNotGrantedPermissions

public static java.lang.String[] getNotGrantedPermissions(android.content.Context context,
                                                          java.lang.String... permissions)

Returns the subset of specific permissions, which are not granted.

Parameters:

context - The context, which should be used, as an instance of the class Context. The context may not be null

permissions - An array, which contains the permissions, e.g. android.Manifest.CALL_PHONE, which should be checked, as a String array. The array may not be null

Returns:

An array, which contains the permissions, which are not granted, as a String array or an empty array, if all permissions are granted

shouldShowRequestPermissionRationale

public static boolean shouldShowRequestPermissionRationale(android.app.Activity activity,
                                                           java.lang.String... permissions)

Returns, whether an UI with a rationale for requesting one or multiple permissions should be shown, or not. A rationale should only be shown, if the permissions are not already granted and if the context, in which the permissions are requested, does not clearly communicate to the user what would be the benefit from granting the permissions. For example, if you write a camera app, requesting the camera permission would be expected by the user and no rationale for why it is requested is needed. If however, the app needs location for tagging photos then a non-tech savvy user may wonder how location is related to taking photos. In this case you may choose to show UI with rationale of requesting this permission.

Parameters:

activity - The activity, which should be used to show the rationale, as an instance of the class Activity. The activity may not be null

permissions - An array, which contains the permissions, e.g. android.Manifest.CALL_PHONE, which should be requested, as a String array. The array may not be null

Returns:

True, if a rationale should be shown, false otherwise