| /* |
| * Copyright (C) 2014 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.settings.users; |
| |
| import static android.os.UserHandle.USER_NULL; |
| |
| import android.app.ActivityManager; |
| import android.app.Dialog; |
| import android.app.settings.SettingsEnums; |
| import android.content.Context; |
| import android.content.pm.UserInfo; |
| import android.os.Bundle; |
| import android.os.RemoteException; |
| import android.os.Trace; |
| import android.os.UserHandle; |
| import android.os.UserManager; |
| import android.util.Log; |
| |
| import androidx.annotation.VisibleForTesting; |
| import androidx.preference.Preference; |
| import androidx.preference.SwitchPreference; |
| |
| import com.android.settings.R; |
| import com.android.settings.SettingsPreferenceFragment; |
| import com.android.settings.Utils; |
| import com.android.settings.core.SubSettingLauncher; |
| import com.android.settingslib.RestrictedLockUtils; |
| import com.android.settingslib.RestrictedLockUtilsInternal; |
| import com.android.settingslib.RestrictedPreference; |
| import com.android.settingslib.utils.CustomDialogHelper; |
| |
| import java.util.concurrent.ExecutorService; |
| import java.util.concurrent.Executors; |
| import java.util.concurrent.atomic.AtomicBoolean; |
| |
| /** |
| * Settings screen for configuring, deleting or switching to a specific user. |
| * It is shown when you tap on a user in the user management (UserSettings) screen. |
| * |
| * Arguments to this fragment must include the userId of the user (in EXTRA_USER_ID) for whom |
| * to display controls. |
| */ |
| public class UserDetailsSettings extends SettingsPreferenceFragment |
| implements Preference.OnPreferenceClickListener, Preference.OnPreferenceChangeListener { |
| |
| private static final String TAG = UserDetailsSettings.class.getSimpleName(); |
| |
| private static final String KEY_SWITCH_USER = "switch_user"; |
| private static final String KEY_ENABLE_TELEPHONY = "enable_calling"; |
| private static final String KEY_REMOVE_USER = "remove_user"; |
| private static final String KEY_GRANT_ADMIN = "user_grant_admin"; |
| private static final String KEY_APP_AND_CONTENT_ACCESS = "app_and_content_access"; |
| private static final String KEY_APP_COPYING = "app_copying"; |
| |
| /** Integer extra containing the userId to manage */ |
| static final String EXTRA_USER_ID = "user_id"; |
| |
| private static final int DIALOG_CONFIRM_REMOVE = 1; |
| private static final int DIALOG_CONFIRM_ENABLE_CALLING_AND_SMS = 2; |
| private static final int DIALOG_SETUP_USER = 3; |
| private static final int DIALOG_CONFIRM_RESET_GUEST = 4; |
| private static final int DIALOG_CONFIRM_RESET_GUEST_AND_SWITCH_USER = 5; |
| private static final int DIALOG_CONFIRM_REVOKE_ADMIN = 6; |
| private static final int DIALOG_CONFIRM_GRANT_ADMIN = 7; |
| |
| /** Whether to enable the app_copying fragment. */ |
| private static final boolean SHOW_APP_COPYING_PREF = false; |
| |
| private UserManager mUserManager; |
| private UserCapabilities mUserCaps; |
| private boolean mGuestUserAutoCreated; |
| private final AtomicBoolean mGuestCreationScheduled = new AtomicBoolean(); |
| private final ExecutorService mExecutor = Executors.newSingleThreadExecutor(); |
| |
| @VisibleForTesting |
| RestrictedPreference mSwitchUserPref; |
| private SwitchPreference mPhonePref; |
| @VisibleForTesting |
| Preference mAppAndContentAccessPref; |
| @VisibleForTesting |
| Preference mAppCopyingPref; |
| @VisibleForTesting |
| Preference mRemoveUserPref; |
| @VisibleForTesting |
| SwitchPreference mGrantAdminPref; |
| |
| @VisibleForTesting |
| /** The user being studied (not the user doing the studying). */ |
| UserInfo mUserInfo; |
| |
| @Override |
| public int getMetricsCategory() { |
| return SettingsEnums.USER_DETAILS; |
| } |
| |
| @Override |
| public void onCreate(Bundle icicle) { |
| super.onCreate(icicle); |
| |
| final Context context = getActivity(); |
| mUserManager = (UserManager) context.getSystemService(Context.USER_SERVICE); |
| mUserCaps = UserCapabilities.create(context); |
| addPreferencesFromResource(R.xml.user_details_settings); |
| |
| mGuestUserAutoCreated = getPrefContext().getResources().getBoolean( |
| com.android.internal.R.bool.config_guestUserAutoCreated); |
| |
| initialize(context, getArguments()); |
| } |
| |
| @Override |
| public void onResume() { |
| super.onResume(); |
| mSwitchUserPref.setEnabled(canSwitchUserNow()); |
| if (mGuestUserAutoCreated) { |
| mRemoveUserPref.setEnabled((mUserInfo.flags & UserInfo.FLAG_INITIALIZED) != 0); |
| } |
| } |
| |
| @Override |
| public boolean onPreferenceClick(Preference preference) { |
| if (preference != null && preference.getKey() != null) { |
| mMetricsFeatureProvider.logSettingsTileClick(preference.getKey(), getMetricsCategory()); |
| } |
| if (preference == mRemoveUserPref) { |
| mMetricsFeatureProvider.action(getActivity(), |
| UserMetricsUtils.getRemoveUserMetricCategory(mUserInfo)); |
| if (canDeleteUser()) { |
| if (mUserInfo.isGuest()) { |
| showDialog(DIALOG_CONFIRM_RESET_GUEST); |
| } else { |
| showDialog(DIALOG_CONFIRM_REMOVE); |
| } |
| return true; |
| } |
| } else if (preference == mSwitchUserPref) { |
| mMetricsFeatureProvider.action(getActivity(), |
| UserMetricsUtils.getSwitchUserMetricCategory(mUserInfo)); |
| if (canSwitchUserNow()) { |
| if (shouldShowSetupPromptDialog()) { |
| showDialog(DIALOG_SETUP_USER); |
| } else if (mUserCaps.mIsGuest && mUserCaps.mIsEphemeral) { |
| // if we are switching away from a ephemeral guest then, |
| // show a dialog that guest user will be reset and then switch |
| // the user |
| showDialog(DIALOG_CONFIRM_RESET_GUEST_AND_SWITCH_USER); |
| } else { |
| switchUser(); |
| } |
| return true; |
| } |
| } else if (preference == mAppAndContentAccessPref) { |
| openAppAndContentAccessScreen(false); |
| return true; |
| } else if (preference == mAppCopyingPref) { |
| openAppCopyingScreen(); |
| return true; |
| } |
| return false; |
| } |
| |
| @Override |
| public boolean onPreferenceChange(Preference preference, Object newValue) { |
| if (preference == mPhonePref) { |
| if (Boolean.TRUE.equals(newValue)) { |
| mMetricsFeatureProvider.action(getActivity(), |
| SettingsEnums.ACTION_ENABLE_USER_CALL); |
| showDialog(DIALOG_CONFIRM_ENABLE_CALLING_AND_SMS); |
| return false; |
| } |
| mMetricsFeatureProvider.action(getActivity(), |
| SettingsEnums.ACTION_DISABLE_USER_CALL); |
| enableCallsAndSms(false); |
| } else if (preference == mGrantAdminPref) { |
| if (Boolean.FALSE.equals(newValue)) { |
| mMetricsFeatureProvider.action(getActivity(), |
| SettingsEnums.ACTION_REVOKE_ADMIN_FROM_SETTINGS); |
| showDialog(DIALOG_CONFIRM_REVOKE_ADMIN); |
| } else { |
| mMetricsFeatureProvider.action(getActivity(), |
| SettingsEnums.ACTION_GRANT_ADMIN_FROM_SETTINGS); |
| showDialog(DIALOG_CONFIRM_GRANT_ADMIN); |
| } |
| return false; |
| } |
| return true; |
| } |
| |
| @Override |
| public int getDialogMetricsCategory(int dialogId) { |
| switch (dialogId) { |
| case DIALOG_CONFIRM_REMOVE: |
| case DIALOG_CONFIRM_RESET_GUEST: |
| case DIALOG_CONFIRM_RESET_GUEST_AND_SWITCH_USER: |
| return SettingsEnums.DIALOG_USER_REMOVE; |
| case DIALOG_CONFIRM_ENABLE_CALLING_AND_SMS: |
| return SettingsEnums.DIALOG_USER_ENABLE_CALLING_AND_SMS; |
| case DIALOG_CONFIRM_REVOKE_ADMIN: |
| return SettingsEnums.DIALOG_REVOKE_USER_ADMIN; |
| case DIALOG_CONFIRM_GRANT_ADMIN: |
| return SettingsEnums.DIALOG_GRANT_USER_ADMIN; |
| case DIALOG_SETUP_USER: |
| return SettingsEnums.DIALOG_USER_SETUP; |
| default: |
| return 0; |
| } |
| } |
| |
| @Override |
| public Dialog onCreateDialog(int dialogId) { |
| Context context = getActivity(); |
| if (context == null) { |
| return null; |
| } |
| switch (dialogId) { |
| case DIALOG_CONFIRM_REMOVE: |
| return UserDialogs.createRemoveDialog(getActivity(), mUserInfo.id, |
| (dialog, which) -> removeUser()); |
| case DIALOG_CONFIRM_ENABLE_CALLING_AND_SMS: |
| return UserDialogs.createEnablePhoneCallsAndSmsDialog(getActivity(), |
| (dialog, which) -> enableCallsAndSms(true)); |
| case DIALOG_SETUP_USER: |
| return UserDialogs.createSetupUserDialog(getActivity(), |
| (dialog, which) -> { |
| if (canSwitchUserNow()) { |
| switchUser(); |
| } |
| }); |
| case DIALOG_CONFIRM_RESET_GUEST: |
| if (mGuestUserAutoCreated) { |
| return UserDialogs.createResetGuestDialog(getActivity(), |
| (dialog, which) -> resetGuest()); |
| } else { |
| return UserDialogs.createRemoveGuestDialog(getActivity(), |
| (dialog, which) -> resetGuest()); |
| } |
| case DIALOG_CONFIRM_RESET_GUEST_AND_SWITCH_USER: |
| if (mGuestUserAutoCreated) { |
| return UserDialogs.createResetGuestDialog(getActivity(), |
| (dialog, which) -> switchUser()); |
| } else { |
| return UserDialogs.createRemoveGuestDialog(getActivity(), |
| (dialog, which) -> switchUser()); |
| } |
| case DIALOG_CONFIRM_REVOKE_ADMIN: |
| return createRevokeAdminDialog(getContext()); |
| case DIALOG_CONFIRM_GRANT_ADMIN: |
| return createGrantAdminDialog(getContext()); |
| } |
| throw new IllegalArgumentException("Unsupported dialogId " + dialogId); |
| } |
| |
| /** |
| * Creates dialog to confirm revoking admin rights. |
| * @return created confirmation dialog |
| */ |
| private Dialog createRevokeAdminDialog(Context context) { |
| CustomDialogHelper dialogHelper = new CustomDialogHelper(context); |
| dialogHelper.setIcon( |
| context.getDrawable(com.android.settingslib.R.drawable.ic_admin_panel_settings)); |
| dialogHelper.setTitle(R.string.user_revoke_admin_confirm_title); |
| dialogHelper.setMessage(R.string.user_revoke_admin_confirm_message); |
| dialogHelper.setPositiveButton(R.string.remove, view -> { |
| updateUserAdminStatus(false); |
| dialogHelper.getDialog().dismiss(); |
| }); |
| dialogHelper.setBackButton(R.string.cancel, view -> { |
| dialogHelper.getDialog().dismiss(); |
| }); |
| return dialogHelper.getDialog(); |
| } |
| |
| /** |
| * Creates dialog to confirm granting admin rights. |
| * @return created confirmation dialog |
| */ |
| private Dialog createGrantAdminDialog(Context context) { |
| CustomDialogHelper dialogHelper = new CustomDialogHelper(context); |
| dialogHelper.setIcon( |
| context.getDrawable(com.android.settingslib.R.drawable.ic_admin_panel_settings)); |
| dialogHelper.setTitle(com.android.settingslib.R.string.user_grant_admin_title); |
| dialogHelper.setMessage(com.android.settingslib.R.string.user_grant_admin_message); |
| dialogHelper.setPositiveButton(com.android.settingslib.R.string.user_grant_admin_button, |
| view -> { |
| updateUserAdminStatus(true); |
| dialogHelper.getDialog().dismiss(); |
| }); |
| dialogHelper.setBackButton(R.string.cancel, view -> { |
| dialogHelper.getDialog().dismiss(); |
| }); |
| return dialogHelper.getDialog(); |
| } |
| |
| /** |
| * Erase the current guest user and create a new one in the background. UserSettings will |
| * handle guest creation after receiving the {@link UserSettings.RESULT_GUEST_REMOVED} result. |
| */ |
| private void resetGuest() { |
| // Just to be safe, check that the selected user is a guest |
| if (!mUserInfo.isGuest()) { |
| return; |
| } |
| mMetricsFeatureProvider.action(getActivity(), |
| SettingsEnums.ACTION_USER_GUEST_EXIT_CONFIRMED); |
| |
| mUserManager.removeUser(mUserInfo.id); |
| setResult(UserSettings.RESULT_GUEST_REMOVED); |
| finishFragment(); |
| } |
| |
| @VisibleForTesting |
| @Override |
| protected void showDialog(int dialogId) { |
| super.showDialog(dialogId); |
| } |
| |
| @VisibleForTesting |
| void initialize(Context context, Bundle arguments) { |
| int userId = arguments != null ? arguments.getInt(EXTRA_USER_ID, USER_NULL) : USER_NULL; |
| if (userId == USER_NULL) { |
| throw new IllegalStateException("Arguments to this fragment must contain the user id"); |
| } |
| boolean isNewUser = |
| arguments.getBoolean(AppRestrictionsFragment.EXTRA_NEW_USER, false); |
| mUserInfo = mUserManager.getUserInfo(userId); |
| |
| mSwitchUserPref = findPreference(KEY_SWITCH_USER); |
| mPhonePref = findPreference(KEY_ENABLE_TELEPHONY); |
| mRemoveUserPref = findPreference(KEY_REMOVE_USER); |
| mAppAndContentAccessPref = findPreference(KEY_APP_AND_CONTENT_ACCESS); |
| mAppCopyingPref = findPreference(KEY_APP_COPYING); |
| mGrantAdminPref = findPreference(KEY_GRANT_ADMIN); |
| |
| mGrantAdminPref.setChecked(mUserInfo.isAdmin()); |
| |
| mSwitchUserPref.setTitle( |
| context.getString(com.android.settingslib.R.string.user_switch_to_user, |
| mUserInfo.name)); |
| |
| if (mUserCaps.mDisallowSwitchUser) { |
| mSwitchUserPref.setDisabledByAdmin(RestrictedLockUtilsInternal.getDeviceOwner(context)); |
| } else { |
| mSwitchUserPref.setDisabledByAdmin(null); |
| mSwitchUserPref.setSelectable(true); |
| mSwitchUserPref.setOnPreferenceClickListener(this); |
| } |
| if (mUserInfo.isMain() || mUserInfo.isGuest() || !UserManager.isMultipleAdminEnabled() |
| || mUserManager.hasUserRestrictionForUser(UserManager.DISALLOW_GRANT_ADMIN, |
| mUserInfo.getUserHandle())) { |
| removePreference(KEY_GRANT_ADMIN); |
| } |
| if (!mUserManager.isAdminUser()) { // non admin users can't remove users and allow calls |
| removePreference(KEY_ENABLE_TELEPHONY); |
| removePreference(KEY_REMOVE_USER); |
| removePreference(KEY_GRANT_ADMIN); |
| removePreference(KEY_APP_AND_CONTENT_ACCESS); |
| removePreference(KEY_APP_COPYING); |
| } else { |
| if (!Utils.isVoiceCapable(context)) { // no telephony |
| removePreference(KEY_ENABLE_TELEPHONY); |
| } |
| |
| if (mUserInfo.isRestricted()) { |
| removePreference(KEY_ENABLE_TELEPHONY); |
| if (isNewUser) { |
| // for newly created restricted users we should open the apps and content access |
| // screen to initialize the default restrictions |
| openAppAndContentAccessScreen(true); |
| } |
| } else { |
| removePreference(KEY_APP_AND_CONTENT_ACCESS); |
| } |
| |
| if (mUserInfo.isGuest()) { |
| removePreference(KEY_ENABLE_TELEPHONY); |
| mRemoveUserPref.setTitle(mGuestUserAutoCreated |
| ? com.android.settingslib.R.string.guest_reset_guest |
| : com.android.settingslib.R.string.guest_exit_guest); |
| if (mGuestUserAutoCreated) { |
| mRemoveUserPref.setEnabled((mUserInfo.flags & UserInfo.FLAG_INITIALIZED) != 0); |
| } |
| if (!SHOW_APP_COPYING_PREF) { |
| removePreference(KEY_APP_COPYING); |
| } |
| } else { |
| mPhonePref.setChecked(!mUserManager.hasUserRestriction( |
| UserManager.DISALLOW_OUTGOING_CALLS, new UserHandle(userId))); |
| mRemoveUserPref.setTitle(R.string.user_remove_user); |
| removePreference(KEY_APP_COPYING); |
| } |
| |
| // Remove preference KEY_REMOVE_USER if DISALLOW_REMOVE_USER restriction is set |
| // on the current user or the user selected in user details settings is a main user. |
| if (RestrictedLockUtilsInternal.hasBaseUserRestriction(context, |
| UserManager.DISALLOW_REMOVE_USER, UserHandle.myUserId()) |
| || mUserInfo.isMain()) { |
| removePreference(KEY_REMOVE_USER); |
| } |
| |
| mRemoveUserPref.setOnPreferenceClickListener(this); |
| mPhonePref.setOnPreferenceChangeListener(this); |
| mGrantAdminPref.setOnPreferenceChangeListener(this); |
| mAppAndContentAccessPref.setOnPreferenceClickListener(this); |
| mAppCopyingPref.setOnPreferenceClickListener(this); |
| } |
| } |
| |
| @VisibleForTesting |
| boolean canDeleteUser() { |
| if (!mUserManager.isAdminUser() || mUserInfo.isMain()) { |
| return false; |
| } |
| |
| Context context = getActivity(); |
| if (context == null) { |
| return false; |
| } |
| |
| final RestrictedLockUtils.EnforcedAdmin removeDisallowedAdmin = |
| RestrictedLockUtilsInternal.checkIfRestrictionEnforced(context, |
| UserManager.DISALLOW_REMOVE_USER, UserHandle.myUserId()); |
| if (removeDisallowedAdmin != null) { |
| RestrictedLockUtils.sendShowAdminSupportDetailsIntent(context, |
| removeDisallowedAdmin); |
| return false; |
| } |
| return true; |
| } |
| |
| @VisibleForTesting |
| boolean canSwitchUserNow() { |
| return mUserManager.getUserSwitchability() == UserManager.SWITCHABILITY_STATUS_OK; |
| } |
| |
| @VisibleForTesting |
| void switchUser() { |
| Trace.beginSection("UserDetailSettings.switchUser"); |
| try { |
| if (mUserCaps.mIsGuest && mUserCaps.mIsEphemeral) { |
| int guestUserId = UserHandle.myUserId(); |
| // Using markGuestForDeletion allows us to create a new guest before this one is |
| // fully removed. |
| boolean marked = mUserManager.markGuestForDeletion(guestUserId); |
| if (!marked) { |
| Log.w(TAG, "Couldn't mark the guest for deletion for user " + guestUserId); |
| return; |
| } |
| } |
| ActivityManager.getService().switchUser(mUserInfo.id); |
| } catch (RemoteException re) { |
| Log.e(TAG, "Error while switching to other user."); |
| } finally { |
| Trace.endSection(); |
| finishFragment(); |
| } |
| } |
| |
| private void enableCallsAndSms(boolean enabled) { |
| mPhonePref.setChecked(enabled); |
| UserHandle userHandle = UserHandle.of(mUserInfo.id); |
| mUserManager.setUserRestriction(UserManager.DISALLOW_OUTGOING_CALLS, !enabled, userHandle); |
| mUserManager.setUserRestriction(UserManager.DISALLOW_SMS, !enabled, userHandle); |
| } |
| |
| /** |
| * Sets admin status of selected user. Method is called when toggle in |
| * user details settings is switched. |
| * @param isSetAdmin indicates if user admin status needs to be set to true. |
| */ |
| private void updateUserAdminStatus(boolean isSetAdmin) { |
| mGrantAdminPref.setChecked(isSetAdmin); |
| if (!isSetAdmin) { |
| mUserManager.revokeUserAdmin(mUserInfo.id); |
| } else if ((mUserInfo.flags & UserInfo.FLAG_ADMIN) == 0) { |
| mUserManager.setUserAdmin(mUserInfo.id); |
| } |
| } |
| |
| private void removeUser() { |
| mUserManager.removeUser(mUserInfo.id); |
| finishFragment(); |
| } |
| |
| /** |
| * @param isNewUser indicates if a user was created recently, for new users |
| * AppRestrictionsFragment should set the default restrictions |
| */ |
| private void openAppAndContentAccessScreen(boolean isNewUser) { |
| Bundle extras = new Bundle(); |
| extras.putInt(AppRestrictionsFragment.EXTRA_USER_ID, mUserInfo.id); |
| extras.putBoolean(AppRestrictionsFragment.EXTRA_NEW_USER, isNewUser); |
| new SubSettingLauncher(getContext()) |
| .setDestination(AppRestrictionsFragment.class.getName()) |
| .setArguments(extras) |
| .setTitleRes(R.string.user_restrictions_title) |
| .setSourceMetricsCategory(getMetricsCategory()) |
| .launch(); |
| } |
| |
| private void openAppCopyingScreen() { |
| if (!SHOW_APP_COPYING_PREF) { |
| return; |
| } |
| final Bundle extras = new Bundle(); |
| extras.putInt(AppRestrictionsFragment.EXTRA_USER_ID, mUserInfo.id); |
| new SubSettingLauncher(getContext()) |
| .setDestination(AppCopyFragment.class.getName()) |
| .setArguments(extras) |
| .setTitleRes(R.string.user_copy_apps_menu_title) |
| .setSourceMetricsCategory(getMetricsCategory()) |
| .launch(); |
| } |
| |
| private boolean isSecondaryUser(UserInfo user) { |
| return UserManager.USER_TYPE_FULL_SECONDARY.equals(user.userType); |
| } |
| |
| private boolean shouldShowSetupPromptDialog() { |
| // TODO: FLAG_INITIALIZED is set when a user is switched to for the first time, |
| // but what we would really need here is a flag that shows if the setup process was |
| // completed. After the user cancels the setup process, mUserInfo.isInitialized() will |
| // return true so there will be no setup prompt dialog shown to the user anymore. |
| return isSecondaryUser(mUserInfo) && !mUserInfo.isInitialized(); |
| } |
| } |