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