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

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