Permissions Flow

Additional

Language
Kotlin
Version
N/A
Created
Apr 27, 2020
Updated
Oct 29, 2023
Owner
Robert (robertlevonyan)
Contributors
MFlisar
Robert (robertlevonyan)
Robert Levonyan (robertpicsart)
3
Activity
Badge
Generate
Download
Source code

Advertisement

Permissions Flow

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

  repositories {
    mavenCentral()
  }

Gradle:

Add following line of code to your module (app) level gradle file:

    implementation 'com.robertlevonyan.components:PermissionsFlow:<LATEST-VERSION>'

Kotlin:

    implementation("com.robertlevonyan.components:PermissionsFlow:$LATEST_VERSION")

Maven:

  <dependency>
    <groupId>com.robertlevonyan.components</groupId>
    <artifactId>PermissionsFlow</artifactId>
    <version>LATEST-VERSION</version>
    <type>pom</type>
  </dependency>

Usage:

Permission flow offers 2 simple extension functions - both for for activities/fragments:

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:

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

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.