| /* | |
| * Copyright (C) 2015 The Android Open Source Project | |
| * | |
| * Licensed under the Apache License, Version 2.0 (the "License"); | |
| * you may not use this file except in compliance with the License. | |
| * You may obtain a copy of the License at | |
| * | |
| * http://www.apache.org/licenses/LICENSE-2.0 | |
| * | |
| * Unless required by applicable law or agreed to in writing, software | |
| * distributed under the License is distributed on an "AS IS" BASIS, | |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | |
| * See the License for the specific language governing permissions and | |
| * limitations under the License. | |
| */ | |
| package com.android.dialer.util; | |
| import static android.Manifest.permission.ACCESS_COARSE_LOCATION; | |
| import static android.Manifest.permission.ACCESS_FINE_LOCATION; | |
| import static android.Manifest.permission.ADD_VOICEMAIL; | |
| import static android.Manifest.permission.CALL_PHONE; | |
| import static android.Manifest.permission.MODIFY_PHONE_STATE; | |
| import static android.Manifest.permission.READ_CALL_LOG; | |
| import static android.Manifest.permission.READ_CONTACTS; | |
| import static android.Manifest.permission.READ_PHONE_STATE; | |
| import static android.Manifest.permission.READ_VOICEMAIL; | |
| import static android.Manifest.permission.SEND_SMS; | |
| import static android.Manifest.permission.WRITE_CALL_LOG; | |
| import static android.Manifest.permission.WRITE_CONTACTS; | |
| import static android.Manifest.permission.WRITE_VOICEMAIL; | |
| import android.Manifest.permission; | |
| import android.content.BroadcastReceiver; | |
| import android.content.Context; | |
| import android.content.Intent; | |
| import android.content.IntentFilter; | |
| import android.content.pm.PackageManager; | |
| import android.support.annotation.NonNull; | |
| import android.support.annotation.VisibleForTesting; | |
| import android.support.v4.content.ContextCompat; | |
| import android.support.v4.content.LocalBroadcastManager; | |
| import android.widget.Toast; | |
| import com.android.dialer.common.LogUtil; | |
| import com.android.dialer.storage.StorageComponent; | |
| import java.util.ArrayList; | |
| import java.util.Arrays; | |
| import java.util.Collections; | |
| import java.util.List; | |
| /** Utility class to help with runtime permissions. */ | |
| public class PermissionsUtil { | |
| @VisibleForTesting | |
| public static final String PREFERENCE_CAMERA_ALLOWED_BY_USER = "camera_allowed_by_user"; | |
| private static final String PERMISSION_PREFERENCE = "dialer_permissions"; | |
| private static final String CEQUINT_PERMISSION = "com.cequint.ecid.CALLER_ID_LOOKUP"; | |
| // Permissions list retrieved from application manifest. | |
| // Starting in Android O Permissions must be explicitly enumerated: | |
| // https://developer.android.com/preview/behavior-changes.html#rmp | |
| public static final List<String> allPhoneGroupPermissionsUsedInDialer = | |
| Collections.unmodifiableList( | |
| Arrays.asList( | |
| READ_CALL_LOG, | |
| WRITE_CALL_LOG, | |
| READ_PHONE_STATE, | |
| MODIFY_PHONE_STATE, | |
| SEND_SMS, | |
| CALL_PHONE, | |
| ADD_VOICEMAIL, | |
| WRITE_VOICEMAIL, | |
| READ_VOICEMAIL)); | |
| public static final List<String> allContactsGroupPermissionsUsedInDialer = | |
| Collections.unmodifiableList(Arrays.asList(READ_CONTACTS, WRITE_CONTACTS)); | |
| public static final List<String> allLocationGroupPermissionsUsedInDialer = | |
| Collections.unmodifiableList(Arrays.asList(ACCESS_FINE_LOCATION, ACCESS_COARSE_LOCATION)); | |
| public static boolean hasPhonePermissions(Context context) { | |
| return hasPermission(context, permission.CALL_PHONE); | |
| } | |
| public static boolean hasReadPhoneStatePermissions(Context context) { | |
| return hasPermission(context, permission.READ_PHONE_STATE); | |
| } | |
| public static boolean hasContactsReadPermissions(Context context) { | |
| return hasPermission(context, permission.READ_CONTACTS); | |
| } | |
| public static boolean hasContactsWritePermissions(Context context) { | |
| return hasPermission(context, permission.WRITE_CONTACTS); | |
| } | |
| public static boolean hasLocationPermissions(Context context) { | |
| return hasPermission(context, permission.ACCESS_FINE_LOCATION); | |
| } | |
| public static boolean hasCameraPermissions(Context context) { | |
| return hasPermission(context, permission.CAMERA); | |
| } | |
| public static boolean hasMicrophonePermissions(Context context) { | |
| return hasPermission(context, permission.RECORD_AUDIO); | |
| } | |
| public static boolean hasCallLogReadPermissions(Context context) { | |
| return hasPermission(context, permission.READ_CALL_LOG); | |
| } | |
| public static boolean hasCallLogWritePermissions(Context context) { | |
| return hasPermission(context, permission.WRITE_CALL_LOG); | |
| } | |
| public static boolean hasCequintPermissions(Context context) { | |
| return hasPermission(context, CEQUINT_PERMISSION); | |
| } | |
| public static boolean hasReadVoicemailPermissions(Context context) { | |
| return hasPermission(context, permission.READ_VOICEMAIL); | |
| } | |
| public static boolean hasWriteVoicemailPermissions(Context context) { | |
| return hasPermission(context, permission.WRITE_VOICEMAIL); | |
| } | |
| public static boolean hasAddVoicemailPermissions(Context context) { | |
| return hasPermission(context, permission.ADD_VOICEMAIL); | |
| } | |
| public static boolean hasSendSmsPermissions(Context context) { | |
| return hasPermission(context, permission.SEND_SMS); | |
| } | |
| public static boolean hasPermission(Context context, String permission) { | |
| return ContextCompat.checkSelfPermission(context, permission) | |
| == PackageManager.PERMISSION_GRANTED; | |
| } | |
| /** | |
| * Checks {@link android.content.SharedPreferences} if a permission has been requested before. | |
| * | |
| * <p>It is important to note that this method only works if you call {@link | |
| * PermissionsUtil#permissionRequested(Context, String)} in {@link | |
| * android.app.Activity#onRequestPermissionsResult(int, String[], int[])}. | |
| */ | |
| public static boolean isFirstRequest(Context context, String permission) { | |
| return context | |
| .getSharedPreferences(PERMISSION_PREFERENCE, Context.MODE_PRIVATE) | |
| .getBoolean(permission, true); | |
| } | |
| /** | |
| * Records in {@link android.content.SharedPreferences} that the specified permission has been | |
| * requested at least once. | |
| * | |
| * <p>This method should be called in {@link android.app.Activity#onRequestPermissionsResult(int, | |
| * String[], int[])}. | |
| */ | |
| public static void permissionRequested(Context context, String permission) { | |
| context | |
| .getSharedPreferences(PERMISSION_PREFERENCE, Context.MODE_PRIVATE) | |
| .edit() | |
| .putBoolean(permission, false) | |
| .apply(); | |
| } | |
| /** | |
| * Rudimentary methods wrapping the use of a LocalBroadcastManager to simplify the process of | |
| * notifying other classes when a particular fragment is notified that a permission is granted. | |
| * | |
| * <p>To be notified when a permission has been granted, create a new broadcast receiver and | |
| * register it using {@link #registerPermissionReceiver(Context, BroadcastReceiver, String)} | |
| * | |
| * <p>E.g. | |
| * | |
| * <p>final BroadcastReceiver receiver = new BroadcastReceiver() { @Override public void | |
| * onReceive(Context context, Intent intent) { refreshContactsView(); } } | |
| * | |
| * <p>PermissionsUtil.registerPermissionReceiver(getActivity(), receiver, READ_CONTACTS); | |
| * | |
| * <p>If you register to listen for multiple permissions, you can identify which permission was | |
| * granted by inspecting {@link Intent#getAction()}. | |
| * | |
| * <p>In the fragment that requests for the permission, be sure to call {@link | |
| * #notifyPermissionGranted(Context, String)} when the permission is granted so that any | |
| * interested listeners are notified of the change. | |
| */ | |
| public static void registerPermissionReceiver( | |
| Context context, BroadcastReceiver receiver, String permission) { | |
| LogUtil.i("PermissionsUtil.registerPermissionReceiver", permission); | |
| final IntentFilter filter = new IntentFilter(permission); | |
| LocalBroadcastManager.getInstance(context).registerReceiver(receiver, filter); | |
| } | |
| public static void unregisterPermissionReceiver(Context context, BroadcastReceiver receiver) { | |
| LogUtil.i("PermissionsUtil.unregisterPermissionReceiver", null); | |
| LocalBroadcastManager.getInstance(context).unregisterReceiver(receiver); | |
| } | |
| public static void notifyPermissionGranted(Context context, String permission) { | |
| LogUtil.i("PermissionsUtil.notifyPermissionGranted", permission); | |
| final Intent intent = new Intent(permission); | |
| LocalBroadcastManager.getInstance(context).sendBroadcast(intent); | |
| } | |
| /** | |
| * Returns a list of permissions currently not granted to the application from the supplied list. | |
| * | |
| * @param context - The Application context. | |
| * @param permissionsList - A list of permissions to check if the current application has been | |
| * granted. | |
| * @return An array of permissions that are currently DENIED to the application; a subset of | |
| * permissionsList. | |
| */ | |
| @NonNull | |
| public static String[] getPermissionsCurrentlyDenied( | |
| @NonNull Context context, @NonNull List<String> permissionsList) { | |
| List<String> permissionsCurrentlyDenied = new ArrayList<>(); | |
| for (String permission : permissionsList) { | |
| if (!hasPermission(context, permission)) { | |
| permissionsCurrentlyDenied.add(permission); | |
| } | |
| } | |
| return permissionsCurrentlyDenied.toArray(new String[permissionsCurrentlyDenied.size()]); | |
| } | |
| /** | |
| * Since we are granted the camera permission automatically as a first-party app, we need to show | |
| * a toast to let users know the permission was granted for privacy reasons. | |
| * | |
| * @return true if we've already shown the camera privacy toast. | |
| */ | |
| public static boolean hasCameraPrivacyToastShown(@NonNull Context context) { | |
| return StorageComponent.get(context) | |
| .unencryptedSharedPrefs() | |
| .getBoolean(PREFERENCE_CAMERA_ALLOWED_BY_USER, false); | |
| } | |
| public static void showCameraPermissionToast(@NonNull Context context) { | |
| Toast.makeText(context, context.getString(R.string.camera_privacy_text), Toast.LENGTH_LONG) | |
| .show(); | |
| setCameraPrivacyToastShown(context); | |
| } | |
| public static void setCameraPrivacyToastShown(@NonNull Context context) { | |
| StorageComponent.get(context) | |
| .unencryptedSharedPrefs() | |
| .edit() | |
| .putBoolean(PREFERENCE_CAMERA_ALLOWED_BY_USER, true) | |
| .apply(); | |
| } | |
| } |