В чем разница между shouldShowRequestPermissionRationale и requestPermissions?

Я создаю приложение, которое требует местоположения пользователя. Я следую учебной документации Android от здесь он говорит:

shouldShowRequestPermissionRationale верните логическое значение, указывающее, должны ли мы показывать пользовательский интерфейс с обоснованием запроса разрешения (опасное разрешение, ACCESS_FINE_LOCATION)

теперь в этом коде (взятом из самой документации):

if (ContextCompat.checkSelfPermission(thisActivity,
                Manifest.permission.READ_CONTACTS)
        != PackageManager.PERMISSION_GRANTED) {

    // Should we show an explanation?
    if (ActivityCompat.shouldShowRequestPermissionRationale(thisActivity,
            Manifest.permission.READ_CONTACTS)) {

        // Show an explanation to the user *asynchronously* -- don't block
        // this thread waiting for the user's response! After the user
        // sees the explanation, try again to request the permission.

    } else {

        // No explanation needed, we can request the permission.

        ActivityCompat.requestPermissions(thisActivity,
                new String[]{Manifest.permission.READ_CONTACTS},
                MY_PERMISSIONS_REQUEST_READ_CONTACTS);

        // MY_PERMISSIONS_REQUEST_READ_CONTACTS is an
        // app-defined int constant. The callback method gets the
        // result of the request.
    }
}

[мои сомнения] не должна ли эта часть кода (ниже)

ActivityCompat.requestPermissions(thisActivity,
                new String[]{Manifest.permission.READ_CONTACTS},
                MY_PERMISSIONS_REQUEST_READ_CONTACTS);

быть внутри условия "если" здесь..

 if (ActivityCompat.shouldShowRequestPermissionRationale(thisActivity,
            Manifest.permission.READ_CONTACTS)) {
    //HERE .....

}

Я имею в виду, если

ActivityCompat.shouldShowRequestPermissionRationale(thisActivity, Manifest.permission.READ_CONTACTS)   

верно, тогда нам нужно показать пользовательский интерфейс, и мы покажем пользовательский интерфейс по

ActivityCompat.requestPermissions(thisActivity,
    newString[{Manifest.permission.READ_CONTACTS}, MY_PERMISSIONS_REQUEST_READ_CONTACTS);

Пожалуйста, объясните, где я ошибаюсь. Я застрял здесь. Спасибо заранее. Пример был бы весьма признателен.

Примечание: конечно, я запускаю свое приложение на Android M, а мой целевой sdk - >=23.

3 ответов


согласно документации,

shouldShowRequestPermissionRationale верните логическое значение, указывающее, следует ли >или нет показывать пользовательский интерфейс с обоснованием запроса разрешения.

этот пользовательский интерфейс - наш пользовательский интерфейс (например, мы можем показать alertdialog), а не диалог, который показывает наше устройство (см. ниже):

Allow SnazzyApp to access your contacts ? //this is NOT our custom UI

имея это в виду, теперь

возвращаемое значение shouldShowRequestPermissionRationale как показано в блок-схеме. enter image description here

Также отметим, что

When that user "denies"  your permission by CHECKING "never ask again", ``shouldShowRequestPermissionRationale`` would still return ``false``. 

таким образом, чтобы уплотнить!--13-->

  • shouldShowRequestPermissionRationale вернет true только в том случае, если приложение было запущено ранее, и пользователь "отказал" в разрешении без проверки "никогда не спрашивайте снова".
  • в других случаях (приложение запущено в первый раз или приложение запущено раньше, и пользователь отказал в разрешении, проверив "никогда не спрашивать снова"), возвращаемое значение ложный.

реализация

давайте создадим PermissionUtils.java файл, который обрабатывает различные случаи для нас.

public class PermissionUtils {

    private static final String TAG = "PermissionUtils";

    /*
        Inside this shared_preference file, we will just store information
        about whether the user had visited our app earlier or not.
    */

    private static final String PREFS_FILE_NAME = "preference_permission";
    private static final String PREFS_FIRST_TIME_KEY = "is_app_launched_first_time";


    //an interface containing 5 methods
    //...the scenario in which these callback will be called is written below each method declaration.
    public interface PermissionAskListener {


        void onPermissionGranted();
        /*
            User has already granted this permission
            The app must had been launched earlier and the user must had "allowed" that permission
         */


        void onPermissionRequest();
        /*
            The app is launched FIRST TIME..
            We don't need to show additional dialog, we just request for the permission..

         */


        void onPermissionPreviouslyDenied();
        /*
            The app was launched earlier and the user simply "denied" the permission..
            The user had NOT clicked "DO NOT SHOW AGAIN"
            We need to show additional dialog in this case explaining how "allowing this permission" would be useful to the user
         */


        void onPermissionDisabled();
        /*
            The app had launched earlier and the user "denied" the permission..
            AND ALSO had clicked "DO NOT ASK AGAIN"
            We need to show Toask/alertdialog/.. to indicate that the user had denied the permission by checking do not disturb too...
            So, you might want to take the user to setting>app>permission page where the user can allow the permission..


         */

    }

    // preference utility methods
    private static boolean getApplicationLaunchedFirstTime(Activity activity) {
        SharedPreferences sharedPreferences = activity.getSharedPreferences(PREFS_FILE_NAME, MODE_PRIVATE);
        return sharedPreferences.getBoolean(PREFS_FIRST_TIME_KEY, true);
    }

    private static void setApplicationLaunchedFirstTime(Activity activity) {
        SharedPreferences sharedPreferences = activity.getSharedPreferences(PREFS_FILE_NAME, MODE_PRIVATE);
        SharedPreferences.Editor editor = sharedPreferences.edit();
        editor.putBoolean(PREFS_FIRST_TIME_KEY, false);
        editor.commit();
    }


    private static boolean isRuntimePermissionRequired() {
        return (Build.VERSION.SDK_INT >= 23);
    }

    public static void checkPermission(Activity activity, String permission, PermissionAskListener permissionAskListener) {

        Log.d(TAG, "checkPermission");


        if (!isRuntimePermissionRequired()) {
            /*
                Runtime permission not required,
                THE DEVICE IS RUNNING ON < 23, So, no runtime permission required..
                Simply call **** permissionAskListener.onPermissionGranted() ****
             */


            permissionAskListener.onPermissionGranted();
        } else {
            //runtime permission required here...

            //check if the permission is already granted, i.e the application was launched earlier too, and the user had "allowed" the permission then.
            if (ContextCompat.checkSelfPermission(activity, permission) != PackageManager.PERMISSION_GRANTED) {
                /* We don't have permission, two cases arise:
                     1. App launched first time, 
                     2. App launched earlier too, and the user had denied the permission is last launch
                           2A. The user denied permission earlier WITHOUT checking "Never ask again"
                           2B. The user denied permission earlier WITH checking "Never ask again"
                */

                if (ActivityCompat.shouldShowRequestPermissionRationale(activity, permission)) {

                    /* 
                       shouldShowRequestPermissionRationale returned true
                       this means Case: 2A
                       see the flowchart, the only case when shouldShowRequestPermissionRationale returns "true", is when the application was launched earlier too and the user had "denied" the permission in last launch WITHOUT checking "never show again"
                    */

                    permissionAskListener.onPermissionPreviouslyDenied();
                } else {
                    /*  
                         this means, either - 
                         Case: 1 or Case 2B
                         See Flowchart, shouldShowRequestPermissionRationale returns false, only when app is launched first time (Case: 1) or app was launched earlier too and user HAD checked "Never show again" then (Case: 2B)
                    */
                    if (getApplicationLaunchedFirstTime(activity)) {

                        //Case: 1
                        Log.d(TAG, "ApplicationLaunchedFirstTime");

                        setApplicationLaunchedFirstTime(activity);  //  ** DON'T FORGET THIS **
                        permissionAskListener.onPermissionRequest();

                    } else {
                        //Case: 2B
                        Log.d(TAG, "onPermissionDisabled");

                        permissionAskListener.onPermissionDisabled();
                    }
                }


            } else {
                Log.d(TAG, "Permission already granted");

                permissionAskListener.onPermissionGranted();
            }
        }
    }
}

логика

  1. сначала мы начнем с проверки, требуется ли нам вообще разрешение во время выполнения в первую очередь ? Это делается с помощью:

    if (!isRuntimePermissionRequired()) {...}
    
  2. если нам требуется разрешение среды выполнения, то мы проверяем, получили ли мы это разрешение уже ранее

    ContextCompat.checkSelfPermission(activity, permission) != PackageManager.PERMISSION_GRANTED)
    
  3. если у нас нет разрешения, то мы должны обрабатывать два случая:

    1. App launched first time, 
    2. App launched earlier too, and the user had denied the permission is last launch                  
        2A. The user denied permission earlier WITHOUT checking "Never ask again".
        2B. The user denied permission earlier WITH checking "Never ask again".
    

Итак, итог:

внутри PermissionUtils.java, у нас есть определенный интерфейс, который содержит 5 абстрактные методы. Эти методы обратного вызова, которая будет вызываться в разных случаях, как описано выше.

наконец-то внутри нашей деятельности мы обрабатываем все эти случаи путем реализации обратных вызовов слушателя.

    PermissionUtils.checkPermission(MainActivity.this,
            Manifest.permission.ACCESS_FINE_LOCATION,
            new PermissionUtils.PermissionAskListener() {
                @Override
                public void onPermissionGranted() {
                    updateUI();

                }

                @Override
                public void onPermissionRequest() {

                    ActivityCompat.requestPermissions(MainActivity.this,
                            new String[]{Manifest.permission.ACCESS_FINE_LOCATION},
                            My_PERMISSION_ACCESS_FINE_LOCATION);


                }

                @Override
                public void onPermissionPreviouslyDenied() {

                    //Show an alert message and "request the permission" in its "setPositiveButton"
                    //...and in "setOnNegativeButton", just cancel the dialog and do not run the
                    //...functionality that requires this permission (here, ACCESS_FINE_LOCATION)
                    new AlertDialog.Builder(MainActivity.this)
                            .setTitle("Permission required")
                            .setMessage("Location is required for this application to work ! ")
                            .setPositiveButton("Allow", new DialogInterface.OnClickListener() {
                                @Override
                                public void onClick(DialogInterface dialog, int which) {
                                    ActivityCompat.requestPermissions(MainActivity.this,
                                            new String[]{Manifest.permission.ACCESS_FINE_LOCATION},
                                            My_PERMISSION_ACCESS_FINE_LOCATION);


                                }

                            })
                            .setNegativeButton("Cancel", new DialogInterface.OnClickListener() {
                                @Override
                                public void onClick(DialogInterface dialog, int which) {
                                    dialog.cancel();
                                    finish();
                                }
                            })
                            .show();


                }

                @Override
                public void onPermissionDisabled() {



                    new AlertDialog.Builder(MainActivity.this)
                            .setTitle("Permission Disabled")
                            .setMessage("Please enable the permission in \n  Settings>Uber>Permission \n and check 'location' permission")
                            .setPositiveButton("Go to settings", new DialogInterface.OnClickListener() {
                                @Override
                                public void onClick(DialogInterface dialog, int which) {
                                    startActivity(new Intent(Settings.ACTION_SETTINGS));


                                }

                            })
                            .setNegativeButton("Cancel", new DialogInterface.OnClickListener() {
                                @Override
                                public void onClick(DialogInterface dialog, int which) {
                                    dialog.cancel();
                                    finish();
                                }
                            })
                            .show();


                }
            });


}

надеюсь, что это помогает.


другой вариант-использовать EasyPermissions который был предоставлен самим Google, чтобы, как сказано, "упростить разрешения системы Android M". Тогда вам не нужно звонить shouldShowRequestPermissionRationale напрямую.

тогда вам не нужно звонить shouldShowRequestPermissionRationale или обработать его возвращаемое значение напрямую.


существует два этапа запроса разрешения-отображение обоснования, а затем фактический запрос разрешений.

они обычно проявляются как два отдельных диалога, показанных последовательно:

  1. диалог, который просто содержит текст, дающий пользователю причину (обоснование), почему требуется разрешение
  2. диалог, который фактически запрашивает разрешение. Который выглядит как изображение ниже:image of permissions dialog

Так код в документации правильный. Логика такова:

if we need to show a rationale:
    show the rationale dialog
otherwise:
    just ask for permissions to be granted without showing the rationale dialog