Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/robertlevonyan/permissions-flow
A simple library to make it easy requesting permissions in Android using Kotlin Coroutines.
https://github.com/robertlevonyan/permissions-flow
android android-app android-application android-architecture android-development android-library android-sdk kotlin kotlin-android kotlin-coroutines kotlin-extensions kotlin-library library permissions
Last synced: 7 days ago
JSON representation
A simple library to make it easy requesting permissions in Android using Kotlin Coroutines.
- Host: GitHub
- URL: https://github.com/robertlevonyan/permissions-flow
- Owner: robertlevonyan
- License: apache-2.0
- Created: 2020-04-27T07:17:18.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-10-29T14:34:34.000Z (about 1 year ago)
- Last Synced: 2024-10-12T20:23:17.423Z (22 days ago)
- Topics: android, android-app, android-application, android-architecture, android-development, android-library, android-sdk, kotlin, kotlin-android, kotlin-coroutines, kotlin-extensions, kotlin-library, library, permissions
- Language: Kotlin
- Size: 281 KB
- Stars: 86
- Watchers: 5
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-list - robertlevonyan/permissions-flow - A simple library to make it easy requesting permissions in Android using Kotlin Coroutines. (Kotlin)
README
# Permissions Flow
[](https://maven-badges.herokuapp.com/maven-central/com.robertlevonyan.components/PermissionsFlow)
[](https://android-arsenal.com/api?level=21)
A simple library to make it easy requesting permissions in Android using Kotlin Coroutines.
## Setup
Add following line of code to your project level gradle file
```kotlin
repositories {
mavenCentral()
}
```
#### Gradle:
Add following line of code to your module (app) level gradle file:
```groovy
implementation 'com.robertlevonyan.components:PermissionsFlow:'
```
#### Kotlin:
```kotlin
implementation("com.robertlevonyan.components:PermissionsFlow:$LATEST_VERSION")
```
#### Maven:
```xml
com.robertlevonyan.components
PermissionsFlow
LATEST-VERSION
pom
```
### Usage:
Permission flow offers 2 simple extension functions - both for for activities/fragments:
```kotlin
requestPermissions(vararg permissionsToRequest: String)
requestEachPermissions(vararg permissionsToRequest: String)
```
Both functions do request all permissions passed to them - the first one emits a list of `Permissions`, the second one flattens the permissions.
Here's a full code example like it would look like in an activity:
```kotlin
override fun onCreate(savedInstanceState: Bundle?) {
CoroutineScope(Dispatchers.Main).launch {
// just call requestPermission and pass in all required permissions
requestPermissions(Manifest.permission.CAMERA, Manifest.permission.WRITE_EXTERNAL_STORAGE)
.collect { permissions ->
// here you get the result of the requests, permissions holds a list of Permission requests and you can check if all of them have been granted:
val allGranted = permissions.find { !it.isGranted } == null
// or iterate over the permissions and check them one by one
permissions.forEach {
val granted = it.isGranted
// ...
}
}
}
}
```
## That's it!
With only few simple steps you can request permissions without splitting your code or overriding functions.
## Versions
#### 1.2.1 - 1.2.3
Update to Java 11,
SDK 31 ready,
Minor updates
### 1.2.0
Migration to mavenCentral
#### 1.1.0
Extensions for Fragment and Activity added
### 1.0.0
First version of library
## Contact
- **Email**: [email protected]
- **Website**: https://robertlevonyan.com/
- **Medium**: https://medium.com/@RobertLevonyan
- **Twitter**: https://twitter.com/@RobertLevonyan
- **Google Play**: https://play.google.com/store/apps/dev?id=5477562049350283357
## Licence
```
Permissions Flow©
Copyright 2020 Robert Levonyan
Url: https://github.com/innfinity-am/PermissionsFlow
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.
```