https://github.com/euzee/permissionutil
Simple permission helper
https://github.com/euzee/permissionutil
android helper permissions runtime runtime-permissions utils
Last synced: 5 months ago
JSON representation
Simple permission helper
- Host: GitHub
- URL: https://github.com/euzee/permissionutil
- Owner: Euzee
- License: apache-2.0
- Created: 2017-05-08T08:40:22.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2018-07-10T16:54:52.000Z (almost 8 years ago)
- Last Synced: 2023-06-30T14:31:30.681Z (almost 3 years ago)
- Topics: android, helper, permissions, runtime, runtime-permissions, utils
- Language: Java
- Size: 93.8 KB
- Stars: 64
- Watchers: 6
- Forks: 12
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
[](https://android-arsenal.com/details/1/5721) [](http://www.apache.org/licenses/LICENSE-2.0.html) [](https://android-arsenal.com/api?level=16) [](https://circleci.com/gh/Euzee/permissionUtil/tree/master)
# permissionUtil
A simple easy-to-use permission helper for Android.
No need to handle result in onActivityResult and passing it to fragment or model.
PermissionUtil can be used from any place with context only (Activity, Fragment,ViewModel).
``` java
//Easy to use
PermissionUtil.locationBoth(context, requestPermissionListener);
```
## Callback
Added new `CallbackBuilder` so now you can build `PermissionCallback` with or without granted or denied calls. Also you can set resources for rationale explanation.
``` java
new CallbackBuilder()
.onGranted(()->yourGrantedCall())
.onDenied(()->yourDeniedCall())
.withRationale(titleId,messageId)
.build();
```
Simplified callback. Just override method that you need and that's it.
``` java
public abstract class ShortPerCallback implements PermissionCallback {
@Override
public void onPermissionGranted() {
}
@Override
public void onPermissionDenied() {
}
}
```
If you need to show rationale explanation - you may use `CallbackBuilder` or you need to override `getRationaleTitleId()` and `getRationaleMessageId()` of `PermissionCallback` class if you don't wan't to use builder . Dialog won't be shown if `getRationaleMessageId()` will return `0`.
``` java
// default implementation
int getRationaleTitleId() {
return 0;
}
int getRationaleMessageId() {
return 0;
}
```
## Actions
You can directly use prepared requests like :
``` java
PermissionUtil.locationFine(context, requestPermissionListener);
PermissionUtil.locationCoarse(context, requestPermissionListener);
```
Or you can request multiple permissions with your group :
``` java
PermissionUtil.checkGroup(context, requestPermissionListener,new String[]{Manifest.permission.READ_PHONE_STATE});
```
List of permissions that could be requested according to [Dangerous permissions](https://developer.android.com/guide/topics/permissions/requesting.html#normal-dangerous) :
- contactsRead
- contactsWrite
- contactsRW
- calendarRead
- calendarWrite
- calendarRW
- storageRead
- storageWrite
- storageRW
- locationFine
- locationCoarse
- locationBoth
- camera
- microphone
- phoneReadState
- phoneCall
- phoneReadCallLog
- phoneWriteCallLog
- phoneAddVoiceMail
- phoneSip
- phoneOutgoing
- phoneAll
- sensors
- smsSend
- smsReceive
- smsRead
- smsWap
- smsMms
- smsAll
- checkGroup
# Download
[  ](https://bintray.com/euzee/Libs/permissionUtil/_latestVersion) [](https://jitpack.io/#Euzee/permissionUtil)
``` groovy
repositories {
// yo can use
mavenCentral() // or jcenter()
//or direct link to repository or jitpack
maven { url "http://dl.bintray.com/euzee/Libs" } // or maven { url "https://jitpack.io" }
}
(with gradle plugin less then v3 use 'compile' instead of implementation)
implementation 'com.github.euzee:permissionUtil:1.0.7'
```
# License
Copyright 2017 Euzee, Inc.
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.