Skip to content

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

License

Notifications You must be signed in to change notification settings

illiashenkoo/startask-permissions

Repository files navigation

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.