262 lines
10 KiB
Java
262 lines
10 KiB
Java
/*
|
|
* Copyright (C) 2013 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;
|
|
|
|
import java.util.HashSet;
|
|
|
|
import android.app.Activity;
|
|
import android.content.BroadcastReceiver;
|
|
import android.content.Context;
|
|
import android.content.Intent;
|
|
import android.content.IntentFilter;
|
|
import android.os.Bundle;
|
|
import android.os.UserManager;
|
|
import android.preference.CheckBoxPreference;
|
|
import android.preference.Preference;
|
|
|
|
/**
|
|
* Base class for settings activities that should be pin protected when in restricted mode.
|
|
* The constructor for this class will take the restriction key that this screen should be
|
|
* locked by. If {@link UserManager.hasRestrictionsPin()} and
|
|
* {@link UserManager.hasUserRestriction(String)} returns true for the restriction key, then
|
|
* the user will have to enter the restrictions pin before seeing the Settings screen.
|
|
*
|
|
* If this settings screen should be pin protected whenever
|
|
* {@link UserManager.hasUserRestriction(String)} returns true, pass in
|
|
* {@link RESTRICTIONS_PIN_SET} to the constructor instead of a restrictions key.
|
|
*/
|
|
public class RestrictedSettingsFragment extends SettingsPreferenceFragment {
|
|
|
|
protected static final String RESTRICTIONS_PIN_SET = "restrictions_pin_set";
|
|
|
|
private static final String EXTRA_PREFERENCE = "pref";
|
|
private static final String EXTRA_CHECKBOX_STATE = "isChecked";
|
|
// Should be unique across all settings screens that use this.
|
|
private static final int REQUEST_PIN_CHALLENGE = 12309;
|
|
|
|
private static final String KEY_CHALLENGE_SUCCEEDED = "chsc";
|
|
private static final String KEY_CHALLENGE_REQUESTED = "chrq";
|
|
private static final String KEY_RESUME_ACTION_BUNDLE = "rsmb";
|
|
|
|
// If the restriction PIN is entered correctly.
|
|
private boolean mChallengeSucceeded;
|
|
private boolean mChallengeRequested;
|
|
private Bundle mResumeActionBundle;
|
|
|
|
private UserManager mUserManager;
|
|
|
|
private final String mRestrictionKey;
|
|
|
|
private final HashSet<Preference> mProtectedByRestictionsPrefs = new HashSet<Preference>();
|
|
|
|
// Receiver to clear pin status when the screen is turned off.
|
|
private BroadcastReceiver mScreenOffReceiver = new BroadcastReceiver() {
|
|
@Override
|
|
public void onReceive(Context context, Intent intent) {
|
|
mChallengeSucceeded = false;
|
|
if (shouldBePinProtected(mRestrictionKey)) {
|
|
ensurePin(null);
|
|
}
|
|
}
|
|
};
|
|
|
|
/**
|
|
* @param restrictionKey The restriction key to check before pin protecting
|
|
* this settings page. Pass in {@link RESTRICTIONS_PIN_SET} if it should
|
|
* be PIN protected whenever a restrictions pin is set. Pass in
|
|
* null if it should never be PIN protected.
|
|
*/
|
|
public RestrictedSettingsFragment(String restrictionKey) {
|
|
mRestrictionKey = restrictionKey;
|
|
}
|
|
|
|
@Override
|
|
public void onCreate(Bundle icicle) {
|
|
super.onCreate(icicle);
|
|
|
|
mUserManager = (UserManager) getSystemService(Context.USER_SERVICE);
|
|
|
|
if (icicle != null) {
|
|
mChallengeSucceeded = icicle.getBoolean(KEY_CHALLENGE_SUCCEEDED, false);
|
|
mChallengeRequested = icicle.getBoolean(KEY_CHALLENGE_REQUESTED, false);
|
|
mResumeActionBundle = icicle.getBundle(KEY_RESUME_ACTION_BUNDLE);
|
|
}
|
|
}
|
|
|
|
@Override
|
|
public void onSaveInstanceState(Bundle outState) {
|
|
super.onSaveInstanceState(outState);
|
|
|
|
outState.putBoolean(KEY_CHALLENGE_REQUESTED, mChallengeRequested);
|
|
if (mResumeActionBundle != null) {
|
|
outState.putBundle(KEY_RESUME_ACTION_BUNDLE, mResumeActionBundle);
|
|
}
|
|
if (getActivity().isChangingConfigurations()) {
|
|
outState.putBoolean(KEY_CHALLENGE_SUCCEEDED, mChallengeSucceeded);
|
|
}
|
|
}
|
|
|
|
@Override
|
|
public void onResume() {
|
|
super.onResume();
|
|
if (shouldBePinProtected(mRestrictionKey)) {
|
|
ensurePin(null);
|
|
} else {
|
|
// If the whole screen is not pin protected, reset mChallengeSucceeded so next
|
|
// time user uses a protected preference, they are prompted for pin again.
|
|
mChallengeSucceeded = false;
|
|
}
|
|
IntentFilter filter = new IntentFilter(Intent.ACTION_SCREEN_OFF);
|
|
filter.addAction(Intent.ACTION_USER_PRESENT);
|
|
getActivity().registerReceiver(mScreenOffReceiver, filter);
|
|
}
|
|
|
|
@Override
|
|
public void onPause() {
|
|
super.onPause();
|
|
getActivity().unregisterReceiver(mScreenOffReceiver);
|
|
}
|
|
|
|
@Override
|
|
public void onActivityResult(int requestCode, int resultCode, Intent data) {
|
|
if (requestCode == REQUEST_PIN_CHALLENGE) {
|
|
Bundle resumeActionBundle = mResumeActionBundle;
|
|
mResumeActionBundle = null;
|
|
mChallengeRequested = false;
|
|
if (resultCode == Activity.RESULT_OK) {
|
|
mChallengeSucceeded = true;
|
|
String prefKey = resumeActionBundle == null ?
|
|
null : resumeActionBundle.getString(EXTRA_PREFERENCE);
|
|
if (prefKey != null) {
|
|
Preference pref = findPreference(prefKey);
|
|
if (pref != null) {
|
|
// Make sure the checkbox state is the same as it was when we launched the
|
|
// pin challenge.
|
|
if (pref instanceof CheckBoxPreference
|
|
&& resumeActionBundle.containsKey(EXTRA_CHECKBOX_STATE)) {
|
|
boolean isChecked =
|
|
resumeActionBundle.getBoolean(EXTRA_CHECKBOX_STATE, false);
|
|
((CheckBoxPreference)pref).setChecked(isChecked);
|
|
}
|
|
if (!onPreferenceTreeClick(getPreferenceScreen(), pref)) {
|
|
Intent prefIntent = pref.getIntent();
|
|
if (prefIntent != null) {
|
|
pref.getContext().startActivity(prefIntent);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
} else if (!isDetached()) {
|
|
finishFragment();
|
|
}
|
|
return;
|
|
}
|
|
|
|
super.onActivityResult(requestCode, resultCode, data);
|
|
}
|
|
|
|
private void ensurePin(Preference preference) {
|
|
if (!mChallengeSucceeded) {
|
|
final UserManager um = UserManager.get(getActivity());
|
|
if (!mChallengeRequested) {
|
|
if (um.hasRestrictionsChallenge()) {
|
|
mResumeActionBundle = new Bundle();
|
|
if (preference != null) {
|
|
mResumeActionBundle.putString(EXTRA_PREFERENCE, preference.getKey());
|
|
if (preference instanceof CheckBoxPreference) {
|
|
mResumeActionBundle.putBoolean(EXTRA_CHECKBOX_STATE,
|
|
((CheckBoxPreference)preference).isChecked());
|
|
}
|
|
}
|
|
Intent requestPin = new Intent(Intent.ACTION_RESTRICTIONS_CHALLENGE);
|
|
startActivityForResult(requestPin, REQUEST_PIN_CHALLENGE);
|
|
mChallengeRequested = true;
|
|
}
|
|
}
|
|
}
|
|
mChallengeSucceeded = false;
|
|
}
|
|
|
|
/**
|
|
* Returns true if this activity is restricted, but no restriction pin has been set.
|
|
* Used to determine if the settings UI should disable UI.
|
|
*/
|
|
protected boolean isRestrictedAndNotPinProtected() {
|
|
if (mRestrictionKey == null || RESTRICTIONS_PIN_SET.equals(mRestrictionKey)) {
|
|
return false;
|
|
}
|
|
return mUserManager.hasUserRestriction(mRestrictionKey)
|
|
&& !mUserManager.hasRestrictionsChallenge();
|
|
}
|
|
|
|
/**
|
|
* Called to trigger the pin entry if the given restriction key is locked down.
|
|
* @param restrictionsKey The restriction key or {@link RESTRICTIONS_PIN_SET} if
|
|
* pin entry should get triggered if there is a pin set.
|
|
*/
|
|
protected boolean restrictionsPinCheck(String restrictionsKey, Preference preference) {
|
|
if (shouldBePinProtected(restrictionsKey) && !mChallengeSucceeded) {
|
|
ensurePin(preference);
|
|
return false;
|
|
} else {
|
|
return true;
|
|
}
|
|
}
|
|
|
|
protected boolean hasChallengeSucceeded() {
|
|
return mChallengeSucceeded;
|
|
}
|
|
|
|
/**
|
|
* Returns true if this restrictions key is locked down.
|
|
*/
|
|
protected boolean shouldBePinProtected(String restrictionKey) {
|
|
if (restrictionKey == null) {
|
|
return false;
|
|
}
|
|
boolean restricted = RESTRICTIONS_PIN_SET.equals(restrictionKey)
|
|
|| mUserManager.hasUserRestriction(restrictionKey);
|
|
return restricted && mUserManager.hasRestrictionsChallenge();
|
|
}
|
|
|
|
/**
|
|
* If the preference is one that was added by protectByRestrictions(), then it will
|
|
* prompt the user for the restrictions pin if they haven't entered it already.
|
|
* Intended to be called at the top of onPreferenceTreeClick. If this function returns
|
|
* true, then onPreferenceTreeClick should return true.
|
|
*/
|
|
boolean ensurePinRestrictedPreference(Preference preference) {
|
|
return mProtectedByRestictionsPrefs.contains(preference)
|
|
&& !restrictionsPinCheck(RESTRICTIONS_PIN_SET, preference);
|
|
}
|
|
|
|
/**
|
|
* Call this with any preferences that should require the PIN to be entered
|
|
* before they are accessible.
|
|
*/
|
|
protected void protectByRestrictions(Preference pref) {
|
|
if (pref != null) {
|
|
mProtectedByRestictionsPrefs.add(pref);
|
|
}
|
|
}
|
|
|
|
protected void protectByRestrictions(String key) {
|
|
Preference pref = findPreference(key);
|
|
protectByRestrictions(pref);
|
|
}
|
|
}
|