Skip to content
Is a library that helps to handle runtime permissions on Android, entirely written using Kotlin language.
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
gradle/wrapper first commit Jun 3, 2019
images added logo for android arsenal Jun 3, 2019
library first commit Jun 3, 2019
sample first commit Jun 3, 2019
.gitignore first commit Jun 3, 2019
LICENSE first commit Jun 3, 2019
README.md added android rsenal badge Jun 5, 2019
build.gradle first commit Jun 3, 2019
dependencies.gradle fixed jitpack issue Jun 13, 2019
gradle.properties first commit Jun 3, 2019
gradlew first commit Jun 3, 2019
gradlew.bat
settings.gradle first commit Jun 3, 2019

README.md

StartaskPermissions

JitPack Android Arsenal

StartaskPermissions is a library that helps to handle runtime permissions on Android, entirely written using Kotlin language.

Using in your projects

Gradle Gradle

The library is published to JitPack repository.

  1. Add the JitPack repository to your root build.gradle at the end of repositories.
allprojects {
    repositories {
        //...
        maven { url 'https://jitpack.io' }
    }
}
  1. Add the dependency

${latest.version} is

dependencies {
    implementation "com.github.illiashenkoo:startask-permissions:${latest.version}"
}

Kotlin Usage with Kotlin

  1. Add the following line to AndroidManifest.xml:
<uses-permission android:name="android.permission.CAMERA" />
  1. Create a Permission object
private val permission: Permission by lazy {
    Permission.Builder(Manifest.permission.CAMERA)
            .setRequestCode(MY_PERMISSIONS_REQUEST_CODE)
            .build()
}
  1. Check and request permission if needed
permission.check(this)
        .onGranted {
            // All requested permissions are granted
        }.onShowRationale {
            // Provide an explanation if the user has already denied that permission request
        }
  1. Delegate the permission handling to library
override fun onRequestPermissionsResult(requestCode: Int, permissions: Array<out String>, grantResults: IntArray) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults)
    permission.onRequestPermissionsResult(this, requestCode, grantResults)
            .onGranted {
                // All requested permissions are granted
            }.onDenied {
                // Oops, some of the permissions are denied
            }.onNeverAskAgain {
                // Oops, some of the permissions are denied
                // User chose "never ask again" about a permission
            }
}

Look at the examples of using the library

License

Apache License 2.0

Contacts

Oleg Illiashenko

Contributions and releases

All development (both new features and bug fixes) is performed in develop branch. This way master sources always contain sources of the most recently released version. Please send PRs with bug fixes to develop branch. Fixes to documentation in markdown files are an exception to this rule. They are updated directly in master.

The develop branch is pushed to master during release.

You can’t perform that action at this time.