Android Runtime Permission Library
Easily handle runtime permissions in android.
- Very short code.
- Handle "don't ask again" condition.
- Can request from any context (Activity, Service, Fragment, etc).
- Can check multiple permissions at once.
- Light weight (12 KB).
- Used by hundreds of developers.
- Quick support.
- Open source and fully customizable.
Dependency:
Gradle (Jcenter)
implementation 'com.nabinbhandari.android:permissions:3.8'
Usage:
First declare your permissions in the manifest. Example:
<uses-permission android:name="android.permission.CAMERA" />Single permission:
Permissions.check(this/*context*/, Manifest.permission.CALL_PHONE, null, new PermissionHandler() {
@Override
public void onGranted() {
// do your task.
}
});Multiple permissions:
String[] permissions = {Manifest.permission.CAMERA, Manifest.permission.WRITE_EXTERNAL_STORAGE};
Permissions.check(this/*context*/, permissions, null/*rationale*/, null/*options*/, new PermissionHandler() {
@Override
public void onGranted() {
// do your task.
}
});Customized permissions request:
String[] permissions = {Manifest.permission.ACCESS_FINE_LOCATION};
String rationale = "Please provide location permission so that you can ...";
Permissions.Options options = new Permissions.Options()
.setRationaleDialogTitle("Info")
.setSettingsDialogTitle("Warning");
Permissions.check(this/*context*/, permissions, rationale, options, new PermissionHandler() {
@Override
public void onGranted() {
// do your task.
}
@Override
public void onDenied(Context context, ArrayList<String> deniedPermissions) {
// permission denied, block the feature.
}
});- You can also override other methods like onDenied, onJustBlocked, etc if you want to change the default behaviour.
- Dialog messages and texts can be modified by building the options parameter.
- See documentation in the source code for more customizations.
If you find this library useful, please consider starring this repository from the top of this page.
LICENSE
Copyright 2018 Nabin Bhandari
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.