1 /* 2 * Copyright (C) 2015 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 package com.android.systemui; 18 19 import android.annotation.StringDef; 20 import android.content.Context; 21 import android.content.SharedPreferences; 22 import android.content.SharedPreferences.OnSharedPreferenceChangeListener; 23 24 import com.android.systemui.settings.CurrentUserContextTracker; 25 26 import java.lang.annotation.Retention; 27 import java.lang.annotation.RetentionPolicy; 28 import java.util.Map; 29 import java.util.Set; 30 31 /** 32 * A helper class to store simple preferences for SystemUI. Its main use case is things such as 33 * feature education, e.g. "has the user seen this tooltip". 34 * 35 * As of this writing, feature education settings are *intentionally exempted* from backup and 36 * restore because there is not a great way to know which subset of features the user _should_ see 37 * again if, for instance, they are coming from multiple OSes back or switching OEMs. 38 * 39 * NOTE: Clients of this class should take care to pass in the correct user context when querying 40 * settings, otherwise you will always read/write for user 0 which is almost never what you want. 41 * See {@link CurrentUserContextTracker} for a simple way to get the current context 42 */ 43 public final class Prefs { Prefs()44 private Prefs() {} // no instantation 45 46 @Retention(RetentionPolicy.SOURCE) 47 @StringDef({ 48 Key.OVERVIEW_LAST_STACK_TASK_ACTIVE_TIME, 49 Key.DEBUG_MODE_ENABLED, 50 Key.HOTSPOT_TILE_LAST_USED, 51 Key.COLOR_INVERSION_TILE_LAST_USED, 52 Key.DND_TILE_VISIBLE, 53 Key.DND_TILE_COMBINED_ICON, 54 Key.DND_CONFIRMED_PRIORITY_INTRODUCTION, 55 Key.DND_CONFIRMED_SILENCE_INTRODUCTION, 56 Key.DND_FAVORITE_BUCKET_INDEX, 57 Key.DND_NONE_SELECTED, 58 Key.DND_FAVORITE_ZEN, 59 Key.QS_HOTSPOT_ADDED, 60 Key.QS_DATA_SAVER_ADDED, 61 Key.QS_DATA_SAVER_DIALOG_SHOWN, 62 Key.QS_INVERT_COLORS_ADDED, 63 Key.QS_WORK_ADDED, 64 Key.QS_NIGHTDISPLAY_ADDED, 65 Key.QS_LONG_PRESS_TOOLTIP_SHOWN_COUNT, 66 Key.SEEN_MULTI_USER, 67 Key.HAS_SEEN_RECENTS_SWIPE_UP_ONBOARDING, 68 Key.HAS_SEEN_RECENTS_QUICK_SCRUB_ONBOARDING, 69 Key.OVERVIEW_OPENED_COUNT, 70 Key.OVERVIEW_OPENED_FROM_HOME_COUNT, 71 Key.SEEN_RINGER_GUIDANCE_COUNT, 72 Key.QS_HAS_TURNED_OFF_MOBILE_DATA, 73 Key.TOUCHED_RINGER_TOGGLE, 74 Key.HAS_SEEN_ODI_CAPTIONS_TOOLTIP, 75 Key.HAS_SEEN_BUBBLES_EDUCATION, 76 Key.HAS_SEEN_BUBBLES_MANAGE_EDUCATION, 77 Key.CONTROLS_STRUCTURE_SWIPE_TOOLTIP_COUNT 78 }) 79 public @interface Key { 80 @Deprecated 81 String OVERVIEW_LAST_STACK_TASK_ACTIVE_TIME = "OverviewLastStackTaskActiveTime"; 82 String DEBUG_MODE_ENABLED = "debugModeEnabled"; 83 String HOTSPOT_TILE_LAST_USED = "HotspotTileLastUsed"; 84 String COLOR_INVERSION_TILE_LAST_USED = "ColorInversionTileLastUsed"; 85 String DND_TILE_VISIBLE = "DndTileVisible"; 86 String DND_TILE_COMBINED_ICON = "DndTileCombinedIcon"; 87 String DND_CONFIRMED_PRIORITY_INTRODUCTION = "DndConfirmedPriorityIntroduction"; 88 String DND_CONFIRMED_SILENCE_INTRODUCTION = "DndConfirmedSilenceIntroduction"; 89 String DND_CONFIRMED_ALARM_INTRODUCTION = "DndConfirmedAlarmIntroduction"; 90 String DND_FAVORITE_BUCKET_INDEX = "DndCountdownMinuteIndex"; 91 String DND_NONE_SELECTED = "DndNoneSelected"; 92 String DND_FAVORITE_ZEN = "DndFavoriteZen"; 93 String QS_DATA_SAVER_DIALOG_SHOWN = "QsDataSaverDialogShown"; 94 @Deprecated 95 String QS_HOTSPOT_ADDED = "QsHotspotAdded"; 96 @Deprecated 97 String QS_DATA_SAVER_ADDED = "QsDataSaverAdded"; 98 @Deprecated 99 String QS_INVERT_COLORS_ADDED = "QsInvertColorsAdded"; 100 @Deprecated 101 String QS_WORK_ADDED = "QsWorkAdded"; 102 @Deprecated 103 String QS_NIGHTDISPLAY_ADDED = "QsNightDisplayAdded"; 104 /** 105 * Used for tracking how many times the user has seen the long press tooltip in the Quick 106 * Settings panel. 107 */ 108 String QS_LONG_PRESS_TOOLTIP_SHOWN_COUNT = "QsLongPressTooltipShownCount"; 109 String SEEN_MULTI_USER = "HasSeenMultiUser"; 110 String OVERVIEW_OPENED_COUNT = "OverviewOpenedCount"; 111 String OVERVIEW_OPENED_FROM_HOME_COUNT = "OverviewOpenedFromHomeCount"; 112 String HAS_SEEN_RECENTS_SWIPE_UP_ONBOARDING = "HasSeenRecentsSwipeUpOnboarding"; 113 String HAS_SEEN_RECENTS_QUICK_SCRUB_ONBOARDING = "HasSeenRecentsQuickScrubOnboarding"; 114 String DISMISSED_RECENTS_SWIPE_UP_ONBOARDING_COUNT = 115 "DismissedRecentsSwipeUpOnboardingCount"; 116 String HAS_DISMISSED_RECENTS_QUICK_SCRUB_ONBOARDING_ONCE = 117 "HasDismissedRecentsQuickScrubOnboardingOnce"; 118 String SEEN_RINGER_GUIDANCE_COUNT = "RingerGuidanceCount"; 119 String QS_TILE_SPECS_REVEALED = "QsTileSpecsRevealed"; 120 String QS_HAS_TURNED_OFF_MOBILE_DATA = "QsHasTurnedOffMobileData"; 121 String TOUCHED_RINGER_TOGGLE = "TouchedRingerToggle"; 122 String HAS_SEEN_ODI_CAPTIONS_TOOLTIP = "HasSeenODICaptionsTooltip"; 123 String HAS_SEEN_BUBBLES_EDUCATION = "HasSeenBubblesOnboarding"; 124 String HAS_SEEN_BUBBLES_MANAGE_EDUCATION = "HasSeenBubblesManageOnboarding"; 125 String CONTROLS_STRUCTURE_SWIPE_TOOLTIP_COUNT = "ControlsStructureSwipeTooltipCount"; 126 /** Tracks whether the user has seen the onboarding screen for priority conversations */ 127 String HAS_SEEN_PRIORITY_ONBOARDING = "HasUserSeenPriorityOnboarding"; 128 } 129 getBoolean(Context context, @Key String key, boolean defaultValue)130 public static boolean getBoolean(Context context, @Key String key, boolean defaultValue) { 131 return get(context).getBoolean(key, defaultValue); 132 } 133 putBoolean(Context context, @Key String key, boolean value)134 public static void putBoolean(Context context, @Key String key, boolean value) { 135 get(context).edit().putBoolean(key, value).apply(); 136 } 137 getInt(Context context, @Key String key, int defaultValue)138 public static int getInt(Context context, @Key String key, int defaultValue) { 139 return get(context).getInt(key, defaultValue); 140 } 141 putInt(Context context, @Key String key, int value)142 public static void putInt(Context context, @Key String key, int value) { 143 get(context).edit().putInt(key, value).apply(); 144 } 145 getLong(Context context, @Key String key, long defaultValue)146 public static long getLong(Context context, @Key String key, long defaultValue) { 147 return get(context).getLong(key, defaultValue); 148 } 149 putLong(Context context, @Key String key, long value)150 public static void putLong(Context context, @Key String key, long value) { 151 get(context).edit().putLong(key, value).apply(); 152 } 153 getString(Context context, @Key String key, String defaultValue)154 public static String getString(Context context, @Key String key, String defaultValue) { 155 return get(context).getString(key, defaultValue); 156 } 157 putString(Context context, @Key String key, String value)158 public static void putString(Context context, @Key String key, String value) { 159 get(context).edit().putString(key, value).apply(); 160 } 161 putStringSet(Context context, @Key String key, Set<String> value)162 public static void putStringSet(Context context, @Key String key, Set<String> value) { 163 get(context).edit().putStringSet(key, value).apply(); 164 } 165 getStringSet( Context context, @Key String key, Set<String> defaultValue)166 public static Set<String> getStringSet( 167 Context context, @Key String key, Set<String> defaultValue) { 168 return get(context).getStringSet(key, defaultValue); 169 } 170 getAll(Context context)171 public static Map<String, ?> getAll(Context context) { 172 return get(context).getAll(); 173 } 174 remove(Context context, @Key String key)175 public static void remove(Context context, @Key String key) { 176 get(context).edit().remove(key).apply(); 177 } 178 registerListener(Context context, OnSharedPreferenceChangeListener listener)179 public static void registerListener(Context context, 180 OnSharedPreferenceChangeListener listener) { 181 get(context).registerOnSharedPreferenceChangeListener(listener); 182 } 183 unregisterListener(Context context, OnSharedPreferenceChangeListener listener)184 public static void unregisterListener(Context context, 185 OnSharedPreferenceChangeListener listener) { 186 get(context).unregisterOnSharedPreferenceChangeListener(listener); 187 } 188 get(Context context)189 public static SharedPreferences get(Context context) { 190 return context.getSharedPreferences(context.getPackageName(), Context.MODE_PRIVATE); 191 } 192 } 193