| /* |
| * 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.accessibility; |
| |
| import static com.android.settings.accessibility.AccessibilityDialogUtils.DialogEnums; |
| |
| import android.app.Dialog; |
| import android.app.settings.SettingsEnums; |
| import android.content.ComponentName; |
| import android.content.ContentResolver; |
| import android.content.Context; |
| import android.content.DialogInterface; |
| import android.content.Intent; |
| import android.content.pm.ResolveInfo; |
| import android.graphics.drawable.Drawable; |
| import android.icu.text.CaseMap; |
| import android.net.Uri; |
| import android.os.Bundle; |
| import android.os.Handler; |
| import android.os.UserHandle; |
| import android.provider.Settings; |
| import android.text.Html; |
| import android.text.TextUtils; |
| import android.view.LayoutInflater; |
| import android.view.View; |
| import android.view.ViewGroup; |
| import android.view.accessibility.AccessibilityManager; |
| import android.view.accessibility.AccessibilityManager.TouchExplorationStateChangeListener; |
| import android.widget.CheckBox; |
| import android.widget.ImageView; |
| import android.widget.Switch; |
| |
| import androidx.annotation.VisibleForTesting; |
| import androidx.preference.Preference; |
| import androidx.preference.PreferenceCategory; |
| import androidx.preference.PreferenceScreen; |
| |
| import com.android.settings.R; |
| import com.android.settings.SettingsActivity; |
| import com.android.settings.SettingsPreferenceFragment; |
| import com.android.settings.accessibility.AccessibilityDialogUtils.DialogType; |
| import com.android.settings.accessibility.AccessibilityUtil.UserShortcutType; |
| import com.android.settings.utils.LocaleUtils; |
| import com.android.settings.widget.SettingsMainSwitchBar; |
| import com.android.settings.widget.SettingsMainSwitchPreference; |
| import com.android.settingslib.HelpUtils; |
| import com.android.settingslib.accessibility.AccessibilityUtils; |
| import com.android.settingslib.widget.IllustrationPreference; |
| import com.android.settingslib.widget.OnMainSwitchChangeListener; |
| |
| import com.google.android.setupcompat.util.WizardManagerHelper; |
| |
| import java.util.ArrayList; |
| import java.util.List; |
| import java.util.Locale; |
| |
| /** |
| * Base class for accessibility fragments with toggle, shortcut, some helper functions |
| * and dialog management. |
| */ |
| public abstract class ToggleFeaturePreferenceFragment extends SettingsPreferenceFragment |
| implements ShortcutPreference.OnClickCallback, OnMainSwitchChangeListener { |
| |
| protected SettingsMainSwitchPreference mToggleServiceSwitchPreference; |
| protected ShortcutPreference mShortcutPreference; |
| protected Preference mSettingsPreference; |
| protected String mPreferenceKey; |
| |
| protected CharSequence mSettingsTitle; |
| protected Intent mSettingsIntent; |
| // The mComponentName maybe null, such as Magnify |
| protected ComponentName mComponentName; |
| protected CharSequence mPackageName; |
| protected Uri mImageUri; |
| private CharSequence mDescription; |
| protected CharSequence mHtmlDescription; |
| |
| private static final String DRAWABLE_FOLDER = "drawable"; |
| protected static final String KEY_USE_SERVICE_PREFERENCE = "use_service"; |
| public static final String KEY_GENERAL_CATEGORY = "general_categories"; |
| protected static final String KEY_HTML_DESCRIPTION_PREFERENCE = "html_description"; |
| private static final String KEY_SHORTCUT_PREFERENCE = "shortcut_preference"; |
| protected static final String KEY_SAVED_USER_SHORTCUT_TYPE = "shortcut_type"; |
| protected static final String KEY_ANIMATED_IMAGE = "animated_image"; |
| |
| private TouchExplorationStateChangeListener mTouchExplorationStateChangeListener; |
| private SettingsContentObserver mSettingsContentObserver; |
| |
| private CheckBox mSoftwareTypeCheckBox; |
| private CheckBox mHardwareTypeCheckBox; |
| |
| public static final int NOT_SET = -1; |
| // Save user's shortcutType value when savedInstance has value (e.g. device rotated). |
| protected int mSavedCheckBoxValue = NOT_SET; |
| |
| // For html description of accessibility service, must follow the rule, such as |
| // <img src="R.drawable.fileName"/>, a11y settings will get the resources successfully. |
| private static final String IMG_PREFIX = "R.drawable."; |
| |
| private ImageView mImageGetterCacheView; |
| |
| private final Html.ImageGetter mImageGetter = (String str) -> { |
| if (str != null && str.startsWith(IMG_PREFIX)) { |
| final String fileName = str.substring(IMG_PREFIX.length()); |
| return getDrawableFromUri(Uri.parse( |
| ContentResolver.SCHEME_ANDROID_RESOURCE + "://" |
| + mComponentName.getPackageName() + "/" + DRAWABLE_FOLDER + "/" |
| + fileName)); |
| } |
| return null; |
| }; |
| |
| @Override |
| public void onCreate(Bundle savedInstanceState) { |
| super.onCreate(savedInstanceState); |
| |
| // Restore the user shortcut type. |
| if (savedInstanceState != null && savedInstanceState.containsKey( |
| KEY_SAVED_USER_SHORTCUT_TYPE)) { |
| mSavedCheckBoxValue = savedInstanceState.getInt(KEY_SAVED_USER_SHORTCUT_TYPE, NOT_SET); |
| } |
| |
| setupDefaultShortcutIfNecessary(getPrefContext()); |
| final int resId = getPreferenceScreenResId(); |
| if (resId <= 0) { |
| final PreferenceScreen preferenceScreen = getPreferenceManager().createPreferenceScreen( |
| getPrefContext()); |
| setPreferenceScreen(preferenceScreen); |
| } |
| |
| final List<String> shortcutFeatureKeys = new ArrayList<>(); |
| shortcutFeatureKeys.add(Settings.Secure.ACCESSIBILITY_BUTTON_TARGETS); |
| shortcutFeatureKeys.add(Settings.Secure.ACCESSIBILITY_SHORTCUT_TARGET_SERVICE); |
| mSettingsContentObserver = new SettingsContentObserver(new Handler(), shortcutFeatureKeys) { |
| @Override |
| public void onChange(boolean selfChange, Uri uri) { |
| updateShortcutPreferenceData(); |
| updateShortcutPreference(); |
| } |
| }; |
| } |
| |
| @Override |
| public View onCreateView(LayoutInflater inflater, ViewGroup container, |
| Bundle savedInstanceState) { |
| // Need to be called as early as possible. Protected variables will be assigned here. |
| onProcessArguments(getArguments()); |
| |
| initAnimatedImagePreference(); |
| initToggleServiceSwitchPreference(); |
| initGeneralCategory(); |
| initShortcutPreference(); |
| initSettingsPreference(); |
| initHtmlTextPreference(); |
| initFooterPreference(); |
| |
| installActionBarToggleSwitch(); |
| |
| updateToggleServiceTitle(mToggleServiceSwitchPreference); |
| |
| mTouchExplorationStateChangeListener = isTouchExplorationEnabled -> { |
| removeDialog(DialogEnums.EDIT_SHORTCUT); |
| mShortcutPreference.setSummary(getShortcutTypeSummary(getPrefContext())); |
| }; |
| return super.onCreateView(inflater, container, savedInstanceState); |
| } |
| |
| @Override |
| public void onViewCreated(View view, Bundle savedInstanceState) { |
| super.onViewCreated(view, savedInstanceState); |
| |
| final SettingsActivity activity = (SettingsActivity) getActivity(); |
| final SettingsMainSwitchBar switchBar = activity.getSwitchBar(); |
| switchBar.hide(); |
| |
| updatePreferenceOrder(); |
| } |
| |
| @Override |
| public void onResume() { |
| super.onResume(); |
| |
| final AccessibilityManager am = getPrefContext().getSystemService( |
| AccessibilityManager.class); |
| am.addTouchExplorationStateChangeListener(mTouchExplorationStateChangeListener); |
| mSettingsContentObserver.register(getContentResolver()); |
| updateShortcutPreferenceData(); |
| updateShortcutPreference(); |
| } |
| |
| @Override |
| public void onPause() { |
| final AccessibilityManager am = getPrefContext().getSystemService( |
| AccessibilityManager.class); |
| am.removeTouchExplorationStateChangeListener(mTouchExplorationStateChangeListener); |
| mSettingsContentObserver.unregister(getContentResolver()); |
| super.onPause(); |
| } |
| |
| @Override |
| public void onSaveInstanceState(Bundle outState) { |
| final int value = getShortcutTypeCheckBoxValue(); |
| if (value != NOT_SET) { |
| outState.putInt(KEY_SAVED_USER_SHORTCUT_TYPE, value); |
| } |
| super.onSaveInstanceState(outState); |
| } |
| |
| @Override |
| public Dialog onCreateDialog(int dialogId) { |
| Dialog dialog; |
| switch (dialogId) { |
| case DialogEnums.EDIT_SHORTCUT: |
| final CharSequence dialogTitle = getPrefContext().getString( |
| R.string.accessibility_shortcut_title, mPackageName); |
| final int dialogType = WizardManagerHelper.isAnySetupWizard(getIntent()) |
| ? DialogType.EDIT_SHORTCUT_GENERIC_SUW : DialogType.EDIT_SHORTCUT_GENERIC; |
| dialog = AccessibilityDialogUtils.showEditShortcutDialog( |
| getPrefContext(), dialogType, dialogTitle, |
| this::callOnAlertDialogCheckboxClicked); |
| setupEditShortcutDialog(dialog); |
| return dialog; |
| case DialogEnums.LAUNCH_ACCESSIBILITY_TUTORIAL: |
| dialog = AccessibilityGestureNavigationTutorial |
| .createAccessibilityTutorialDialog(getPrefContext(), |
| getUserShortcutTypes()); |
| dialog.setCanceledOnTouchOutside(false); |
| return dialog; |
| default: |
| throw new IllegalArgumentException("Unsupported dialogId " + dialogId); |
| } |
| } |
| |
| @Override |
| public int getDialogMetricsCategory(int dialogId) { |
| switch (dialogId) { |
| case DialogEnums.EDIT_SHORTCUT: |
| return SettingsEnums.DIALOG_ACCESSIBILITY_SERVICE_EDIT_SHORTCUT; |
| case DialogEnums.LAUNCH_ACCESSIBILITY_TUTORIAL: |
| return SettingsEnums.DIALOG_ACCESSIBILITY_TUTORIAL; |
| default: |
| return SettingsEnums.ACTION_UNKNOWN; |
| } |
| } |
| |
| @Override |
| public int getMetricsCategory() { |
| return SettingsEnums.ACCESSIBILITY_SERVICE; |
| } |
| |
| @Override |
| public int getHelpResource() { |
| return 0; |
| } |
| |
| @Override |
| public void onDestroyView() { |
| super.onDestroyView(); |
| removeActionBarToggleSwitch(); |
| } |
| |
| @Override |
| public void onSwitchChanged(Switch switchView, boolean isChecked) { |
| onPreferenceToggled(mPreferenceKey, isChecked); |
| } |
| |
| /** |
| * Returns the shortcut type list which has been checked by user. |
| */ |
| abstract int getUserShortcutTypes(); |
| |
| protected void updateToggleServiceTitle(SettingsMainSwitchPreference switchPreference) { |
| switchPreference.setTitle(R.string.accessibility_service_primary_switch_title); |
| } |
| |
| protected abstract void onPreferenceToggled(String preferenceKey, boolean enabled); |
| |
| protected void onInstallSwitchPreferenceToggleSwitch() { |
| // Implement this to set a checked listener. |
| updateSwitchBarToggleSwitch(); |
| mToggleServiceSwitchPreference.addOnSwitchChangeListener(this); |
| } |
| |
| protected void onRemoveSwitchPreferenceToggleSwitch() { |
| // Implement this to reset a checked listener. |
| } |
| |
| protected void updateSwitchBarToggleSwitch() { |
| // Implement this to update the state of switch. |
| } |
| |
| private void installActionBarToggleSwitch() { |
| onInstallSwitchPreferenceToggleSwitch(); |
| } |
| |
| private void removeActionBarToggleSwitch() { |
| mToggleServiceSwitchPreference.setOnPreferenceClickListener(null); |
| onRemoveSwitchPreferenceToggleSwitch(); |
| } |
| |
| public void setTitle(String title) { |
| getActivity().setTitle(title); |
| } |
| |
| protected void onProcessArguments(Bundle arguments) { |
| // Key. |
| mPreferenceKey = arguments.getString(AccessibilitySettings.EXTRA_PREFERENCE_KEY); |
| |
| // Title. |
| if (arguments.containsKey(AccessibilitySettings.EXTRA_RESOLVE_INFO)) { |
| ResolveInfo info = arguments.getParcelable(AccessibilitySettings.EXTRA_RESOLVE_INFO); |
| getActivity().setTitle(info.loadLabel(getPackageManager()).toString()); |
| } else if (arguments.containsKey(AccessibilitySettings.EXTRA_TITLE)) { |
| setTitle(arguments.getString(AccessibilitySettings.EXTRA_TITLE)); |
| } |
| |
| // Summary. |
| if (arguments.containsKey(AccessibilitySettings.EXTRA_SUMMARY)) { |
| mDescription = arguments.getCharSequence(AccessibilitySettings.EXTRA_SUMMARY); |
| } |
| |
| // Settings html description. |
| if (arguments.containsKey(AccessibilitySettings.EXTRA_HTML_DESCRIPTION)) { |
| mHtmlDescription = arguments.getCharSequence( |
| AccessibilitySettings.EXTRA_HTML_DESCRIPTION); |
| } |
| } |
| |
| /** Customizes the order by preference key. */ |
| protected List<String> getPreferenceOrderList() { |
| final List<String> lists = new ArrayList<>(); |
| lists.add(KEY_ANIMATED_IMAGE); |
| lists.add(KEY_USE_SERVICE_PREFERENCE); |
| lists.add(KEY_GENERAL_CATEGORY); |
| lists.add(KEY_HTML_DESCRIPTION_PREFERENCE); |
| return lists; |
| } |
| |
| private void updatePreferenceOrder() { |
| final List<String> lists = getPreferenceOrderList(); |
| |
| final PreferenceScreen preferenceScreen = getPreferenceScreen(); |
| preferenceScreen.setOrderingAsAdded(false); |
| |
| final int size = lists.size(); |
| for (int i = 0; i < size; i++) { |
| final Preference preference = preferenceScreen.findPreference(lists.get(i)); |
| if (preference != null) { |
| preference.setOrder(i); |
| } |
| } |
| } |
| |
| private Drawable getDrawableFromUri(Uri imageUri) { |
| if (mImageGetterCacheView == null) { |
| mImageGetterCacheView = new ImageView(getPrefContext()); |
| } |
| |
| mImageGetterCacheView.setAdjustViewBounds(true); |
| mImageGetterCacheView.setImageURI(imageUri); |
| |
| if (mImageGetterCacheView.getDrawable() == null) { |
| return null; |
| } |
| |
| final Drawable drawable = |
| mImageGetterCacheView.getDrawable().mutate().getConstantState().newDrawable(); |
| mImageGetterCacheView.setImageURI(null); |
| final int imageWidth = drawable.getIntrinsicWidth(); |
| final int imageHeight = drawable.getIntrinsicHeight(); |
| final int screenHalfHeight = AccessibilityUtil.getScreenHeightPixels(getPrefContext()) / 2; |
| if ((imageWidth > AccessibilityUtil.getScreenWidthPixels(getPrefContext())) |
| || (imageHeight > screenHalfHeight)) { |
| return null; |
| } |
| |
| drawable.setBounds(/* left= */0, /* top= */0, drawable.getIntrinsicWidth(), |
| drawable.getIntrinsicHeight()); |
| |
| return drawable; |
| } |
| |
| private void initAnimatedImagePreference() { |
| if (mImageUri == null) { |
| return; |
| } |
| |
| final IllustrationPreference illustrationPreference = |
| new IllustrationPreference(getPrefContext()); |
| illustrationPreference.setImageUri(mImageUri); |
| illustrationPreference.setSelectable(false); |
| illustrationPreference.setKey(KEY_ANIMATED_IMAGE); |
| |
| getPreferenceScreen().addPreference(illustrationPreference); |
| } |
| |
| private void initToggleServiceSwitchPreference() { |
| mToggleServiceSwitchPreference = new SettingsMainSwitchPreference(getPrefContext()); |
| mToggleServiceSwitchPreference.setKey(KEY_USE_SERVICE_PREFERENCE); |
| if (getArguments().containsKey(AccessibilitySettings.EXTRA_CHECKED)) { |
| final boolean enabled = getArguments().getBoolean(AccessibilitySettings.EXTRA_CHECKED); |
| mToggleServiceSwitchPreference.setChecked(enabled); |
| } |
| |
| getPreferenceScreen().addPreference(mToggleServiceSwitchPreference); |
| } |
| |
| private void initGeneralCategory() { |
| final PreferenceCategory generalCategory = new PreferenceCategory(getPrefContext()); |
| generalCategory.setKey(KEY_GENERAL_CATEGORY); |
| generalCategory.setTitle(R.string.accessibility_screen_option); |
| |
| getPreferenceScreen().addPreference(generalCategory); |
| } |
| |
| protected void initShortcutPreference() { |
| // Initial the shortcut preference. |
| mShortcutPreference = new ShortcutPreference(getPrefContext(), /* attrs= */ null); |
| mShortcutPreference.setPersistent(false); |
| mShortcutPreference.setKey(getShortcutPreferenceKey()); |
| mShortcutPreference.setOnClickCallback(this); |
| |
| final CharSequence title = getString(R.string.accessibility_shortcut_title, mPackageName); |
| mShortcutPreference.setTitle(title); |
| |
| final PreferenceCategory generalCategory = findPreference(KEY_GENERAL_CATEGORY); |
| generalCategory.addPreference(mShortcutPreference); |
| } |
| |
| protected void initSettingsPreference() { |
| if (mSettingsTitle == null || mSettingsIntent == null) { |
| return; |
| } |
| |
| // Show the "Settings" menu as if it were a preference screen. |
| mSettingsPreference = new Preference(getPrefContext()); |
| mSettingsPreference.setTitle(mSettingsTitle); |
| mSettingsPreference.setIconSpaceReserved(false); |
| mSettingsPreference.setIntent(mSettingsIntent); |
| |
| final PreferenceCategory generalCategory = findPreference(KEY_GENERAL_CATEGORY); |
| generalCategory.addPreference(mSettingsPreference); |
| } |
| |
| private void initHtmlTextPreference() { |
| if (TextUtils.isEmpty(mHtmlDescription)) { |
| return; |
| } |
| final PreferenceScreen screen = getPreferenceScreen(); |
| final CharSequence htmlDescription = Html.fromHtml(mHtmlDescription.toString(), |
| Html.FROM_HTML_MODE_COMPACT, mImageGetter, /* tagHandler= */ null); |
| final String iconContentDescription = |
| getString(R.string.accessibility_introduction_title, mPackageName); |
| |
| final AccessibilityFooterPreference htmlFooterPreference = |
| new AccessibilityFooterPreference(screen.getContext()); |
| htmlFooterPreference.setKey(KEY_HTML_DESCRIPTION_PREFERENCE); |
| htmlFooterPreference.setSummary(htmlDescription); |
| htmlFooterPreference.setContentDescription( |
| generateFooterContentDescription(htmlDescription)); |
| |
| // Only framework tools support help link |
| if (getHelpResource() != 0) { |
| htmlFooterPreference.setLearnMoreAction(view -> { |
| final Intent helpIntent = HelpUtils.getHelpIntent( |
| getContext(), getContext().getString(getHelpResource()), |
| getContext().getClass().getName()); |
| view.startActivityForResult(helpIntent, 0); |
| }); |
| |
| final String learnMoreContentDescription = getPrefContext().getString( |
| R.string.footer_learn_more_content_description, mPackageName); |
| htmlFooterPreference.setLearnMoreContentDescription(learnMoreContentDescription); |
| htmlFooterPreference.setLinkEnabled(true); |
| } else { |
| htmlFooterPreference.setLinkEnabled(false); |
| } |
| screen.addPreference(htmlFooterPreference); |
| } |
| |
| private void initFooterPreference() { |
| if (!TextUtils.isEmpty(mDescription)) { |
| createFooterPreference(getPreferenceScreen(), mDescription, |
| getString(R.string.accessibility_introduction_title, mPackageName)); |
| } |
| |
| if (TextUtils.isEmpty(mHtmlDescription) && TextUtils.isEmpty(mDescription)) { |
| final CharSequence defaultDescription = |
| getText(R.string.accessibility_service_default_description); |
| createFooterPreference(getPreferenceScreen(), defaultDescription, |
| getString(R.string.accessibility_introduction_title, mPackageName)); |
| } |
| } |
| |
| |
| /** |
| * Creates {@link AccessibilityFooterPreference} and append into {@link PreferenceScreen} |
| * |
| * @param screen The preference screen to add the footer preference |
| * @param summary The summary of the preference summary. |
| * @param iconContentDescription The content description of icon in the footer. |
| */ |
| @VisibleForTesting |
| void createFooterPreference(PreferenceScreen screen, CharSequence summary, |
| String iconContentDescription) { |
| final AccessibilityFooterPreference footerPreference = |
| new AccessibilityFooterPreference(screen.getContext()); |
| footerPreference.setSummary(summary); |
| footerPreference.setContentDescription( |
| generateFooterContentDescription(summary)); |
| |
| // Only framework tools support help link |
| if (getHelpResource() != 0) { |
| footerPreference.setLearnMoreAction(view -> { |
| final Intent helpIntent = HelpUtils.getHelpIntent( |
| getContext(), getContext().getString(getHelpResource()), |
| getContext().getClass().getName()); |
| view.startActivityForResult(helpIntent, 0); |
| }); |
| |
| final String learnMoreContentDescription = getPrefContext().getString( |
| R.string.footer_learn_more_content_description, mPackageName); |
| footerPreference.setLearnMoreContentDescription(learnMoreContentDescription); |
| } |
| screen.addPreference(footerPreference); |
| } |
| |
| private CharSequence generateFooterContentDescription(CharSequence footerContent) { |
| final StringBuffer sb = new StringBuffer(); |
| sb.append(getPrefContext().getString( |
| R.string.accessibility_introduction_title, mPackageName)) |
| .append("\n\n") |
| .append(footerContent); |
| return sb; |
| } |
| @VisibleForTesting |
| void setupEditShortcutDialog(Dialog dialog) { |
| final View dialogSoftwareView = dialog.findViewById(R.id.software_shortcut); |
| mSoftwareTypeCheckBox = dialogSoftwareView.findViewById(R.id.checkbox); |
| setDialogTextAreaClickListener(dialogSoftwareView, mSoftwareTypeCheckBox); |
| |
| final View dialogHardwareView = dialog.findViewById(R.id.hardware_shortcut); |
| mHardwareTypeCheckBox = dialogHardwareView.findViewById(R.id.checkbox); |
| setDialogTextAreaClickListener(dialogHardwareView, mHardwareTypeCheckBox); |
| |
| updateEditShortcutDialogCheckBox(); |
| } |
| |
| private void setDialogTextAreaClickListener(View dialogView, CheckBox checkBox) { |
| final View dialogTextArea = dialogView.findViewById(R.id.container); |
| dialogTextArea.setOnClickListener(v -> checkBox.toggle()); |
| } |
| |
| private void updateEditShortcutDialogCheckBox() { |
| // If it is during onConfigChanged process then restore the value, or get the saved value |
| // when shortcutPreference is checked. |
| int value = restoreOnConfigChangedValue(); |
| if (value == NOT_SET) { |
| final int lastNonEmptyUserShortcutType = PreferredShortcuts.retrieveUserShortcutType( |
| getPrefContext(), mComponentName.flattenToString(), UserShortcutType.SOFTWARE); |
| value = mShortcutPreference.isChecked() ? lastNonEmptyUserShortcutType |
| : UserShortcutType.EMPTY; |
| } |
| |
| mSoftwareTypeCheckBox.setChecked( |
| hasShortcutType(value, UserShortcutType.SOFTWARE)); |
| mHardwareTypeCheckBox.setChecked( |
| hasShortcutType(value, UserShortcutType.HARDWARE)); |
| } |
| |
| private int restoreOnConfigChangedValue() { |
| final int savedValue = mSavedCheckBoxValue; |
| mSavedCheckBoxValue = NOT_SET; |
| return savedValue; |
| } |
| |
| private boolean hasShortcutType(int value, @UserShortcutType int type) { |
| return (value & type) == type; |
| } |
| |
| /** |
| * Returns accumulated {@link UserShortcutType} checkbox value or {@code NOT_SET} if checkboxes |
| * did not exist. |
| */ |
| protected int getShortcutTypeCheckBoxValue() { |
| if (mSoftwareTypeCheckBox == null || mHardwareTypeCheckBox == null) { |
| return NOT_SET; |
| } |
| |
| int value = UserShortcutType.EMPTY; |
| if (mSoftwareTypeCheckBox.isChecked()) { |
| value |= UserShortcutType.SOFTWARE; |
| } |
| if (mHardwareTypeCheckBox.isChecked()) { |
| value |= UserShortcutType.HARDWARE; |
| } |
| return value; |
| } |
| |
| protected CharSequence getShortcutTypeSummary(Context context) { |
| if (!mShortcutPreference.isSettingsEditable()) { |
| return context.getText(R.string.accessibility_shortcut_edit_dialog_title_hardware); |
| } |
| |
| if (!mShortcutPreference.isChecked()) { |
| return context.getText(R.string.switch_off_text); |
| } |
| |
| final int shortcutTypes = PreferredShortcuts.retrieveUserShortcutType(context, |
| mComponentName.flattenToString(), UserShortcutType.SOFTWARE); |
| |
| final List<CharSequence> list = new ArrayList<>(); |
| final CharSequence softwareTitle = context.getText( |
| R.string.accessibility_shortcut_edit_summary_software); |
| |
| if (hasShortcutType(shortcutTypes, UserShortcutType.SOFTWARE)) { |
| list.add(softwareTitle); |
| } |
| if (hasShortcutType(shortcutTypes, UserShortcutType.HARDWARE)) { |
| final CharSequence hardwareTitle = context.getText( |
| R.string.accessibility_shortcut_hardware_keyword); |
| list.add(hardwareTitle); |
| } |
| |
| // Show software shortcut if first time to use. |
| if (list.isEmpty()) { |
| list.add(softwareTitle); |
| } |
| |
| return CaseMap.toTitle().wholeString().noLowercase().apply(Locale.getDefault(), /* iter= */ |
| null, LocaleUtils.getConcatenatedString(list)); |
| } |
| |
| /** |
| * This method will be invoked when a button in the edit shortcut dialog is clicked. |
| * |
| * @param dialog The dialog that received the click |
| * @param which The button that was clicked |
| */ |
| protected void callOnAlertDialogCheckboxClicked(DialogInterface dialog, int which) { |
| if (mComponentName == null) { |
| return; |
| } |
| |
| final int value = getShortcutTypeCheckBoxValue(); |
| |
| saveNonEmptyUserShortcutType(value); |
| AccessibilityUtil.optInAllValuesToSettings(getPrefContext(), value, mComponentName); |
| AccessibilityUtil.optOutAllValuesFromSettings(getPrefContext(), ~value, mComponentName); |
| mShortcutPreference.setChecked(value != UserShortcutType.EMPTY); |
| mShortcutPreference.setSummary(getShortcutTypeSummary(getPrefContext())); |
| } |
| |
| protected void updateShortcutPreferenceData() { |
| if (mComponentName == null) { |
| return; |
| } |
| |
| final int shortcutTypes = AccessibilityUtil.getUserShortcutTypesFromSettings( |
| getPrefContext(), mComponentName); |
| if (shortcutTypes != UserShortcutType.EMPTY) { |
| final PreferredShortcut shortcut = new PreferredShortcut( |
| mComponentName.flattenToString(), shortcutTypes); |
| PreferredShortcuts.saveUserShortcutType(getPrefContext(), shortcut); |
| } |
| } |
| |
| protected void updateShortcutPreference() { |
| if (mComponentName == null) { |
| return; |
| } |
| |
| final int shortcutTypes = PreferredShortcuts.retrieveUserShortcutType(getPrefContext(), |
| mComponentName.flattenToString(), UserShortcutType.SOFTWARE); |
| mShortcutPreference.setChecked( |
| AccessibilityUtil.hasValuesInSettings(getPrefContext(), shortcutTypes, |
| mComponentName)); |
| mShortcutPreference.setSummary(getShortcutTypeSummary(getPrefContext())); |
| } |
| |
| protected String getShortcutPreferenceKey() { |
| return KEY_SHORTCUT_PREFERENCE; |
| } |
| |
| @Override |
| public void onToggleClicked(ShortcutPreference preference) { |
| if (mComponentName == null) { |
| return; |
| } |
| |
| final int shortcutTypes = PreferredShortcuts.retrieveUserShortcutType(getPrefContext(), |
| mComponentName.flattenToString(), UserShortcutType.SOFTWARE); |
| if (preference.isChecked()) { |
| AccessibilityUtil.optInAllValuesToSettings(getPrefContext(), shortcutTypes, |
| mComponentName); |
| showDialog(DialogEnums.LAUNCH_ACCESSIBILITY_TUTORIAL); |
| } else { |
| AccessibilityUtil.optOutAllValuesFromSettings(getPrefContext(), shortcutTypes, |
| mComponentName); |
| } |
| mShortcutPreference.setSummary(getShortcutTypeSummary(getPrefContext())); |
| } |
| |
| @Override |
| public void onSettingsClicked(ShortcutPreference preference) { |
| showDialog(DialogEnums.EDIT_SHORTCUT); |
| } |
| |
| /** |
| * Setups a configurable default if the setting has never been set. |
| */ |
| private static void setupDefaultShortcutIfNecessary(Context context) { |
| final String targetKey = Settings.Secure.ACCESSIBILITY_SHORTCUT_TARGET_SERVICE; |
| String targetString = Settings.Secure.getString(context.getContentResolver(), targetKey); |
| if (!TextUtils.isEmpty(targetString)) { |
| // The shortcut setting has been set |
| return; |
| } |
| |
| // AccessibilityManager#getAccessibilityShortcutTargets may not return correct shortcut |
| // targets during boot. Needs to read settings directly here. |
| targetString = AccessibilityUtils.getShortcutTargetServiceComponentNameString(context, |
| UserHandle.myUserId()); |
| if (TextUtils.isEmpty(targetString)) { |
| // No configurable default accessibility service |
| return; |
| } |
| |
| // Only fallback to default accessibility service when setting is never updated. |
| final ComponentName shortcutName = ComponentName.unflattenFromString(targetString); |
| if (shortcutName != null) { |
| Settings.Secure.putString(context.getContentResolver(), targetKey, |
| shortcutName.flattenToString()); |
| } |
| } |
| |
| @VisibleForTesting |
| void saveNonEmptyUserShortcutType(int type) { |
| if (type == UserShortcutType.EMPTY) { |
| return; |
| } |
| |
| final PreferredShortcut shortcut = new PreferredShortcut( |
| mComponentName.flattenToString(), type); |
| PreferredShortcuts.saveUserShortcutType(getPrefContext(), shortcut); |
| } |
| } |
