Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dsiner/permissioncompat

Android runtime permissions without RxJava2 ——Android 6.0 运行时权限
https://github.com/dsiner/permissioncompat

android-permissions permission runtime-permissions

Last synced: about 1 month ago
JSON representation

Android runtime permissions without RxJava2 ——Android 6.0 运行时权限

Awesome Lists containing this project

README

        

# PermissionCompat for Android

[![License](https://img.shields.io/badge/license-Apache%202-green.svg)](https://www.apache.org/licenses/LICENSE-2.0)
[![API](https://img.shields.io/badge/API-9%2B-green.svg?style=flat)](https://android-arsenal.com/api?level=9)
[![Download](https://api.bintray.com/packages/dsiner/maven/permissioncompat/images/download.svg) ](https://bintray.com/dsiner/maven/permissioncompat/_latestVersion)

> A library to handle runtime permissions

## Set up
Maven:
```xml

com.dsiner.lib
permissioncompat
1.0.3

```
or Gradle:
```groovy
compile 'com.dsiner.lib:permissioncompat:1.0.3'
```

## Features
- [x] Fully Marshmallow support
- [x] Xiaomi support
- [x] Special devices support, such as Xiaomi, Meizu, Oppo, etc. it's not good, can not be 100% supported

## Support level
- `SUPPORT_LEVEL_M` If you only want to support Marshmallow above. 'Default options'
- `SUPPORT_LEVEL_M_XIAOMI` If you only want to support Marshmallow above and Xiaomi device.
- `SUPPORT_LEVEL_L` If you want to support LOLLIPOP above, such as Xiaomi, Meizu, Oppo, etc. Not Suggest

## Initialize in the application

```java
public class App extends Application {

@Override
public void onCreate() {
super.onCreate();
// Set support level
PermissionSupport.setLevel(PermissionSupport.SUPPORT_LEVEL_M_XIAOMI);
// You can set the thread pool yourself here, otherwise the default will be used.
PermissionSupport.setThreadPool(new ThreadPool() {
@Override
public void executeMain(Runnable r) {
TaskScheduler.executeMain(r);
}

@Override
public void executeTask(Runnable r) {
TaskScheduler.executeTask(r);
}

@Override
public void executeNew(Runnable r) {
TaskScheduler.executeNew(r);
}
});
}
}
```

## Usage

1. Check whether the permissions are all already granted

```java
PermissionChecker.isGranted(context, permissions)
or
PermissionCompat.hasSelfPermissions(context, permissions)
```

2. Request permissions

```java
PermissionCompat.with(activity)
.requestEachCombined(Manifest.permission.READ_EXTERNAL_STORAGE, Manifest.permission.WRITE_EXTERNAL_STORAGE)
.subscribeOn(PermissionSchedulers.io())
.observeOn(PermissionSchedulers.mainThread())
.requestPermissions(new PermissionCallback() {
@Override
public void onNext(Permission permission) {
if (permission.granted) {
// All permissions are granted !
Toast.makeText(getApplicationContext(), "All permissions are granted", Toast.LENGTH_SHORT).show();
} else if (permission.shouldShowRequestPermissionRationale) {
// At least one denied permission without ask never again
Toast.makeText(getApplicationContext(), "Permission without ask never again", Toast.LENGTH_SHORT).show();
} else {
// At least one denied permission with ask never again
// Need to go to the settings
Toast.makeText(getApplicationContext(), "Need to go to the settings", Toast.LENGTH_SHORT).show();
}
}
});
```

3. Request permissions in asynchronous thread

```java
PermissionCompat.checkSelfPermissions(activity, new WeakRefSimpleCallback(activity), PERMISSIONS);
```

## Latest Changes
- [Changelog.md](CHANGELOG.md)

More usage see [Demo](app/src/main/java/com/d/permissioncompat/MainActivity.java)

## Licence

```txt
Copyright 2018 D

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.
```