pub.devrel.easypermissions

Class EasyPermissions

java.lang.Object

pub.devrel.easypermissions.EasyPermissions

public class EasyPermissions
extends java.lang.Object

Utility to request and check System permissions for apps targeting Android M (API >= 23).

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	EasyPermissions.PermissionCallbacks Callback interface to receive the results of EasyPermissions.requestPermissions() calls.
static interface	EasyPermissions.RationaleCallbacks Callback interface to receive button clicked events of the rationale dialog

Constructor Summary

Constructors

Constructor and Description
EasyPermissions()

Method Summary

Modifier and Type	Method and Description
static boolean	hasPermissions(android.content.Context context, java.lang.String... perms) Check if the calling context has a set of permissions.
static void	onRequestPermissionsResult(int requestCode, java.lang.String[] permissions, int[] grantResults, java.lang.Object... receivers) Handle the result of a permission request, should be called from the calling Activity's ActivityCompat.OnRequestPermissionsResultCallback#onRequestPermissionsResult(int, String[], int[]) method.
static boolean	permissionPermanentlyDenied(android.app.Activity host, java.lang.String deniedPermission) Check if a permission has been permanently denied (user clicked "Never ask again").
static boolean	permissionPermanentlyDenied(Fragment host, java.lang.String deniedPermission)
static void	requestPermissions(android.app.Activity host, java.lang.String rationale, int positiveButton, int negativeButton, int requestCode, java.lang.String... perms) Deprecated. use requestPermissions(PermissionRequest) instead
static void	requestPermissions(android.app.Activity host, java.lang.String rationale, int requestCode, java.lang.String... perms) Request a set of permissions, showing a rationale if the system requests it.
static void	requestPermissions(Fragment host, java.lang.String rationale, int positiveButton, int negativeButton, int requestCode, java.lang.String... perms) Deprecated. use requestPermissions(PermissionRequest) instead
static void	requestPermissions(Fragment host, java.lang.String rationale, int requestCode, java.lang.String... perms) Request permissions from a Support Fragment with standard OK/Cancel buttons.
static void	requestPermissions(PermissionRequest request) Request a set of permissions.
static boolean	somePermissionDenied(android.app.Activity host, java.lang.String... perms) See if some denied permission has been permanently denied.
static boolean	somePermissionDenied(Fragment host, java.lang.String... perms)
static boolean	somePermissionPermanentlyDenied(android.app.Activity host, java.util.List<java.lang.String> deniedPermissions) Check if at least one permission in the list of denied permissions has been permanently denied (user clicked "Never ask again").
static boolean	somePermissionPermanentlyDenied(Fragment host, java.util.List<java.lang.String> deniedPermissions)

Methods inherited from class java.lang.Object

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

Constructor Detail

EasyPermissions

public EasyPermissions()

Method Detail

hasPermissions

public static boolean hasPermissions(android.content.Context context,
                                     java.lang.String... perms)

Check if the calling context has a set of permissions.

Parameters:

context - the calling context.

perms - one ore more permissions, such as Manifest.permission#CAMERA.

Returns:

true if all permissions are already granted, false if at least one permission is not yet granted.

See Also:

Manifest.permission

requestPermissions

public static void requestPermissions(android.app.Activity host,
                                      java.lang.String rationale,
                                      int requestCode,
                                      java.lang.String... perms)

Request a set of permissions, showing a rationale if the system requests it.

Parameters:

host - requesting context.

rationale - a message explaining why the application needs this set of permissions; will be displayed if the user rejects the request the first time.

requestCode - request code to track this request, must be < 256.

perms - a set of permissions to be requested.

See Also:

Manifest.permission

requestPermissions

public static void requestPermissions(Fragment host,
                                      java.lang.String rationale,
                                      int requestCode,
                                      java.lang.String... perms)

Request permissions from a Support Fragment with standard OK/Cancel buttons.

See Also:

requestPermissions(Activity, String, int, String...)

requestPermissions

@Deprecated
public static void requestPermissions(android.app.Activity host,
                                                  java.lang.String rationale,
                                                  int positiveButton,
                                                  int negativeButton,
                                                  int requestCode,
                                                  java.lang.String... perms)

Deprecated. use requestPermissions(PermissionRequest) instead

Request a set of permissions, showing rationale if the system requests it.

Parameters:

host - requesting context.

rationale - a message explaining why the application needs this set of permissions, will be displayed if the user rejects the request the first time.

positiveButton - custom text for positive button

negativeButton - custom text for negative button

requestCode - request code to track this request, must be < 256.

perms - a set of permissions to be requested.

See Also:

Manifest.permission

requestPermissions

@Deprecated
public static void requestPermissions(Fragment host,
                                                  java.lang.String rationale,
                                                  int positiveButton,
                                                  int negativeButton,
                                                  int requestCode,
                                                  java.lang.String... perms)

Deprecated. use requestPermissions(PermissionRequest) instead

Request permissions from a Support Fragment.

See Also:

requestPermissions(Activity, String, int, int, int, String...)

requestPermissions

public static void requestPermissions(PermissionRequest request)

Request a set of permissions.

Parameters:

request - the permission request

See Also:

PermissionRequest

onRequestPermissionsResult

public static void onRequestPermissionsResult(int requestCode,
                                              java.lang.String[] permissions,
                                              int[] grantResults,
                                              java.lang.Object... receivers)

Handle the result of a permission request, should be called from the calling Activity's ActivityCompat.OnRequestPermissionsResultCallback#onRequestPermissionsResult(int, String[], int[]) method.

If any permissions were granted or denied, the object will receive the appropriate callbacks through EasyPermissions.PermissionCallbacks and methods annotated with AfterPermissionGranted will be run if appropriate.

Parameters:

requestCode - requestCode argument to permission result callback.

permissions - permissions argument to permission result callback.

grantResults - grantResults argument to permission result callback.

receivers - an array of objects that have a method annotated with AfterPermissionGranted or implement EasyPermissions.PermissionCallbacks.

somePermissionPermanentlyDenied

public static boolean somePermissionPermanentlyDenied(android.app.Activity host,
                                                      java.util.List<java.lang.String> deniedPermissions)

Check if at least one permission in the list of denied permissions has been permanently denied (user clicked "Never ask again").

Parameters:

host - context requesting permissions.

deniedPermissions - list of denied permissions, usually from EasyPermissions.PermissionCallbacks.onPermissionsDenied(int, List)

Returns:

true if at least one permission in the list was permanently denied.

somePermissionPermanentlyDenied

public static boolean somePermissionPermanentlyDenied(Fragment host,
                                                      java.util.List<java.lang.String> deniedPermissions)

See Also:

somePermissionPermanentlyDenied(Activity, List)

permissionPermanentlyDenied

public static boolean permissionPermanentlyDenied(android.app.Activity host,
                                                  java.lang.String deniedPermission)

Check if a permission has been permanently denied (user clicked "Never ask again").

Parameters:

host - context requesting permissions.

deniedPermission - denied permission.

Returns:

true if the permissions has been permanently denied.

permissionPermanentlyDenied

public static boolean permissionPermanentlyDenied(Fragment host,
                                                  java.lang.String deniedPermission)

See Also:

permissionPermanentlyDenied(Activity, String)

somePermissionDenied

public static boolean somePermissionDenied(android.app.Activity host,
                                           java.lang.String... perms)

See if some denied permission has been permanently denied.

Parameters:

host - requesting context.

perms - array of permissions.

Returns:

true if the user has previously denied any of the perms and we should show a rationale, false otherwise.

somePermissionDenied

public static boolean somePermissionDenied(Fragment host,
                                           java.lang.String... perms)

See Also:

somePermissionDenied(Activity, String...)