1 /* 2 * Copyright (C) 2015 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 package com.android.contacts.util; 18 19 import android.Manifest.permission; 20 import android.app.AppOpsManager; 21 import android.content.BroadcastReceiver; 22 import android.content.Context; 23 import android.content.Intent; 24 import android.content.IntentFilter; 25 import android.content.pm.PackageManager; 26 import android.os.Process; 27 import androidx.core.content.ContextCompat; 28 import androidx.localbroadcastmanager.content.LocalBroadcastManager; 29 30 /** 31 * Utility class to help with runtime permissions. 32 */ 33 public class PermissionsUtil { 34 // Each permission in this list is a cherry-picked permission from a particular permission 35 // group. Granting a permission group enables access to all permissions in that group so we 36 // only need to check a single permission in each group. 37 // Note: This assumes that the app has correctly requested for all the relevant permissions 38 // in its Manifest file. 39 public static final String PHONE = permission.CALL_PHONE; 40 public static final String CONTACTS = permission.READ_CONTACTS; 41 public static final String LOCATION = permission.ACCESS_FINE_LOCATION; 42 hasPhonePermissions(Context context)43 public static boolean hasPhonePermissions(Context context) { 44 return hasPermission(context, PHONE); 45 } 46 hasContactsPermissions(Context context)47 public static boolean hasContactsPermissions(Context context) { 48 return hasPermission(context, CONTACTS); 49 } 50 hasLocationPermissions(Context context)51 public static boolean hasLocationPermissions(Context context) { 52 return hasPermission(context, LOCATION); 53 } 54 hasPermission(Context context, String permission)55 public static boolean hasPermission(Context context, String permission) { 56 return ContextCompat.checkSelfPermission(context, permission) 57 == PackageManager.PERMISSION_GRANTED; 58 } 59 hasAppOp(Context context, String appOp)60 public static boolean hasAppOp(Context context, String appOp) { 61 final AppOpsManager appOpsManager = 62 (AppOpsManager) context.getSystemService(Context.APP_OPS_SERVICE); 63 final int mode = appOpsManager.checkOpNoThrow(appOp, Process.myUid(), 64 context.getPackageName()); 65 return mode == AppOpsManager.MODE_ALLOWED; 66 } 67 68 /** 69 * Rudimentary methods wrapping the use of a LocalBroadcastManager to simplify the process 70 * of notifying other classes when a particular fragment is notified that a permission is 71 * granted. 72 * 73 * To be notified when a permission has been granted, create a new broadcast receiver 74 * and register it using {@link #registerPermissionReceiver(Context, BroadcastReceiver, String)} 75 * 76 * E.g. 77 * 78 * final BroadcastReceiver receiver = new BroadcastReceiver() { 79 * @Override 80 * public void onReceive(Context context, Intent intent) { 81 * refreshContactsView(); 82 * } 83 * } 84 * 85 * PermissionsUtil.registerPermissionReceiver(getActivity(), receiver, READ_CONTACTS); 86 * 87 * If you register to listen for multiple permissions, you can identify which permission was 88 * granted by inspecting {@link Intent#getAction()}. 89 * 90 * In the fragment that requests for the permission, be sure to call 91 * {@link #notifyPermissionGranted(Context, String)} when the permission is granted so that 92 * any interested listeners are notified of the change. 93 */ registerPermissionReceiver(Context context, BroadcastReceiver receiver, String permission)94 public static void registerPermissionReceiver(Context context, BroadcastReceiver receiver, 95 String permission) { 96 final IntentFilter filter = new IntentFilter(permission); 97 LocalBroadcastManager.getInstance(context).registerReceiver(receiver, filter); 98 } 99 unregisterPermissionReceiver(Context context, BroadcastReceiver receiver)100 public static void unregisterPermissionReceiver(Context context, BroadcastReceiver receiver) { 101 LocalBroadcastManager.getInstance(context).unregisterReceiver(receiver); 102 } 103 notifyPermissionGranted(Context context, String permission)104 public static void notifyPermissionGranted(Context context, String permission) { 105 final Intent intent = new Intent(permission); 106 LocalBroadcastManager.getInstance(context).sendBroadcast(intent); 107 } 108 } 109