/* * 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 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 androidx.annotation.VisibleForTesting; import androidx.preference.Preference; import androidx.preference.PreferenceCategory; import androidx.preference.PreferenceScreen; import androidx.preference.SwitchPreference; import com.android.settings.R; import com.android.settings.SettingsActivity; import com.android.settings.SettingsPreferenceFragment; import com.android.settings.accessibility.AccessibilityUtil.UserShortcutType; import com.android.settings.widget.SettingsMainSwitchBar; import com.android.settingslib.accessibility.AccessibilityUtils; import com.android.settingslib.widget.FooterPreference; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; 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 { protected DividerSwitchPreference mToggleServiceDividerSwitchPreference; 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"; protected static final String KEY_GENERAL_CATEGORY = "general_categories"; protected static final String KEY_INTRODUCTION_CATEGORY = "introduction_categories"; private static final String KEY_SHORTCUT_PREFERENCE = "shortcut_preference"; protected static final String KEY_SAVED_USER_SHORTCUT_TYPE = "shortcut_type"; 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 // , 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) { PreferenceScreen preferenceScreen = getPreferenceManager().createPreferenceScreen( getPrefContext()); setPreferenceScreen(preferenceScreen); } final List 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(); initToggleServiceDividerSwitchPreference(); initGeneralCategory(); initShortcutPreference(); initSettingsPreference(); initHtmlTextPreference(); initFooterPreference(); installActionBarToggleSwitch(); updateToggleServiceTitle(mToggleServiceDividerSwitchPreference); 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(); } @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); dialog = AccessibilityEditDialogUtils.showEditShortcutDialog( getPrefContext(), 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; } } /** Denotes the dialog emuns for show dialog */ @Retention(RetentionPolicy.SOURCE) protected @interface DialogEnums { /** OPEN: Settings > Accessibility > Any toggle service > Shortcut > Settings. */ int EDIT_SHORTCUT = 1; /** OPEN: Settings > Accessibility > Magnification > Shortcut > Settings. */ int MAGNIFICATION_EDIT_SHORTCUT = 1001; /** * OPEN: Settings > Accessibility > Downloaded toggle service > Toggle use service to * enable service. */ int ENABLE_WARNING_FROM_TOGGLE = 1002; /** OPEN: Settings > Accessibility > Downloaded toggle service > Shortcut checkbox. */ int ENABLE_WARNING_FROM_SHORTCUT = 1003; /** * OPEN: Settings > Accessibility > Downloaded toggle service > Shortcut checkbox * toggle. */ int ENABLE_WARNING_FROM_SHORTCUT_TOGGLE = 1004; /** * OPEN: Settings > Accessibility > Downloaded toggle service > Toggle use service to * disable service. */ int DISABLE_WARNING_FROM_TOGGLE = 1005; /** * OPEN: Settings > Accessibility > Magnification > Toggle user service in button * navigation. */ int ACCESSIBILITY_BUTTON_TUTORIAL = 1006; /** * OPEN: Settings > Accessibility > Magnification > Toggle user service in gesture * navigation. */ int GESTURE_NAVIGATION_TUTORIAL = 1007; /** * OPEN: Settings > Accessibility > Downloaded toggle service > Toggle user service > Show * launch tutorial. */ int LAUNCH_ACCESSIBILITY_TUTORIAL = 1008; } @Override public int getMetricsCategory() { return SettingsEnums.ACCESSIBILITY_SERVICE; } @Override public void onDestroyView() { super.onDestroyView(); removeActionBarToggleSwitch(); } /** * Returns the shortcut type list which has been checked by user. */ abstract int getUserShortcutTypes(); protected void updateToggleServiceTitle(SwitchPreference 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. } protected void onRemoveSwitchPreferenceToggleSwitch() { // Implement this to reset a checked listener. } private void installActionBarToggleSwitch() { onInstallSwitchPreferenceToggleSwitch(); } private void removeActionBarToggleSwitch() { mToggleServiceDividerSwitchPreference.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); } } 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 int screenHalfHeight = AccessibilityUtil.getScreenHeightPixels(getPrefContext()) / 2; final AnimatedImagePreference animatedImagePreference = new AnimatedImagePreference(getPrefContext()); animatedImagePreference.setImageUri(mImageUri); animatedImagePreference.setSelectable(false); animatedImagePreference.setMaxHeight(screenHalfHeight); getPreferenceScreen().addPreference(animatedImagePreference); } private void initToggleServiceDividerSwitchPreference() { mToggleServiceDividerSwitchPreference = new DividerSwitchPreference(getPrefContext()); mToggleServiceDividerSwitchPreference.setKey(KEY_USE_SERVICE_PREFERENCE); if (getArguments().containsKey(AccessibilitySettings.EXTRA_CHECKED)) { final boolean enabled = getArguments().getBoolean(AccessibilitySettings.EXTRA_CHECKED); mToggleServiceDividerSwitchPreference.setChecked(enabled); } getPreferenceScreen().addPreference(mToggleServiceDividerSwitchPreference); } 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(true); mSettingsPreference.setIntent(mSettingsIntent); final PreferenceCategory generalCategory = findPreference(KEY_GENERAL_CATEGORY); generalCategory.addPreference(mSettingsPreference); } private void initIntroductionCategory() { final PreferenceCategory introductionCategory = new PreferenceCategory(getPrefContext()); final CharSequence title = getString(R.string.accessibility_introduction_title, mPackageName); introductionCategory.setKey(KEY_INTRODUCTION_CATEGORY); introductionCategory.setTitle(title); getPreferenceScreen().addPreference(introductionCategory); } private void initHtmlTextPreference() { if (TextUtils.isEmpty(mHtmlDescription)) { return; } initIntroductionCategory(); final HtmlTextPreference htmlTextPreference = new HtmlTextPreference(getPrefContext()); htmlTextPreference.setSummary(mHtmlDescription); htmlTextPreference.setImageGetter(mImageGetter); htmlTextPreference.setSelectable(false); final PreferenceCategory introductionCategory = findPreference(KEY_INTRODUCTION_CATEGORY); introductionCategory.addPreference(htmlTextPreference); } private void initFooterPreference() { if (!TextUtils.isEmpty(mDescription)) { createFooterPreference(mDescription); } if (TextUtils.isEmpty(mHtmlDescription) && TextUtils.isEmpty(mDescription)) { final CharSequence defaultDescription = getText(R.string.accessibility_service_default_description); createFooterPreference(defaultDescription); } } @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); int resId = R.string.accessibility_shortcut_edit_summary_software; if (AccessibilityUtil.isGestureNavigateEnabled(context)) { resId = AccessibilityUtil.isTouchExploreEnabled(context) ? R.string.accessibility_shortcut_edit_dialog_title_software_gesture_talkback : R.string.accessibility_shortcut_edit_dialog_title_software_gesture; } final CharSequence softwareTitle = context.getText(resId); List list = new ArrayList<>(); if ((shortcutTypes & UserShortcutType.SOFTWARE) == UserShortcutType.SOFTWARE) { list.add(softwareTitle); } if ((shortcutTypes & UserShortcutType.HARDWARE) == 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); } final String joinStrings = TextUtils.join(/* delimiter= */", ", list); return CaseMap.toTitle().wholeString().noLowercase().apply(Locale.getDefault(), /* iter= */ null, joinStrings); } /** * 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); } private void createFooterPreference(CharSequence title) { final PreferenceScreen preferenceScreen = getPreferenceScreen(); preferenceScreen.addPreference(new FooterPreference.Builder(getActivity()).setTitle( title).build()); } /** * 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); } }