Hi, Guys. Welcome to Android Kotlin Runtime Permissions example.
In this tutorial, We will learn how to programmatically request multiple Android Kotlin Runtime Permissions.
From android’s Marshmallow version, the developer needs to programmatically check and request multiple Android Kotlin Runtime Permissions to the user.
Using our code, you can ask for multiple or single runtime permissions android as per your requirements.
Following is the output:
Download Source Code For Check Multiple Android Kotlin Runtime Permissions
[sociallocker]Kotlin_MarshmallowPermission[/sociallocker]
Understanding Runtime Permissions Architecture
As you have seen in the video, a dialog is created for asking every permission.
If the user denies, it will again ask when the user opens an Android app.
Once user allows, it will never ask for same permission in the future.
There is also one checkbox saying “Never ask again,” if the user clicks on that and then after deny, then Android will never ask for that permission.
For handling above situation, Android opens another dialog which allows the user to go to setting of our app and from there, he can turn on and off various permissions.
Following are required code snippets.
Step 1: Creating WelcomeActivity.kt class:
Create new Activity named WelcomeActivity.kt and add below code
import android.support.v7.app.AppCompatActivity import android.os.Bundle class WelcomeActivity : AppCompatActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_welcome) } }
Update activity_welcome.xml as below
<?xml version="1.0" encoding="utf-8"?> <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent" android:paddingBottom="10dp" android:paddingLeft="10dp" android:paddingRight="10dp" android:paddingTop="10dp" tools:context="com.example.parsaniahardik.kotlin_marshmallowpermission.WelcomeActivity"> <TextView android:layout_width="match_parent" android:layout_height="match_parent" android:gravity="center" android:text="Welcome" android:textSize="40sp"/> </RelativeLayout>
Step 2: Creating MainActivity.kt class:
import android.Manifest import android.app.AlertDialog import android.content.DialogInterface import android.content.Intent import android.content.pm.PackageManager import android.net.Uri import android.os.Handler import android.support.v4.app.ActivityCompat import android.support.v4.content.ContextCompat import android.support.v7.app.AppCompatActivity import android.os.Bundle import android.util.Log import java.util.ArrayList import java.util.HashMap class MainActivity : AppCompatActivity() { private val TAG = "tag" override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) if (checkAndRequestPermissions()) { // carry on the normal flow, as the case of permissions granted. Handler().postDelayed({ // This method will be executed once the timer is over // Start your app main activity val i = Intent(this@MainActivity, WelcomeActivity::class.java) startActivity(i) // close this activity finish() }, SPLASH_TIME_OUT.toLong()) } } private fun checkAndRequestPermissions(): Boolean { val camerapermission = ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA) val writepermission = ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) val permissionLocation = ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) val permissionRecordAudio = ContextCompat.checkSelfPermission(this, Manifest.permission.RECORD_AUDIO) val listPermissionsNeeded = ArrayList<String>() if (camerapermission != PackageManager.PERMISSION_GRANTED) { listPermissionsNeeded.add(Manifest.permission.CAMERA) } if (writepermission != PackageManager.PERMISSION_GRANTED) { listPermissionsNeeded.add(Manifest.permission.WRITE_EXTERNAL_STORAGE) } if (permissionLocation != PackageManager.PERMISSION_GRANTED) { listPermissionsNeeded.add(Manifest.permission.ACCESS_FINE_LOCATION) } if (permissionRecordAudio != PackageManager.PERMISSION_GRANTED) { listPermissionsNeeded.add(Manifest.permission.RECORD_AUDIO) } if (!listPermissionsNeeded.isEmpty()) { ActivityCompat.requestPermissions(this, listPermissionsNeeded.toTypedArray(), REQUEST_ID_MULTIPLE_PERMISSIONS) return false } return true } override fun onRequestPermissionsResult(requestCode: Int, permissions: Array<String>, grantResults: IntArray) { Log.d(TAG, "Permission callback called-------") when (requestCode) { REQUEST_ID_MULTIPLE_PERMISSIONS -> { val perms = HashMap<String, Int>() // Initialize the map with both permissions perms[Manifest.permission.CAMERA] = PackageManager.PERMISSION_GRANTED perms[Manifest.permission.WRITE_EXTERNAL_STORAGE] = PackageManager.PERMISSION_GRANTED perms[Manifest.permission.ACCESS_FINE_LOCATION] = PackageManager.PERMISSION_GRANTED perms[Manifest.permission.RECORD_AUDIO] = PackageManager.PERMISSION_GRANTED // Fill with actual results from user if (grantResults.size > 0) { for (i in permissions.indices) perms[permissions[i]] = grantResults[i] // Check for both permissions if (perms[Manifest.permission.CAMERA] == PackageManager.PERMISSION_GRANTED && perms[Manifest.permission.WRITE_EXTERNAL_STORAGE] == PackageManager.PERMISSION_GRANTED && perms[Manifest.permission.ACCESS_FINE_LOCATION] == PackageManager.PERMISSION_GRANTED && perms[Manifest.permission.RECORD_AUDIO] == PackageManager.PERMISSION_GRANTED) { Log.d(TAG, "sms & location services permission granted") // process the normal flow val i = Intent(this@MainActivity, WelcomeActivity::class.java) startActivity(i) finish() //else any one or both the permissions are not granted } else { Log.d(TAG, "Some permissions are not granted ask again ") //permission is denied (this is the first time, when "never ask again" is not checked) so ask again explaining the usage of permission // // shouldShowRequestPermissionRationale will return true //show the dialog or snackbar saying its necessary and try again otherwise proceed with setup. if (ActivityCompat.shouldShowRequestPermissionRationale(this, Manifest.permission.CAMERA) || ActivityCompat.shouldShowRequestPermissionRationale(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) || ActivityCompat.shouldShowRequestPermissionRationale(this, Manifest.permission.ACCESS_FINE_LOCATION) || ActivityCompat.shouldShowRequestPermissionRationale(this, Manifest.permission.RECORD_AUDIO)) { showDialogOK("Service Permissions are required for this app", DialogInterface.OnClickListener { dialog, which -> when (which) { DialogInterface.BUTTON_POSITIVE -> checkAndRequestPermissions() DialogInterface.BUTTON_NEGATIVE -> // proceed with logic by disabling the related features or quit the app. finish() } }) } else { explain("You need to give some mandatory permissions to continue. Do you want to go to app settings?") // //proceed with logic by disabling the related features or quit the app. }//permission is denied (and never ask again is checked) //shouldShowRequestPermissionRationale will return false } } } } } private fun showDialogOK(message: String, okListener: DialogInterface.OnClickListener) { AlertDialog.Builder(this) .setMessage(message) .setPositiveButton("OK", okListener) .setNegativeButton("Cancel", okListener) .create() .show() } private fun explain(msg: String) { val dialog = android.support.v7.app.AlertDialog.Builder(this) dialog.setMessage(msg) .setPositiveButton("Yes") { paramDialogInterface, paramInt -> // permissionsclass.requestPermission(type,code); startActivity(Intent(android.provider.Settings.ACTION_APPLICATION_DETAILS_SETTINGS, Uri.parse("package:com.example.parsaniahardik.kotlin_marshmallowpermission"))) } .setNegativeButton("Cancel") { paramDialogInterface, paramInt -> finish() } dialog.show() } companion object { val REQUEST_ID_MULTIPLE_PERMISSIONS = 1 private val SPLASH_TIME_OUT = 2000 } }
Step 3: Description of MainActivity
Defining permission codes
In checkAndRequestPermissions() method, create permission code for each permission like below.
val camerapermission = ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA) val writepermission = ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) val permissionLocation = ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) val permissionRecordAudio = ContextCompat.checkSelfPermission(this, Manifest.permission.RECORD_AUDIO)
Preparing ArrayList
Add each permission in ArrayList and ask user by below source code
val listPermissionsNeeded = ArrayList<String>() if (camerapermission != PackageManager.PERMISSION_GRANTED) { listPermissionsNeeded.add(Manifest.permission.CAMERA) } if (writepermission != PackageManager.PERMISSION_GRANTED) { listPermissionsNeeded.add(Manifest.permission.WRITE_EXTERNAL_STORAGE) } if (permissionLocation != PackageManager.PERMISSION_GRANTED) { listPermissionsNeeded.add(Manifest.permission.ACCESS_FINE_LOCATION) } if (permissionRecordAudio != PackageManager.PERMISSION_GRANTED) { listPermissionsNeeded.add(Manifest.permission.RECORD_AUDIO) } if (!listPermissionsNeeded.isEmpty()) { ActivityCompat.requestPermissions(this, listPermissionsNeeded.toTypedArray(), REQUEST_ID_MULTIPLE_PERMISSIONS) return false }
Hashmap Creation
In onRequestPermissionResult() method, put all permission in one Hashmap.
val perms = HashMap<String, Int>() // Initialize the map with both permissions perms[Manifest.permission.CAMERA] = PackageManager.PERMISSION_GRANTED perms[Manifest.permission.WRITE_EXTERNAL_STORAGE] = PackageManager.PERMISSION_GRANTED perms[Manifest.permission.ACCESS_FINE_LOCATION] = PackageManager.PERMISSION_GRANTED perms[Manifest.permission.RECORD_AUDIO] = PackageManager.PERMISSION_GRANTED
Now check if all permissions are granted or not.
If granted, open WelcomeActivity or continue to the normal flow of your app.
If not granted, then ask again with your message.
// Fill with actual results from user if (grantResults.size > 0) { for (i in permissions.indices) perms[permissions[i]] = grantResults[i] // Check for both permissions if (perms[Manifest.permission.CAMERA] == PackageManager.PERMISSION_GRANTED && perms[Manifest.permission.WRITE_EXTERNAL_STORAGE] == PackageManager.PERMISSION_GRANTED && perms[Manifest.permission.ACCESS_FINE_LOCATION] == PackageManager.PERMISSION_GRANTED && perms[Manifest.permission.RECORD_AUDIO] == PackageManager.PERMISSION_GRANTED) { Log.d(TAG, "sms & location services permission granted") // process the normal flow val i = Intent(this@MainActivity, WelcomeActivity::class.java) startActivity(i) finish() //else any one or both the permissions are not granted } else { Log.d(TAG, "Some permissions are not granted ask again ") //permission is denied (this is the first time, when "never ask again" is not checked) so ask again explaining the usage of permission // // shouldShowRequestPermissionRationale will return true //show the dialog or snackbar saying its necessary and try again otherwise proceed with setup. if (ActivityCompat.shouldShowRequestPermissionRationale(this, Manifest.permission.CAMERA) || ActivityCompat.shouldShowRequestPermissionRationale(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) || ActivityCompat.shouldShowRequestPermissionRationale(this, Manifest.permission.ACCESS_FINE_LOCATION) || ActivityCompat.shouldShowRequestPermissionRationale(this, Manifest.permission.RECORD_AUDIO)) { showDialogOK("Service Permissions are required for this app", DialogInterface.OnClickListener { dialog, which -> when (which) { DialogInterface.BUTTON_POSITIVE -> checkAndRequestPermissions() DialogInterface.BUTTON_NEGATIVE -> // proceed with logic by disabling the related features or quit the app. finish() } }) } else { explain("You need to give some mandatory permissions to continue. Do you want to go to app settings?") // //proceed with logic by disabling the related features or quit the app. }
Update Package name
In explain() method you need to update package name in below line
explain("You need to give some mandatory permissions to continue. Do you want to go to app settings?")
Define required permissions in AndroidManifest.xml
<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.parsaniahardik.kotlin_marshmallowpermission"> <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> <uses-permission android:name="android.permission.CAMERA" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.RECORD_AUDIO" /> <application android:allowBackup="true" android:icon="@mipmap/ic_launcher" android:label="@string/app_name" android:roundIcon="@mipmap/ic_launcher_round" android:supportsRtl="true" android:theme="@style/AppTheme"> <activity android:name=".MainActivity"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> </application> </manifest>
What are Normal Permissions?
Now, notice one thing. We have to define INTERNET permission in manifest file but have not ask for same in MainActivity.java class.
Android has classified some permissions as Normal Permissions, which are not very dangerous for user’s security and that’s why we don’t need to ask for those normal permissions but need to define them in the Manifest file.
You can find some more details and list of normal permissions here on an official document.
Java Version
Java version of this tutorial : Runtime Permissions Android Studio.
If you have any question about implementing check request multiple android kotlin runtime permissions, feel free ask in the comment section.
Cheers and happy coding!