com.tumblr.permissme.utils

Class PermissMeUtils

java.lang.Object

com.tumblr.permissme.utils.PermissMeUtils

public final class PermissMeUtils
extends Object

Utils to help in common runtime permission related tasks introduced in AndroidM

See Also:

Runtime Permissions Ref Doc} Created by sumbul on 1/28/16.

Method Summary

Methods

Modifier and Type	Method and Description
static View.OnClickListener	createSettingsClickListener(Activity activity) The onClickListener that takes you to the app's system settings screen
static String[]	getDeniedPermissions(Context context, String... permissions) Given a list of permissions, get all the permissions that are denied by the user.
static boolean	hasCameraPermission(Context context) Common camera permission check.
static boolean	hasReadWriteStoragePermission(Context context) Common READ/WRITE Storage Permission Check.
static boolean	isAutoDeniedPermission(AppCompatActivity activity, String permission) Checks if the permission is auto-denied, i.e.
static boolean	needToRequestPermission(Context context, String... permissions) Check if we already have access granted for this permission
static void	runOnUiThread(Runnable runnable) Helper method to post a Runnable to the main thread
static void	showPermissionDeniedSnackbar(Activity activity, String customErrorMessage) Shows the snackbar which is used in the scenario where user auto-denied permissions before.
static void	showSnackBar(View view, String msg, int backgroundColor, String ctaString, View.OnClickListener ctaClickListener) Displays a SnackBar message.
static boolean	verifyPermissions(int[] grantResults) Check that all given permissions have been granted by verifying that each entry in the given array is of the value PermissionChecker.PERMISSION_GRANTED.

Methods inherited from class java.lang.Object

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

Method Detail

verifyPermissions

public static boolean verifyPermissions(@NonNull
                        int[] grantResults)

Check that all given permissions have been granted by verifying that each entry in the given array is of the value PermissionChecker.PERMISSION_GRANTED.

Parameters:

grantResults - the results to check whether they are granted

Returns:

whether the permissions have been granted

See Also:

Activity.onRequestPermissionsResult(int, String[], int[])

getDeniedPermissions

@NonNull
public static String[] getDeniedPermissions(@NonNull
                                    Context context,
                                    @Nullable
                                    String... permissions)

Given a list of permissions, get all the permissions that are denied by the user.

Parameters:

context - Caller context

permissions - List of permissions to check

Returns:

The denied permission, if there is one, else empty array

needToRequestPermission

public static boolean needToRequestPermission(@NonNull
                              Context context,
                              @NonNull
                              String... permissions)

Check if we already have access granted for this permission

Parameters:

context - The caller activity

permissions - The permissions that needs to be granted

Returns:

Whether we have access to the permission

showPermissionDeniedSnackbar

public static void showPermissionDeniedSnackbar(@NonNull
                                Activity activity,
                                @Nullable
                                String customErrorMessage)

Shows the snackbar which is used in the scenario where user auto-denied permissions before. It can also be used to display the permissions snackbar if user is trying to interact with a feature which requires permissions the user hasn't granted

Parameters:

activity - the activity with the view to attach the snackbar to

customErrorMessage - an optional custom error message. this method uses the default one if the custom one is null

hasCameraPermission

public static boolean hasCameraPermission(Context context)

Common camera permission check.

Parameters:

context - caller context

Returns:

whether the package has camera permissions granted

hasReadWriteStoragePermission

public static boolean hasReadWriteStoragePermission(Context context)

Common READ/WRITE Storage Permission Check.

Parameters:

context - caller context

Returns:

whether the package has read+write storage permissions granted

isAutoDeniedPermission

public static boolean isAutoDeniedPermission(AppCompatActivity activity,
                             @NonNull
                             String permission)

Checks if the permission is auto-denied, i.e. the user tapped "Never ask again" in the dialog before, thus, the permission cannot be queried for

Parameters:

activity - the activity

permission - the permission being queried

Returns:

whether the permission was auto-denied by the system for the package

createSettingsClickListener

public static View.OnClickListener createSettingsClickListener(Activity activity)

The onClickListener that takes you to the app's system settings screen

Parameters:

activity - the caller activity used to start the settings intent

Returns:

the View.OnClickListener

showSnackBar

public static void showSnackBar(View view,
                String msg,
                int backgroundColor,
                String ctaString,
                View.OnClickListener ctaClickListener)

Displays a SnackBar message.

Parameters:

view - the view to find a parent from.

msg - the message to display.

backgroundColor - the background color.

ctaString - the call to action string

ctaClickListener - the call to action click listener.

runOnUiThread

public static void runOnUiThread(Runnable runnable)

Helper method to post a Runnable to the main thread

Parameters:

runnable - runnable to execute on the main thread