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 android.support.v4.content.ContextCompat;
28 import android.support.v4.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