README.md

PermissionHelper

Android Library to help you with your runtime Permissions.

Demo

Android M Watch it in action.
Pre M Watch it in action. Nexus 6 (M)

Nexus 7 (L)

Nexus 10 (L)

Installation

    compile 'com.github.k0shk0sh:PermissionHelper:1.0.8'

Usage

Ask Permissions in Style

Have you wondered what will give you a higher chance of letting the user accepts your permission?

The answer is simple: (Educating UI) that explains why you need to use that particular permission.

• All you need to do is extending BasePermissionActivity.

  • By extending BasePermissionActivity you'll have control over (Features):
    • Permissions that being asked and their Explanation if its needed.
    • Each Screen Background color (DarkPrimaryColor of that background will be generated automatically).
    • Each Screen Image Resource.
    • Each Screen Title & Message.
    • Each Screen Title & Message Text Color.
    • Each Screen Title & Message Text Size.
    • Each Screen Text & Message FontType, yes you heard me right, each Screen can have their own FontType.
    • Each Screen Next, Previous & Request Buttons Icon Resources.
    • Your Own Theme.
    • Your Own Implementation of ViewPager.PageTransformer or use the default one.
    • You can defined for instance that a particular permission can't be skipped until the Explanation Dialog is showed.(follow example code below to know how).
    • BasePermissionActivity support Portrait & Landscape modes for both Mobile Phones & Tablets (as showing in above images).
    • SYSTEM_ALERT_WINDOW Permission is being automatically handled if you ever pass it along other permissions ;) .

• And Finally Let The Library Do The Job For You. in Style.

Notice

You still can use the library to explain why you used the permission in your app, the library will never try ask the permission if Android is smaller than M, it will just do like any Intro library does. as you can see in Nexus 7 & Nexus 10 screens running Android L, request button is hidden ;).

For Better Understanding, please have a look at the example code at SamplePagerActivity

Take Control.

Your Activity/Presenter should implement OnPermissionCallback which in return will give you access to

    void onPermissionGranted(String[] permissionName);

    void onPermissionDeclined(String[] permissionName);

    void onPermissionPreGranted(String permissionsName);

    void onPermissionNeedExplanation(String permissionName);  
    
    void onPermissionReallyDeclined(String permissionName);//user has ticked don't show again and deny the permission

    void onNoPermissionNeeded(); // fallback to api < M

to request a permission all you have to do is:

permissionHelper
     .setForceAccepting(false)// true if you had like force reshowing the permission dialog on Deny (not recommended)
     .request(isSingle ? SINGLE_PERMISSION : MULTIPLE_PERMISSIONS);

and finally in your Activity

onRequestPermissionsResult(....)

call

permissionHelper.onRequestPermissionsResult(....)

Extra

public static String declinedPermission(@NonNull Context context, @NonNull String[])

public static String[] declinedPermissions(@NonNull Context context, @NonNull String[] permissions)

public static boolean isPermissionGranted(@NonNull Context context, @NonNull String permission)

public static boolean isPermissionDeclined(@NonNull Context context, @NonNull String permission)

public static boolean isExplanationNeeded(@NonNull Activity context, @NonNull String permissionName)

public static boolean permissionExists(@NonNull Context context, @NonNull String permissionName)

public static boolean isPermissionPermanentlyDenied(@NonNull Activity context, @NonNull String permission)

public static void openSettingsScreen(Context context)//useful when we can't request for the permission due to user ticked don't show again.

@TargetApi(Build.VERSION_CODES.M)
public static boolean isSystemAlertGranted(@NonNull Context context)// special case for SYSTEM_ALERT_WINDOW permission.

public void requestAfterExplanation(String permissionName)// to be used if the permission needs explanation

public void requestAfterExplanation(String[] permissions)//to be used if the permission needs explanation

public void requestSystemAlertPermission() // not really needed as request(...) will handle this case.

> all of the above static methods you can still access them with PermissionHelper instance.

To understand more how taking control would look like please go through the sample app

Why this library?

• Its simple to use.
• Its Unique, Customizable & read back first point.
• You have two choices, do it your way through callbacks, or let the Library do it for you with your look & Feel.
• Minimum API is 14, but it'll probably work in API 11 and above, just make sure you test it out.

If you're using this library drop me an email at kosh20111@gmail.com to include in the list.

Dependency

Android Support library v23.1.1

CirclePageIndicator by JakeWharton (integrated within the library).

Images

Images used inside the demo are by Maximilian Keppeler

Copyright Notice

Copyright (C) 2015 Kosh. Licensed under the Apache 2.0 license (see the LICENSE file).