How To Tell Whether My App Needs Certain Permissions Android Manifest

Starting from Android Marshmallow (API 23), users will be asked for permissions while the app is running. This way, a user is able to choose which permissions they should grant without affecting the application flow. In this tutorial I will cover requesting runtime permissions in Android M and N, how to perform a request, get its result and then handle it.

Requesting a Permission

There are many user-permissions in Android but I am only going to focus on some of the most used.

You can find the code for this project in github.

To begin, create a new project in Android Studio, choosing a minimum API level of 23 and adding an Empty Activity. This will be the only activity in the project.

Declaring Permissions

Open AndroidManifest.xml and add the following permissions:

                                                    <uses-permission                              android:name                              =                "android.permission.ACCESS_COARSE_LOCATION"                            />                                                      <uses-permission                              android:name                              =                "android.permission.ACCESS_FINE_LOCATION"                            />                                                      <uses-permission                              android:name                              =                "android.permission.CALL_PHONE"                            />                                                      <uses-permission                              android:name                              =                "android.permission.WRITE_EXTERNAL_STORAGE"                            />                                                      <uses-permission                              android:name                              =                "android.permission.READ_EXTERNAL_STORAGE"                            />                                                      <uses-permission                              android:name                              =                "android.permission.CAMERA"                            />                                                      <uses-permission                              android:name                              =                "android.permission.GET_ACCOUNTS"                            />

The permissions above are some of the most used in android apps, but all of them work in a similar way.

Asking for Permission

Each of this permissions will be asked for by using a button. Update the code inside activity_main.xml to:

                      <?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                              =                "@dimen/activity_vertical_margin"                                            android:paddingLeft                              =                "@dimen/activity_horizontal_margin"                                            android:paddingRight                              =                "@dimen/activity_horizontal_margin"                                            android:paddingTop                              =                "@dimen/activity_vertical_margin"                                            tools:context                              =                "com.example.theodhor.runtimepermissions.MainActivity"                            >                                                      <LinearLayout                              android:orientation                              =                "vertical"                                            android:layout_width                              =                "wrap_content"                                            android:layout_height                              =                "wrap_content"                                            android:layout_centerHorizontal                              =                "true"                            >                                                      <Button                              android:layout_width                              =                "match_parent"                                            android:layout_height                              =                "wrap_content"                                            android:text                              =                "Location"                                            android:id                              =                "@+id/location"                                            android:layout_marginBottom                              =                "10dp"                                            android:onClick                              =                "ask"                            />                                                      <Button              style                              =                "?android:attr/buttonStyleSmall"                                            android:layout_width                              =                "match_parent"                                            android:layout_height                              =                "wrap_content"                                            android:text                              =                "Write ExStorage"                                            android:id                              =                "@+id/write"                                            android:onClick                              =                "ask"                                            android:layout_marginBottom                              =                "10dp"                            />                                                      <Button                              android:layout_width                              =                "match_parent"                                            android:layout_height                              =                "wrap_content"                                            android:text                              =                "Read ExStorage"                                            android:id                              =                "@+id/read"                                            android:layout_marginBottom                              =                "10dp"                                            android:onClick                              =                "ask"                            />                                                      <Button                              android:layout_width                              =                "match_parent"                                            android:layout_height                              =                "wrap_content"                                            android:text                              =                "Call"                                            android:id                              =                "@+id/call"                                            android:layout_marginBottom                              =                "10dp"                                            android:onClick                              =                "ask"                            />                                                      <Button                              android:layout_width                              =                "match_parent"                                            android:layout_height                              =                "wrap_content"                                            android:text                              =                "Camera"                                            android:id                              =                "@+id/camera"                                            android:layout_marginBottom                              =                "10dp"                                            android:onClick                              =                "ask"                            />                                                      <Button                              android:layout_width                              =                "match_parent"                                            android:layout_height                              =                "wrap_content"                                            android:text                              =                "Get Accounts"                                            android:id                              =                "@+id/accounts"                                            android:layout_marginBottom                              =                "10dp"                                            android:onClick                              =                "ask"                            />                                                      </LinearLayout              >                                                      </RelativeLayout              >

This is the layout you just created:

Layout

At this stage, if a user installed the application, it would require the following permissions:

Permissions Required

Inside MainActivity.java, after onCreate add this method:

                      private            void            askForPermission            (            String            permission,            Integer            requestCode)            {            if            (            ContextCompat            .            checkSelfPermission            (            MainActivity            .            this            ,            permission)            !=            PackageManager            .PERMISSION_GRANTED)            {            // Should we show an explanation?            if            (            ActivityCompat            .            shouldShowRequestPermissionRationale            (            MainActivity            .            this            ,            permission)            )            {            //This is called if user has denied the permission before            //In this case I am just asking the permission again            ActivityCompat            .            requestPermissions            (            MainActivity            .            this            ,            new            String            [            ]            {permission}            ,            requestCode)            ;            }            else            {            ActivityCompat            .            requestPermissions            (            MainActivity            .            this            ,            new            String            [            ]            {permission}            ,            requestCode)            ;            }            }            else            {            Toast            .            makeText            (            this            ,            ""            +            permission            +            " is already granted."            ,            Toast            .LENGTH_SHORT)            .            show            (            )            ;            }            }

This method asks a user for permissions. Firstly it checks whether the permission you are asking for is granted or not. If it is, then the app shows a Toast saying that the permission was already granted. If the permission is not granted, it checks if the user has denied this permission before. If the permission is important for the app, it should be requested again. If the permission was not denied before, perform a request by calling ActivityCompat.requestPermissions(MainActivity.this, new String[]{permission}, requestCode);

Each permission request needs three parameters. The first is context, the second a String array of permission(s), and the third the requestCode of type Integer. The last parameter is a random code attached to the request, and can be any number that suits your use case. When a result returns in the activity, it contains this code and uses it to differentiate multiple results from each other.

The method is ready to perform requests, and now it should be linked with the corresponding buttons. Each of the buttons created has an android:onClick="ask" property.

You need to create a public method called ask that will be called on each click of the buttons. It's code is:

                      public            void            ask            (            View            v)            {            switch            (v.            getId            (            )            )            {            case            R            .id.location:            askForPermission            (            Manifest            .permission.ACCESS_FINE_LOCATION,LOCATION)            ;            break            ;            case            R            .id.call:            askForPermission            (            Manifest            .permission.CALL_PHONE,CALL)            ;            break            ;            case            R            .id.write:            askForPermission            (            Manifest            .permission.WRITE_EXTERNAL_STORAGE,WRITE_EXST)            ;            break            ;            case            R            .id.read:            askForPermission            (            Manifest            .permission.READ_EXTERNAL_STORAGE,READ_EXST)            ;            break            ;            case            R            .id.camera:            askForPermission            (            Manifest            .permission.CAMERA,CAMERA)            ;            break            ;            case            R            .id.accounts:            askForPermission            (            Manifest            .permission.GET_ACCOUNTS,ACCOUNTS)            ;            break            ;            default            :            break            ;            }            }

The second parameter of the askForPermission method are some random integers. Add their declarations before the onCreate() method:

                      static            final            Integer            LOCATION            =            0x1            ;            static            final            Integer            CALL            =            0x2            ;            static            final            Integer            WRITE_EXST            =            0x3            ;            static            final            Integer            READ_EXST            =            0x4            ;            static            final            Integer            CAMERA            =            0x5            ;            static            final            Integer            ACCOUNTS            =            0x6            ;            static            final            Integer            GPS_SETTINGS            =            0x7            ;

Now the application can perform requests. The next step is handling the request results.

Handling the Results

To handle the results of a permission request, the onRequestPermissionsResult method is called. It's code is below:

                      @Override            public            void            onRequestPermissionsResult            (            int            requestCode,            String            [            ]            permissions,            int            [            ]            grantResults)            {            super            .            onRequestPermissionsResult            (requestCode,            permissions,            grantResults)            ;            if            (            ActivityCompat            .            checkSelfPermission            (            this            ,            permissions[            0            ]            )            ==            PackageManager            .PERMISSION_GRANTED)            {            switch            (requestCode)            {            //Location            case            1            :            askForGPS            (            )            ;            break            ;            //Call            case            2            :            Intent            callIntent            =            new            Intent            (            Intent            .ACTION_CALL)            ;            callIntent.            setData            (            Uri            .            parse            (            "tel:"            +            "{This is a telephone number}"            )            )            ;            if            (            ActivityCompat            .            checkSelfPermission            (            this            ,            Manifest            .permission.CALL_PHONE)            !=            PackageManager            .PERMISSION_GRANTED)            {            startActivity            (callIntent)            ;            }            break            ;            //Write external Storage            case            3            :            break            ;            //Read External Storage            case            4            :            Intent            imageIntent            =            new            Intent            (            Intent            .ACTION_PICK,                          android.provider.              MediaStore.Images.Media            .EXTERNAL_CONTENT_URI)            ;            startActivityForResult            (imageIntent,            11            )            ;            break            ;            //Camera            case            5            :            Intent            takePictureIntent            =            new            Intent            (            MediaStore            .ACTION_IMAGE_CAPTURE)            ;            if            (takePictureIntent.            resolveActivity            (            getPackageManager            (            )            )            !=            null            )            {            startActivityForResult            (takePictureIntent,            12            )            ;            }            break            ;            //Accounts            case            6            :            AccountManager            manager            =            (            AccountManager            )            getSystemService            (ACCOUNT_SERVICE)            ;            Account            [            ]            list            =            manager.            getAccounts            (            )            ;            Toast            .            makeText            (            this            ,            ""            +list[            0            ]            .name,            Toast            .LENGTH_SHORT)            .            show            (            )            ;            for            (            int            i=            0            ;            i<list.length;i++            )            {            Log            .            e            (            "Account "            +i,            ""            +list[i]            .name)            ;            }            }            Toast            .            makeText            (            this            ,            "Permission granted"            ,            Toast            .LENGTH_SHORT)            .            show            (            )            ;            }            else            {            Toast            .            makeText            (            this            ,            "Permission denied"            ,            Toast            .LENGTH_SHORT)            .            show            (            )            ;            }            }

When a result is returned, it checks whether the permission was granted or not. If it is, the requestCode is passed to a switch statement to differentiate the results. I added extra lines inside each case to show further steps, but they are just examples.

Location Request

At case 1: there is a function called askForGPS(). This function prompts the user to enable GPS if it's not enabled. If the device is not connected to GPS after the user has granted the location permission, the dialog below is shown:

No GPS dialog

To show this dialog, you need a GoogleApiClient. First, declare some variables by adding these lines before onCreate:

                      GoogleApiClient            client;            LocationRequest            mLocationRequest;            PendingResult                          <              LocationSettingsResult              >                        result;

And build the client inside the onCreate method:

          client            =            new            GoogleApiClient.Builder            (            this            )            .            addApi            (            AppIndex            .API)            .            addApi            (            LocationServices            .API)            .            build            (            )            ;

Now the client is built, it needs to connected when the app starts and disconnect when it stops. Add these two overriden methods to MainActivity:

                      @Override            public            void            onStart            (            )            {            super            .            onStart            (            )            ;            client.            connect            (            )            ;            }            @Override            public            void            onStop            (            )            {            super            .            onStop            (            )            ;            client.            disconnect            (            )            ;            }

Finally, add the function that shows the GPS dialog:

                      private            void            askForGPS            (            )            {            mLocationRequest            =            LocationRequest            .            create            (            )            ;            mLocationRequest.            setPriority            (            LocationRequest            .PRIORITY_HIGH_ACCURACY)            ;            mLocationRequest.            setInterval            (            30            *            1000            )            ;            mLocationRequest.            setFastestInterval            (            5            *            1000            )            ;            LocationSettingsRequest.Builder            builder            =            new            LocationSettingsRequest.Builder            (            )            .            addLocationRequest            (mLocationRequest)            ;            builder.            setAlwaysShow            (            true            )            ;            result            =            LocationServices.SettingsApi            .            checkLocationSettings            (client,            builder.            build            (            )            )            ;            result.            setResultCallback            (            new            ResultCallback                          <              LocationSettingsResult              >                        (            )            {            @Override            public            void            onResult            (            LocationSettingsResult            result)            {            final            Status            status            =            result.            getStatus            (            )            ;            switch            (status.            getStatusCode            (            )            )            {            case            LocationSettingsStatusCodes            .SUCCESS:            break            ;            case            LocationSettingsStatusCodes            .RESOLUTION_REQUIRED:            try            {            status.            startResolutionForResult            (            MainActivity            .            this            ,            GPS_SETTINGS)            ;            }            catch            (            IntentSender.SendIntentException            e)            {            }            break            ;            case            LocationSettingsStatusCodes            .SETTINGS_CHANGE_UNAVAILABLE:            break            ;            }            }            }            )            ;            }

Conclusion

In this tutorial, I showed how to ask for permissions, and handle the results with Android's new permission model. The aim of this new model is to put users in control of what our apps need to do. I'd love to hear your comments and opinions on this change and how to handle it below.