Settings.java revision 82ab9801ebebe8e4783ad327ad02686b44ab87f1
1/*
2 * Copyright (C) 2006 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
17package android.provider;
18
19import android.annotation.SdkConstant;
20import android.annotation.SdkConstant.SdkConstantType;
21import android.annotation.SystemApi;
22import android.annotation.TestApi;
23import android.app.ActivityThread;
24import android.app.AppOpsManager;
25import android.app.Application;
26import android.app.SearchManager;
27import android.app.WallpaperManager;
28import android.content.ComponentName;
29import android.content.ContentResolver;
30import android.content.ContentValues;
31import android.content.Context;
32import android.content.IContentProvider;
33import android.content.Intent;
34import android.content.pm.ActivityInfo;
35import android.content.pm.PackageManager;
36import android.content.pm.ResolveInfo;
37import android.content.res.Configuration;
38import android.content.res.Resources;
39import android.database.Cursor;
40import android.database.SQLException;
41import android.location.LocationManager;
42import android.net.ConnectivityManager;
43import android.net.Uri;
44import android.net.wifi.WifiManager;
45import android.os.BatteryManager;
46import android.os.Binder;
47import android.os.Bundle;
48import android.os.DropBoxManager;
49import android.os.IBinder;
50import android.os.Process;
51import android.os.RemoteException;
52import android.os.ServiceManager;
53import android.os.SystemProperties;
54import android.os.UserHandle;
55import android.os.Build.VERSION_CODES;
56import android.speech.tts.TextToSpeech;
57import android.text.TextUtils;
58import android.util.AndroidException;
59import android.util.ArrayMap;
60import android.util.ArraySet;
61import android.util.LocaleList;
62import android.util.Log;
63
64import com.android.internal.util.ArrayUtils;
65import com.android.internal.widget.ILockSettings;
66
67import java.net.URISyntaxException;
68import java.text.SimpleDateFormat;
69import java.util.HashMap;
70import java.util.HashSet;
71import java.util.Locale;
72import java.util.Map;
73import java.util.Set;
74
75/**
76 * The Settings provider contains global system-level device preferences.
77 */
78public final class Settings {
79
80    // Intent actions for Settings
81
82    /**
83     * Activity Action: Show system settings.
84     * <p>
85     * Input: Nothing.
86     * <p>
87     * Output: Nothing.
88     */
89    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
90    public static final String ACTION_SETTINGS = "android.settings.SETTINGS";
91
92    /**
93     * Activity Action: Show settings to allow configuration of APNs.
94     * <p>
95     * Input: Nothing.
96     * <p>
97     * Output: Nothing.
98     */
99    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
100    public static final String ACTION_APN_SETTINGS = "android.settings.APN_SETTINGS";
101
102    /**
103     * Activity Action: Show settings to allow configuration of current location
104     * sources.
105     * <p>
106     * In some cases, a matching Activity may not exist, so ensure you
107     * safeguard against this.
108     * <p>
109     * Input: Nothing.
110     * <p>
111     * Output: Nothing.
112     */
113    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
114    public static final String ACTION_LOCATION_SOURCE_SETTINGS =
115            "android.settings.LOCATION_SOURCE_SETTINGS";
116
117    /**
118     * Activity Action: Show settings to allow configuration of users.
119     * <p>
120     * In some cases, a matching Activity may not exist, so ensure you
121     * safeguard against this.
122     * <p>
123     * Input: Nothing.
124     * <p>
125     * Output: Nothing.
126     * @hide
127     */
128    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
129    public static final String ACTION_USER_SETTINGS =
130            "android.settings.USER_SETTINGS";
131
132    /**
133     * Activity Action: Show settings to allow configuration of wireless controls
134     * such as Wi-Fi, Bluetooth and Mobile networks.
135     * <p>
136     * In some cases, a matching Activity may not exist, so ensure you
137     * safeguard against this.
138     * <p>
139     * Input: Nothing.
140     * <p>
141     * Output: Nothing.
142     */
143    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
144    public static final String ACTION_WIRELESS_SETTINGS =
145            "android.settings.WIRELESS_SETTINGS";
146
147    /**
148     * Activity Action: Show tether provisioning activity.
149     *
150     * <p>
151     * In some cases, a matching Activity may not exist, so ensure you
152     * safeguard against this.
153     * <p>
154     * Input: {@link ConnectivityManager.EXTRA_TETHER_TYPE} should be included to specify which type
155     * of tethering should be checked. {@link ConnectivityManager.EXTRA_PROVISION_CALLBACK} should
156     * contain a {@link ResultReceiver} which will be called back with a tether result code.
157     * <p>
158     * Output: The result of the provisioning check.
159     * {@link ConnectivityManager.TETHER_ERROR_NO_ERROR} if successful,
160     * {@link ConnectivityManager.TETHER_ERROR_PROVISION_FAILED} for failure.
161     *
162     * @hide
163     */
164    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
165    public static final String ACTION_TETHER_PROVISIONING =
166            "android.settings.TETHER_PROVISIONING_UI";
167
168    /**
169     * Activity Action: Show settings to allow entering/exiting airplane mode.
170     * <p>
171     * In some cases, a matching Activity may not exist, so ensure you
172     * safeguard against this.
173     * <p>
174     * Input: Nothing.
175     * <p>
176     * Output: Nothing.
177     */
178    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
179    public static final String ACTION_AIRPLANE_MODE_SETTINGS =
180            "android.settings.AIRPLANE_MODE_SETTINGS";
181
182    /**
183     * Activity Action: Modify Airplane mode settings using a voice command.
184     * <p>
185     * In some cases, a matching Activity may not exist, so ensure you safeguard against this.
186     * <p>
187     * This intent MUST be started using
188     * {@link android.service.voice.VoiceInteractionSession#startVoiceActivity
189     * startVoiceActivity}.
190     * <p>
191     * Note: The activity implementing this intent MUST verify that
192     * {@link android.app.Activity#isVoiceInteraction isVoiceInteraction} returns true before
193     * modifying the setting.
194     * <p>
195     * Input: To tell which state airplane mode should be set to, add the
196     * {@link #EXTRA_AIRPLANE_MODE_ENABLED} extra to this Intent with the state specified.
197     * If the extra is not included, no changes will be made.
198     * <p>
199     * Output: Nothing.
200     */
201    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
202    public static final String ACTION_VOICE_CONTROL_AIRPLANE_MODE =
203            "android.settings.VOICE_CONTROL_AIRPLANE_MODE";
204
205    /**
206     * Activity Action: Show settings for accessibility modules.
207     * <p>
208     * In some cases, a matching Activity may not exist, so ensure you
209     * safeguard against this.
210     * <p>
211     * Input: Nothing.
212     * <p>
213     * Output: Nothing.
214     */
215    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
216    public static final String ACTION_ACCESSIBILITY_SETTINGS =
217            "android.settings.ACCESSIBILITY_SETTINGS";
218
219    /**
220     * Activity Action: Launch the screen reader tutorial.
221     * <p>
222     * In some cases, a matching Activity may not exist, so ensure you
223     * safeguard against this.
224     * <p>
225     * Input: Nothing.
226     * <p>
227     * Output: Nothing.
228     */
229    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
230    public static final String ACTION_SCREEN_READER_TUTORIAL =
231            "android.settings.SCREEN_READER_TUTORIAL";
232
233
234    /**
235     * Activity Action: Show settings to control access to usage information.
236     * <p>
237     * In some cases, a matching Activity may not exist, so ensure you
238     * safeguard against this.
239     * <p>
240     * Input: Nothing.
241     * <p>
242     * Output: Nothing.
243     */
244    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
245    public static final String ACTION_USAGE_ACCESS_SETTINGS =
246            "android.settings.USAGE_ACCESS_SETTINGS";
247
248    /**
249     * Activity Category: Show application settings related to usage access.
250     * <p>
251     * An activity that provides a user interface for adjusting usage access related
252     * preferences for its containing application. Optional but recommended for apps that
253     * use {@link android.Manifest.permission#PACKAGE_USAGE_STATS}.
254     * <p>
255     * The activity may define meta-data to describe what usage access is
256     * used for within their app with {@link #METADATA_USAGE_ACCESS_REASON}, which
257     * will be displayed in Settings.
258     * <p>
259     * Input: Nothing.
260     * <p>
261     * Output: Nothing.
262     */
263    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
264    public static final String INTENT_CATEGORY_USAGE_ACCESS_CONFIG =
265            "android.intent.category.USAGE_ACCESS_CONFIG";
266
267    /**
268     * Metadata key: Reason for needing usage access.
269     * <p>
270     * A key for metadata attached to an activity that receives action
271     * {@link #INTENT_CATEGORY_USAGE_ACCESS_CONFIG}, shown to the
272     * user as description of how the app uses usage access.
273     * <p>
274     */
275    public static final String METADATA_USAGE_ACCESS_REASON =
276            "android.settings.metadata.USAGE_ACCESS_REASON";
277
278    /**
279     * Activity Action: Show settings to allow configuration of security and
280     * location privacy.
281     * <p>
282     * In some cases, a matching Activity may not exist, so ensure you
283     * safeguard against this.
284     * <p>
285     * Input: Nothing.
286     * <p>
287     * Output: Nothing.
288     */
289    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
290    public static final String ACTION_SECURITY_SETTINGS =
291            "android.settings.SECURITY_SETTINGS";
292
293    /**
294     * Activity Action: Show trusted credentials settings, opening to the user tab,
295     * to allow management of installed credentials.
296     * <p>
297     * In some cases, a matching Activity may not exist, so ensure you
298     * safeguard against this.
299     * <p>
300     * Input: Nothing.
301     * <p>
302     * Output: Nothing.
303     * @hide
304     */
305    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
306    public static final String ACTION_TRUSTED_CREDENTIALS_USER =
307            "com.android.settings.TRUSTED_CREDENTIALS_USER";
308
309    /**
310     * Activity Action: Show dialog explaining that an installed CA cert may enable
311     * monitoring of encrypted network traffic.
312     * <p>
313     * In some cases, a matching Activity may not exist, so ensure you
314     * safeguard against this.
315     * <p>
316     * Input: Nothing.
317     * <p>
318     * Output: Nothing.
319     * @hide
320     */
321    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
322    public static final String ACTION_MONITORING_CERT_INFO =
323            "com.android.settings.MONITORING_CERT_INFO";
324
325    /**
326     * Activity Action: Show settings to allow configuration of privacy options.
327     * <p>
328     * In some cases, a matching Activity may not exist, so ensure you
329     * safeguard against this.
330     * <p>
331     * Input: Nothing.
332     * <p>
333     * Output: Nothing.
334     */
335    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
336    public static final String ACTION_PRIVACY_SETTINGS =
337            "android.settings.PRIVACY_SETTINGS";
338
339    /**
340     * Activity Action: Show settings to allow configuration of Wi-Fi.
341     * <p>
342     * In some cases, a matching Activity may not exist, so ensure you
343     * safeguard against this.
344     * <p>
345     * Input: Nothing.
346     * <p>
347     * Output: Nothing.
348
349     */
350    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
351    public static final String ACTION_WIFI_SETTINGS =
352            "android.settings.WIFI_SETTINGS";
353
354    /**
355     * Activity Action: Show settings to allow configuration of a static IP
356     * address for Wi-Fi.
357     * <p>
358     * In some cases, a matching Activity may not exist, so ensure you safeguard
359     * against this.
360     * <p>
361     * Input: Nothing.
362     * <p>
363     * Output: Nothing.
364     */
365    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
366    public static final String ACTION_WIFI_IP_SETTINGS =
367            "android.settings.WIFI_IP_SETTINGS";
368
369    /**
370     * Activity Action: Show settings to allow configuration of Bluetooth.
371     * <p>
372     * In some cases, a matching Activity may not exist, so ensure you
373     * safeguard against this.
374     * <p>
375     * Input: Nothing.
376     * <p>
377     * Output: Nothing.
378     */
379    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
380    public static final String ACTION_BLUETOOTH_SETTINGS =
381            "android.settings.BLUETOOTH_SETTINGS";
382
383    /**
384     * Activity Action: Show settings to allow configuration of cast endpoints.
385     * <p>
386     * In some cases, a matching Activity may not exist, so ensure you
387     * safeguard against this.
388     * <p>
389     * Input: Nothing.
390     * <p>
391     * Output: Nothing.
392     */
393    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
394    public static final String ACTION_CAST_SETTINGS =
395            "android.settings.CAST_SETTINGS";
396
397    /**
398     * Activity Action: Show settings to allow configuration of date and time.
399     * <p>
400     * In some cases, a matching Activity may not exist, so ensure you
401     * safeguard against this.
402     * <p>
403     * Input: Nothing.
404     * <p>
405     * Output: Nothing.
406     */
407    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
408    public static final String ACTION_DATE_SETTINGS =
409            "android.settings.DATE_SETTINGS";
410
411    /**
412     * Activity Action: Show settings to allow configuration of sound and volume.
413     * <p>
414     * In some cases, a matching Activity may not exist, so ensure you
415     * safeguard against this.
416     * <p>
417     * Input: Nothing.
418     * <p>
419     * Output: Nothing.
420     */
421    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
422    public static final String ACTION_SOUND_SETTINGS =
423            "android.settings.SOUND_SETTINGS";
424
425    /**
426     * Activity Action: Show settings to allow configuration of display.
427     * <p>
428     * In some cases, a matching Activity may not exist, so ensure you
429     * safeguard against this.
430     * <p>
431     * Input: Nothing.
432     * <p>
433     * Output: Nothing.
434     */
435    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
436    public static final String ACTION_DISPLAY_SETTINGS =
437            "android.settings.DISPLAY_SETTINGS";
438
439    /**
440     * Activity Action: Show settings to allow configuration of locale.
441     * <p>
442     * In some cases, a matching Activity may not exist, so ensure you
443     * safeguard against this.
444     * <p>
445     * Input: Nothing.
446     * <p>
447     * Output: Nothing.
448     */
449    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
450    public static final String ACTION_LOCALE_SETTINGS =
451            "android.settings.LOCALE_SETTINGS";
452
453    /**
454     * Activity Action: Show settings to configure input methods, in particular
455     * allowing the user to enable input methods.
456     * <p>
457     * In some cases, a matching Activity may not exist, so ensure you
458     * safeguard against this.
459     * <p>
460     * Input: Nothing.
461     * <p>
462     * Output: Nothing.
463     */
464    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
465    public static final String ACTION_VOICE_INPUT_SETTINGS =
466            "android.settings.VOICE_INPUT_SETTINGS";
467
468    /**
469     * Activity Action: Show settings to configure input methods, in particular
470     * allowing the user to enable input methods.
471     * <p>
472     * In some cases, a matching Activity may not exist, so ensure you
473     * safeguard against this.
474     * <p>
475     * Input: Nothing.
476     * <p>
477     * Output: Nothing.
478     */
479    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
480    public static final String ACTION_INPUT_METHOD_SETTINGS =
481            "android.settings.INPUT_METHOD_SETTINGS";
482
483    /**
484     * Activity Action: Show settings to enable/disable input method subtypes.
485     * <p>
486     * In some cases, a matching Activity may not exist, so ensure you
487     * safeguard against this.
488     * <p>
489     * To tell which input method's subtypes are displayed in the settings, add
490     * {@link #EXTRA_INPUT_METHOD_ID} extra to this Intent with the input method id.
491     * If there is no extra in this Intent, subtypes from all installed input methods
492     * will be displayed in the settings.
493     *
494     * @see android.view.inputmethod.InputMethodInfo#getId
495     * <p>
496     * Input: Nothing.
497     * <p>
498     * Output: Nothing.
499     */
500    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
501    public static final String ACTION_INPUT_METHOD_SUBTYPE_SETTINGS =
502            "android.settings.INPUT_METHOD_SUBTYPE_SETTINGS";
503
504    /**
505     * Activity Action: Show a dialog to select input method.
506     * <p>
507     * In some cases, a matching Activity may not exist, so ensure you
508     * safeguard against this.
509     * <p>
510     * Input: Nothing.
511     * <p>
512     * Output: Nothing.
513     * @hide
514     */
515    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
516    public static final String ACTION_SHOW_INPUT_METHOD_PICKER =
517            "android.settings.SHOW_INPUT_METHOD_PICKER";
518
519    /**
520     * Activity Action: Show settings to manage the user input dictionary.
521     * <p>
522     * Starting with {@link android.os.Build.VERSION_CODES#KITKAT},
523     * it is guaranteed there will always be an appropriate implementation for this Intent action.
524     * In prior releases of the platform this was optional, so ensure you safeguard against it.
525     * <p>
526     * Input: Nothing.
527     * <p>
528     * Output: Nothing.
529     */
530    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
531    public static final String ACTION_USER_DICTIONARY_SETTINGS =
532            "android.settings.USER_DICTIONARY_SETTINGS";
533
534    /**
535     * Activity Action: Show settings to configure the hardware keyboard layout.
536     * <p>
537     * In some cases, a matching Activity may not exist, so ensure you
538     * safeguard against this.
539     * <p>
540     *
541     * @see android.hardware.input.InputManager#ACTION_QUERY_KEYBOARD_LAYOUTS
542     * <p>
543     * Input: Nothing.
544     * <p>
545     * Output: Nothing.
546     */
547    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
548    public static final String ACTION_KEYBOARD_LAYOUT_SETTINGS =
549            "android.settings.KEYBOARD_LAYOUT_SETTINGS";
550
551    /**
552     * Activity Action: Adds a word to the user dictionary.
553     * <p>
554     * In some cases, a matching Activity may not exist, so ensure you
555     * safeguard against this.
556     * <p>
557     * Input: An extra with key <code>word</code> that contains the word
558     * that should be added to the dictionary.
559     * <p>
560     * Output: Nothing.
561     *
562     * @hide
563     */
564    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
565    public static final String ACTION_USER_DICTIONARY_INSERT =
566            "com.android.settings.USER_DICTIONARY_INSERT";
567
568    /**
569     * Activity Action: Show settings to allow configuration of application-related settings.
570     * <p>
571     * In some cases, a matching Activity may not exist, so ensure you
572     * safeguard against this.
573     * <p>
574     * Input: Nothing.
575     * <p>
576     * Output: Nothing.
577     */
578    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
579    public static final String ACTION_APPLICATION_SETTINGS =
580            "android.settings.APPLICATION_SETTINGS";
581
582    /**
583     * Activity Action: Show settings to allow configuration of application
584     * development-related settings.  As of
585     * {@link android.os.Build.VERSION_CODES#JELLY_BEAN_MR1} this action is
586     * a required part of the platform.
587     * <p>
588     * Input: Nothing.
589     * <p>
590     * Output: Nothing.
591     */
592    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
593    public static final String ACTION_APPLICATION_DEVELOPMENT_SETTINGS =
594            "android.settings.APPLICATION_DEVELOPMENT_SETTINGS";
595
596    /**
597     * Activity Action: Show settings to allow configuration of quick launch shortcuts.
598     * <p>
599     * In some cases, a matching Activity may not exist, so ensure you
600     * safeguard against this.
601     * <p>
602     * Input: Nothing.
603     * <p>
604     * Output: Nothing.
605     */
606    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
607    public static final String ACTION_QUICK_LAUNCH_SETTINGS =
608            "android.settings.QUICK_LAUNCH_SETTINGS";
609
610    /**
611     * Activity Action: Show settings to manage installed applications.
612     * <p>
613     * In some cases, a matching Activity may not exist, so ensure you
614     * safeguard against this.
615     * <p>
616     * Input: Nothing.
617     * <p>
618     * Output: Nothing.
619     */
620    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
621    public static final String ACTION_MANAGE_APPLICATIONS_SETTINGS =
622            "android.settings.MANAGE_APPLICATIONS_SETTINGS";
623
624    /**
625     * Activity Action: Show settings to manage all applications.
626     * <p>
627     * In some cases, a matching Activity may not exist, so ensure you
628     * safeguard against this.
629     * <p>
630     * Input: Nothing.
631     * <p>
632     * Output: Nothing.
633     */
634    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
635    public static final String ACTION_MANAGE_ALL_APPLICATIONS_SETTINGS =
636            "android.settings.MANAGE_ALL_APPLICATIONS_SETTINGS";
637
638    /**
639     * Activity Action: Show screen for controlling which apps can draw on top of other apps.
640     * <p>
641     * In some cases, a matching Activity may not exist, so ensure you
642     * safeguard against this.
643     * <p>
644     * Input: Optionally, the Intent's data URI can specify the application package name to
645     * directly invoke the management GUI specific to the package name. For example
646     * "package:com.my.app".
647     * <p>
648     * Output: Nothing.
649     */
650    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
651    public static final String ACTION_MANAGE_OVERLAY_PERMISSION =
652            "android.settings.action.MANAGE_OVERLAY_PERMISSION";
653
654    /**
655     * Activity Action: Show screen for controlling which apps are allowed to write/modify
656     * system settings.
657     * <p>
658     * In some cases, a matching Activity may not exist, so ensure you
659     * safeguard against this.
660     * <p>
661     * Input: Optionally, the Intent's data URI can specify the application package name to
662     * directly invoke the management GUI specific to the package name. For example
663     * "package:com.my.app".
664     * <p>
665     * Output: Nothing.
666     */
667    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
668    public static final String ACTION_MANAGE_WRITE_SETTINGS =
669            "android.settings.action.MANAGE_WRITE_SETTINGS";
670
671    /**
672     * Activity Action: Show screen of details about a particular application.
673     * <p>
674     * In some cases, a matching Activity may not exist, so ensure you
675     * safeguard against this.
676     * <p>
677     * Input: The Intent's data URI specifies the application package name
678     * to be shown, with the "package" scheme.  That is "package:com.my.app".
679     * <p>
680     * Output: Nothing.
681     */
682    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
683    public static final String ACTION_APPLICATION_DETAILS_SETTINGS =
684            "android.settings.APPLICATION_DETAILS_SETTINGS";
685
686    /**
687     * Activity Action: Show screen for controlling which apps can ignore battery optimizations.
688     * <p>
689     * Input: Nothing.
690     * <p>
691     * Output: Nothing.
692     * <p>
693     * You can use {@link android.os.PowerManager#isIgnoringBatteryOptimizations
694     * PowerManager.isIgnoringBatteryOptimizations()} to determine if an application is
695     * already ignoring optimizations.  You can use
696     * {@link #ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS} to ask the user to put you
697     * on this list.
698     */
699    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
700    public static final String ACTION_IGNORE_BATTERY_OPTIMIZATION_SETTINGS =
701            "android.settings.IGNORE_BATTERY_OPTIMIZATION_SETTINGS";
702
703    /**
704     * Activity Action: Ask the user to allow an app to ignore battery optimizations (that is,
705     * put them on the whitelist of apps shown by
706     * {@link #ACTION_IGNORE_BATTERY_OPTIMIZATION_SETTINGS}).  For an app to use this, it also
707     * must hold the {@link android.Manifest.permission#REQUEST_IGNORE_BATTERY_OPTIMIZATIONS}
708     * permission.
709     * <p><b>Note:</b> most applications should <em>not</em> use this; there are many facilities
710     * provided by the platform for applications to operate correctly in the various power
711     * saving modes.  This is only for unusual applications that need to deeply control their own
712     * execution, at the potential expense of the user's battery life.  Note that these applications
713     * greatly run the risk of showing to the user as high power consumers on their device.</p>
714     * <p>
715     * Input: The Intent's data URI must specify the application package name
716     * to be shown, with the "package" scheme.  That is "package:com.my.app".
717     * <p>
718     * Output: Nothing.
719     * <p>
720     * You can use {@link android.os.PowerManager#isIgnoringBatteryOptimizations
721     * PowerManager.isIgnoringBatteryOptimizations()} to determine if an application is
722     * already ignoring optimizations.
723     */
724    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
725    public static final String ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS =
726            "android.settings.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS";
727
728    /**
729     * Activity Action: Show screen for controlling which apps can ignore background data
730     * restrictions.
731     * <p>
732     * Input: if the Intent's data URI is set with an application name (using the "package" schema,
733     * like "package:com.my.app"), then when the screen is displayed it will focus on such app. If
734     * the data is not set, it will just open the screen.
735     * <p>
736     * Output: Nothing.
737     * <p>
738     * Applications can also use {@link android.net.ConnectivityManager#getRestrictBackgroundStatus
739     * ConnectivityManager#getRestrictBackgroundStatus()} to determine the status of the background
740     * data restrictions for them.
741     */
742    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
743    public static final String ACTION_IGNORE_BACKGROUND_DATA_RESTRICTIONS_SETTINGS =
744            "android.settings.IGNORE_BACKGROUND_DATA_RESTRICTIONS_SETTINGS";
745
746    /**
747     * @hide
748     * Activity Action: Show the "app ops" settings screen.
749     * <p>
750     * Input: Nothing.
751     * <p>
752     * Output: Nothing.
753     */
754    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
755    public static final String ACTION_APP_OPS_SETTINGS =
756            "android.settings.APP_OPS_SETTINGS";
757
758    /**
759     * Activity Action: Show settings for system update functionality.
760     * <p>
761     * In some cases, a matching Activity may not exist, so ensure you
762     * safeguard against this.
763     * <p>
764     * Input: Nothing.
765     * <p>
766     * Output: Nothing.
767     *
768     * @hide
769     */
770    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
771    public static final String ACTION_SYSTEM_UPDATE_SETTINGS =
772            "android.settings.SYSTEM_UPDATE_SETTINGS";
773
774    /**
775     * Activity Action: Show settings to allow configuration of sync settings.
776     * <p>
777     * In some cases, a matching Activity may not exist, so ensure you
778     * safeguard against this.
779     * <p>
780     * The account types available to add via the add account button may be restricted by adding an
781     * {@link #EXTRA_AUTHORITIES} extra to this Intent with one or more syncable content provider's
782     * authorities. Only account types which can sync with that content provider will be offered to
783     * the user.
784     * <p>
785     * Input: Nothing.
786     * <p>
787     * Output: Nothing.
788     */
789    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
790    public static final String ACTION_SYNC_SETTINGS =
791            "android.settings.SYNC_SETTINGS";
792
793    /**
794     * Activity Action: Show add account screen for creating a new account.
795     * <p>
796     * In some cases, a matching Activity may not exist, so ensure you
797     * safeguard against this.
798     * <p>
799     * The account types available to add may be restricted by adding an {@link #EXTRA_AUTHORITIES}
800     * extra to the Intent with one or more syncable content provider's authorities.  Only account
801     * types which can sync with that content provider will be offered to the user.
802     * <p>
803     * Account types can also be filtered by adding an {@link #EXTRA_ACCOUNT_TYPES} extra to the
804     * Intent with one or more account types.
805     * <p>
806     * Input: Nothing.
807     * <p>
808     * Output: Nothing.
809     */
810    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
811    public static final String ACTION_ADD_ACCOUNT =
812            "android.settings.ADD_ACCOUNT_SETTINGS";
813
814    /**
815     * Activity Action: Show settings for selecting the network operator.
816     * <p>
817     * In some cases, a matching Activity may not exist, so ensure you
818     * safeguard against this.
819     * <p>
820     * Input: Nothing.
821     * <p>
822     * Output: Nothing.
823     */
824    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
825    public static final String ACTION_NETWORK_OPERATOR_SETTINGS =
826            "android.settings.NETWORK_OPERATOR_SETTINGS";
827
828    /**
829     * Activity Action: Show settings for selection of 2G/3G.
830     * <p>
831     * In some cases, a matching Activity may not exist, so ensure you
832     * safeguard against this.
833     * <p>
834     * Input: Nothing.
835     * <p>
836     * Output: Nothing.
837     */
838    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
839    public static final String ACTION_DATA_ROAMING_SETTINGS =
840            "android.settings.DATA_ROAMING_SETTINGS";
841
842    /**
843     * Activity Action: Show settings for internal storage.
844     * <p>
845     * In some cases, a matching Activity may not exist, so ensure you
846     * safeguard against this.
847     * <p>
848     * Input: Nothing.
849     * <p>
850     * Output: Nothing.
851     */
852    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
853    public static final String ACTION_INTERNAL_STORAGE_SETTINGS =
854            "android.settings.INTERNAL_STORAGE_SETTINGS";
855    /**
856     * Activity Action: Show settings for memory card storage.
857     * <p>
858     * In some cases, a matching Activity may not exist, so ensure you
859     * safeguard against this.
860     * <p>
861     * Input: Nothing.
862     * <p>
863     * Output: Nothing.
864     */
865    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
866    public static final String ACTION_MEMORY_CARD_SETTINGS =
867            "android.settings.MEMORY_CARD_SETTINGS";
868
869    /**
870     * Activity Action: Show settings for global search.
871     * <p>
872     * In some cases, a matching Activity may not exist, so ensure you
873     * safeguard against this.
874     * <p>
875     * Input: Nothing.
876     * <p>
877     * Output: Nothing
878     */
879    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
880    public static final String ACTION_SEARCH_SETTINGS =
881        "android.search.action.SEARCH_SETTINGS";
882
883    /**
884     * Activity Action: Show general device information settings (serial
885     * number, software version, phone number, etc.).
886     * <p>
887     * In some cases, a matching Activity may not exist, so ensure you
888     * safeguard against this.
889     * <p>
890     * Input: Nothing.
891     * <p>
892     * Output: Nothing
893     */
894    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
895    public static final String ACTION_DEVICE_INFO_SETTINGS =
896        "android.settings.DEVICE_INFO_SETTINGS";
897
898    /**
899     * Activity Action: Show NFC settings.
900     * <p>
901     * This shows UI that allows NFC to be turned on or off.
902     * <p>
903     * In some cases, a matching Activity may not exist, so ensure you
904     * safeguard against this.
905     * <p>
906     * Input: Nothing.
907     * <p>
908     * Output: Nothing
909     * @see android.nfc.NfcAdapter#isEnabled()
910     */
911    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
912    public static final String ACTION_NFC_SETTINGS = "android.settings.NFC_SETTINGS";
913
914    /**
915     * Activity Action: Show NFC Sharing settings.
916     * <p>
917     * This shows UI that allows NDEF Push (Android Beam) to be turned on or
918     * off.
919     * <p>
920     * In some cases, a matching Activity may not exist, so ensure you
921     * safeguard against this.
922     * <p>
923     * Input: Nothing.
924     * <p>
925     * Output: Nothing
926     * @see android.nfc.NfcAdapter#isNdefPushEnabled()
927     */
928    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
929    public static final String ACTION_NFCSHARING_SETTINGS =
930        "android.settings.NFCSHARING_SETTINGS";
931
932    /**
933     * Activity Action: Show NFC Tap & Pay settings
934     * <p>
935     * This shows UI that allows the user to configure Tap&Pay
936     * settings.
937     * <p>
938     * In some cases, a matching Activity may not exist, so ensure you
939     * safeguard against this.
940     * <p>
941     * Input: Nothing.
942     * <p>
943     * Output: Nothing
944     */
945    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
946    public static final String ACTION_NFC_PAYMENT_SETTINGS =
947        "android.settings.NFC_PAYMENT_SETTINGS";
948
949    /**
950     * Activity Action: Show Daydream settings.
951     * <p>
952     * In some cases, a matching Activity may not exist, so ensure you
953     * safeguard against this.
954     * <p>
955     * Input: Nothing.
956     * <p>
957     * Output: Nothing.
958     * @see android.service.dreams.DreamService
959     */
960    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
961    public static final String ACTION_DREAM_SETTINGS = "android.settings.DREAM_SETTINGS";
962
963    /**
964     * Activity Action: Show Notification listener settings.
965     * <p>
966     * In some cases, a matching Activity may not exist, so ensure you
967     * safeguard against this.
968     * <p>
969     * Input: Nothing.
970     * <p>
971     * Output: Nothing.
972     * @see android.service.notification.NotificationListenerService
973     */
974    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
975    public static final String ACTION_NOTIFICATION_LISTENER_SETTINGS
976            = "android.settings.ACTION_NOTIFICATION_LISTENER_SETTINGS";
977
978    /**
979     * Activity Action: Show Do Not Disturb access settings.
980     * <p>
981     * Users can grant and deny access to Do Not Disturb configuration from here.
982     * See {@link android.app.NotificationManager#isNotificationPolicyAccessGranted()} for more
983     * details.
984     * <p>
985     * Input: Nothing.
986     * <p>
987     * Output: Nothing.
988     */
989    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
990    public static final String ACTION_NOTIFICATION_POLICY_ACCESS_SETTINGS
991            = "android.settings.NOTIFICATION_POLICY_ACCESS_SETTINGS";
992
993    /**
994     * @hide
995     */
996    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
997    public static final String ACTION_CONDITION_PROVIDER_SETTINGS
998            = "android.settings.ACTION_CONDITION_PROVIDER_SETTINGS";
999
1000    /**
1001     * Activity Action: Show settings for video captioning.
1002     * <p>
1003     * In some cases, a matching Activity may not exist, so ensure you safeguard
1004     * against this.
1005     * <p>
1006     * Input: Nothing.
1007     * <p>
1008     * Output: Nothing.
1009     */
1010    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1011    public static final String ACTION_CAPTIONING_SETTINGS = "android.settings.CAPTIONING_SETTINGS";
1012
1013    /**
1014     * Activity Action: Show the top level print settings.
1015     * <p>
1016     * In some cases, a matching Activity may not exist, so ensure you
1017     * safeguard against this.
1018     * <p>
1019     * Input: Nothing.
1020     * <p>
1021     * Output: Nothing.
1022     */
1023    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1024    public static final String ACTION_PRINT_SETTINGS =
1025            "android.settings.ACTION_PRINT_SETTINGS";
1026
1027    /**
1028     * Activity Action: Show Zen Mode configuration settings.
1029     *
1030     * @hide
1031     */
1032    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1033    public static final String ACTION_ZEN_MODE_SETTINGS = "android.settings.ZEN_MODE_SETTINGS";
1034
1035    /**
1036     * Activity Action: Show Zen Mode priority configuration settings.
1037     *
1038     * @hide
1039     */
1040    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1041    public static final String ACTION_ZEN_MODE_PRIORITY_SETTINGS
1042            = "android.settings.ZEN_MODE_PRIORITY_SETTINGS";
1043
1044    /**
1045     * Activity Action: Show Zen Mode automation configuration settings.
1046     *
1047     * @hide
1048     */
1049    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1050    public static final String ACTION_ZEN_MODE_AUTOMATION_SETTINGS
1051            = "android.settings.ZEN_MODE_AUTOMATION_SETTINGS";
1052
1053    /**
1054     * Activity Action: Modify do not disturb mode settings.
1055     * <p>
1056     * In some cases, a matching Activity may not exist, so ensure you safeguard against this.
1057     * <p>
1058     * This intent MUST be started using
1059     * {@link android.service.voice.VoiceInteractionSession#startVoiceActivity
1060     * startVoiceActivity}.
1061     * <p>
1062     * Note: The Activity implementing this intent MUST verify that
1063     * {@link android.app.Activity#isVoiceInteraction isVoiceInteraction}.
1064     * returns true before modifying the setting.
1065     * <p>
1066     * Input: The optional {@link #EXTRA_DO_NOT_DISTURB_MODE_MINUTES} extra can be used to indicate
1067     * how long the user wishes to avoid interruptions for. The optional
1068     * {@link #EXTRA_DO_NOT_DISTURB_MODE_ENABLED} extra can be to indicate if the user is
1069     * enabling or disabling do not disturb mode. If either extra is not included, the
1070     * user maybe asked to provide the value.
1071     * <p>
1072     * Output: Nothing.
1073     */
1074    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1075    public static final String ACTION_VOICE_CONTROL_DO_NOT_DISTURB_MODE =
1076            "android.settings.VOICE_CONTROL_DO_NOT_DISTURB_MODE";
1077
1078    /**
1079     * Activity Action: Show Zen Mode schedule rule configuration settings.
1080     *
1081     * @hide
1082     */
1083    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1084    public static final String ACTION_ZEN_MODE_SCHEDULE_RULE_SETTINGS
1085            = "android.settings.ZEN_MODE_SCHEDULE_RULE_SETTINGS";
1086
1087    /**
1088     * Activity Action: Show Zen Mode event rule configuration settings.
1089     *
1090     * @hide
1091     */
1092    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1093    public static final String ACTION_ZEN_MODE_EVENT_RULE_SETTINGS
1094            = "android.settings.ZEN_MODE_EVENT_RULE_SETTINGS";
1095
1096    /**
1097     * Activity Action: Show Zen Mode external rule configuration settings.
1098     *
1099     * @hide
1100     */
1101    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1102    public static final String ACTION_ZEN_MODE_EXTERNAL_RULE_SETTINGS
1103            = "android.settings.ZEN_MODE_EXTERNAL_RULE_SETTINGS";
1104
1105    /**
1106     * Activity Action: Show the regulatory information screen for the device.
1107     * <p>
1108     * In some cases, a matching Activity may not exist, so ensure you safeguard
1109     * against this.
1110     * <p>
1111     * Input: Nothing.
1112     * <p>
1113     * Output: Nothing.
1114     */
1115    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1116    public static final String
1117            ACTION_SHOW_REGULATORY_INFO = "android.settings.SHOW_REGULATORY_INFO";
1118
1119    /**
1120     * Activity Action: Show Device Name Settings.
1121     * <p>
1122     * In some cases, a matching Activity may not exist, so ensure you safeguard
1123     * against this.
1124     *
1125     * @hide
1126     */
1127    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1128    public static final String DEVICE_NAME_SETTINGS = "android.settings.DEVICE_NAME";
1129
1130    /**
1131     * Activity Action: Show pairing settings.
1132     * <p>
1133     * In some cases, a matching Activity may not exist, so ensure you safeguard
1134     * against this.
1135     *
1136     * @hide
1137     */
1138    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1139    public static final String ACTION_PAIRING_SETTINGS = "android.settings.PAIRING_SETTINGS";
1140
1141    /**
1142     * Activity Action: Show battery saver settings.
1143     * <p>
1144     * In some cases, a matching Activity may not exist, so ensure you safeguard
1145     * against this.
1146     */
1147    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1148    public static final String ACTION_BATTERY_SAVER_SETTINGS
1149            = "android.settings.BATTERY_SAVER_SETTINGS";
1150
1151    /**
1152     * Activity Action: Modify Battery Saver mode setting using a voice command.
1153     * <p>
1154     * In some cases, a matching Activity may not exist, so ensure you safeguard against this.
1155     * <p>
1156     * This intent MUST be started using
1157     * {@link android.service.voice.VoiceInteractionSession#startVoiceActivity
1158     * startVoiceActivity}.
1159     * <p>
1160     * Note: The activity implementing this intent MUST verify that
1161     * {@link android.app.Activity#isVoiceInteraction isVoiceInteraction} returns true before
1162     * modifying the setting.
1163     * <p>
1164     * Input: To tell which state batter saver mode should be set to, add the
1165     * {@link #EXTRA_BATTERY_SAVER_MODE_ENABLED} extra to this Intent with the state specified.
1166     * If the extra is not included, no changes will be made.
1167     * <p>
1168     * Output: Nothing.
1169     */
1170    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1171    public static final String ACTION_VOICE_CONTROL_BATTERY_SAVER_MODE =
1172            "android.settings.VOICE_CONTROL_BATTERY_SAVER_MODE";
1173
1174    /**
1175     * Activity Action: Show Home selection settings. If there are multiple activities
1176     * that can satisfy the {@link Intent#CATEGORY_HOME} intent, this screen allows you
1177     * to pick your preferred activity.
1178     */
1179    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1180    public static final String ACTION_HOME_SETTINGS
1181            = "android.settings.HOME_SETTINGS";
1182
1183
1184
1185    /**
1186     * Activity Action: Show Default apps settings.
1187     * <p>
1188     * In some cases, a matching Activity may not exist, so ensure you
1189     * safeguard against this.
1190     * <p>
1191     * Input: Nothing.
1192     * <p>
1193     * Output: Nothing.
1194     */
1195    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1196    public static final String ACTION_MANAGE_DEFAULT_APPS_SETTINGS
1197            = "android.settings.MANAGE_DEFAULT_APPS_SETTINGS";
1198
1199    /**
1200     * Activity Action: Show notification settings.
1201     *
1202     * @hide
1203     */
1204    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1205    public static final String ACTION_NOTIFICATION_SETTINGS
1206            = "android.settings.NOTIFICATION_SETTINGS";
1207
1208    /**
1209     * Activity Action: Show notification settings for a single app.
1210     *
1211     * @hide
1212     */
1213    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1214    public static final String ACTION_APP_NOTIFICATION_SETTINGS
1215            = "android.settings.APP_NOTIFICATION_SETTINGS";
1216
1217    /**
1218     * Activity Action: Show notification redaction settings.
1219     *
1220     * @hide
1221     */
1222    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1223    public static final String ACTION_APP_NOTIFICATION_REDACTION
1224            = "android.settings.ACTION_APP_NOTIFICATION_REDACTION";
1225
1226    /** @hide */ public static final String EXTRA_APP_UID = "app_uid";
1227    /** @hide */ public static final String EXTRA_APP_PACKAGE = "app_package";
1228
1229    /**
1230     * Activity Action: Show a dialog with disabled by policy message.
1231     * <p> If an user action is disabled by policy, this dialog can be triggered to let
1232     * the user know about this.
1233     * <p>
1234     * Input: Nothing.
1235     * <p>
1236     * Output: Nothing.
1237     *
1238     * @hide
1239     */
1240    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1241    public static final String ACTION_SHOW_ADMIN_SUPPORT_DETAILS
1242            = "android.settings.SHOW_ADMIN_SUPPORT_DETAILS";
1243
1244    /**
1245     * Activity Action: Show a dialog for remote bugreport flow.
1246     * <p>
1247     * Input: Nothing.
1248     * <p>
1249     * Output: Nothing.
1250     *
1251     * @hide
1252     */
1253    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1254    public static final String ACTION_SHOW_REMOTE_BUGREPORT_DIALOG
1255            = "android.settings.SHOW_REMOTE_BUGREPORT_DIALOG";
1256
1257    // End of Intent actions for Settings
1258
1259    /**
1260     * @hide - Private call() method on SettingsProvider to read from 'system' table.
1261     */
1262    public static final String CALL_METHOD_GET_SYSTEM = "GET_system";
1263
1264    /**
1265     * @hide - Private call() method on SettingsProvider to read from 'secure' table.
1266     */
1267    public static final String CALL_METHOD_GET_SECURE = "GET_secure";
1268
1269    /**
1270     * @hide - Private call() method on SettingsProvider to read from 'global' table.
1271     */
1272    public static final String CALL_METHOD_GET_GLOBAL = "GET_global";
1273
1274    /**
1275     * @hide - User handle argument extra to the fast-path call()-based requests
1276     */
1277    public static final String CALL_METHOD_USER_KEY = "_user";
1278
1279    /** @hide - Private call() method to write to 'system' table */
1280    public static final String CALL_METHOD_PUT_SYSTEM = "PUT_system";
1281
1282    /** @hide - Private call() method to write to 'secure' table */
1283    public static final String CALL_METHOD_PUT_SECURE = "PUT_secure";
1284
1285    /** @hide - Private call() method to write to 'global' table */
1286    public static final String CALL_METHOD_PUT_GLOBAL= "PUT_global";
1287
1288    /**
1289     * Activity Extra: Limit available options in launched activity based on the given authority.
1290     * <p>
1291     * This can be passed as an extra field in an Activity Intent with one or more syncable content
1292     * provider's authorities as a String[]. This field is used by some intents to alter the
1293     * behavior of the called activity.
1294     * <p>
1295     * Example: The {@link #ACTION_ADD_ACCOUNT} intent restricts the account types available based
1296     * on the authority given.
1297     */
1298    public static final String EXTRA_AUTHORITIES = "authorities";
1299
1300    /**
1301     * Activity Extra: Limit available options in launched activity based on the given account
1302     * types.
1303     * <p>
1304     * This can be passed as an extra field in an Activity Intent with one or more account types
1305     * as a String[]. This field is used by some intents to alter the behavior of the called
1306     * activity.
1307     * <p>
1308     * Example: The {@link #ACTION_ADD_ACCOUNT} intent restricts the account types to the specified
1309     * list.
1310     */
1311    public static final String EXTRA_ACCOUNT_TYPES = "account_types";
1312
1313    public static final String EXTRA_INPUT_METHOD_ID = "input_method_id";
1314
1315    /**
1316     * Activity Extra: The device identifier to act upon.
1317     * <p>
1318     * This can be passed as an extra field in an Activity Intent with a single
1319     * InputDeviceIdentifier. This field is used by some activities to jump straight into the
1320     * settings for the given device.
1321     * <p>
1322     * Example: The {@link #ACTION_INPUT_METHOD_SETTINGS} intent opens the keyboard layout
1323     * dialog for the given device.
1324     * @hide
1325     */
1326    public static final String EXTRA_INPUT_DEVICE_IDENTIFIER = "input_device_identifier";
1327
1328    /**
1329     * Activity Extra: Enable or disable Airplane Mode.
1330     * <p>
1331     * This can be passed as an extra field to the {@link #ACTION_VOICE_CONTROL_AIRPLANE_MODE}
1332     * intent as a boolean to indicate if it should be enabled.
1333     */
1334    public static final String EXTRA_AIRPLANE_MODE_ENABLED = "airplane_mode_enabled";
1335
1336    /**
1337     * Activity Extra: Enable or disable Battery saver mode.
1338     * <p>
1339     * This can be passed as an extra field to the {@link #ACTION_VOICE_CONTROL_BATTERY_SAVER_MODE}
1340     * intent as a boolean to indicate if it should be enabled.
1341     */
1342    public static final String EXTRA_BATTERY_SAVER_MODE_ENABLED =
1343            "android.settings.extra.battery_saver_mode_enabled";
1344
1345    /**
1346     * Activity Extra: Enable or disable Do Not Disturb mode.
1347     * <p>
1348     * This can be passed as an extra field to the {@link #ACTION_VOICE_CONTROL_DO_NOT_DISTURB_MODE}
1349     * intent as a boolean to indicate if it should be enabled.
1350     */
1351    public static final String EXTRA_DO_NOT_DISTURB_MODE_ENABLED =
1352            "android.settings.extra.do_not_disturb_mode_enabled";
1353
1354    /**
1355     * Activity Extra: How many minutes to enable do not disturb mode for.
1356     * <p>
1357     * This can be passed as an extra field to the {@link #ACTION_VOICE_CONTROL_DO_NOT_DISTURB_MODE}
1358     * intent to indicate how long do not disturb mode should be enabled for.
1359     */
1360    public static final String EXTRA_DO_NOT_DISTURB_MODE_MINUTES =
1361            "android.settings.extra.do_not_disturb_mode_minutes";
1362
1363    private static final String JID_RESOURCE_PREFIX = "android";
1364
1365    public static final String AUTHORITY = "settings";
1366
1367    private static final String TAG = "Settings";
1368    private static final boolean LOCAL_LOGV = false;
1369
1370    // Lock ensures that when enabling/disabling the master location switch, we don't end up
1371    // with a partial enable/disable state in multi-threaded situations.
1372    private static final Object mLocationSettingsLock = new Object();
1373
1374    public static class SettingNotFoundException extends AndroidException {
1375        public SettingNotFoundException(String msg) {
1376            super(msg);
1377        }
1378    }
1379
1380    /**
1381     * Common base for tables of name/value settings.
1382     */
1383    public static class NameValueTable implements BaseColumns {
1384        public static final String NAME = "name";
1385        public static final String VALUE = "value";
1386
1387        protected static boolean putString(ContentResolver resolver, Uri uri,
1388                String name, String value) {
1389            // The database will take care of replacing duplicates.
1390            try {
1391                ContentValues values = new ContentValues();
1392                values.put(NAME, name);
1393                values.put(VALUE, value);
1394                resolver.insert(uri, values);
1395                return true;
1396            } catch (SQLException e) {
1397                Log.w(TAG, "Can't set key " + name + " in " + uri, e);
1398                return false;
1399            }
1400        }
1401
1402        public static Uri getUriFor(Uri uri, String name) {
1403            return Uri.withAppendedPath(uri, name);
1404        }
1405    }
1406
1407    // Thread-safe.
1408    private static class NameValueCache {
1409        private final String mVersionSystemProperty;
1410        private final Uri mUri;
1411
1412        private static final String[] SELECT_VALUE =
1413            new String[] { Settings.NameValueTable.VALUE };
1414        private static final String NAME_EQ_PLACEHOLDER = "name=?";
1415
1416        // Must synchronize on 'this' to access mValues and mValuesVersion.
1417        private final HashMap<String, String> mValues = new HashMap<String, String>();
1418        private long mValuesVersion = 0;
1419
1420        // Initially null; set lazily and held forever.  Synchronized on 'this'.
1421        private IContentProvider mContentProvider = null;
1422
1423        // The method we'll call (or null, to not use) on the provider
1424        // for the fast path of retrieving settings.
1425        private final String mCallGetCommand;
1426        private final String mCallSetCommand;
1427
1428        public NameValueCache(String versionSystemProperty, Uri uri,
1429                String getCommand, String setCommand) {
1430            mVersionSystemProperty = versionSystemProperty;
1431            mUri = uri;
1432            mCallGetCommand = getCommand;
1433            mCallSetCommand = setCommand;
1434        }
1435
1436        private IContentProvider lazyGetProvider(ContentResolver cr) {
1437            IContentProvider cp = null;
1438            synchronized (this) {
1439                cp = mContentProvider;
1440                if (cp == null) {
1441                    cp = mContentProvider = cr.acquireProvider(mUri.getAuthority());
1442                }
1443            }
1444            return cp;
1445        }
1446
1447        public boolean putStringForUser(ContentResolver cr, String name, String value,
1448                final int userHandle) {
1449            try {
1450                Bundle arg = new Bundle();
1451                arg.putString(Settings.NameValueTable.VALUE, value);
1452                arg.putInt(CALL_METHOD_USER_KEY, userHandle);
1453                IContentProvider cp = lazyGetProvider(cr);
1454                cp.call(cr.getPackageName(), mCallSetCommand, name, arg);
1455            } catch (RemoteException e) {
1456                Log.w(TAG, "Can't set key " + name + " in " + mUri, e);
1457                return false;
1458            }
1459            return true;
1460        }
1461
1462        public String getStringForUser(ContentResolver cr, String name, final int userHandle) {
1463            final boolean isSelf = (userHandle == UserHandle.myUserId());
1464            if (isSelf) {
1465                long newValuesVersion = SystemProperties.getLong(mVersionSystemProperty, 0);
1466
1467                // Our own user's settings data uses a client-side cache
1468                synchronized (this) {
1469                    if (mValuesVersion != newValuesVersion) {
1470                        if (LOCAL_LOGV || false) {
1471                            Log.v(TAG, "invalidate [" + mUri.getLastPathSegment() + "]: current "
1472                                    + newValuesVersion + " != cached " + mValuesVersion);
1473                        }
1474
1475                        mValues.clear();
1476                        mValuesVersion = newValuesVersion;
1477                    }
1478
1479                    if (mValues.containsKey(name)) {
1480                        return mValues.get(name);  // Could be null, that's OK -- negative caching
1481                    }
1482                }
1483            } else {
1484                if (LOCAL_LOGV) Log.v(TAG, "get setting for user " + userHandle
1485                        + " by user " + UserHandle.myUserId() + " so skipping cache");
1486            }
1487
1488            IContentProvider cp = lazyGetProvider(cr);
1489
1490            // Try the fast path first, not using query().  If this
1491            // fails (alternate Settings provider that doesn't support
1492            // this interface?) then we fall back to the query/table
1493            // interface.
1494            if (mCallGetCommand != null) {
1495                try {
1496                    Bundle args = null;
1497                    if (!isSelf) {
1498                        args = new Bundle();
1499                        args.putInt(CALL_METHOD_USER_KEY, userHandle);
1500                    }
1501                    Bundle b = cp.call(cr.getPackageName(), mCallGetCommand, name, args);
1502                    if (b != null) {
1503                        String value = b.getPairValue();
1504                        // Don't update our cache for reads of other users' data
1505                        if (isSelf) {
1506                            synchronized (this) {
1507                                mValues.put(name, value);
1508                            }
1509                        } else {
1510                            if (LOCAL_LOGV) Log.i(TAG, "call-query of user " + userHandle
1511                                    + " by " + UserHandle.myUserId()
1512                                    + " so not updating cache");
1513                        }
1514                        return value;
1515                    }
1516                    // If the response Bundle is null, we fall through
1517                    // to the query interface below.
1518                } catch (RemoteException e) {
1519                    // Not supported by the remote side?  Fall through
1520                    // to query().
1521                }
1522            }
1523
1524            Cursor c = null;
1525            try {
1526                c = cp.query(cr.getPackageName(), mUri, SELECT_VALUE, NAME_EQ_PLACEHOLDER,
1527                             new String[]{name}, null, null);
1528                if (c == null) {
1529                    Log.w(TAG, "Can't get key " + name + " from " + mUri);
1530                    return null;
1531                }
1532
1533                String value = c.moveToNext() ? c.getString(0) : null;
1534                synchronized (this) {
1535                    mValues.put(name, value);
1536                }
1537                if (LOCAL_LOGV) {
1538                    Log.v(TAG, "cache miss [" + mUri.getLastPathSegment() + "]: " +
1539                            name + " = " + (value == null ? "(null)" : value));
1540                }
1541                return value;
1542            } catch (RemoteException e) {
1543                Log.w(TAG, "Can't get key " + name + " from " + mUri, e);
1544                return null;  // Return null, but don't cache it.
1545            } finally {
1546                if (c != null) c.close();
1547            }
1548        }
1549    }
1550
1551    /**
1552     * An app can use this method to check if it is currently allowed to draw on top of other
1553     * apps. In order to be allowed to do so, an app must first declare the
1554     * {@link android.Manifest.permission#SYSTEM_ALERT_WINDOW} permission in its manifest. If it
1555     * is currently disallowed, it can prompt the user to grant it this capability through a
1556     * management UI by sending an Intent with action
1557     * {@link android.provider.Settings#ACTION_MANAGE_OVERLAY_PERMISSION}.
1558     *
1559     * @param context A context
1560     * @return true if the calling app can draw on top of other apps, false otherwise.
1561     */
1562    public static boolean canDrawOverlays(Context context) {
1563        int uid = Binder.getCallingUid();
1564        return Settings.isCallingPackageAllowedToDrawOverlays(context, uid, Settings
1565                .getPackageNameForUid(context, uid), false);
1566    }
1567
1568    /**
1569     * System settings, containing miscellaneous system preferences.  This
1570     * table holds simple name/value pairs.  There are convenience
1571     * functions for accessing individual settings entries.
1572     */
1573    public static final class System extends NameValueTable {
1574        public static final String SYS_PROP_SETTING_VERSION = "sys.settings_system_version";
1575
1576        /** @hide */
1577        public static interface Validator {
1578            public boolean validate(String value);
1579        }
1580
1581        /**
1582         * The content:// style URL for this table
1583         */
1584        public static final Uri CONTENT_URI =
1585            Uri.parse("content://" + AUTHORITY + "/system");
1586
1587        private static final NameValueCache sNameValueCache = new NameValueCache(
1588                SYS_PROP_SETTING_VERSION,
1589                CONTENT_URI,
1590                CALL_METHOD_GET_SYSTEM,
1591                CALL_METHOD_PUT_SYSTEM);
1592
1593        private static final HashSet<String> MOVED_TO_SECURE;
1594        static {
1595            MOVED_TO_SECURE = new HashSet<String>(30);
1596            MOVED_TO_SECURE.add(Secure.ANDROID_ID);
1597            MOVED_TO_SECURE.add(Secure.HTTP_PROXY);
1598            MOVED_TO_SECURE.add(Secure.LOCATION_PROVIDERS_ALLOWED);
1599            MOVED_TO_SECURE.add(Secure.LOCK_BIOMETRIC_WEAK_FLAGS);
1600            MOVED_TO_SECURE.add(Secure.LOCK_PATTERN_ENABLED);
1601            MOVED_TO_SECURE.add(Secure.LOCK_PATTERN_VISIBLE);
1602            MOVED_TO_SECURE.add(Secure.LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED);
1603            MOVED_TO_SECURE.add(Secure.LOGGING_ID);
1604            MOVED_TO_SECURE.add(Secure.PARENTAL_CONTROL_ENABLED);
1605            MOVED_TO_SECURE.add(Secure.PARENTAL_CONTROL_LAST_UPDATE);
1606            MOVED_TO_SECURE.add(Secure.PARENTAL_CONTROL_REDIRECT_URL);
1607            MOVED_TO_SECURE.add(Secure.SETTINGS_CLASSNAME);
1608            MOVED_TO_SECURE.add(Secure.USE_GOOGLE_MAIL);
1609            MOVED_TO_SECURE.add(Secure.WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON);
1610            MOVED_TO_SECURE.add(Secure.WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY);
1611            MOVED_TO_SECURE.add(Secure.WIFI_NUM_OPEN_NETWORKS_KEPT);
1612            MOVED_TO_SECURE.add(Secure.WIFI_ON);
1613            MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE);
1614            MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_AP_COUNT);
1615            MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS);
1616            MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED);
1617            MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS);
1618            MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT);
1619            MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_MAX_AP_CHECKS);
1620            MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_ON);
1621            MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_PING_COUNT);
1622            MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_PING_DELAY_MS);
1623            MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_PING_TIMEOUT_MS);
1624
1625            // At one time in System, then Global, but now back in Secure
1626            MOVED_TO_SECURE.add(Secure.INSTALL_NON_MARKET_APPS);
1627        }
1628
1629        private static final HashSet<String> MOVED_TO_GLOBAL;
1630        private static final HashSet<String> MOVED_TO_SECURE_THEN_GLOBAL;
1631        static {
1632            MOVED_TO_GLOBAL = new HashSet<String>();
1633            MOVED_TO_SECURE_THEN_GLOBAL = new HashSet<String>();
1634
1635            // these were originally in system but migrated to secure in the past,
1636            // so are duplicated in the Secure.* namespace
1637            MOVED_TO_SECURE_THEN_GLOBAL.add(Global.ADB_ENABLED);
1638            MOVED_TO_SECURE_THEN_GLOBAL.add(Global.BLUETOOTH_ON);
1639            MOVED_TO_SECURE_THEN_GLOBAL.add(Global.DATA_ROAMING);
1640            MOVED_TO_SECURE_THEN_GLOBAL.add(Global.DEVICE_PROVISIONED);
1641            MOVED_TO_SECURE_THEN_GLOBAL.add(Global.USB_MASS_STORAGE_ENABLED);
1642            MOVED_TO_SECURE_THEN_GLOBAL.add(Global.HTTP_PROXY);
1643
1644            // these are moving directly from system to global
1645            MOVED_TO_GLOBAL.add(Settings.Global.AIRPLANE_MODE_ON);
1646            MOVED_TO_GLOBAL.add(Settings.Global.AIRPLANE_MODE_RADIOS);
1647            MOVED_TO_GLOBAL.add(Settings.Global.AIRPLANE_MODE_TOGGLEABLE_RADIOS);
1648            MOVED_TO_GLOBAL.add(Settings.Global.AUTO_TIME);
1649            MOVED_TO_GLOBAL.add(Settings.Global.AUTO_TIME_ZONE);
1650            MOVED_TO_GLOBAL.add(Settings.Global.CAR_DOCK_SOUND);
1651            MOVED_TO_GLOBAL.add(Settings.Global.CAR_UNDOCK_SOUND);
1652            MOVED_TO_GLOBAL.add(Settings.Global.DESK_DOCK_SOUND);
1653            MOVED_TO_GLOBAL.add(Settings.Global.DESK_UNDOCK_SOUND);
1654            MOVED_TO_GLOBAL.add(Settings.Global.DOCK_SOUNDS_ENABLED);
1655            MOVED_TO_GLOBAL.add(Settings.Global.LOCK_SOUND);
1656            MOVED_TO_GLOBAL.add(Settings.Global.UNLOCK_SOUND);
1657            MOVED_TO_GLOBAL.add(Settings.Global.LOW_BATTERY_SOUND);
1658            MOVED_TO_GLOBAL.add(Settings.Global.POWER_SOUNDS_ENABLED);
1659            MOVED_TO_GLOBAL.add(Settings.Global.STAY_ON_WHILE_PLUGGED_IN);
1660            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_SLEEP_POLICY);
1661            MOVED_TO_GLOBAL.add(Settings.Global.MODE_RINGER);
1662            MOVED_TO_GLOBAL.add(Settings.Global.WINDOW_ANIMATION_SCALE);
1663            MOVED_TO_GLOBAL.add(Settings.Global.TRANSITION_ANIMATION_SCALE);
1664            MOVED_TO_GLOBAL.add(Settings.Global.ANIMATOR_DURATION_SCALE);
1665            MOVED_TO_GLOBAL.add(Settings.Global.FANCY_IME_ANIMATIONS);
1666            MOVED_TO_GLOBAL.add(Settings.Global.COMPATIBILITY_MODE);
1667            MOVED_TO_GLOBAL.add(Settings.Global.EMERGENCY_TONE);
1668            MOVED_TO_GLOBAL.add(Settings.Global.CALL_AUTO_RETRY);
1669            MOVED_TO_GLOBAL.add(Settings.Global.DEBUG_APP);
1670            MOVED_TO_GLOBAL.add(Settings.Global.WAIT_FOR_DEBUGGER);
1671            MOVED_TO_GLOBAL.add(Settings.Global.SHOW_PROCESSES);
1672            MOVED_TO_GLOBAL.add(Settings.Global.ALWAYS_FINISH_ACTIVITIES);
1673            MOVED_TO_GLOBAL.add(Settings.Global.TZINFO_UPDATE_CONTENT_URL);
1674            MOVED_TO_GLOBAL.add(Settings.Global.TZINFO_UPDATE_METADATA_URL);
1675            MOVED_TO_GLOBAL.add(Settings.Global.SELINUX_UPDATE_CONTENT_URL);
1676            MOVED_TO_GLOBAL.add(Settings.Global.SELINUX_UPDATE_METADATA_URL);
1677            MOVED_TO_GLOBAL.add(Settings.Global.SMS_SHORT_CODES_UPDATE_CONTENT_URL);
1678            MOVED_TO_GLOBAL.add(Settings.Global.SMS_SHORT_CODES_UPDATE_METADATA_URL);
1679            MOVED_TO_GLOBAL.add(Settings.Global.CERT_PIN_UPDATE_CONTENT_URL);
1680            MOVED_TO_GLOBAL.add(Settings.Global.CERT_PIN_UPDATE_METADATA_URL);
1681        }
1682
1683        private static final Validator sBooleanValidator =
1684                new DiscreteValueValidator(new String[] {"0", "1"});
1685
1686        private static final Validator sNonNegativeIntegerValidator = new Validator() {
1687            @Override
1688            public boolean validate(String value) {
1689                try {
1690                    return Integer.parseInt(value) >= 0;
1691                } catch (NumberFormatException e) {
1692                    return false;
1693                }
1694            }
1695        };
1696
1697        private static final Validator sUriValidator = new Validator() {
1698            @Override
1699            public boolean validate(String value) {
1700                try {
1701                    Uri.decode(value);
1702                    return true;
1703                } catch (IllegalArgumentException e) {
1704                    return false;
1705                }
1706            }
1707        };
1708
1709        private static final Validator sLenientIpAddressValidator = new Validator() {
1710            private static final int MAX_IPV6_LENGTH = 45;
1711
1712            @Override
1713            public boolean validate(String value) {
1714                return value.length() <= MAX_IPV6_LENGTH;
1715            }
1716        };
1717
1718        /** @hide */
1719        public static void getMovedToGlobalSettings(Set<String> outKeySet) {
1720            outKeySet.addAll(MOVED_TO_GLOBAL);
1721            outKeySet.addAll(MOVED_TO_SECURE_THEN_GLOBAL);
1722        }
1723
1724        /** @hide */
1725        public static void getMovedToSecureSettings(Set<String> outKeySet) {
1726            outKeySet.addAll(MOVED_TO_SECURE);
1727        }
1728
1729        /** @hide */
1730        public static void getNonLegacyMovedKeys(HashSet<String> outKeySet) {
1731            outKeySet.addAll(MOVED_TO_GLOBAL);
1732        }
1733
1734        /**
1735         * Look up a name in the database.
1736         * @param resolver to access the database with
1737         * @param name to look up in the table
1738         * @return the corresponding value, or null if not present
1739         */
1740        public static String getString(ContentResolver resolver, String name) {
1741            return getStringForUser(resolver, name, UserHandle.myUserId());
1742        }
1743
1744        /** @hide */
1745        public static String getStringForUser(ContentResolver resolver, String name,
1746                int userHandle) {
1747            if (MOVED_TO_SECURE.contains(name)) {
1748                Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.System"
1749                        + " to android.provider.Settings.Secure, returning read-only value.");
1750                return Secure.getStringForUser(resolver, name, userHandle);
1751            }
1752            if (MOVED_TO_GLOBAL.contains(name) || MOVED_TO_SECURE_THEN_GLOBAL.contains(name)) {
1753                Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.System"
1754                        + " to android.provider.Settings.Global, returning read-only value.");
1755                return Global.getStringForUser(resolver, name, userHandle);
1756            }
1757            return sNameValueCache.getStringForUser(resolver, name, userHandle);
1758        }
1759
1760        /**
1761         * Store a name/value pair into the database.
1762         * @param resolver to access the database with
1763         * @param name to store
1764         * @param value to associate with the name
1765         * @return true if the value was set, false on database errors
1766         */
1767        public static boolean putString(ContentResolver resolver, String name, String value) {
1768            return putStringForUser(resolver, name, value, UserHandle.myUserId());
1769        }
1770
1771        /** @hide */
1772        public static boolean putStringForUser(ContentResolver resolver, String name, String value,
1773                int userHandle) {
1774            if (MOVED_TO_SECURE.contains(name)) {
1775                Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.System"
1776                        + " to android.provider.Settings.Secure, value is unchanged.");
1777                return false;
1778            }
1779            if (MOVED_TO_GLOBAL.contains(name) || MOVED_TO_SECURE_THEN_GLOBAL.contains(name)) {
1780                Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.System"
1781                        + " to android.provider.Settings.Global, value is unchanged.");
1782                return false;
1783            }
1784            return sNameValueCache.putStringForUser(resolver, name, value, userHandle);
1785        }
1786
1787        /**
1788         * Construct the content URI for a particular name/value pair,
1789         * useful for monitoring changes with a ContentObserver.
1790         * @param name to look up in the table
1791         * @return the corresponding content URI, or null if not present
1792         */
1793        public static Uri getUriFor(String name) {
1794            if (MOVED_TO_SECURE.contains(name)) {
1795                Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.System"
1796                    + " to android.provider.Settings.Secure, returning Secure URI.");
1797                return Secure.getUriFor(Secure.CONTENT_URI, name);
1798            }
1799            if (MOVED_TO_GLOBAL.contains(name) || MOVED_TO_SECURE_THEN_GLOBAL.contains(name)) {
1800                Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.System"
1801                        + " to android.provider.Settings.Global, returning read-only global URI.");
1802                return Global.getUriFor(Global.CONTENT_URI, name);
1803            }
1804            return getUriFor(CONTENT_URI, name);
1805        }
1806
1807        /**
1808         * Convenience function for retrieving a single system settings value
1809         * as an integer.  Note that internally setting values are always
1810         * stored as strings; this function converts the string to an integer
1811         * for you.  The default value will be returned if the setting is
1812         * not defined or not an integer.
1813         *
1814         * @param cr The ContentResolver to access.
1815         * @param name The name of the setting to retrieve.
1816         * @param def Value to return if the setting is not defined.
1817         *
1818         * @return The setting's current value, or 'def' if it is not defined
1819         * or not a valid integer.
1820         */
1821        public static int getInt(ContentResolver cr, String name, int def) {
1822            return getIntForUser(cr, name, def, UserHandle.myUserId());
1823        }
1824
1825        /** @hide */
1826        public static int getIntForUser(ContentResolver cr, String name, int def, int userHandle) {
1827            String v = getStringForUser(cr, name, userHandle);
1828            try {
1829                return v != null ? Integer.parseInt(v) : def;
1830            } catch (NumberFormatException e) {
1831                return def;
1832            }
1833        }
1834
1835        /**
1836         * Convenience function for retrieving a single system settings value
1837         * as an integer.  Note that internally setting values are always
1838         * stored as strings; this function converts the string to an integer
1839         * for you.
1840         * <p>
1841         * This version does not take a default value.  If the setting has not
1842         * been set, or the string value is not a number,
1843         * it throws {@link SettingNotFoundException}.
1844         *
1845         * @param cr The ContentResolver to access.
1846         * @param name The name of the setting to retrieve.
1847         *
1848         * @throws SettingNotFoundException Thrown if a setting by the given
1849         * name can't be found or the setting value is not an integer.
1850         *
1851         * @return The setting's current value.
1852         */
1853        public static int getInt(ContentResolver cr, String name)
1854                throws SettingNotFoundException {
1855            return getIntForUser(cr, name, UserHandle.myUserId());
1856        }
1857
1858        /** @hide */
1859        public static int getIntForUser(ContentResolver cr, String name, int userHandle)
1860                throws SettingNotFoundException {
1861            String v = getStringForUser(cr, name, userHandle);
1862            try {
1863                return Integer.parseInt(v);
1864            } catch (NumberFormatException e) {
1865                throw new SettingNotFoundException(name);
1866            }
1867        }
1868
1869        /**
1870         * Convenience function for updating a single settings value as an
1871         * integer. This will either create a new entry in the table if the
1872         * given name does not exist, or modify the value of the existing row
1873         * with that name.  Note that internally setting values are always
1874         * stored as strings, so this function converts the given value to a
1875         * string before storing it.
1876         *
1877         * @param cr The ContentResolver to access.
1878         * @param name The name of the setting to modify.
1879         * @param value The new value for the setting.
1880         * @return true if the value was set, false on database errors
1881         */
1882        public static boolean putInt(ContentResolver cr, String name, int value) {
1883            return putIntForUser(cr, name, value, UserHandle.myUserId());
1884        }
1885
1886        /** @hide */
1887        public static boolean putIntForUser(ContentResolver cr, String name, int value,
1888                int userHandle) {
1889            return putStringForUser(cr, name, Integer.toString(value), userHandle);
1890        }
1891
1892        /**
1893         * Convenience function for retrieving a single system settings value
1894         * as a {@code long}.  Note that internally setting values are always
1895         * stored as strings; this function converts the string to a {@code long}
1896         * for you.  The default value will be returned if the setting is
1897         * not defined or not a {@code long}.
1898         *
1899         * @param cr The ContentResolver to access.
1900         * @param name The name of the setting to retrieve.
1901         * @param def Value to return if the setting is not defined.
1902         *
1903         * @return The setting's current value, or 'def' if it is not defined
1904         * or not a valid {@code long}.
1905         */
1906        public static long getLong(ContentResolver cr, String name, long def) {
1907            return getLongForUser(cr, name, def, UserHandle.myUserId());
1908        }
1909
1910        /** @hide */
1911        public static long getLongForUser(ContentResolver cr, String name, long def,
1912                int userHandle) {
1913            String valString = getStringForUser(cr, name, userHandle);
1914            long value;
1915            try {
1916                value = valString != null ? Long.parseLong(valString) : def;
1917            } catch (NumberFormatException e) {
1918                value = def;
1919            }
1920            return value;
1921        }
1922
1923        /**
1924         * Convenience function for retrieving a single system settings value
1925         * as a {@code long}.  Note that internally setting values are always
1926         * stored as strings; this function converts the string to a {@code long}
1927         * for you.
1928         * <p>
1929         * This version does not take a default value.  If the setting has not
1930         * been set, or the string value is not a number,
1931         * it throws {@link SettingNotFoundException}.
1932         *
1933         * @param cr The ContentResolver to access.
1934         * @param name The name of the setting to retrieve.
1935         *
1936         * @return The setting's current value.
1937         * @throws SettingNotFoundException Thrown if a setting by the given
1938         * name can't be found or the setting value is not an integer.
1939         */
1940        public static long getLong(ContentResolver cr, String name)
1941                throws SettingNotFoundException {
1942            return getLongForUser(cr, name, UserHandle.myUserId());
1943        }
1944
1945        /** @hide */
1946        public static long getLongForUser(ContentResolver cr, String name, int userHandle)
1947                throws SettingNotFoundException {
1948            String valString = getStringForUser(cr, name, userHandle);
1949            try {
1950                return Long.parseLong(valString);
1951            } catch (NumberFormatException e) {
1952                throw new SettingNotFoundException(name);
1953            }
1954        }
1955
1956        /**
1957         * Convenience function for updating a single settings value as a long
1958         * integer. This will either create a new entry in the table if the
1959         * given name does not exist, or modify the value of the existing row
1960         * with that name.  Note that internally setting values are always
1961         * stored as strings, so this function converts the given value to a
1962         * string before storing it.
1963         *
1964         * @param cr The ContentResolver to access.
1965         * @param name The name of the setting to modify.
1966         * @param value The new value for the setting.
1967         * @return true if the value was set, false on database errors
1968         */
1969        public static boolean putLong(ContentResolver cr, String name, long value) {
1970            return putLongForUser(cr, name, value, UserHandle.myUserId());
1971        }
1972
1973        /** @hide */
1974        public static boolean putLongForUser(ContentResolver cr, String name, long value,
1975                int userHandle) {
1976            return putStringForUser(cr, name, Long.toString(value), userHandle);
1977        }
1978
1979        /**
1980         * Convenience function for retrieving a single system settings value
1981         * as a floating point number.  Note that internally setting values are
1982         * always stored as strings; this function converts the string to an
1983         * float for you. The default value will be returned if the setting
1984         * is not defined or not a valid float.
1985         *
1986         * @param cr The ContentResolver to access.
1987         * @param name The name of the setting to retrieve.
1988         * @param def Value to return if the setting is not defined.
1989         *
1990         * @return The setting's current value, or 'def' if it is not defined
1991         * or not a valid float.
1992         */
1993        public static float getFloat(ContentResolver cr, String name, float def) {
1994            return getFloatForUser(cr, name, def, UserHandle.myUserId());
1995        }
1996
1997        /** @hide */
1998        public static float getFloatForUser(ContentResolver cr, String name, float def,
1999                int userHandle) {
2000            String v = getStringForUser(cr, name, userHandle);
2001            try {
2002                return v != null ? Float.parseFloat(v) : def;
2003            } catch (NumberFormatException e) {
2004                return def;
2005            }
2006        }
2007
2008        /**
2009         * Convenience function for retrieving a single system settings value
2010         * as a float.  Note that internally setting values are always
2011         * stored as strings; this function converts the string to a float
2012         * for you.
2013         * <p>
2014         * This version does not take a default value.  If the setting has not
2015         * been set, or the string value is not a number,
2016         * it throws {@link SettingNotFoundException}.
2017         *
2018         * @param cr The ContentResolver to access.
2019         * @param name The name of the setting to retrieve.
2020         *
2021         * @throws SettingNotFoundException Thrown if a setting by the given
2022         * name can't be found or the setting value is not a float.
2023         *
2024         * @return The setting's current value.
2025         */
2026        public static float getFloat(ContentResolver cr, String name)
2027                throws SettingNotFoundException {
2028            return getFloatForUser(cr, name, UserHandle.myUserId());
2029        }
2030
2031        /** @hide */
2032        public static float getFloatForUser(ContentResolver cr, String name, int userHandle)
2033                throws SettingNotFoundException {
2034            String v = getStringForUser(cr, name, userHandle);
2035            if (v == null) {
2036                throw new SettingNotFoundException(name);
2037            }
2038            try {
2039                return Float.parseFloat(v);
2040            } catch (NumberFormatException e) {
2041                throw new SettingNotFoundException(name);
2042            }
2043        }
2044
2045        /**
2046         * Convenience function for updating a single settings value as a
2047         * floating point number. This will either create a new entry in the
2048         * table if the given name does not exist, or modify the value of the
2049         * existing row with that name.  Note that internally setting values
2050         * are always stored as strings, so this function converts the given
2051         * value to a string before storing it.
2052         *
2053         * @param cr The ContentResolver to access.
2054         * @param name The name of the setting to modify.
2055         * @param value The new value for the setting.
2056         * @return true if the value was set, false on database errors
2057         */
2058        public static boolean putFloat(ContentResolver cr, String name, float value) {
2059            return putFloatForUser(cr, name, value, UserHandle.myUserId());
2060        }
2061
2062        /** @hide */
2063        public static boolean putFloatForUser(ContentResolver cr, String name, float value,
2064                int userHandle) {
2065            return putStringForUser(cr, name, Float.toString(value), userHandle);
2066        }
2067
2068        /**
2069         * Convenience function to read all of the current
2070         * configuration-related settings into a
2071         * {@link Configuration} object.
2072         *
2073         * @param cr The ContentResolver to access.
2074         * @param outConfig Where to place the configuration settings.
2075         */
2076        public static void getConfiguration(ContentResolver cr, Configuration outConfig) {
2077            getConfigurationForUser(cr, outConfig, UserHandle.myUserId());
2078        }
2079
2080        /** @hide */
2081        public static void getConfigurationForUser(ContentResolver cr, Configuration outConfig,
2082                int userHandle) {
2083            outConfig.fontScale = Settings.System.getFloatForUser(
2084                cr, FONT_SCALE, outConfig.fontScale, userHandle);
2085            if (outConfig.fontScale < 0) {
2086                outConfig.fontScale = 1;
2087            }
2088            outConfig.setLocales(LocaleList.forLanguageTags(
2089                    Settings.System.getStringForUser(cr, SYSTEM_LOCALES, userHandle)));
2090        }
2091
2092        /**
2093         * @hide Erase the fields in the Configuration that should be applied
2094         * by the settings.
2095         */
2096        public static void clearConfiguration(Configuration inoutConfig) {
2097            inoutConfig.fontScale = 0;
2098            if (!inoutConfig.userSetLocale) {
2099                inoutConfig.setLocales(LocaleList.getEmptyLocaleList());
2100            }
2101        }
2102
2103        /**
2104         * Convenience function to write a batch of configuration-related
2105         * settings from a {@link Configuration} object.
2106         *
2107         * @param cr The ContentResolver to access.
2108         * @param config The settings to write.
2109         * @return true if the values were set, false on database errors
2110         */
2111        public static boolean putConfiguration(ContentResolver cr, Configuration config) {
2112            return putConfigurationForUser(cr, config, UserHandle.myUserId());
2113        }
2114
2115        /** @hide */
2116        public static boolean putConfigurationForUser(ContentResolver cr, Configuration config,
2117                int userHandle) {
2118            return Settings.System.putFloatForUser(cr, FONT_SCALE, config.fontScale, userHandle) &&
2119                    Settings.System.putStringForUser(
2120                            cr, SYSTEM_LOCALES, config.getLocales().toLanguageTags(), userHandle);
2121        }
2122
2123        /** @hide */
2124        public static boolean hasInterestingConfigurationChanges(int changes) {
2125            return (changes & ActivityInfo.CONFIG_FONT_SCALE) != 0 ||
2126                    (changes & ActivityInfo.CONFIG_LOCALE) != 0;
2127        }
2128
2129        /** @deprecated - Do not use */
2130        @Deprecated
2131        public static boolean getShowGTalkServiceStatus(ContentResolver cr) {
2132            return getShowGTalkServiceStatusForUser(cr, UserHandle.myUserId());
2133        }
2134
2135        /**
2136         * @hide
2137         * @deprecated - Do not use
2138         */
2139        public static boolean getShowGTalkServiceStatusForUser(ContentResolver cr,
2140                int userHandle) {
2141            return getIntForUser(cr, SHOW_GTALK_SERVICE_STATUS, 0, userHandle) != 0;
2142        }
2143
2144        /** @deprecated - Do not use */
2145        @Deprecated
2146        public static void setShowGTalkServiceStatus(ContentResolver cr, boolean flag) {
2147            setShowGTalkServiceStatusForUser(cr, flag, UserHandle.myUserId());
2148        }
2149
2150        /**
2151         * @hide
2152         * @deprecated - Do not use
2153         */
2154        @Deprecated
2155        public static void setShowGTalkServiceStatusForUser(ContentResolver cr, boolean flag,
2156                int userHandle) {
2157            putIntForUser(cr, SHOW_GTALK_SERVICE_STATUS, flag ? 1 : 0, userHandle);
2158        }
2159
2160        private static final class DiscreteValueValidator implements Validator {
2161            private final String[] mValues;
2162
2163            public DiscreteValueValidator(String[] values) {
2164                mValues = values;
2165            }
2166
2167            @Override
2168            public boolean validate(String value) {
2169                return ArrayUtils.contains(mValues, value);
2170            }
2171        }
2172
2173        private static final class InclusiveIntegerRangeValidator implements Validator {
2174            private final int mMin;
2175            private final int mMax;
2176
2177            public InclusiveIntegerRangeValidator(int min, int max) {
2178                mMin = min;
2179                mMax = max;
2180            }
2181
2182            @Override
2183            public boolean validate(String value) {
2184                try {
2185                    final int intValue = Integer.parseInt(value);
2186                    return intValue >= mMin && intValue <= mMax;
2187                } catch (NumberFormatException e) {
2188                    return false;
2189                }
2190            }
2191        }
2192
2193        private static final class InclusiveFloatRangeValidator implements Validator {
2194            private final float mMin;
2195            private final float mMax;
2196
2197            public InclusiveFloatRangeValidator(float min, float max) {
2198                mMin = min;
2199                mMax = max;
2200            }
2201
2202            @Override
2203            public boolean validate(String value) {
2204                try {
2205                    final float floatValue = Float.parseFloat(value);
2206                    return floatValue >= mMin && floatValue <= mMax;
2207                } catch (NumberFormatException e) {
2208                    return false;
2209                }
2210            }
2211        }
2212
2213        /**
2214         * @deprecated Use {@link android.provider.Settings.Global#STAY_ON_WHILE_PLUGGED_IN} instead
2215         */
2216        @Deprecated
2217        public static final String STAY_ON_WHILE_PLUGGED_IN = Global.STAY_ON_WHILE_PLUGGED_IN;
2218
2219        /**
2220         * What happens when the user presses the end call button if they're not
2221         * on a call.<br/>
2222         * <b>Values:</b><br/>
2223         * 0 - The end button does nothing.<br/>
2224         * 1 - The end button goes to the home screen.<br/>
2225         * 2 - The end button puts the device to sleep and locks the keyguard.<br/>
2226         * 3 - The end button goes to the home screen.  If the user is already on the
2227         * home screen, it puts the device to sleep.
2228         */
2229        public static final String END_BUTTON_BEHAVIOR = "end_button_behavior";
2230
2231        private static final Validator END_BUTTON_BEHAVIOR_VALIDATOR =
2232                new InclusiveIntegerRangeValidator(0, 3);
2233
2234        /**
2235         * END_BUTTON_BEHAVIOR value for "go home".
2236         * @hide
2237         */
2238        public static final int END_BUTTON_BEHAVIOR_HOME = 0x1;
2239
2240        /**
2241         * END_BUTTON_BEHAVIOR value for "go to sleep".
2242         * @hide
2243         */
2244        public static final int END_BUTTON_BEHAVIOR_SLEEP = 0x2;
2245
2246        /**
2247         * END_BUTTON_BEHAVIOR default value.
2248         * @hide
2249         */
2250        public static final int END_BUTTON_BEHAVIOR_DEFAULT = END_BUTTON_BEHAVIOR_SLEEP;
2251
2252        /**
2253         * Is advanced settings mode turned on. 0 == no, 1 == yes
2254         * @hide
2255         */
2256        public static final String ADVANCED_SETTINGS = "advanced_settings";
2257
2258        private static final Validator ADVANCED_SETTINGS_VALIDATOR = sBooleanValidator;
2259
2260        /**
2261         * ADVANCED_SETTINGS default value.
2262         * @hide
2263         */
2264        public static final int ADVANCED_SETTINGS_DEFAULT = 0;
2265
2266        /**
2267         * @deprecated Use {@link android.provider.Settings.Global#AIRPLANE_MODE_ON} instead
2268         */
2269        @Deprecated
2270        public static final String AIRPLANE_MODE_ON = Global.AIRPLANE_MODE_ON;
2271
2272        /**
2273         * @deprecated Use {@link android.provider.Settings.Global#RADIO_BLUETOOTH} instead
2274         */
2275        @Deprecated
2276        public static final String RADIO_BLUETOOTH = Global.RADIO_BLUETOOTH;
2277
2278        /**
2279         * @deprecated Use {@link android.provider.Settings.Global#RADIO_WIFI} instead
2280         */
2281        @Deprecated
2282        public static final String RADIO_WIFI = Global.RADIO_WIFI;
2283
2284        /**
2285         * @deprecated Use {@link android.provider.Settings.Global#RADIO_WIMAX} instead
2286         * {@hide}
2287         */
2288        @Deprecated
2289        public static final String RADIO_WIMAX = Global.RADIO_WIMAX;
2290
2291        /**
2292         * @deprecated Use {@link android.provider.Settings.Global#RADIO_CELL} instead
2293         */
2294        @Deprecated
2295        public static final String RADIO_CELL = Global.RADIO_CELL;
2296
2297        /**
2298         * @deprecated Use {@link android.provider.Settings.Global#RADIO_NFC} instead
2299         */
2300        @Deprecated
2301        public static final String RADIO_NFC = Global.RADIO_NFC;
2302
2303        /**
2304         * @deprecated Use {@link android.provider.Settings.Global#AIRPLANE_MODE_RADIOS} instead
2305         */
2306        @Deprecated
2307        public static final String AIRPLANE_MODE_RADIOS = Global.AIRPLANE_MODE_RADIOS;
2308
2309        /**
2310         * @deprecated Use {@link android.provider.Settings.Global#AIRPLANE_MODE_TOGGLEABLE_RADIOS} instead
2311         *
2312         * {@hide}
2313         */
2314        @Deprecated
2315        public static final String AIRPLANE_MODE_TOGGLEABLE_RADIOS =
2316                Global.AIRPLANE_MODE_TOGGLEABLE_RADIOS;
2317
2318        /**
2319         * @deprecated Use {@link android.provider.Settings.Global#WIFI_SLEEP_POLICY} instead
2320         */
2321        @Deprecated
2322        public static final String WIFI_SLEEP_POLICY = Global.WIFI_SLEEP_POLICY;
2323
2324        /**
2325         * @deprecated Use {@link android.provider.Settings.Global#WIFI_SLEEP_POLICY_DEFAULT} instead
2326         */
2327        @Deprecated
2328        public static final int WIFI_SLEEP_POLICY_DEFAULT = Global.WIFI_SLEEP_POLICY_DEFAULT;
2329
2330        /**
2331         * @deprecated Use {@link android.provider.Settings.Global#WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED} instead
2332         */
2333        @Deprecated
2334        public static final int WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED =
2335                Global.WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED;
2336
2337        /**
2338         * @deprecated Use {@link android.provider.Settings.Global#WIFI_SLEEP_POLICY_NEVER} instead
2339         */
2340        @Deprecated
2341        public static final int WIFI_SLEEP_POLICY_NEVER = Global.WIFI_SLEEP_POLICY_NEVER;
2342
2343        /**
2344         * @deprecated Use {@link android.provider.Settings.Global#MODE_RINGER} instead
2345         */
2346        @Deprecated
2347        public static final String MODE_RINGER = Global.MODE_RINGER;
2348
2349        /**
2350         * Whether to use static IP and other static network attributes.
2351         * <p>
2352         * Set to 1 for true and 0 for false.
2353         *
2354         * @deprecated Use {@link WifiManager} instead
2355         */
2356        @Deprecated
2357        public static final String WIFI_USE_STATIC_IP = "wifi_use_static_ip";
2358
2359        private static final Validator WIFI_USE_STATIC_IP_VALIDATOR = sBooleanValidator;
2360
2361        /**
2362         * The static IP address.
2363         * <p>
2364         * Example: "192.168.1.51"
2365         *
2366         * @deprecated Use {@link WifiManager} instead
2367         */
2368        @Deprecated
2369        public static final String WIFI_STATIC_IP = "wifi_static_ip";
2370
2371        private static final Validator WIFI_STATIC_IP_VALIDATOR = sLenientIpAddressValidator;
2372
2373        /**
2374         * If using static IP, the gateway's IP address.
2375         * <p>
2376         * Example: "192.168.1.1"
2377         *
2378         * @deprecated Use {@link WifiManager} instead
2379         */
2380        @Deprecated
2381        public static final String WIFI_STATIC_GATEWAY = "wifi_static_gateway";
2382
2383        private static final Validator WIFI_STATIC_GATEWAY_VALIDATOR = sLenientIpAddressValidator;
2384
2385        /**
2386         * If using static IP, the net mask.
2387         * <p>
2388         * Example: "255.255.255.0"
2389         *
2390         * @deprecated Use {@link WifiManager} instead
2391         */
2392        @Deprecated
2393        public static final String WIFI_STATIC_NETMASK = "wifi_static_netmask";
2394
2395        private static final Validator WIFI_STATIC_NETMASK_VALIDATOR = sLenientIpAddressValidator;
2396
2397        /**
2398         * If using static IP, the primary DNS's IP address.
2399         * <p>
2400         * Example: "192.168.1.1"
2401         *
2402         * @deprecated Use {@link WifiManager} instead
2403         */
2404        @Deprecated
2405        public static final String WIFI_STATIC_DNS1 = "wifi_static_dns1";
2406
2407        private static final Validator WIFI_STATIC_DNS1_VALIDATOR = sLenientIpAddressValidator;
2408
2409        /**
2410         * If using static IP, the secondary DNS's IP address.
2411         * <p>
2412         * Example: "192.168.1.2"
2413         *
2414         * @deprecated Use {@link WifiManager} instead
2415         */
2416        @Deprecated
2417        public static final String WIFI_STATIC_DNS2 = "wifi_static_dns2";
2418
2419        private static final Validator WIFI_STATIC_DNS2_VALIDATOR = sLenientIpAddressValidator;
2420
2421        /**
2422         * Determines whether remote devices may discover and/or connect to
2423         * this device.
2424         * <P>Type: INT</P>
2425         * 2 -- discoverable and connectable
2426         * 1 -- connectable but not discoverable
2427         * 0 -- neither connectable nor discoverable
2428         */
2429        public static final String BLUETOOTH_DISCOVERABILITY =
2430            "bluetooth_discoverability";
2431
2432        private static final Validator BLUETOOTH_DISCOVERABILITY_VALIDATOR =
2433                new InclusiveIntegerRangeValidator(0, 2);
2434
2435        /**
2436         * Bluetooth discoverability timeout.  If this value is nonzero, then
2437         * Bluetooth becomes discoverable for a certain number of seconds,
2438         * after which is becomes simply connectable.  The value is in seconds.
2439         */
2440        public static final String BLUETOOTH_DISCOVERABILITY_TIMEOUT =
2441            "bluetooth_discoverability_timeout";
2442
2443        private static final Validator BLUETOOTH_DISCOVERABILITY_TIMEOUT_VALIDATOR =
2444                sNonNegativeIntegerValidator;
2445
2446        /**
2447         * @deprecated Use {@link android.provider.Settings.Secure#LOCK_PATTERN_ENABLED}
2448         * instead
2449         */
2450        @Deprecated
2451        public static final String LOCK_PATTERN_ENABLED = Secure.LOCK_PATTERN_ENABLED;
2452
2453        /**
2454         * @deprecated Use {@link android.provider.Settings.Secure#LOCK_PATTERN_VISIBLE}
2455         * instead
2456         */
2457        @Deprecated
2458        public static final String LOCK_PATTERN_VISIBLE = "lock_pattern_visible_pattern";
2459
2460        /**
2461         * @deprecated Use
2462         * {@link android.provider.Settings.Secure#LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED}
2463         * instead
2464         */
2465        @Deprecated
2466        public static final String LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED =
2467            "lock_pattern_tactile_feedback_enabled";
2468
2469        /**
2470         * A formatted string of the next alarm that is set, or the empty string
2471         * if there is no alarm set.
2472         *
2473         * @deprecated Use {@link android.app.AlarmManager#getNextAlarmClock()}.
2474         */
2475        @Deprecated
2476        public static final String NEXT_ALARM_FORMATTED = "next_alarm_formatted";
2477
2478        private static final Validator NEXT_ALARM_FORMATTED_VALIDATOR = new Validator() {
2479            private static final int MAX_LENGTH = 1000;
2480
2481            @Override
2482            public boolean validate(String value) {
2483                // TODO: No idea what the correct format is.
2484                return value == null || value.length() < MAX_LENGTH;
2485            }
2486        };
2487
2488        /**
2489         * Scaling factor for fonts, float.
2490         */
2491        public static final String FONT_SCALE = "font_scale";
2492
2493        private static final Validator FONT_SCALE_VALIDATOR = new Validator() {
2494            @Override
2495            public boolean validate(String value) {
2496                try {
2497                    return Float.parseFloat(value) >= 0;
2498                } catch (NumberFormatException e) {
2499                    return false;
2500                }
2501            }
2502        };
2503
2504        /**
2505         * The serialized system locale value.
2506         *
2507         * Do not use this value directory.
2508         * To get system locale, use {@link android.util.LocaleList#getDefault} instead.
2509         * To update system locale, use {@link com.android.internal.app.LocalePicker#updateLocales}
2510         * instead.
2511         * @hide
2512         */
2513        public static final String SYSTEM_LOCALES = "system_locales";
2514
2515
2516        /**
2517         * Name of an application package to be debugged.
2518         *
2519         * @deprecated Use {@link Global#DEBUG_APP} instead
2520         */
2521        @Deprecated
2522        public static final String DEBUG_APP = Global.DEBUG_APP;
2523
2524        /**
2525         * If 1, when launching DEBUG_APP it will wait for the debugger before
2526         * starting user code.  If 0, it will run normally.
2527         *
2528         * @deprecated Use {@link Global#WAIT_FOR_DEBUGGER} instead
2529         */
2530        @Deprecated
2531        public static final String WAIT_FOR_DEBUGGER = Global.WAIT_FOR_DEBUGGER;
2532
2533        /**
2534         * Whether or not to dim the screen. 0=no  1=yes
2535         * @deprecated This setting is no longer used.
2536         */
2537        @Deprecated
2538        public static final String DIM_SCREEN = "dim_screen";
2539
2540        private static final Validator DIM_SCREEN_VALIDATOR = sBooleanValidator;
2541
2542        /**
2543         * The amount of time in milliseconds before the device goes to sleep or begins
2544         * to dream after a period of inactivity.  This value is also known as the
2545         * user activity timeout period since the screen isn't necessarily turned off
2546         * when it expires.
2547         */
2548        public static final String SCREEN_OFF_TIMEOUT = "screen_off_timeout";
2549
2550        private static final Validator SCREEN_OFF_TIMEOUT_VALIDATOR = sNonNegativeIntegerValidator;
2551
2552        /**
2553         * The screen backlight brightness between 0 and 255.
2554         */
2555        public static final String SCREEN_BRIGHTNESS = "screen_brightness";
2556
2557        private static final Validator SCREEN_BRIGHTNESS_VALIDATOR =
2558                new InclusiveIntegerRangeValidator(0, 255);
2559
2560        /**
2561         * Control whether to enable automatic brightness mode.
2562         */
2563        public static final String SCREEN_BRIGHTNESS_MODE = "screen_brightness_mode";
2564
2565        private static final Validator SCREEN_BRIGHTNESS_MODE_VALIDATOR = sBooleanValidator;
2566
2567        /**
2568         * Adjustment to auto-brightness to make it generally more (>0.0 <1.0)
2569         * or less (<0.0 >-1.0) bright.
2570         * @hide
2571         */
2572        public static final String SCREEN_AUTO_BRIGHTNESS_ADJ = "screen_auto_brightness_adj";
2573
2574        private static final Validator SCREEN_AUTO_BRIGHTNESS_ADJ_VALIDATOR =
2575                new InclusiveFloatRangeValidator(-1, 1);
2576
2577        /**
2578         * SCREEN_BRIGHTNESS_MODE value for manual mode.
2579         */
2580        public static final int SCREEN_BRIGHTNESS_MODE_MANUAL = 0;
2581
2582        /**
2583         * SCREEN_BRIGHTNESS_MODE value for automatic mode.
2584         */
2585        public static final int SCREEN_BRIGHTNESS_MODE_AUTOMATIC = 1;
2586
2587        /**
2588         * Control whether the process CPU usage meter should be shown.
2589         *
2590         * @deprecated Use {@link Global#SHOW_PROCESSES} instead
2591         */
2592        @Deprecated
2593        public static final String SHOW_PROCESSES = Global.SHOW_PROCESSES;
2594
2595        /**
2596         * If 1, the activity manager will aggressively finish activities and
2597         * processes as soon as they are no longer needed.  If 0, the normal
2598         * extended lifetime is used.
2599         *
2600         * @deprecated Use {@link Global#ALWAYS_FINISH_ACTIVITIES} instead
2601         */
2602        @Deprecated
2603        public static final String ALWAYS_FINISH_ACTIVITIES = Global.ALWAYS_FINISH_ACTIVITIES;
2604
2605        /**
2606         * Determines which streams are affected by ringer mode changes. The
2607         * stream type's bit should be set to 1 if it should be muted when going
2608         * into an inaudible ringer mode.
2609         */
2610        public static final String MODE_RINGER_STREAMS_AFFECTED = "mode_ringer_streams_affected";
2611
2612        private static final Validator MODE_RINGER_STREAMS_AFFECTED_VALIDATOR =
2613                sNonNegativeIntegerValidator;
2614
2615        /**
2616          * Determines which streams are affected by mute. The
2617          * stream type's bit should be set to 1 if it should be muted when a mute request
2618          * is received.
2619          */
2620        public static final String MUTE_STREAMS_AFFECTED = "mute_streams_affected";
2621
2622        private static final Validator MUTE_STREAMS_AFFECTED_VALIDATOR =
2623                sNonNegativeIntegerValidator;
2624
2625        /**
2626         * Whether vibrate is on for different events. This is used internally,
2627         * changing this value will not change the vibrate. See AudioManager.
2628         */
2629        public static final String VIBRATE_ON = "vibrate_on";
2630
2631        private static final Validator VIBRATE_ON_VALIDATOR = sBooleanValidator;
2632
2633        /**
2634         * If 1, redirects the system vibrator to all currently attached input devices
2635         * that support vibration.  If there are no such input devices, then the system
2636         * vibrator is used instead.
2637         * If 0, does not register the system vibrator.
2638         *
2639         * This setting is mainly intended to provide a compatibility mechanism for
2640         * applications that only know about the system vibrator and do not use the
2641         * input device vibrator API.
2642         *
2643         * @hide
2644         */
2645        public static final String VIBRATE_INPUT_DEVICES = "vibrate_input_devices";
2646
2647        private static final Validator VIBRATE_INPUT_DEVICES_VALIDATOR = sBooleanValidator;
2648
2649        /**
2650         * Ringer volume. This is used internally, changing this value will not
2651         * change the volume. See AudioManager.
2652         *
2653         * @removed Not used by anything since API 2.
2654         */
2655        public static final String VOLUME_RING = "volume_ring";
2656
2657        /**
2658         * System/notifications volume. This is used internally, changing this
2659         * value will not change the volume. See AudioManager.
2660         *
2661         * @removed Not used by anything since API 2.
2662         */
2663        public static final String VOLUME_SYSTEM = "volume_system";
2664
2665        /**
2666         * Voice call volume. This is used internally, changing this value will
2667         * not change the volume. See AudioManager.
2668         *
2669         * @removed Not used by anything since API 2.
2670         */
2671        public static final String VOLUME_VOICE = "volume_voice";
2672
2673        /**
2674         * Music/media/gaming volume. This is used internally, changing this
2675         * value will not change the volume. See AudioManager.
2676         *
2677         * @removed Not used by anything since API 2.
2678         */
2679        public static final String VOLUME_MUSIC = "volume_music";
2680
2681        /**
2682         * Alarm volume. This is used internally, changing this
2683         * value will not change the volume. See AudioManager.
2684         *
2685         * @removed Not used by anything since API 2.
2686         */
2687        public static final String VOLUME_ALARM = "volume_alarm";
2688
2689        /**
2690         * Notification volume. This is used internally, changing this
2691         * value will not change the volume. See AudioManager.
2692         *
2693         * @removed Not used by anything since API 2.
2694         */
2695        public static final String VOLUME_NOTIFICATION = "volume_notification";
2696
2697        /**
2698         * Bluetooth Headset volume. This is used internally, changing this value will
2699         * not change the volume. See AudioManager.
2700         *
2701         * @removed Not used by anything since API 2.
2702         */
2703        public static final String VOLUME_BLUETOOTH_SCO = "volume_bluetooth_sco";
2704
2705        /**
2706         * Master volume (float in the range 0.0f to 1.0f).
2707         *
2708         * @hide
2709         */
2710        public static final String VOLUME_MASTER = "volume_master";
2711
2712        /**
2713         * Master volume mute (int 1 = mute, 0 = not muted).
2714         *
2715         * @hide
2716         */
2717        public static final String VOLUME_MASTER_MUTE = "volume_master_mute";
2718
2719        private static final Validator VOLUME_MASTER_MUTE_VALIDATOR = sBooleanValidator;
2720
2721        /**
2722         * Microphone mute (int 1 = mute, 0 = not muted).
2723         *
2724         * @hide
2725         */
2726        public static final String MICROPHONE_MUTE = "microphone_mute";
2727
2728        private static final Validator MICROPHONE_MUTE_VALIDATOR = sBooleanValidator;
2729
2730        /**
2731         * Master mono (int 1 = mono, 0 = normal).
2732         *
2733         * @hide
2734         */
2735        public static final String MASTER_MONO = "master_mono";
2736
2737        private static final Validator MASTER_MONO_VALIDATOR = sBooleanValidator;
2738
2739        /**
2740         * Whether the notifications should use the ring volume (value of 1) or
2741         * a separate notification volume (value of 0). In most cases, users
2742         * will have this enabled so the notification and ringer volumes will be
2743         * the same. However, power users can disable this and use the separate
2744         * notification volume control.
2745         * <p>
2746         * Note: This is a one-off setting that will be removed in the future
2747         * when there is profile support. For this reason, it is kept hidden
2748         * from the public APIs.
2749         *
2750         * @hide
2751         * @deprecated
2752         */
2753        @Deprecated
2754        public static final String NOTIFICATIONS_USE_RING_VOLUME =
2755            "notifications_use_ring_volume";
2756
2757        private static final Validator NOTIFICATIONS_USE_RING_VOLUME_VALIDATOR = sBooleanValidator;
2758
2759        /**
2760         * Whether silent mode should allow vibration feedback. This is used
2761         * internally in AudioService and the Sound settings activity to
2762         * coordinate decoupling of vibrate and silent modes. This setting
2763         * will likely be removed in a future release with support for
2764         * audio/vibe feedback profiles.
2765         *
2766         * Not used anymore. On devices with vibrator, the user explicitly selects
2767         * silent or vibrate mode.
2768         * Kept for use by legacy database upgrade code in DatabaseHelper.
2769         * @hide
2770         */
2771        public static final String VIBRATE_IN_SILENT = "vibrate_in_silent";
2772
2773        private static final Validator VIBRATE_IN_SILENT_VALIDATOR = sBooleanValidator;
2774
2775        /**
2776         * The mapping of stream type (integer) to its setting.
2777         *
2778         * @removed  Not used by anything since API 2.
2779         */
2780        public static final String[] VOLUME_SETTINGS = {
2781            VOLUME_VOICE, VOLUME_SYSTEM, VOLUME_RING, VOLUME_MUSIC,
2782            VOLUME_ALARM, VOLUME_NOTIFICATION, VOLUME_BLUETOOTH_SCO
2783        };
2784
2785        /**
2786         * Appended to various volume related settings to record the previous
2787         * values before they the settings were affected by a silent/vibrate
2788         * ringer mode change.
2789         *
2790         * @removed  Not used by anything since API 2.
2791         */
2792        public static final String APPEND_FOR_LAST_AUDIBLE = "_last_audible";
2793
2794        /**
2795         * Persistent store for the system-wide default ringtone URI.
2796         * <p>
2797         * If you need to play the default ringtone at any given time, it is recommended
2798         * you give {@link #DEFAULT_RINGTONE_URI} to the media player.  It will resolve
2799         * to the set default ringtone at the time of playing.
2800         *
2801         * @see #DEFAULT_RINGTONE_URI
2802         */
2803        public static final String RINGTONE = "ringtone";
2804
2805        private static final Validator RINGTONE_VALIDATOR = sUriValidator;
2806
2807        /**
2808         * A {@link Uri} that will point to the current default ringtone at any
2809         * given time.
2810         * <p>
2811         * If the current default ringtone is in the DRM provider and the caller
2812         * does not have permission, the exception will be a
2813         * FileNotFoundException.
2814         */
2815        public static final Uri DEFAULT_RINGTONE_URI = getUriFor(RINGTONE);
2816
2817        /** {@hide} */
2818        public static final String RINGTONE_CACHE = "ringtone_cache";
2819        /** {@hide} */
2820        public static final Uri RINGTONE_CACHE_URI = getUriFor(RINGTONE_CACHE);
2821
2822        /**
2823         * Persistent store for the system-wide default notification sound.
2824         *
2825         * @see #RINGTONE
2826         * @see #DEFAULT_NOTIFICATION_URI
2827         */
2828        public static final String NOTIFICATION_SOUND = "notification_sound";
2829
2830        private static final Validator NOTIFICATION_SOUND_VALIDATOR = sUriValidator;
2831
2832        /**
2833         * A {@link Uri} that will point to the current default notification
2834         * sound at any given time.
2835         *
2836         * @see #DEFAULT_RINGTONE_URI
2837         */
2838        public static final Uri DEFAULT_NOTIFICATION_URI = getUriFor(NOTIFICATION_SOUND);
2839
2840        /** {@hide} */
2841        public static final String NOTIFICATION_SOUND_CACHE = "notification_sound_cache";
2842        /** {@hide} */
2843        public static final Uri NOTIFICATION_SOUND_CACHE_URI = getUriFor(NOTIFICATION_SOUND_CACHE);
2844
2845        /**
2846         * Persistent store for the system-wide default alarm alert.
2847         *
2848         * @see #RINGTONE
2849         * @see #DEFAULT_ALARM_ALERT_URI
2850         */
2851        public static final String ALARM_ALERT = "alarm_alert";
2852
2853        private static final Validator ALARM_ALERT_VALIDATOR = sUriValidator;
2854
2855        /**
2856         * A {@link Uri} that will point to the current default alarm alert at
2857         * any given time.
2858         *
2859         * @see #DEFAULT_ALARM_ALERT_URI
2860         */
2861        public static final Uri DEFAULT_ALARM_ALERT_URI = getUriFor(ALARM_ALERT);
2862
2863        /** {@hide} */
2864        public static final String ALARM_ALERT_CACHE = "alarm_alert_cache";
2865        /** {@hide} */
2866        public static final Uri ALARM_ALERT_CACHE_URI = getUriFor(ALARM_ALERT_CACHE);
2867
2868        /**
2869         * Persistent store for the system default media button event receiver.
2870         *
2871         * @hide
2872         */
2873        public static final String MEDIA_BUTTON_RECEIVER = "media_button_receiver";
2874
2875        private static final Validator MEDIA_BUTTON_RECEIVER_VALIDATOR = new Validator() {
2876            @Override
2877            public boolean validate(String value) {
2878                try {
2879                    ComponentName.unflattenFromString(value);
2880                    return true;
2881                } catch (NullPointerException e) {
2882                    return false;
2883                }
2884            }
2885        };
2886
2887        /**
2888         * Setting to enable Auto Replace (AutoText) in text editors. 1 = On, 0 = Off
2889         */
2890        public static final String TEXT_AUTO_REPLACE = "auto_replace";
2891
2892        private static final Validator TEXT_AUTO_REPLACE_VALIDATOR = sBooleanValidator;
2893
2894        /**
2895         * Setting to enable Auto Caps in text editors. 1 = On, 0 = Off
2896         */
2897        public static final String TEXT_AUTO_CAPS = "auto_caps";
2898
2899        private static final Validator TEXT_AUTO_CAPS_VALIDATOR = sBooleanValidator;
2900
2901        /**
2902         * Setting to enable Auto Punctuate in text editors. 1 = On, 0 = Off. This
2903         * feature converts two spaces to a "." and space.
2904         */
2905        public static final String TEXT_AUTO_PUNCTUATE = "auto_punctuate";
2906
2907        private static final Validator TEXT_AUTO_PUNCTUATE_VALIDATOR = sBooleanValidator;
2908
2909        /**
2910         * Setting to showing password characters in text editors. 1 = On, 0 = Off
2911         */
2912        public static final String TEXT_SHOW_PASSWORD = "show_password";
2913
2914        private static final Validator TEXT_SHOW_PASSWORD_VALIDATOR = sBooleanValidator;
2915
2916        public static final String SHOW_GTALK_SERVICE_STATUS =
2917                "SHOW_GTALK_SERVICE_STATUS";
2918
2919        private static final Validator SHOW_GTALK_SERVICE_STATUS_VALIDATOR = sBooleanValidator;
2920
2921        /**
2922         * Name of activity to use for wallpaper on the home screen.
2923         *
2924         * @deprecated Use {@link WallpaperManager} instead.
2925         */
2926        @Deprecated
2927        public static final String WALLPAPER_ACTIVITY = "wallpaper_activity";
2928
2929        private static final Validator WALLPAPER_ACTIVITY_VALIDATOR = new Validator() {
2930            private static final int MAX_LENGTH = 1000;
2931
2932            @Override
2933            public boolean validate(String value) {
2934                if (value != null && value.length() > MAX_LENGTH) {
2935                    return false;
2936                }
2937                return ComponentName.unflattenFromString(value) != null;
2938            }
2939        };
2940
2941        /**
2942         * @deprecated Use {@link android.provider.Settings.Global#AUTO_TIME}
2943         * instead
2944         */
2945        @Deprecated
2946        public static final String AUTO_TIME = Global.AUTO_TIME;
2947
2948        /**
2949         * @deprecated Use {@link android.provider.Settings.Global#AUTO_TIME_ZONE}
2950         * instead
2951         */
2952        @Deprecated
2953        public static final String AUTO_TIME_ZONE = Global.AUTO_TIME_ZONE;
2954
2955        /**
2956         * Display times as 12 or 24 hours
2957         *   12
2958         *   24
2959         */
2960        public static final String TIME_12_24 = "time_12_24";
2961
2962        /** @hide */
2963        public static final Validator TIME_12_24_VALIDATOR =
2964                new DiscreteValueValidator(new String[] {"12", "24"});
2965
2966        /**
2967         * Date format string
2968         *   mm/dd/yyyy
2969         *   dd/mm/yyyy
2970         *   yyyy/mm/dd
2971         */
2972        public static final String DATE_FORMAT = "date_format";
2973
2974        /** @hide */
2975        public static final Validator DATE_FORMAT_VALIDATOR = new Validator() {
2976            @Override
2977            public boolean validate(String value) {
2978                try {
2979                    new SimpleDateFormat(value);
2980                    return true;
2981                } catch (IllegalArgumentException e) {
2982                    return false;
2983                }
2984            }
2985        };
2986
2987        /**
2988         * Whether the setup wizard has been run before (on first boot), or if
2989         * it still needs to be run.
2990         *
2991         * nonzero = it has been run in the past
2992         * 0 = it has not been run in the past
2993         */
2994        public static final String SETUP_WIZARD_HAS_RUN = "setup_wizard_has_run";
2995
2996        /** @hide */
2997        public static final Validator SETUP_WIZARD_HAS_RUN_VALIDATOR = sBooleanValidator;
2998
2999        /**
3000         * Scaling factor for normal window animations. Setting to 0 will disable window
3001         * animations.
3002         *
3003         * @deprecated Use {@link Global#WINDOW_ANIMATION_SCALE} instead
3004         */
3005        @Deprecated
3006        public static final String WINDOW_ANIMATION_SCALE = Global.WINDOW_ANIMATION_SCALE;
3007
3008        /**
3009         * Scaling factor for activity transition animations. Setting to 0 will disable window
3010         * animations.
3011         *
3012         * @deprecated Use {@link Global#TRANSITION_ANIMATION_SCALE} instead
3013         */
3014        @Deprecated
3015        public static final String TRANSITION_ANIMATION_SCALE = Global.TRANSITION_ANIMATION_SCALE;
3016
3017        /**
3018         * Scaling factor for Animator-based animations. This affects both the start delay and
3019         * duration of all such animations. Setting to 0 will cause animations to end immediately.
3020         * The default value is 1.
3021         *
3022         * @deprecated Use {@link Global#ANIMATOR_DURATION_SCALE} instead
3023         */
3024        @Deprecated
3025        public static final String ANIMATOR_DURATION_SCALE = Global.ANIMATOR_DURATION_SCALE;
3026
3027        /**
3028         * Control whether the accelerometer will be used to change screen
3029         * orientation.  If 0, it will not be used unless explicitly requested
3030         * by the application; if 1, it will be used by default unless explicitly
3031         * disabled by the application.
3032         */
3033        public static final String ACCELEROMETER_ROTATION = "accelerometer_rotation";
3034
3035        /** @hide */
3036        public static final Validator ACCELEROMETER_ROTATION_VALIDATOR = sBooleanValidator;
3037
3038        /**
3039         * Default screen rotation when no other policy applies.
3040         * When {@link #ACCELEROMETER_ROTATION} is zero and no on-screen Activity expresses a
3041         * preference, this rotation value will be used. Must be one of the
3042         * {@link android.view.Surface#ROTATION_0 Surface rotation constants}.
3043         *
3044         * @see android.view.Display#getRotation
3045         */
3046        public static final String USER_ROTATION = "user_rotation";
3047
3048        /** @hide */
3049        public static final Validator USER_ROTATION_VALIDATOR =
3050                new InclusiveIntegerRangeValidator(0, 3);
3051
3052        /**
3053         * Control whether the rotation lock toggle in the System UI should be hidden.
3054         * Typically this is done for accessibility purposes to make it harder for
3055         * the user to accidentally toggle the rotation lock while the display rotation
3056         * has been locked for accessibility.
3057         *
3058         * If 0, then rotation lock toggle is not hidden for accessibility (although it may be
3059         * unavailable for other reasons).  If 1, then the rotation lock toggle is hidden.
3060         *
3061         * @hide
3062         */
3063        public static final String HIDE_ROTATION_LOCK_TOGGLE_FOR_ACCESSIBILITY =
3064                "hide_rotation_lock_toggle_for_accessibility";
3065
3066        /** @hide */
3067        public static final Validator HIDE_ROTATION_LOCK_TOGGLE_FOR_ACCESSIBILITY_VALIDATOR =
3068                sBooleanValidator;
3069
3070        /**
3071         * Whether the phone vibrates when it is ringing due to an incoming call. This will
3072         * be used by Phone and Setting apps; it shouldn't affect other apps.
3073         * The value is boolean (1 or 0).
3074         *
3075         * Note: this is not same as "vibrate on ring", which had been available until ICS.
3076         * It was about AudioManager's setting and thus affected all the applications which
3077         * relied on the setting, while this is purely about the vibration setting for incoming
3078         * calls.
3079         */
3080        public static final String VIBRATE_WHEN_RINGING = "vibrate_when_ringing";
3081
3082        /** @hide */
3083        public static final Validator VIBRATE_WHEN_RINGING_VALIDATOR = sBooleanValidator;
3084
3085        /**
3086         * Whether the audible DTMF tones are played by the dialer when dialing. The value is
3087         * boolean (1 or 0).
3088         */
3089        public static final String DTMF_TONE_WHEN_DIALING = "dtmf_tone";
3090
3091        /** @hide */
3092        public static final Validator DTMF_TONE_WHEN_DIALING_VALIDATOR = sBooleanValidator;
3093
3094        /**
3095         * CDMA only settings
3096         * DTMF tone type played by the dialer when dialing.
3097         *                 0 = Normal
3098         *                 1 = Long
3099         */
3100        public static final String DTMF_TONE_TYPE_WHEN_DIALING = "dtmf_tone_type";
3101
3102        /** @hide */
3103        public static final Validator DTMF_TONE_TYPE_WHEN_DIALING_VALIDATOR = sBooleanValidator;
3104
3105        /**
3106         * Whether the hearing aid is enabled. The value is
3107         * boolean (1 or 0).
3108         * @hide
3109         */
3110        public static final String HEARING_AID = "hearing_aid";
3111
3112        /** @hide */
3113        public static final Validator HEARING_AID_VALIDATOR = sBooleanValidator;
3114
3115        /**
3116         * CDMA only settings
3117         * TTY Mode
3118         * 0 = OFF
3119         * 1 = FULL
3120         * 2 = VCO
3121         * 3 = HCO
3122         * @hide
3123         */
3124        public static final String TTY_MODE = "tty_mode";
3125
3126        /** @hide */
3127        public static final Validator TTY_MODE_VALIDATOR = new InclusiveIntegerRangeValidator(0, 3);
3128
3129        /**
3130         * Whether the sounds effects (key clicks, lid open ...) are enabled. The value is
3131         * boolean (1 or 0).
3132         */
3133        public static final String SOUND_EFFECTS_ENABLED = "sound_effects_enabled";
3134
3135        /** @hide */
3136        public static final Validator SOUND_EFFECTS_ENABLED_VALIDATOR = sBooleanValidator;
3137
3138        /**
3139         * Whether the haptic feedback (long presses, ...) are enabled. The value is
3140         * boolean (1 or 0).
3141         */
3142        public static final String HAPTIC_FEEDBACK_ENABLED = "haptic_feedback_enabled";
3143
3144        /** @hide */
3145        public static final Validator HAPTIC_FEEDBACK_ENABLED_VALIDATOR = sBooleanValidator;
3146
3147        /**
3148         * @deprecated Each application that shows web suggestions should have its own
3149         * setting for this.
3150         */
3151        @Deprecated
3152        public static final String SHOW_WEB_SUGGESTIONS = "show_web_suggestions";
3153
3154        /** @hide */
3155        public static final Validator SHOW_WEB_SUGGESTIONS_VALIDATOR = sBooleanValidator;
3156
3157        /**
3158         * Whether the notification LED should repeatedly flash when a notification is
3159         * pending. The value is boolean (1 or 0).
3160         * @hide
3161         */
3162        public static final String NOTIFICATION_LIGHT_PULSE = "notification_light_pulse";
3163
3164        /** @hide */
3165        public static final Validator NOTIFICATION_LIGHT_PULSE_VALIDATOR = sBooleanValidator;
3166
3167        /**
3168         * Show pointer location on screen?
3169         * 0 = no
3170         * 1 = yes
3171         * @hide
3172         */
3173        public static final String POINTER_LOCATION = "pointer_location";
3174
3175        /** @hide */
3176        public static final Validator POINTER_LOCATION_VALIDATOR = sBooleanValidator;
3177
3178        /**
3179         * Show touch positions on screen?
3180         * 0 = no
3181         * 1 = yes
3182         * @hide
3183         */
3184        public static final String SHOW_TOUCHES = "show_touches";
3185
3186        /** @hide */
3187        public static final Validator SHOW_TOUCHES_VALIDATOR = sBooleanValidator;
3188
3189        /**
3190         * Log raw orientation data from
3191         * {@link com.android.server.policy.WindowOrientationListener} for use with the
3192         * orientationplot.py tool.
3193         * 0 = no
3194         * 1 = yes
3195         * @hide
3196         */
3197        public static final String WINDOW_ORIENTATION_LISTENER_LOG =
3198                "window_orientation_listener_log";
3199
3200        /** @hide */
3201        public static final Validator WINDOW_ORIENTATION_LISTENER_LOG_VALIDATOR = sBooleanValidator;
3202
3203        /**
3204         * @deprecated Use {@link android.provider.Settings.Global#POWER_SOUNDS_ENABLED}
3205         * instead
3206         * @hide
3207         */
3208        @Deprecated
3209        public static final String POWER_SOUNDS_ENABLED = Global.POWER_SOUNDS_ENABLED;
3210
3211        /**
3212         * @deprecated Use {@link android.provider.Settings.Global#DOCK_SOUNDS_ENABLED}
3213         * instead
3214         * @hide
3215         */
3216        @Deprecated
3217        public static final String DOCK_SOUNDS_ENABLED = Global.DOCK_SOUNDS_ENABLED;
3218
3219        /**
3220         * Whether to play sounds when the keyguard is shown and dismissed.
3221         * @hide
3222         */
3223        public static final String LOCKSCREEN_SOUNDS_ENABLED = "lockscreen_sounds_enabled";
3224
3225        /** @hide */
3226        public static final Validator LOCKSCREEN_SOUNDS_ENABLED_VALIDATOR = sBooleanValidator;
3227
3228        /**
3229         * Whether the lockscreen should be completely disabled.
3230         * @hide
3231         */
3232        public static final String LOCKSCREEN_DISABLED = "lockscreen.disabled";
3233
3234        /** @hide */
3235        public static final Validator LOCKSCREEN_DISABLED_VALIDATOR = sBooleanValidator;
3236
3237        /**
3238         * @deprecated Use {@link android.provider.Settings.Global#LOW_BATTERY_SOUND}
3239         * instead
3240         * @hide
3241         */
3242        @Deprecated
3243        public static final String LOW_BATTERY_SOUND = Global.LOW_BATTERY_SOUND;
3244
3245        /**
3246         * @deprecated Use {@link android.provider.Settings.Global#DESK_DOCK_SOUND}
3247         * instead
3248         * @hide
3249         */
3250        @Deprecated
3251        public static final String DESK_DOCK_SOUND = Global.DESK_DOCK_SOUND;
3252
3253        /**
3254         * @deprecated Use {@link android.provider.Settings.Global#DESK_UNDOCK_SOUND}
3255         * instead
3256         * @hide
3257         */
3258        @Deprecated
3259        public static final String DESK_UNDOCK_SOUND = Global.DESK_UNDOCK_SOUND;
3260
3261        /**
3262         * @deprecated Use {@link android.provider.Settings.Global#CAR_DOCK_SOUND}
3263         * instead
3264         * @hide
3265         */
3266        @Deprecated
3267        public static final String CAR_DOCK_SOUND = Global.CAR_DOCK_SOUND;
3268
3269        /**
3270         * @deprecated Use {@link android.provider.Settings.Global#CAR_UNDOCK_SOUND}
3271         * instead
3272         * @hide
3273         */
3274        @Deprecated
3275        public static final String CAR_UNDOCK_SOUND = Global.CAR_UNDOCK_SOUND;
3276
3277        /**
3278         * @deprecated Use {@link android.provider.Settings.Global#LOCK_SOUND}
3279         * instead
3280         * @hide
3281         */
3282        @Deprecated
3283        public static final String LOCK_SOUND = Global.LOCK_SOUND;
3284
3285        /**
3286         * @deprecated Use {@link android.provider.Settings.Global#UNLOCK_SOUND}
3287         * instead
3288         * @hide
3289         */
3290        @Deprecated
3291        public static final String UNLOCK_SOUND = Global.UNLOCK_SOUND;
3292
3293        /**
3294         * Receive incoming SIP calls?
3295         * 0 = no
3296         * 1 = yes
3297         * @hide
3298         */
3299        public static final String SIP_RECEIVE_CALLS = "sip_receive_calls";
3300
3301        /** @hide */
3302        public static final Validator SIP_RECEIVE_CALLS_VALIDATOR = sBooleanValidator;
3303
3304        /**
3305         * Call Preference String.
3306         * "SIP_ALWAYS" : Always use SIP with network access
3307         * "SIP_ADDRESS_ONLY" : Only if destination is a SIP address
3308         * @hide
3309         */
3310        public static final String SIP_CALL_OPTIONS = "sip_call_options";
3311
3312        /** @hide */
3313        public static final Validator SIP_CALL_OPTIONS_VALIDATOR = new DiscreteValueValidator(
3314                new String[] {"SIP_ALWAYS", "SIP_ADDRESS_ONLY"});
3315
3316        /**
3317         * One of the sip call options: Always use SIP with network access.
3318         * @hide
3319         */
3320        public static final String SIP_ALWAYS = "SIP_ALWAYS";
3321
3322        /** @hide */
3323        public static final Validator SIP_ALWAYS_VALIDATOR = sBooleanValidator;
3324
3325        /**
3326         * One of the sip call options: Only if destination is a SIP address.
3327         * @hide
3328         */
3329        public static final String SIP_ADDRESS_ONLY = "SIP_ADDRESS_ONLY";
3330
3331        /** @hide */
3332        public static final Validator SIP_ADDRESS_ONLY_VALIDATOR = sBooleanValidator;
3333
3334        /**
3335         * @deprecated Use SIP_ALWAYS or SIP_ADDRESS_ONLY instead.  Formerly used to indicate that
3336         * the user should be prompted each time a call is made whether it should be placed using
3337         * SIP.  The {@link com.android.providers.settings.DatabaseHelper} replaces this with
3338         * SIP_ADDRESS_ONLY.
3339         * @hide
3340         */
3341        @Deprecated
3342        public static final String SIP_ASK_ME_EACH_TIME = "SIP_ASK_ME_EACH_TIME";
3343
3344        /** @hide */
3345        public static final Validator SIP_ASK_ME_EACH_TIME_VALIDATOR = sBooleanValidator;
3346
3347        /**
3348         * Pointer speed setting.
3349         * This is an integer value in a range between -7 and +7, so there are 15 possible values.
3350         *   -7 = slowest
3351         *    0 = default speed
3352         *   +7 = fastest
3353         * @hide
3354         */
3355        public static final String POINTER_SPEED = "pointer_speed";
3356
3357        /** @hide */
3358        public static final Validator POINTER_SPEED_VALIDATOR =
3359                new InclusiveFloatRangeValidator(-7, 7);
3360
3361        /**
3362         * Whether lock-to-app will be triggered by long-press on recents.
3363         * @hide
3364         */
3365        public static final String LOCK_TO_APP_ENABLED = "lock_to_app_enabled";
3366
3367        /** @hide */
3368        public static final Validator LOCK_TO_APP_ENABLED_VALIDATOR = sBooleanValidator;
3369
3370        /**
3371         * I am the lolrus.
3372         * <p>
3373         * Nonzero values indicate that the user has a bukkit.
3374         * Backward-compatible with <code>PrefGetPreference(prefAllowEasterEggs)</code>.
3375         * @hide
3376         */
3377        public static final String EGG_MODE = "egg_mode";
3378
3379        /** @hide */
3380        public static final Validator EGG_MODE_VALIDATOR = new Validator() {
3381            @Override
3382            public boolean validate(String value) {
3383                try {
3384                    return Long.parseLong(value) >= 0;
3385                } catch (NumberFormatException e) {
3386                    return false;
3387                }
3388            }
3389        };
3390
3391        /**
3392         * IMPORTANT: If you add a new public settings you also have to add it to
3393         * PUBLIC_SETTINGS below. If the new setting is hidden you have to add
3394         * it to PRIVATE_SETTINGS below. Also add a validator that can validate
3395         * the setting value. See an example above.
3396         */
3397
3398        /**
3399         * Settings to backup. This is here so that it's in the same place as the settings
3400         * keys and easy to update.
3401         *
3402         * NOTE: Settings are backed up and restored in the order they appear
3403         *       in this array. If you have one setting depending on another,
3404         *       make sure that they are ordered appropriately.
3405         *
3406         * @hide
3407         */
3408        public static final String[] SETTINGS_TO_BACKUP = {
3409            STAY_ON_WHILE_PLUGGED_IN,   // moved to global
3410            WIFI_USE_STATIC_IP,
3411            WIFI_STATIC_IP,
3412            WIFI_STATIC_GATEWAY,
3413            WIFI_STATIC_NETMASK,
3414            WIFI_STATIC_DNS1,
3415            WIFI_STATIC_DNS2,
3416            BLUETOOTH_DISCOVERABILITY,
3417            BLUETOOTH_DISCOVERABILITY_TIMEOUT,
3418            FONT_SCALE,
3419            DIM_SCREEN,
3420            SCREEN_OFF_TIMEOUT,
3421            SCREEN_BRIGHTNESS,
3422            SCREEN_BRIGHTNESS_MODE,
3423            SCREEN_AUTO_BRIGHTNESS_ADJ,
3424            VIBRATE_INPUT_DEVICES,
3425            MODE_RINGER_STREAMS_AFFECTED,
3426            TEXT_AUTO_REPLACE,
3427            TEXT_AUTO_CAPS,
3428            TEXT_AUTO_PUNCTUATE,
3429            TEXT_SHOW_PASSWORD,
3430            AUTO_TIME,                  // moved to global
3431            AUTO_TIME_ZONE,             // moved to global
3432            TIME_12_24,
3433            DATE_FORMAT,
3434            DTMF_TONE_WHEN_DIALING,
3435            DTMF_TONE_TYPE_WHEN_DIALING,
3436            HEARING_AID,
3437            TTY_MODE,
3438            SOUND_EFFECTS_ENABLED,
3439            HAPTIC_FEEDBACK_ENABLED,
3440            POWER_SOUNDS_ENABLED,       // moved to global
3441            DOCK_SOUNDS_ENABLED,        // moved to global
3442            LOCKSCREEN_SOUNDS_ENABLED,
3443            SHOW_WEB_SUGGESTIONS,
3444            SIP_CALL_OPTIONS,
3445            SIP_RECEIVE_CALLS,
3446            POINTER_SPEED,
3447            VIBRATE_WHEN_RINGING,
3448            RINGTONE,
3449            LOCK_TO_APP_ENABLED,
3450            NOTIFICATION_SOUND,
3451            ACCELEROMETER_ROTATION
3452        };
3453
3454        /**
3455         * These are all public system settings
3456         *
3457         * @hide
3458         */
3459        public static final Set<String> PUBLIC_SETTINGS = new ArraySet<>();
3460        static {
3461            PUBLIC_SETTINGS.add(END_BUTTON_BEHAVIOR);
3462            PUBLIC_SETTINGS.add(WIFI_USE_STATIC_IP);
3463            PUBLIC_SETTINGS.add(WIFI_STATIC_IP);
3464            PUBLIC_SETTINGS.add(WIFI_STATIC_GATEWAY);
3465            PUBLIC_SETTINGS.add(WIFI_STATIC_NETMASK);
3466            PUBLIC_SETTINGS.add(WIFI_STATIC_DNS1);
3467            PUBLIC_SETTINGS.add(WIFI_STATIC_DNS2);
3468            PUBLIC_SETTINGS.add(BLUETOOTH_DISCOVERABILITY);
3469            PUBLIC_SETTINGS.add(BLUETOOTH_DISCOVERABILITY_TIMEOUT);
3470            PUBLIC_SETTINGS.add(NEXT_ALARM_FORMATTED);
3471            PUBLIC_SETTINGS.add(FONT_SCALE);
3472            PUBLIC_SETTINGS.add(DIM_SCREEN);
3473            PUBLIC_SETTINGS.add(SCREEN_OFF_TIMEOUT);
3474            PUBLIC_SETTINGS.add(SCREEN_BRIGHTNESS);
3475            PUBLIC_SETTINGS.add(SCREEN_BRIGHTNESS_MODE);
3476            PUBLIC_SETTINGS.add(MODE_RINGER_STREAMS_AFFECTED);
3477            PUBLIC_SETTINGS.add(MUTE_STREAMS_AFFECTED);
3478            PUBLIC_SETTINGS.add(VIBRATE_ON);
3479            PUBLIC_SETTINGS.add(VOLUME_RING);
3480            PUBLIC_SETTINGS.add(VOLUME_SYSTEM);
3481            PUBLIC_SETTINGS.add(VOLUME_VOICE);
3482            PUBLIC_SETTINGS.add(VOLUME_MUSIC);
3483            PUBLIC_SETTINGS.add(VOLUME_ALARM);
3484            PUBLIC_SETTINGS.add(VOLUME_NOTIFICATION);
3485            PUBLIC_SETTINGS.add(VOLUME_BLUETOOTH_SCO);
3486            PUBLIC_SETTINGS.add(RINGTONE);
3487            PUBLIC_SETTINGS.add(NOTIFICATION_SOUND);
3488            PUBLIC_SETTINGS.add(ALARM_ALERT);
3489            PUBLIC_SETTINGS.add(TEXT_AUTO_REPLACE);
3490            PUBLIC_SETTINGS.add(TEXT_AUTO_CAPS);
3491            PUBLIC_SETTINGS.add(TEXT_AUTO_PUNCTUATE);
3492            PUBLIC_SETTINGS.add(TEXT_SHOW_PASSWORD);
3493            PUBLIC_SETTINGS.add(SHOW_GTALK_SERVICE_STATUS);
3494            PUBLIC_SETTINGS.add(WALLPAPER_ACTIVITY);
3495            PUBLIC_SETTINGS.add(TIME_12_24);
3496            PUBLIC_SETTINGS.add(DATE_FORMAT);
3497            PUBLIC_SETTINGS.add(SETUP_WIZARD_HAS_RUN);
3498            PUBLIC_SETTINGS.add(ACCELEROMETER_ROTATION);
3499            PUBLIC_SETTINGS.add(USER_ROTATION);
3500            PUBLIC_SETTINGS.add(DTMF_TONE_WHEN_DIALING);
3501            PUBLIC_SETTINGS.add(SOUND_EFFECTS_ENABLED);
3502            PUBLIC_SETTINGS.add(HAPTIC_FEEDBACK_ENABLED);
3503            PUBLIC_SETTINGS.add(SHOW_WEB_SUGGESTIONS);
3504            PUBLIC_SETTINGS.add(VIBRATE_WHEN_RINGING);
3505        }
3506
3507        /**
3508         * These are all hidden system settings.
3509         *
3510         * @hide
3511         */
3512        public static final Set<String> PRIVATE_SETTINGS = new ArraySet<>();
3513        static {
3514            PRIVATE_SETTINGS.add(WIFI_USE_STATIC_IP);
3515            PRIVATE_SETTINGS.add(END_BUTTON_BEHAVIOR);
3516            PRIVATE_SETTINGS.add(ADVANCED_SETTINGS);
3517            PRIVATE_SETTINGS.add(SCREEN_AUTO_BRIGHTNESS_ADJ);
3518            PRIVATE_SETTINGS.add(VIBRATE_INPUT_DEVICES);
3519            PRIVATE_SETTINGS.add(VOLUME_MASTER);
3520            PRIVATE_SETTINGS.add(VOLUME_MASTER_MUTE);
3521            PRIVATE_SETTINGS.add(MICROPHONE_MUTE);
3522            PRIVATE_SETTINGS.add(MASTER_MONO);
3523            PRIVATE_SETTINGS.add(NOTIFICATIONS_USE_RING_VOLUME);
3524            PRIVATE_SETTINGS.add(VIBRATE_IN_SILENT);
3525            PRIVATE_SETTINGS.add(MEDIA_BUTTON_RECEIVER);
3526            PRIVATE_SETTINGS.add(HIDE_ROTATION_LOCK_TOGGLE_FOR_ACCESSIBILITY);
3527            PRIVATE_SETTINGS.add(DTMF_TONE_TYPE_WHEN_DIALING);
3528            PRIVATE_SETTINGS.add(HEARING_AID);
3529            PRIVATE_SETTINGS.add(TTY_MODE);
3530            PRIVATE_SETTINGS.add(NOTIFICATION_LIGHT_PULSE);
3531            PRIVATE_SETTINGS.add(POINTER_LOCATION);
3532            PRIVATE_SETTINGS.add(SHOW_TOUCHES);
3533            PRIVATE_SETTINGS.add(WINDOW_ORIENTATION_LISTENER_LOG);
3534            PRIVATE_SETTINGS.add(POWER_SOUNDS_ENABLED);
3535            PRIVATE_SETTINGS.add(DOCK_SOUNDS_ENABLED);
3536            PRIVATE_SETTINGS.add(LOCKSCREEN_SOUNDS_ENABLED);
3537            PRIVATE_SETTINGS.add(LOCKSCREEN_DISABLED);
3538            PRIVATE_SETTINGS.add(LOW_BATTERY_SOUND);
3539            PRIVATE_SETTINGS.add(DESK_DOCK_SOUND);
3540            PRIVATE_SETTINGS.add(DESK_UNDOCK_SOUND);
3541            PRIVATE_SETTINGS.add(CAR_DOCK_SOUND);
3542            PRIVATE_SETTINGS.add(CAR_UNDOCK_SOUND);
3543            PRIVATE_SETTINGS.add(LOCK_SOUND);
3544            PRIVATE_SETTINGS.add(UNLOCK_SOUND);
3545            PRIVATE_SETTINGS.add(SIP_RECEIVE_CALLS);
3546            PRIVATE_SETTINGS.add(SIP_CALL_OPTIONS);
3547            PRIVATE_SETTINGS.add(SIP_ALWAYS);
3548            PRIVATE_SETTINGS.add(SIP_ADDRESS_ONLY);
3549            PRIVATE_SETTINGS.add(SIP_ASK_ME_EACH_TIME);
3550            PRIVATE_SETTINGS.add(POINTER_SPEED);
3551            PRIVATE_SETTINGS.add(LOCK_TO_APP_ENABLED);
3552            PRIVATE_SETTINGS.add(EGG_MODE);
3553        }
3554
3555        /**
3556         * These are all public system settings
3557         *
3558         * @hide
3559         */
3560        public static final Map<String, Validator> VALIDATORS = new ArrayMap<>();
3561        static {
3562            VALIDATORS.put(END_BUTTON_BEHAVIOR,END_BUTTON_BEHAVIOR_VALIDATOR);
3563            VALIDATORS.put(WIFI_USE_STATIC_IP, WIFI_USE_STATIC_IP_VALIDATOR);
3564            VALIDATORS.put(BLUETOOTH_DISCOVERABILITY, BLUETOOTH_DISCOVERABILITY_VALIDATOR);
3565            VALIDATORS.put(BLUETOOTH_DISCOVERABILITY_TIMEOUT,
3566                    BLUETOOTH_DISCOVERABILITY_TIMEOUT_VALIDATOR);
3567            VALIDATORS.put(NEXT_ALARM_FORMATTED, NEXT_ALARM_FORMATTED_VALIDATOR);
3568            VALIDATORS.put(FONT_SCALE, FONT_SCALE_VALIDATOR);
3569            VALIDATORS.put(DIM_SCREEN, DIM_SCREEN_VALIDATOR);
3570            VALIDATORS.put(SCREEN_OFF_TIMEOUT, SCREEN_OFF_TIMEOUT_VALIDATOR);
3571            VALIDATORS.put(SCREEN_BRIGHTNESS, SCREEN_BRIGHTNESS_VALIDATOR);
3572            VALIDATORS.put(SCREEN_BRIGHTNESS_MODE, SCREEN_BRIGHTNESS_MODE_VALIDATOR);
3573            VALIDATORS.put(MODE_RINGER_STREAMS_AFFECTED, MODE_RINGER_STREAMS_AFFECTED_VALIDATOR);
3574            VALIDATORS.put(MUTE_STREAMS_AFFECTED, MUTE_STREAMS_AFFECTED_VALIDATOR);
3575            VALIDATORS.put(VIBRATE_ON, VIBRATE_ON_VALIDATOR);
3576            VALIDATORS.put(RINGTONE, RINGTONE_VALIDATOR);
3577            VALIDATORS.put(NOTIFICATION_SOUND, NOTIFICATION_SOUND_VALIDATOR);
3578            VALIDATORS.put(ALARM_ALERT, ALARM_ALERT_VALIDATOR);
3579            VALIDATORS.put(TEXT_AUTO_REPLACE, TEXT_AUTO_REPLACE_VALIDATOR);
3580            VALIDATORS.put(TEXT_AUTO_CAPS, TEXT_AUTO_CAPS_VALIDATOR);
3581            VALIDATORS.put(TEXT_AUTO_PUNCTUATE, TEXT_AUTO_PUNCTUATE_VALIDATOR);
3582            VALIDATORS.put(TEXT_SHOW_PASSWORD, TEXT_SHOW_PASSWORD_VALIDATOR);
3583            VALIDATORS.put(SHOW_GTALK_SERVICE_STATUS, SHOW_GTALK_SERVICE_STATUS_VALIDATOR);
3584            VALIDATORS.put(WALLPAPER_ACTIVITY, WALLPAPER_ACTIVITY_VALIDATOR);
3585            VALIDATORS.put(TIME_12_24, TIME_12_24_VALIDATOR);
3586            VALIDATORS.put(DATE_FORMAT, DATE_FORMAT_VALIDATOR);
3587            VALIDATORS.put(SETUP_WIZARD_HAS_RUN, SETUP_WIZARD_HAS_RUN_VALIDATOR);
3588            VALIDATORS.put(ACCELEROMETER_ROTATION, ACCELEROMETER_ROTATION_VALIDATOR);
3589            VALIDATORS.put(USER_ROTATION, USER_ROTATION_VALIDATOR);
3590            VALIDATORS.put(DTMF_TONE_WHEN_DIALING, DTMF_TONE_WHEN_DIALING_VALIDATOR);
3591            VALIDATORS.put(SOUND_EFFECTS_ENABLED, SOUND_EFFECTS_ENABLED_VALIDATOR);
3592            VALIDATORS.put(HAPTIC_FEEDBACK_ENABLED, HAPTIC_FEEDBACK_ENABLED_VALIDATOR);
3593            VALIDATORS.put(SHOW_WEB_SUGGESTIONS, SHOW_WEB_SUGGESTIONS_VALIDATOR);
3594            VALIDATORS.put(WIFI_USE_STATIC_IP, WIFI_USE_STATIC_IP_VALIDATOR);
3595            VALIDATORS.put(END_BUTTON_BEHAVIOR, END_BUTTON_BEHAVIOR_VALIDATOR);
3596            VALIDATORS.put(ADVANCED_SETTINGS, ADVANCED_SETTINGS_VALIDATOR);
3597            VALIDATORS.put(SCREEN_AUTO_BRIGHTNESS_ADJ, SCREEN_AUTO_BRIGHTNESS_ADJ_VALIDATOR);
3598            VALIDATORS.put(VIBRATE_INPUT_DEVICES, VIBRATE_INPUT_DEVICES_VALIDATOR);
3599            VALIDATORS.put(VOLUME_MASTER_MUTE, VOLUME_MASTER_MUTE_VALIDATOR);
3600            VALIDATORS.put(MICROPHONE_MUTE, MICROPHONE_MUTE_VALIDATOR);
3601            VALIDATORS.put(MASTER_MONO, MASTER_MONO_VALIDATOR);
3602            VALIDATORS.put(NOTIFICATIONS_USE_RING_VOLUME, NOTIFICATIONS_USE_RING_VOLUME_VALIDATOR);
3603            VALIDATORS.put(VIBRATE_IN_SILENT, VIBRATE_IN_SILENT_VALIDATOR);
3604            VALIDATORS.put(MEDIA_BUTTON_RECEIVER, MEDIA_BUTTON_RECEIVER_VALIDATOR);
3605            VALIDATORS.put(HIDE_ROTATION_LOCK_TOGGLE_FOR_ACCESSIBILITY,
3606                    HIDE_ROTATION_LOCK_TOGGLE_FOR_ACCESSIBILITY_VALIDATOR);
3607            VALIDATORS.put(VIBRATE_WHEN_RINGING, VIBRATE_WHEN_RINGING_VALIDATOR);
3608            VALIDATORS.put(DTMF_TONE_TYPE_WHEN_DIALING, DTMF_TONE_TYPE_WHEN_DIALING_VALIDATOR);
3609            VALIDATORS.put(HEARING_AID, HEARING_AID_VALIDATOR);
3610            VALIDATORS.put(TTY_MODE, TTY_MODE_VALIDATOR);
3611            VALIDATORS.put(NOTIFICATION_LIGHT_PULSE, NOTIFICATION_LIGHT_PULSE_VALIDATOR);
3612            VALIDATORS.put(POINTER_LOCATION, POINTER_LOCATION_VALIDATOR);
3613            VALIDATORS.put(SHOW_TOUCHES, SHOW_TOUCHES_VALIDATOR);
3614            VALIDATORS.put(WINDOW_ORIENTATION_LISTENER_LOG,
3615                    WINDOW_ORIENTATION_LISTENER_LOG_VALIDATOR);
3616            VALIDATORS.put(LOCKSCREEN_SOUNDS_ENABLED, LOCKSCREEN_SOUNDS_ENABLED_VALIDATOR);
3617            VALIDATORS.put(LOCKSCREEN_DISABLED, LOCKSCREEN_DISABLED_VALIDATOR);
3618            VALIDATORS.put(SIP_RECEIVE_CALLS, SIP_RECEIVE_CALLS_VALIDATOR);
3619            VALIDATORS.put(SIP_CALL_OPTIONS, SIP_CALL_OPTIONS_VALIDATOR);
3620            VALIDATORS.put(SIP_ALWAYS, SIP_ALWAYS_VALIDATOR);
3621            VALIDATORS.put(SIP_ADDRESS_ONLY, SIP_ADDRESS_ONLY_VALIDATOR);
3622            VALIDATORS.put(SIP_ASK_ME_EACH_TIME, SIP_ASK_ME_EACH_TIME_VALIDATOR);
3623            VALIDATORS.put(POINTER_SPEED, POINTER_SPEED_VALIDATOR);
3624            VALIDATORS.put(LOCK_TO_APP_ENABLED, LOCK_TO_APP_ENABLED_VALIDATOR);
3625            VALIDATORS.put(EGG_MODE, EGG_MODE_VALIDATOR);
3626            VALIDATORS.put(WIFI_STATIC_IP, WIFI_STATIC_IP_VALIDATOR);
3627            VALIDATORS.put(WIFI_STATIC_GATEWAY, WIFI_STATIC_GATEWAY_VALIDATOR);
3628            VALIDATORS.put(WIFI_STATIC_NETMASK, WIFI_STATIC_NETMASK_VALIDATOR);
3629            VALIDATORS.put(WIFI_STATIC_DNS1, WIFI_STATIC_DNS1_VALIDATOR);
3630            VALIDATORS.put(WIFI_STATIC_DNS2, WIFI_STATIC_DNS2_VALIDATOR);
3631        }
3632
3633        /**
3634         * These entries are considered common between the personal and the managed profile,
3635         * since the managed profile doesn't get to change them.
3636         */
3637        private static final Set<String> CLONE_TO_MANAGED_PROFILE = new ArraySet<>();
3638        static {
3639            CLONE_TO_MANAGED_PROFILE.add(DATE_FORMAT);
3640            CLONE_TO_MANAGED_PROFILE.add(HAPTIC_FEEDBACK_ENABLED);
3641            CLONE_TO_MANAGED_PROFILE.add(SOUND_EFFECTS_ENABLED);
3642            CLONE_TO_MANAGED_PROFILE.add(TEXT_SHOW_PASSWORD);
3643            CLONE_TO_MANAGED_PROFILE.add(TIME_12_24);
3644        }
3645
3646        /** @hide */
3647        public static void getCloneToManagedProfileSettings(Set<String> outKeySet) {
3648            outKeySet.addAll(CLONE_TO_MANAGED_PROFILE);
3649        }
3650
3651        /**
3652         * When to use Wi-Fi calling
3653         *
3654         * @see android.telephony.TelephonyManager.WifiCallingChoices
3655         * @hide
3656         */
3657        public static final String WHEN_TO_MAKE_WIFI_CALLS = "when_to_make_wifi_calls";
3658
3659        // Settings moved to Settings.Secure
3660
3661        /**
3662         * @deprecated Use {@link android.provider.Settings.Global#ADB_ENABLED}
3663         * instead
3664         */
3665        @Deprecated
3666        public static final String ADB_ENABLED = Global.ADB_ENABLED;
3667
3668        /**
3669         * @deprecated Use {@link android.provider.Settings.Secure#ANDROID_ID} instead
3670         */
3671        @Deprecated
3672        public static final String ANDROID_ID = Secure.ANDROID_ID;
3673
3674        /**
3675         * @deprecated Use {@link android.provider.Settings.Global#BLUETOOTH_ON} instead
3676         */
3677        @Deprecated
3678        public static final String BLUETOOTH_ON = Global.BLUETOOTH_ON;
3679
3680        /**
3681         * @deprecated Use {@link android.provider.Settings.Global#DATA_ROAMING} instead
3682         */
3683        @Deprecated
3684        public static final String DATA_ROAMING = Global.DATA_ROAMING;
3685
3686        /**
3687         * @deprecated Use {@link android.provider.Settings.Global#DEVICE_PROVISIONED} instead
3688         */
3689        @Deprecated
3690        public static final String DEVICE_PROVISIONED = Global.DEVICE_PROVISIONED;
3691
3692        /**
3693         * @deprecated Use {@link android.provider.Settings.Global#HTTP_PROXY} instead
3694         */
3695        @Deprecated
3696        public static final String HTTP_PROXY = Global.HTTP_PROXY;
3697
3698        /**
3699         * @deprecated Use {@link android.provider.Settings.Secure#INSTALL_NON_MARKET_APPS} instead
3700         */
3701        @Deprecated
3702        public static final String INSTALL_NON_MARKET_APPS = Secure.INSTALL_NON_MARKET_APPS;
3703
3704        /**
3705         * @deprecated Use {@link android.provider.Settings.Secure#LOCATION_PROVIDERS_ALLOWED}
3706         * instead
3707         */
3708        @Deprecated
3709        public static final String LOCATION_PROVIDERS_ALLOWED = Secure.LOCATION_PROVIDERS_ALLOWED;
3710
3711        /**
3712         * @deprecated Use {@link android.provider.Settings.Secure#LOGGING_ID} instead
3713         */
3714        @Deprecated
3715        public static final String LOGGING_ID = Secure.LOGGING_ID;
3716
3717        /**
3718         * @deprecated Use {@link android.provider.Settings.Global#NETWORK_PREFERENCE} instead
3719         */
3720        @Deprecated
3721        public static final String NETWORK_PREFERENCE = Global.NETWORK_PREFERENCE;
3722
3723        /**
3724         * @deprecated Use {@link android.provider.Settings.Secure#PARENTAL_CONTROL_ENABLED}
3725         * instead
3726         */
3727        @Deprecated
3728        public static final String PARENTAL_CONTROL_ENABLED = Secure.PARENTAL_CONTROL_ENABLED;
3729
3730        /**
3731         * @deprecated Use {@link android.provider.Settings.Secure#PARENTAL_CONTROL_LAST_UPDATE}
3732         * instead
3733         */
3734        @Deprecated
3735        public static final String PARENTAL_CONTROL_LAST_UPDATE = Secure.PARENTAL_CONTROL_LAST_UPDATE;
3736
3737        /**
3738         * @deprecated Use {@link android.provider.Settings.Secure#PARENTAL_CONTROL_REDIRECT_URL}
3739         * instead
3740         */
3741        @Deprecated
3742        public static final String PARENTAL_CONTROL_REDIRECT_URL =
3743            Secure.PARENTAL_CONTROL_REDIRECT_URL;
3744
3745        /**
3746         * @deprecated Use {@link android.provider.Settings.Secure#SETTINGS_CLASSNAME} instead
3747         */
3748        @Deprecated
3749        public static final String SETTINGS_CLASSNAME = Secure.SETTINGS_CLASSNAME;
3750
3751        /**
3752         * @deprecated Use {@link android.provider.Settings.Global#USB_MASS_STORAGE_ENABLED} instead
3753         */
3754        @Deprecated
3755        public static final String USB_MASS_STORAGE_ENABLED = Global.USB_MASS_STORAGE_ENABLED;
3756
3757        /**
3758         * @deprecated Use {@link android.provider.Settings.Global#USE_GOOGLE_MAIL} instead
3759         */
3760        @Deprecated
3761        public static final String USE_GOOGLE_MAIL = Global.USE_GOOGLE_MAIL;
3762
3763       /**
3764         * @deprecated Use
3765         * {@link android.provider.Settings.Global#WIFI_MAX_DHCP_RETRY_COUNT} instead
3766         */
3767        @Deprecated
3768        public static final String WIFI_MAX_DHCP_RETRY_COUNT = Global.WIFI_MAX_DHCP_RETRY_COUNT;
3769
3770        /**
3771         * @deprecated Use
3772         * {@link android.provider.Settings.Global#WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS} instead
3773         */
3774        @Deprecated
3775        public static final String WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS =
3776                Global.WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS;
3777
3778        /**
3779         * @deprecated Use
3780         * {@link android.provider.Settings.Global#WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON} instead
3781         */
3782        @Deprecated
3783        public static final String WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON =
3784                Global.WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON;
3785
3786        /**
3787         * @deprecated Use
3788         * {@link android.provider.Settings.Global#WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY} instead
3789         */
3790        @Deprecated
3791        public static final String WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY =
3792                Global.WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY;
3793
3794        /**
3795         * @deprecated Use {@link android.provider.Settings.Global#WIFI_NUM_OPEN_NETWORKS_KEPT}
3796         * instead
3797         */
3798        @Deprecated
3799        public static final String WIFI_NUM_OPEN_NETWORKS_KEPT = Global.WIFI_NUM_OPEN_NETWORKS_KEPT;
3800
3801        /**
3802         * @deprecated Use {@link android.provider.Settings.Global#WIFI_ON} instead
3803         */
3804        @Deprecated
3805        public static final String WIFI_ON = Global.WIFI_ON;
3806
3807        /**
3808         * @deprecated Use
3809         * {@link android.provider.Settings.Secure#WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE}
3810         * instead
3811         */
3812        @Deprecated
3813        public static final String WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE =
3814                Secure.WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE;
3815
3816        /**
3817         * @deprecated Use {@link android.provider.Settings.Secure#WIFI_WATCHDOG_AP_COUNT} instead
3818         */
3819        @Deprecated
3820        public static final String WIFI_WATCHDOG_AP_COUNT = Secure.WIFI_WATCHDOG_AP_COUNT;
3821
3822        /**
3823         * @deprecated Use
3824         * {@link android.provider.Settings.Secure#WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS} instead
3825         */
3826        @Deprecated
3827        public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS =
3828                Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS;
3829
3830        /**
3831         * @deprecated Use
3832         * {@link android.provider.Settings.Secure#WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED} instead
3833         */
3834        @Deprecated
3835        public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED =
3836                Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED;
3837
3838        /**
3839         * @deprecated Use
3840         * {@link android.provider.Settings.Secure#WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS}
3841         * instead
3842         */
3843        @Deprecated
3844        public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS =
3845                Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS;
3846
3847        /**
3848         * @deprecated Use
3849         * {@link android.provider.Settings.Secure#WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT} instead
3850         */
3851        @Deprecated
3852        public static final String WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT =
3853            Secure.WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT;
3854
3855        /**
3856         * @deprecated Use {@link android.provider.Settings.Secure#WIFI_WATCHDOG_MAX_AP_CHECKS}
3857         * instead
3858         */
3859        @Deprecated
3860        public static final String WIFI_WATCHDOG_MAX_AP_CHECKS = Secure.WIFI_WATCHDOG_MAX_AP_CHECKS;
3861
3862        /**
3863         * @deprecated Use {@link android.provider.Settings.Global#WIFI_WATCHDOG_ON} instead
3864         */
3865        @Deprecated
3866        public static final String WIFI_WATCHDOG_ON = Global.WIFI_WATCHDOG_ON;
3867
3868        /**
3869         * @deprecated Use {@link android.provider.Settings.Secure#WIFI_WATCHDOG_PING_COUNT} instead
3870         */
3871        @Deprecated
3872        public static final String WIFI_WATCHDOG_PING_COUNT = Secure.WIFI_WATCHDOG_PING_COUNT;
3873
3874        /**
3875         * @deprecated Use {@link android.provider.Settings.Secure#WIFI_WATCHDOG_PING_DELAY_MS}
3876         * instead
3877         */
3878        @Deprecated
3879        public static final String WIFI_WATCHDOG_PING_DELAY_MS = Secure.WIFI_WATCHDOG_PING_DELAY_MS;
3880
3881        /**
3882         * @deprecated Use {@link android.provider.Settings.Secure#WIFI_WATCHDOG_PING_TIMEOUT_MS}
3883         * instead
3884         */
3885        @Deprecated
3886        public static final String WIFI_WATCHDOG_PING_TIMEOUT_MS =
3887            Secure.WIFI_WATCHDOG_PING_TIMEOUT_MS;
3888
3889        /**
3890         * An app can use this method to check if it is currently allowed to write or modify system
3891         * settings. In order to gain write access to the system settings, an app must declare the
3892         * {@link android.Manifest.permission#WRITE_SETTINGS} permission in its manifest. If it is
3893         * currently disallowed, it can prompt the user to grant it this capability through a
3894         * management UI by sending an Intent with action
3895         * {@link android.provider.Settings#ACTION_MANAGE_WRITE_SETTINGS}.
3896         *
3897         * @param context A context
3898         * @return true if the calling app can write to system settings, false otherwise
3899         */
3900        public static boolean canWrite(Context context) {
3901            int uid = Binder.getCallingUid();
3902            return isCallingPackageAllowedToWriteSettings(context, uid, getPackageNameForUid(
3903                    context, uid), false);
3904        }
3905    }
3906
3907    /**
3908     * Secure system settings, containing system preferences that applications
3909     * can read but are not allowed to write.  These are for preferences that
3910     * the user must explicitly modify through the system UI or specialized
3911     * APIs for those values, not modified directly by applications.
3912     */
3913    public static final class Secure extends NameValueTable {
3914        public static final String SYS_PROP_SETTING_VERSION = "sys.settings_secure_version";
3915
3916        /**
3917         * The content:// style URL for this table
3918         */
3919        public static final Uri CONTENT_URI =
3920            Uri.parse("content://" + AUTHORITY + "/secure");
3921
3922        // Populated lazily, guarded by class object:
3923        private static final NameValueCache sNameValueCache = new NameValueCache(
3924                SYS_PROP_SETTING_VERSION,
3925                CONTENT_URI,
3926                CALL_METHOD_GET_SECURE,
3927                CALL_METHOD_PUT_SECURE);
3928
3929        private static ILockSettings sLockSettings = null;
3930
3931        private static boolean sIsSystemProcess;
3932        private static final HashSet<String> MOVED_TO_LOCK_SETTINGS;
3933        private static final HashSet<String> MOVED_TO_GLOBAL;
3934        static {
3935            MOVED_TO_LOCK_SETTINGS = new HashSet<String>(3);
3936            MOVED_TO_LOCK_SETTINGS.add(Secure.LOCK_PATTERN_ENABLED);
3937            MOVED_TO_LOCK_SETTINGS.add(Secure.LOCK_PATTERN_VISIBLE);
3938            MOVED_TO_LOCK_SETTINGS.add(Secure.LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED);
3939
3940            MOVED_TO_GLOBAL = new HashSet<String>();
3941            MOVED_TO_GLOBAL.add(Settings.Global.ADB_ENABLED);
3942            MOVED_TO_GLOBAL.add(Settings.Global.ASSISTED_GPS_ENABLED);
3943            MOVED_TO_GLOBAL.add(Settings.Global.BLUETOOTH_ON);
3944            MOVED_TO_GLOBAL.add(Settings.Global.BUGREPORT_IN_POWER_MENU);
3945            MOVED_TO_GLOBAL.add(Settings.Global.CDMA_CELL_BROADCAST_SMS);
3946            MOVED_TO_GLOBAL.add(Settings.Global.CDMA_ROAMING_MODE);
3947            MOVED_TO_GLOBAL.add(Settings.Global.CDMA_SUBSCRIPTION_MODE);
3948            MOVED_TO_GLOBAL.add(Settings.Global.DATA_ACTIVITY_TIMEOUT_MOBILE);
3949            MOVED_TO_GLOBAL.add(Settings.Global.DATA_ACTIVITY_TIMEOUT_WIFI);
3950            MOVED_TO_GLOBAL.add(Settings.Global.DATA_ROAMING);
3951            MOVED_TO_GLOBAL.add(Settings.Global.DEVELOPMENT_SETTINGS_ENABLED);
3952            MOVED_TO_GLOBAL.add(Settings.Global.DEVICE_PROVISIONED);
3953            MOVED_TO_GLOBAL.add(Settings.Global.DISPLAY_SIZE_FORCED);
3954            MOVED_TO_GLOBAL.add(Settings.Global.DOWNLOAD_MAX_BYTES_OVER_MOBILE);
3955            MOVED_TO_GLOBAL.add(Settings.Global.DOWNLOAD_RECOMMENDED_MAX_BYTES_OVER_MOBILE);
3956            MOVED_TO_GLOBAL.add(Settings.Global.MOBILE_DATA);
3957            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_DEV_BUCKET_DURATION);
3958            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_DEV_DELETE_AGE);
3959            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_DEV_PERSIST_BYTES);
3960            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_DEV_ROTATE_AGE);
3961            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_ENABLED);
3962            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_GLOBAL_ALERT_BYTES);
3963            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_POLL_INTERVAL);
3964            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_SAMPLE_ENABLED);
3965            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_TIME_CACHE_MAX_AGE);
3966            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_UID_BUCKET_DURATION);
3967            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_UID_DELETE_AGE);
3968            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_UID_PERSIST_BYTES);
3969            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_UID_ROTATE_AGE);
3970            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_UID_TAG_BUCKET_DURATION);
3971            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_UID_TAG_DELETE_AGE);
3972            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_UID_TAG_PERSIST_BYTES);
3973            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_UID_TAG_ROTATE_AGE);
3974            MOVED_TO_GLOBAL.add(Settings.Global.NETWORK_PREFERENCE);
3975            MOVED_TO_GLOBAL.add(Settings.Global.NITZ_UPDATE_DIFF);
3976            MOVED_TO_GLOBAL.add(Settings.Global.NITZ_UPDATE_SPACING);
3977            MOVED_TO_GLOBAL.add(Settings.Global.NTP_SERVER);
3978            MOVED_TO_GLOBAL.add(Settings.Global.NTP_TIMEOUT);
3979            MOVED_TO_GLOBAL.add(Settings.Global.PDP_WATCHDOG_ERROR_POLL_COUNT);
3980            MOVED_TO_GLOBAL.add(Settings.Global.PDP_WATCHDOG_LONG_POLL_INTERVAL_MS);
3981            MOVED_TO_GLOBAL.add(Settings.Global.PDP_WATCHDOG_MAX_PDP_RESET_FAIL_COUNT);
3982            MOVED_TO_GLOBAL.add(Settings.Global.PDP_WATCHDOG_POLL_INTERVAL_MS);
3983            MOVED_TO_GLOBAL.add(Settings.Global.PDP_WATCHDOG_TRIGGER_PACKET_COUNT);
3984            MOVED_TO_GLOBAL.add(Settings.Global.SAMPLING_PROFILER_MS);
3985            MOVED_TO_GLOBAL.add(Settings.Global.SETUP_PREPAID_DATA_SERVICE_URL);
3986            MOVED_TO_GLOBAL.add(Settings.Global.SETUP_PREPAID_DETECTION_REDIR_HOST);
3987            MOVED_TO_GLOBAL.add(Settings.Global.SETUP_PREPAID_DETECTION_TARGET_URL);
3988            MOVED_TO_GLOBAL.add(Settings.Global.TETHER_DUN_APN);
3989            MOVED_TO_GLOBAL.add(Settings.Global.TETHER_DUN_REQUIRED);
3990            MOVED_TO_GLOBAL.add(Settings.Global.TETHER_SUPPORTED);
3991            MOVED_TO_GLOBAL.add(Settings.Global.USB_MASS_STORAGE_ENABLED);
3992            MOVED_TO_GLOBAL.add(Settings.Global.USE_GOOGLE_MAIL);
3993            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_COUNTRY_CODE);
3994            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_FRAMEWORK_SCAN_INTERVAL_MS);
3995            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_FREQUENCY_BAND);
3996            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_IDLE_MS);
3997            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_MAX_DHCP_RETRY_COUNT);
3998            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS);
3999            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON);
4000            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY);
4001            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_NUM_OPEN_NETWORKS_KEPT);
4002            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_ON);
4003            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_P2P_DEVICE_NAME);
4004            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_SAVED_STATE);
4005            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_SUPPLICANT_SCAN_INTERVAL_MS);
4006            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_SUSPEND_OPTIMIZATIONS_ENABLED);
4007            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_ENHANCED_AUTO_JOIN);
4008            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_NETWORK_SHOW_RSSI);
4009            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_WATCHDOG_ON);
4010            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_WATCHDOG_POOR_NETWORK_TEST_ENABLED);
4011            MOVED_TO_GLOBAL.add(Settings.Global.WIMAX_NETWORKS_AVAILABLE_NOTIFICATION_ON);
4012            MOVED_TO_GLOBAL.add(Settings.Global.PACKAGE_VERIFIER_ENABLE);
4013            MOVED_TO_GLOBAL.add(Settings.Global.PACKAGE_VERIFIER_TIMEOUT);
4014            MOVED_TO_GLOBAL.add(Settings.Global.PACKAGE_VERIFIER_DEFAULT_RESPONSE);
4015            MOVED_TO_GLOBAL.add(Settings.Global.DATA_STALL_ALARM_NON_AGGRESSIVE_DELAY_IN_MS);
4016            MOVED_TO_GLOBAL.add(Settings.Global.DATA_STALL_ALARM_AGGRESSIVE_DELAY_IN_MS);
4017            MOVED_TO_GLOBAL.add(Settings.Global.GPRS_REGISTER_CHECK_PERIOD_MS);
4018            MOVED_TO_GLOBAL.add(Settings.Global.WTF_IS_FATAL);
4019            MOVED_TO_GLOBAL.add(Settings.Global.BATTERY_DISCHARGE_DURATION_THRESHOLD);
4020            MOVED_TO_GLOBAL.add(Settings.Global.BATTERY_DISCHARGE_THRESHOLD);
4021            MOVED_TO_GLOBAL.add(Settings.Global.SEND_ACTION_APP_ERROR);
4022            MOVED_TO_GLOBAL.add(Settings.Global.DROPBOX_AGE_SECONDS);
4023            MOVED_TO_GLOBAL.add(Settings.Global.DROPBOX_MAX_FILES);
4024            MOVED_TO_GLOBAL.add(Settings.Global.DROPBOX_QUOTA_KB);
4025            MOVED_TO_GLOBAL.add(Settings.Global.DROPBOX_QUOTA_PERCENT);
4026            MOVED_TO_GLOBAL.add(Settings.Global.DROPBOX_RESERVE_PERCENT);
4027            MOVED_TO_GLOBAL.add(Settings.Global.DROPBOX_TAG_PREFIX);
4028            MOVED_TO_GLOBAL.add(Settings.Global.ERROR_LOGCAT_PREFIX);
4029            MOVED_TO_GLOBAL.add(Settings.Global.SYS_FREE_STORAGE_LOG_INTERVAL);
4030            MOVED_TO_GLOBAL.add(Settings.Global.DISK_FREE_CHANGE_REPORTING_THRESHOLD);
4031            MOVED_TO_GLOBAL.add(Settings.Global.SYS_STORAGE_THRESHOLD_PERCENTAGE);
4032            MOVED_TO_GLOBAL.add(Settings.Global.SYS_STORAGE_THRESHOLD_MAX_BYTES);
4033            MOVED_TO_GLOBAL.add(Settings.Global.SYS_STORAGE_FULL_THRESHOLD_BYTES);
4034            MOVED_TO_GLOBAL.add(Settings.Global.SYNC_MAX_RETRY_DELAY_IN_SECONDS);
4035            MOVED_TO_GLOBAL.add(Settings.Global.CONNECTIVITY_CHANGE_DELAY);
4036            MOVED_TO_GLOBAL.add(Settings.Global.CAPTIVE_PORTAL_DETECTION_ENABLED);
4037            MOVED_TO_GLOBAL.add(Settings.Global.CAPTIVE_PORTAL_SERVER);
4038            MOVED_TO_GLOBAL.add(Settings.Global.NSD_ON);
4039            MOVED_TO_GLOBAL.add(Settings.Global.SET_INSTALL_LOCATION);
4040            MOVED_TO_GLOBAL.add(Settings.Global.DEFAULT_INSTALL_LOCATION);
4041            MOVED_TO_GLOBAL.add(Settings.Global.INET_CONDITION_DEBOUNCE_UP_DELAY);
4042            MOVED_TO_GLOBAL.add(Settings.Global.INET_CONDITION_DEBOUNCE_DOWN_DELAY);
4043            MOVED_TO_GLOBAL.add(Settings.Global.READ_EXTERNAL_STORAGE_ENFORCED_DEFAULT);
4044            MOVED_TO_GLOBAL.add(Settings.Global.HTTP_PROXY);
4045            MOVED_TO_GLOBAL.add(Settings.Global.GLOBAL_HTTP_PROXY_HOST);
4046            MOVED_TO_GLOBAL.add(Settings.Global.GLOBAL_HTTP_PROXY_PORT);
4047            MOVED_TO_GLOBAL.add(Settings.Global.GLOBAL_HTTP_PROXY_EXCLUSION_LIST);
4048            MOVED_TO_GLOBAL.add(Settings.Global.SET_GLOBAL_HTTP_PROXY);
4049            MOVED_TO_GLOBAL.add(Settings.Global.DEFAULT_DNS_SERVER);
4050            MOVED_TO_GLOBAL.add(Settings.Global.PREFERRED_NETWORK_MODE);
4051            MOVED_TO_GLOBAL.add(Settings.Global.WEBVIEW_DATA_REDUCTION_PROXY_KEY);
4052        }
4053
4054        /** @hide */
4055        public static void getMovedToGlobalSettings(Set<String> outKeySet) {
4056            outKeySet.addAll(MOVED_TO_GLOBAL);
4057        }
4058
4059        /**
4060         * Look up a name in the database.
4061         * @param resolver to access the database with
4062         * @param name to look up in the table
4063         * @return the corresponding value, or null if not present
4064         */
4065        public static String getString(ContentResolver resolver, String name) {
4066            return getStringForUser(resolver, name, UserHandle.myUserId());
4067        }
4068
4069        /** @hide */
4070        public static String getStringForUser(ContentResolver resolver, String name,
4071                int userHandle) {
4072            if (MOVED_TO_GLOBAL.contains(name)) {
4073                Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.Secure"
4074                        + " to android.provider.Settings.Global.");
4075                return Global.getStringForUser(resolver, name, userHandle);
4076            }
4077
4078            if (MOVED_TO_LOCK_SETTINGS.contains(name)) {
4079                synchronized (Secure.class) {
4080                    if (sLockSettings == null) {
4081                        sLockSettings = ILockSettings.Stub.asInterface(
4082                                (IBinder) ServiceManager.getService("lock_settings"));
4083                        sIsSystemProcess = Process.myUid() == Process.SYSTEM_UID;
4084                    }
4085                }
4086                if (sLockSettings != null && !sIsSystemProcess) {
4087                    // No context; use the ActivityThread's context as an approximation for
4088                    // determining the target API level.
4089                    Application application = ActivityThread.currentApplication();
4090
4091                    boolean isPreMnc = application != null
4092                            && application.getApplicationInfo() != null
4093                            && application.getApplicationInfo().targetSdkVersion
4094                            <= VERSION_CODES.LOLLIPOP_MR1;
4095                    if (isPreMnc) {
4096                        try {
4097                            return sLockSettings.getString(name, "0", userHandle);
4098                        } catch (RemoteException re) {
4099                            // Fall through
4100                        }
4101                    } else {
4102                        throw new SecurityException("Settings.Secure." + name
4103                                + " is deprecated and no longer accessible."
4104                                + " See API documentation for potential replacements.");
4105                    }
4106                }
4107            }
4108
4109            return sNameValueCache.getStringForUser(resolver, name, userHandle);
4110        }
4111
4112        /**
4113         * Store a name/value pair into the database.
4114         * @param resolver to access the database with
4115         * @param name to store
4116         * @param value to associate with the name
4117         * @return true if the value was set, false on database errors
4118         */
4119        public static boolean putString(ContentResolver resolver, String name, String value) {
4120            return putStringForUser(resolver, name, value, UserHandle.myUserId());
4121        }
4122
4123        /** @hide */
4124        public static boolean putStringForUser(ContentResolver resolver, String name, String value,
4125                int userHandle) {
4126            if (LOCATION_MODE.equals(name)) {
4127                // HACK ALERT: temporary hack to work around b/10491283.
4128                // TODO: once b/10491283 fixed, remove this hack
4129                return setLocationModeForUser(resolver, Integer.parseInt(value), userHandle);
4130            }
4131            if (MOVED_TO_GLOBAL.contains(name)) {
4132                Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.System"
4133                        + " to android.provider.Settings.Global");
4134                return Global.putStringForUser(resolver, name, value, userHandle);
4135            }
4136            return sNameValueCache.putStringForUser(resolver, name, value, userHandle);
4137        }
4138
4139        /**
4140         * Construct the content URI for a particular name/value pair,
4141         * useful for monitoring changes with a ContentObserver.
4142         * @param name to look up in the table
4143         * @return the corresponding content URI, or null if not present
4144         */
4145        public static Uri getUriFor(String name) {
4146            if (MOVED_TO_GLOBAL.contains(name)) {
4147                Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.Secure"
4148                        + " to android.provider.Settings.Global, returning global URI.");
4149                return Global.getUriFor(Global.CONTENT_URI, name);
4150            }
4151            return getUriFor(CONTENT_URI, name);
4152        }
4153
4154        /**
4155         * Convenience function for retrieving a single secure settings value
4156         * as an integer.  Note that internally setting values are always
4157         * stored as strings; this function converts the string to an integer
4158         * for you.  The default value will be returned if the setting is
4159         * not defined or not an integer.
4160         *
4161         * @param cr The ContentResolver to access.
4162         * @param name The name of the setting to retrieve.
4163         * @param def Value to return if the setting is not defined.
4164         *
4165         * @return The setting's current value, or 'def' if it is not defined
4166         * or not a valid integer.
4167         */
4168        public static int getInt(ContentResolver cr, String name, int def) {
4169            return getIntForUser(cr, name, def, UserHandle.myUserId());
4170        }
4171
4172        /** @hide */
4173        public static int getIntForUser(ContentResolver cr, String name, int def, int userHandle) {
4174            if (LOCATION_MODE.equals(name)) {
4175                // HACK ALERT: temporary hack to work around b/10491283.
4176                // TODO: once b/10491283 fixed, remove this hack
4177                return getLocationModeForUser(cr, userHandle);
4178            }
4179            String v = getStringForUser(cr, name, userHandle);
4180            try {
4181                return v != null ? Integer.parseInt(v) : def;
4182            } catch (NumberFormatException e) {
4183                return def;
4184            }
4185        }
4186
4187        /**
4188         * Convenience function for retrieving a single secure settings value
4189         * as an integer.  Note that internally setting values are always
4190         * stored as strings; this function converts the string to an integer
4191         * for you.
4192         * <p>
4193         * This version does not take a default value.  If the setting has not
4194         * been set, or the string value is not a number,
4195         * it throws {@link SettingNotFoundException}.
4196         *
4197         * @param cr The ContentResolver to access.
4198         * @param name The name of the setting to retrieve.
4199         *
4200         * @throws SettingNotFoundException Thrown if a setting by the given
4201         * name can't be found or the setting value is not an integer.
4202         *
4203         * @return The setting's current value.
4204         */
4205        public static int getInt(ContentResolver cr, String name)
4206                throws SettingNotFoundException {
4207            return getIntForUser(cr, name, UserHandle.myUserId());
4208        }
4209
4210        /** @hide */
4211        public static int getIntForUser(ContentResolver cr, String name, int userHandle)
4212                throws SettingNotFoundException {
4213            if (LOCATION_MODE.equals(name)) {
4214                // HACK ALERT: temporary hack to work around b/10491283.
4215                // TODO: once b/10491283 fixed, remove this hack
4216                return getLocationModeForUser(cr, userHandle);
4217            }
4218            String v = getStringForUser(cr, name, userHandle);
4219            try {
4220                return Integer.parseInt(v);
4221            } catch (NumberFormatException e) {
4222                throw new SettingNotFoundException(name);
4223            }
4224        }
4225
4226        /**
4227         * Convenience function for updating a single settings value as an
4228         * integer. This will either create a new entry in the table if the
4229         * given name does not exist, or modify the value of the existing row
4230         * with that name.  Note that internally setting values are always
4231         * stored as strings, so this function converts the given value to a
4232         * string before storing it.
4233         *
4234         * @param cr The ContentResolver to access.
4235         * @param name The name of the setting to modify.
4236         * @param value The new value for the setting.
4237         * @return true if the value was set, false on database errors
4238         */
4239        public static boolean putInt(ContentResolver cr, String name, int value) {
4240            return putIntForUser(cr, name, value, UserHandle.myUserId());
4241        }
4242
4243        /** @hide */
4244        public static boolean putIntForUser(ContentResolver cr, String name, int value,
4245                int userHandle) {
4246            return putStringForUser(cr, name, Integer.toString(value), userHandle);
4247        }
4248
4249        /**
4250         * Convenience function for retrieving a single secure settings value
4251         * as a {@code long}.  Note that internally setting values are always
4252         * stored as strings; this function converts the string to a {@code long}
4253         * for you.  The default value will be returned if the setting is
4254         * not defined or not a {@code long}.
4255         *
4256         * @param cr The ContentResolver to access.
4257         * @param name The name of the setting to retrieve.
4258         * @param def Value to return if the setting is not defined.
4259         *
4260         * @return The setting's current value, or 'def' if it is not defined
4261         * or not a valid {@code long}.
4262         */
4263        public static long getLong(ContentResolver cr, String name, long def) {
4264            return getLongForUser(cr, name, def, UserHandle.myUserId());
4265        }
4266
4267        /** @hide */
4268        public static long getLongForUser(ContentResolver cr, String name, long def,
4269                int userHandle) {
4270            String valString = getStringForUser(cr, name, userHandle);
4271            long value;
4272            try {
4273                value = valString != null ? Long.parseLong(valString) : def;
4274            } catch (NumberFormatException e) {
4275                value = def;
4276            }
4277            return value;
4278        }
4279
4280        /**
4281         * Convenience function for retrieving a single secure settings value
4282         * as a {@code long}.  Note that internally setting values are always
4283         * stored as strings; this function converts the string to a {@code long}
4284         * for you.
4285         * <p>
4286         * This version does not take a default value.  If the setting has not
4287         * been set, or the string value is not a number,
4288         * it throws {@link SettingNotFoundException}.
4289         *
4290         * @param cr The ContentResolver to access.
4291         * @param name The name of the setting to retrieve.
4292         *
4293         * @return The setting's current value.
4294         * @throws SettingNotFoundException Thrown if a setting by the given
4295         * name can't be found or the setting value is not an integer.
4296         */
4297        public static long getLong(ContentResolver cr, String name)
4298                throws SettingNotFoundException {
4299            return getLongForUser(cr, name, UserHandle.myUserId());
4300        }
4301
4302        /** @hide */
4303        public static long getLongForUser(ContentResolver cr, String name, int userHandle)
4304                throws SettingNotFoundException {
4305            String valString = getStringForUser(cr, name, userHandle);
4306            try {
4307                return Long.parseLong(valString);
4308            } catch (NumberFormatException e) {
4309                throw new SettingNotFoundException(name);
4310            }
4311        }
4312
4313        /**
4314         * Convenience function for updating a secure settings value as a long
4315         * integer. This will either create a new entry in the table if the
4316         * given name does not exist, or modify the value of the existing row
4317         * with that name.  Note that internally setting values are always
4318         * stored as strings, so this function converts the given value to a
4319         * string before storing it.
4320         *
4321         * @param cr The ContentResolver to access.
4322         * @param name The name of the setting to modify.
4323         * @param value The new value for the setting.
4324         * @return true if the value was set, false on database errors
4325         */
4326        public static boolean putLong(ContentResolver cr, String name, long value) {
4327            return putLongForUser(cr, name, value, UserHandle.myUserId());
4328        }
4329
4330        /** @hide */
4331        public static boolean putLongForUser(ContentResolver cr, String name, long value,
4332                int userHandle) {
4333            return putStringForUser(cr, name, Long.toString(value), userHandle);
4334        }
4335
4336        /**
4337         * Convenience function for retrieving a single secure settings value
4338         * as a floating point number.  Note that internally setting values are
4339         * always stored as strings; this function converts the string to an
4340         * float for you. The default value will be returned if the setting
4341         * is not defined or not a valid float.
4342         *
4343         * @param cr The ContentResolver to access.
4344         * @param name The name of the setting to retrieve.
4345         * @param def Value to return if the setting is not defined.
4346         *
4347         * @return The setting's current value, or 'def' if it is not defined
4348         * or not a valid float.
4349         */
4350        public static float getFloat(ContentResolver cr, String name, float def) {
4351            return getFloatForUser(cr, name, def, UserHandle.myUserId());
4352        }
4353
4354        /** @hide */
4355        public static float getFloatForUser(ContentResolver cr, String name, float def,
4356                int userHandle) {
4357            String v = getStringForUser(cr, name, userHandle);
4358            try {
4359                return v != null ? Float.parseFloat(v) : def;
4360            } catch (NumberFormatException e) {
4361                return def;
4362            }
4363        }
4364
4365        /**
4366         * Convenience function for retrieving a single secure settings value
4367         * as a float.  Note that internally setting values are always
4368         * stored as strings; this function converts the string to a float
4369         * for you.
4370         * <p>
4371         * This version does not take a default value.  If the setting has not
4372         * been set, or the string value is not a number,
4373         * it throws {@link SettingNotFoundException}.
4374         *
4375         * @param cr The ContentResolver to access.
4376         * @param name The name of the setting to retrieve.
4377         *
4378         * @throws SettingNotFoundException Thrown if a setting by the given
4379         * name can't be found or the setting value is not a float.
4380         *
4381         * @return The setting's current value.
4382         */
4383        public static float getFloat(ContentResolver cr, String name)
4384                throws SettingNotFoundException {
4385            return getFloatForUser(cr, name, UserHandle.myUserId());
4386        }
4387
4388        /** @hide */
4389        public static float getFloatForUser(ContentResolver cr, String name, int userHandle)
4390                throws SettingNotFoundException {
4391            String v = getStringForUser(cr, name, userHandle);
4392            if (v == null) {
4393                throw new SettingNotFoundException(name);
4394            }
4395            try {
4396                return Float.parseFloat(v);
4397            } catch (NumberFormatException e) {
4398                throw new SettingNotFoundException(name);
4399            }
4400        }
4401
4402        /**
4403         * Convenience function for updating a single settings value as a
4404         * floating point number. This will either create a new entry in the
4405         * table if the given name does not exist, or modify the value of the
4406         * existing row with that name.  Note that internally setting values
4407         * are always stored as strings, so this function converts the given
4408         * value to a string before storing it.
4409         *
4410         * @param cr The ContentResolver to access.
4411         * @param name The name of the setting to modify.
4412         * @param value The new value for the setting.
4413         * @return true if the value was set, false on database errors
4414         */
4415        public static boolean putFloat(ContentResolver cr, String name, float value) {
4416            return putFloatForUser(cr, name, value, UserHandle.myUserId());
4417        }
4418
4419        /** @hide */
4420        public static boolean putFloatForUser(ContentResolver cr, String name, float value,
4421                int userHandle) {
4422            return putStringForUser(cr, name, Float.toString(value), userHandle);
4423        }
4424
4425        /**
4426         * @deprecated Use {@link android.provider.Settings.Global#DEVELOPMENT_SETTINGS_ENABLED}
4427         * instead
4428         */
4429        @Deprecated
4430        public static final String DEVELOPMENT_SETTINGS_ENABLED =
4431                Global.DEVELOPMENT_SETTINGS_ENABLED;
4432
4433        /**
4434         * When the user has enable the option to have a "bug report" command
4435         * in the power menu.
4436         * @deprecated Use {@link android.provider.Settings.Global#BUGREPORT_IN_POWER_MENU} instead
4437         * @hide
4438         */
4439        @Deprecated
4440        public static final String BUGREPORT_IN_POWER_MENU = "bugreport_in_power_menu";
4441
4442        /**
4443         * @deprecated Use {@link android.provider.Settings.Global#ADB_ENABLED} instead
4444         */
4445        @Deprecated
4446        public static final String ADB_ENABLED = Global.ADB_ENABLED;
4447
4448        /**
4449         * Setting to allow mock locations and location provider status to be injected into the
4450         * LocationManager service for testing purposes during application development.  These
4451         * locations and status values  override actual location and status information generated
4452         * by network, gps, or other location providers.
4453         *
4454         * @deprecated This settings is not used anymore.
4455         */
4456        @Deprecated
4457        public static final String ALLOW_MOCK_LOCATION = "mock_location";
4458
4459        /**
4460         * A 64-bit number (as a hex string) that is randomly
4461         * generated when the user first sets up the device and should remain
4462         * constant for the lifetime of the user's device. The value may
4463         * change if a factory reset is performed on the device.
4464         * <p class="note"><strong>Note:</strong> When a device has <a
4465         * href="{@docRoot}about/versions/android-4.2.html#MultipleUsers">multiple users</a>
4466         * (available on certain devices running Android 4.2 or higher), each user appears as a
4467         * completely separate device, so the {@code ANDROID_ID} value is unique to each
4468         * user.</p>
4469         */
4470        public static final String ANDROID_ID = "android_id";
4471
4472        /**
4473         * @deprecated Use {@link android.provider.Settings.Global#BLUETOOTH_ON} instead
4474         */
4475        @Deprecated
4476        public static final String BLUETOOTH_ON = Global.BLUETOOTH_ON;
4477
4478        /**
4479         * @deprecated Use {@link android.provider.Settings.Global#DATA_ROAMING} instead
4480         */
4481        @Deprecated
4482        public static final String DATA_ROAMING = Global.DATA_ROAMING;
4483
4484        /**
4485         * Setting to record the input method used by default, holding the ID
4486         * of the desired method.
4487         */
4488        public static final String DEFAULT_INPUT_METHOD = "default_input_method";
4489
4490        /**
4491         * Setting to record the input method subtype used by default, holding the ID
4492         * of the desired method.
4493         */
4494        public static final String SELECTED_INPUT_METHOD_SUBTYPE =
4495                "selected_input_method_subtype";
4496
4497        /**
4498         * Setting to record the history of input method subtype, holding the pair of ID of IME
4499         * and its last used subtype.
4500         * @hide
4501         */
4502        public static final String INPUT_METHODS_SUBTYPE_HISTORY =
4503                "input_methods_subtype_history";
4504
4505        /**
4506         * Setting to record the visibility of input method selector
4507         */
4508        public static final String INPUT_METHOD_SELECTOR_VISIBILITY =
4509                "input_method_selector_visibility";
4510
4511        /**
4512         * The currently selected voice interaction service flattened ComponentName.
4513         * @hide
4514         */
4515        @TestApi
4516        public static final String VOICE_INTERACTION_SERVICE = "voice_interaction_service";
4517
4518        /**
4519         * bluetooth HCI snoop log configuration
4520         * @hide
4521         */
4522        public static final String BLUETOOTH_HCI_LOG =
4523                "bluetooth_hci_log";
4524
4525        /**
4526         * @deprecated Use {@link android.provider.Settings.Global#DEVICE_PROVISIONED} instead
4527         */
4528        @Deprecated
4529        public static final String DEVICE_PROVISIONED = Global.DEVICE_PROVISIONED;
4530
4531        /**
4532         * Whether the current user has been set up via setup wizard (0 = false, 1 = true)
4533         * @hide
4534         */
4535        public static final String USER_SETUP_COMPLETE = "user_setup_complete";
4536
4537        /**
4538         * Prefix for category name that marks whether a suggested action from that category was
4539         * completed.
4540         * @hide
4541         */
4542        public static final String COMPLETED_CATEGORY_PREFIX = "suggested.completed_category.";
4543
4544        /**
4545         * List of input methods that are currently enabled.  This is a string
4546         * containing the IDs of all enabled input methods, each ID separated
4547         * by ':'.
4548         */
4549        public static final String ENABLED_INPUT_METHODS = "enabled_input_methods";
4550
4551        /**
4552         * List of system input methods that are currently disabled.  This is a string
4553         * containing the IDs of all disabled input methods, each ID separated
4554         * by ':'.
4555         * @hide
4556         */
4557        public static final String DISABLED_SYSTEM_INPUT_METHODS = "disabled_system_input_methods";
4558
4559        /**
4560         * Whether to show the IME when a hard keyboard is connected. This is a boolean that
4561         * determines if the IME should be shown when a hard keyboard is attached.
4562         * @hide
4563         */
4564        public static final String SHOW_IME_WITH_HARD_KEYBOARD = "show_ime_with_hard_keyboard";
4565
4566        /**
4567         * Host name and port for global http proxy. Uses ':' seperator for
4568         * between host and port.
4569         *
4570         * @deprecated Use {@link Global#HTTP_PROXY}
4571         */
4572        @Deprecated
4573        public static final String HTTP_PROXY = Global.HTTP_PROXY;
4574
4575        /**
4576         * Package designated as always-on VPN provider.
4577         *
4578         * @hide
4579         */
4580        public static final String ALWAYS_ON_VPN_APP = "always_on_vpn_app";
4581
4582        /**
4583         * Whether applications can be installed for this user via the system's
4584         * {@link Intent#ACTION_INSTALL_PACKAGE} mechanism.
4585         *
4586         * <p>1 = permit app installation via the system package installer intent
4587         * <p>0 = do not allow use of the package installer
4588         */
4589        public static final String INSTALL_NON_MARKET_APPS = "install_non_market_apps";
4590
4591        /**
4592         * Comma-separated list of location providers that activities may access. Do not rely on
4593         * this value being present in settings.db or on ContentObserver notifications on the
4594         * corresponding Uri.
4595         *
4596         * @deprecated use {@link #LOCATION_MODE} and
4597         * {@link LocationManager#MODE_CHANGED_ACTION} (or
4598         * {@link LocationManager#PROVIDERS_CHANGED_ACTION})
4599         */
4600        @Deprecated
4601        public static final String LOCATION_PROVIDERS_ALLOWED = "location_providers_allowed";
4602
4603        /**
4604         * The degree of location access enabled by the user.
4605         * <p>
4606         * When used with {@link #putInt(ContentResolver, String, int)}, must be one of {@link
4607         * #LOCATION_MODE_HIGH_ACCURACY}, {@link #LOCATION_MODE_SENSORS_ONLY}, {@link
4608         * #LOCATION_MODE_BATTERY_SAVING}, or {@link #LOCATION_MODE_OFF}. When used with {@link
4609         * #getInt(ContentResolver, String)}, the caller must gracefully handle additional location
4610         * modes that might be added in the future.
4611         * <p>
4612         * Note: do not rely on this value being present in settings.db or on ContentObserver
4613         * notifications for the corresponding Uri. Use {@link LocationManager#MODE_CHANGED_ACTION}
4614         * to receive changes in this value.
4615         */
4616        public static final String LOCATION_MODE = "location_mode";
4617        /**
4618         * Stores the previous location mode when {@link #LOCATION_MODE} is set to
4619         * {@link #LOCATION_MODE_OFF}
4620         * @hide
4621         */
4622        public static final String LOCATION_PREVIOUS_MODE = "location_previous_mode";
4623
4624        /**
4625         * Sets all location providers to the previous states before location was turned off.
4626         * @hide
4627         */
4628        public static final int LOCATION_MODE_PREVIOUS = -1;
4629        /**
4630         * Location access disabled.
4631         */
4632        public static final int LOCATION_MODE_OFF = 0;
4633        /**
4634         * Network Location Provider disabled, but GPS and other sensors enabled.
4635         */
4636        public static final int LOCATION_MODE_SENSORS_ONLY = 1;
4637        /**
4638         * Reduced power usage, such as limiting the number of GPS updates per hour. Requests
4639         * with {@link android.location.Criteria#POWER_HIGH} may be downgraded to
4640         * {@link android.location.Criteria#POWER_MEDIUM}.
4641         */
4642        public static final int LOCATION_MODE_BATTERY_SAVING = 2;
4643        /**
4644         * Best-effort location computation allowed.
4645         */
4646        public static final int LOCATION_MODE_HIGH_ACCURACY = 3;
4647
4648        /**
4649         * A flag containing settings used for biometric weak
4650         * @hide
4651         */
4652        @Deprecated
4653        public static final String LOCK_BIOMETRIC_WEAK_FLAGS =
4654                "lock_biometric_weak_flags";
4655
4656        /**
4657         * Whether lock-to-app will lock the keyguard when exiting.
4658         * @hide
4659         */
4660        public static final String LOCK_TO_APP_EXIT_LOCKED = "lock_to_app_exit_locked";
4661
4662        /**
4663         * Whether autolock is enabled (0 = false, 1 = true)
4664         *
4665         * @deprecated Use {@link android.app.KeyguardManager} to determine the state and security
4666         *             level of the keyguard. Accessing this setting from an app that is targeting
4667         *             {@link VERSION_CODES#M} or later throws a {@code SecurityException}.
4668         */
4669        @Deprecated
4670        public static final String LOCK_PATTERN_ENABLED = "lock_pattern_autolock";
4671
4672        /**
4673         * Whether lock pattern is visible as user enters (0 = false, 1 = true)
4674         *
4675         * @deprecated Accessing this setting from an app that is targeting
4676         *             {@link VERSION_CODES#M} or later throws a {@code SecurityException}.
4677         */
4678        @Deprecated
4679        public static final String LOCK_PATTERN_VISIBLE = "lock_pattern_visible_pattern";
4680
4681        /**
4682         * Whether lock pattern will vibrate as user enters (0 = false, 1 =
4683         * true)
4684         *
4685         * @deprecated Starting in {@link VERSION_CODES#JELLY_BEAN_MR1} the
4686         *             lockscreen uses
4687         *             {@link Settings.System#HAPTIC_FEEDBACK_ENABLED}.
4688         *             Accessing this setting from an app that is targeting
4689         *             {@link VERSION_CODES#M} or later throws a {@code SecurityException}.
4690         */
4691        @Deprecated
4692        public static final String
4693                LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED = "lock_pattern_tactile_feedback_enabled";
4694
4695        /**
4696         * This preference allows the device to be locked given time after screen goes off,
4697         * subject to current DeviceAdmin policy limits.
4698         * @hide
4699         */
4700        public static final String LOCK_SCREEN_LOCK_AFTER_TIMEOUT = "lock_screen_lock_after_timeout";
4701
4702
4703        /**
4704         * This preference contains the string that shows for owner info on LockScreen.
4705         * @hide
4706         * @deprecated
4707         */
4708        public static final String LOCK_SCREEN_OWNER_INFO = "lock_screen_owner_info";
4709
4710        /**
4711         * Ids of the user-selected appwidgets on the lockscreen (comma-delimited).
4712         * @hide
4713         */
4714        @Deprecated
4715        public static final String LOCK_SCREEN_APPWIDGET_IDS =
4716            "lock_screen_appwidget_ids";
4717
4718        /**
4719         * Id of the appwidget shown on the lock screen when appwidgets are disabled.
4720         * @hide
4721         */
4722        @Deprecated
4723        public static final String LOCK_SCREEN_FALLBACK_APPWIDGET_ID =
4724            "lock_screen_fallback_appwidget_id";
4725
4726        /**
4727         * Index of the lockscreen appwidget to restore, -1 if none.
4728         * @hide
4729         */
4730        @Deprecated
4731        public static final String LOCK_SCREEN_STICKY_APPWIDGET =
4732            "lock_screen_sticky_appwidget";
4733
4734        /**
4735         * This preference enables showing the owner info on LockScreen.
4736         * @hide
4737         * @deprecated
4738         */
4739        public static final String LOCK_SCREEN_OWNER_INFO_ENABLED =
4740            "lock_screen_owner_info_enabled";
4741
4742        /**
4743         * When set by a user, allows notifications to be shown atop a securely locked screen
4744         * in their full "private" form (same as when the device is unlocked).
4745         * @hide
4746         */
4747        public static final String LOCK_SCREEN_ALLOW_PRIVATE_NOTIFICATIONS =
4748                "lock_screen_allow_private_notifications";
4749
4750        /**
4751         * When set by a user, allows notification remote input atop a securely locked screen
4752         * without having to unlock
4753         * @hide
4754         */
4755        public static final String LOCK_SCREEN_ALLOW_REMOTE_INPUT =
4756                "lock_screen_allow_remote_input";
4757
4758        /**
4759         * Set by the system to track if the user needs to see the call to action for
4760         * the lockscreen notification policy.
4761         * @hide
4762         */
4763        public static final String SHOW_NOTE_ABOUT_NOTIFICATION_HIDING =
4764                "show_note_about_notification_hiding";
4765
4766        /**
4767         * Set to 1 by the system after trust agents have been initialized.
4768         * @hide
4769         */
4770        public static final String TRUST_AGENTS_INITIALIZED =
4771                "trust_agents_initialized";
4772
4773        /**
4774         * The Logging ID (a unique 64-bit value) as a hex string.
4775         * Used as a pseudonymous identifier for logging.
4776         * @deprecated This identifier is poorly initialized and has
4777         * many collisions.  It should not be used.
4778         */
4779        @Deprecated
4780        public static final String LOGGING_ID = "logging_id";
4781
4782        /**
4783         * @deprecated Use {@link android.provider.Settings.Global#NETWORK_PREFERENCE} instead
4784         */
4785        @Deprecated
4786        public static final String NETWORK_PREFERENCE = Global.NETWORK_PREFERENCE;
4787
4788        /**
4789         * No longer supported.
4790         */
4791        public static final String PARENTAL_CONTROL_ENABLED = "parental_control_enabled";
4792
4793        /**
4794         * No longer supported.
4795         */
4796        public static final String PARENTAL_CONTROL_LAST_UPDATE = "parental_control_last_update";
4797
4798        /**
4799         * No longer supported.
4800         */
4801        public static final String PARENTAL_CONTROL_REDIRECT_URL = "parental_control_redirect_url";
4802
4803        /**
4804         * Settings classname to launch when Settings is clicked from All
4805         * Applications.  Needed because of user testing between the old
4806         * and new Settings apps.
4807         */
4808        // TODO: 881807
4809        public static final String SETTINGS_CLASSNAME = "settings_classname";
4810
4811        /**
4812         * @deprecated Use {@link android.provider.Settings.Global#USB_MASS_STORAGE_ENABLED} instead
4813         */
4814        @Deprecated
4815        public static final String USB_MASS_STORAGE_ENABLED = Global.USB_MASS_STORAGE_ENABLED;
4816
4817        /**
4818         * @deprecated Use {@link android.provider.Settings.Global#USE_GOOGLE_MAIL} instead
4819         */
4820        @Deprecated
4821        public static final String USE_GOOGLE_MAIL = Global.USE_GOOGLE_MAIL;
4822
4823        /**
4824         * If accessibility is enabled.
4825         */
4826        public static final String ACCESSIBILITY_ENABLED = "accessibility_enabled";
4827
4828        /**
4829         * If touch exploration is enabled.
4830         */
4831        public static final String TOUCH_EXPLORATION_ENABLED = "touch_exploration_enabled";
4832
4833        /**
4834         * List of the enabled accessibility providers.
4835         */
4836        public static final String ENABLED_ACCESSIBILITY_SERVICES =
4837            "enabled_accessibility_services";
4838
4839        /**
4840         * List of the accessibility services to which the user has granted
4841         * permission to put the device into touch exploration mode.
4842         *
4843         * @hide
4844         */
4845        public static final String TOUCH_EXPLORATION_GRANTED_ACCESSIBILITY_SERVICES =
4846            "touch_exploration_granted_accessibility_services";
4847
4848        /**
4849         * Whether to speak passwords while in accessibility mode.
4850         */
4851        public static final String ACCESSIBILITY_SPEAK_PASSWORD = "speak_password";
4852
4853        /**
4854         * Whether to draw text with high contrast while in accessibility mode.
4855         *
4856         * @hide
4857         */
4858        public static final String ACCESSIBILITY_HIGH_TEXT_CONTRAST_ENABLED =
4859                "high_text_contrast_enabled";
4860
4861        /**
4862         * If injection of accessibility enhancing JavaScript screen-reader
4863         * is enabled.
4864         * <p>
4865         *   Note: The JavaScript based screen-reader is served by the
4866         *   Google infrastructure and enable users with disabilities to
4867         *   efficiently navigate in and explore web content.
4868         * </p>
4869         * <p>
4870         *   This property represents a boolean value.
4871         * </p>
4872         * @hide
4873         */
4874        public static final String ACCESSIBILITY_SCRIPT_INJECTION =
4875            "accessibility_script_injection";
4876
4877        /**
4878         * The URL for the injected JavaScript based screen-reader used
4879         * for providing accessibility of content in WebView.
4880         * <p>
4881         *   Note: The JavaScript based screen-reader is served by the
4882         *   Google infrastructure and enable users with disabilities to
4883         *   efficiently navigate in and explore web content.
4884         * </p>
4885         * <p>
4886         *   This property represents a string value.
4887         * </p>
4888         * @hide
4889         */
4890        public static final String ACCESSIBILITY_SCREEN_READER_URL =
4891            "accessibility_script_injection_url";
4892
4893        /**
4894         * Key bindings for navigation in built-in accessibility support for web content.
4895         * <p>
4896         *   Note: These key bindings are for the built-in accessibility navigation for
4897         *   web content which is used as a fall back solution if JavaScript in a WebView
4898         *   is not enabled or the user has not opted-in script injection from Google.
4899         * </p>
4900         * <p>
4901         *   The bindings are separated by semi-colon. A binding is a mapping from
4902         *   a key to a sequence of actions (for more details look at
4903         *   android.webkit.AccessibilityInjector). A key is represented as the hexademical
4904         *   string representation of an integer obtained from a meta state (optional) shifted
4905         *   sixteen times left and bitwise ored with a key code. An action is represented
4906         *   as a hexademical string representation of an integer where the first two digits
4907         *   are navigation action index, the second, the third, and the fourth digit pairs
4908         *   represent the action arguments. The separate actions in a binding are colon
4909         *   separated. The key and the action sequence it maps to are separated by equals.
4910         * </p>
4911         * <p>
4912         *   For example, the binding below maps the DPAD right button to traverse the
4913         *   current navigation axis once without firing an accessibility event and to
4914         *   perform the same traversal again but to fire an event:
4915         *   <code>
4916         *     0x16=0x01000100:0x01000101;
4917         *   </code>
4918         * </p>
4919         * <p>
4920         *   The goal of this binding is to enable dynamic rebinding of keys to
4921         *   navigation actions for web content without requiring a framework change.
4922         * </p>
4923         * <p>
4924         *   This property represents a string value.
4925         * </p>
4926         * @hide
4927         */
4928        public static final String ACCESSIBILITY_WEB_CONTENT_KEY_BINDINGS =
4929            "accessibility_web_content_key_bindings";
4930
4931        /**
4932         * Setting that specifies whether the display magnification is enabled.
4933         * Display magnifications allows the user to zoom in the display content
4934         * and is targeted to low vision users. The current magnification scale
4935         * is controlled by {@link #ACCESSIBILITY_DISPLAY_MAGNIFICATION_SCALE}.
4936         *
4937         * @hide
4938         */
4939        public static final String ACCESSIBILITY_DISPLAY_MAGNIFICATION_ENABLED =
4940                "accessibility_display_magnification_enabled";
4941
4942        /**
4943         * Setting that specifies what the display magnification scale is.
4944         * Display magnifications allows the user to zoom in the display
4945         * content and is targeted to low vision users. Whether a display
4946         * magnification is performed is controlled by
4947         * {@link #ACCESSIBILITY_DISPLAY_MAGNIFICATION_ENABLED}
4948         *
4949         * @hide
4950         */
4951        public static final String ACCESSIBILITY_DISPLAY_MAGNIFICATION_SCALE =
4952                "accessibility_display_magnification_scale";
4953
4954        /**
4955         * Setting that specifies whether the display magnification should be
4956         * automatically updated. If this fearture is enabled the system will
4957         * exit magnification mode or pan the viewport when a context change
4958         * occurs. For example, on staring a new activity or rotating the screen,
4959         * the system may zoom out so the user can see the new context he is in.
4960         * Another example is on showing a window that is not visible in the
4961         * magnified viewport the system may pan the viewport to make the window
4962         * the has popped up so the user knows that the context has changed.
4963         * Whether a screen magnification is performed is controlled by
4964         * {@link #ACCESSIBILITY_DISPLAY_MAGNIFICATION_ENABLED}
4965         *
4966         * @hide
4967         */
4968        public static final String ACCESSIBILITY_DISPLAY_MAGNIFICATION_AUTO_UPDATE =
4969                "accessibility_display_magnification_auto_update";
4970
4971        /**
4972         * Setting that specifies what mode the soft keyboard is in (default or hidden). Can be
4973         * modified from an AccessibilityService using the SoftKeyboardController.
4974         *
4975         * @hide
4976         */
4977        public static final String ACCESSIBILITY_SOFT_KEYBOARD_MODE =
4978                "accessibility_soft_keyboard_mode";
4979
4980        /**
4981         * Default soft keyboard behavior.
4982         *
4983         * @hide
4984         */
4985        public static final int SHOW_MODE_AUTO = 0;
4986
4987        /**
4988         * Soft keyboard is never shown.
4989         *
4990         * @hide
4991         */
4992        public static final int SHOW_MODE_HIDDEN = 1;
4993
4994        /**
4995         * Setting that specifies whether timed text (captions) should be
4996         * displayed in video content. Text display properties are controlled by
4997         * the following settings:
4998         * <ul>
4999         * <li>{@link #ACCESSIBILITY_CAPTIONING_LOCALE}
5000         * <li>{@link #ACCESSIBILITY_CAPTIONING_BACKGROUND_COLOR}
5001         * <li>{@link #ACCESSIBILITY_CAPTIONING_FOREGROUND_COLOR}
5002         * <li>{@link #ACCESSIBILITY_CAPTIONING_EDGE_COLOR}
5003         * <li>{@link #ACCESSIBILITY_CAPTIONING_EDGE_TYPE}
5004         * <li>{@link #ACCESSIBILITY_CAPTIONING_TYPEFACE}
5005         * <li>{@link #ACCESSIBILITY_CAPTIONING_FONT_SCALE}
5006         * </ul>
5007         *
5008         * @hide
5009         */
5010        public static final String ACCESSIBILITY_CAPTIONING_ENABLED =
5011                "accessibility_captioning_enabled";
5012
5013        /**
5014         * Setting that specifies the language for captions as a locale string,
5015         * e.g. en_US.
5016         *
5017         * @see java.util.Locale#toString
5018         * @hide
5019         */
5020        public static final String ACCESSIBILITY_CAPTIONING_LOCALE =
5021                "accessibility_captioning_locale";
5022
5023        /**
5024         * Integer property that specifies the preset style for captions, one
5025         * of:
5026         * <ul>
5027         * <li>{@link android.view.accessibility.CaptioningManager.CaptionStyle#PRESET_CUSTOM}
5028         * <li>a valid index of {@link android.view.accessibility.CaptioningManager.CaptionStyle#PRESETS}
5029         * </ul>
5030         *
5031         * @see java.util.Locale#toString
5032         * @hide
5033         */
5034        public static final String ACCESSIBILITY_CAPTIONING_PRESET =
5035                "accessibility_captioning_preset";
5036
5037        /**
5038         * Integer property that specifes the background color for captions as a
5039         * packed 32-bit color.
5040         *
5041         * @see android.graphics.Color#argb
5042         * @hide
5043         */
5044        public static final String ACCESSIBILITY_CAPTIONING_BACKGROUND_COLOR =
5045                "accessibility_captioning_background_color";
5046
5047        /**
5048         * Integer property that specifes the foreground color for captions as a
5049         * packed 32-bit color.
5050         *
5051         * @see android.graphics.Color#argb
5052         * @hide
5053         */
5054        public static final String ACCESSIBILITY_CAPTIONING_FOREGROUND_COLOR =
5055                "accessibility_captioning_foreground_color";
5056
5057        /**
5058         * Integer property that specifes the edge type for captions, one of:
5059         * <ul>
5060         * <li>{@link android.view.accessibility.CaptioningManager.CaptionStyle#EDGE_TYPE_NONE}
5061         * <li>{@link android.view.accessibility.CaptioningManager.CaptionStyle#EDGE_TYPE_OUTLINE}
5062         * <li>{@link android.view.accessibility.CaptioningManager.CaptionStyle#EDGE_TYPE_DROP_SHADOW}
5063         * </ul>
5064         *
5065         * @see #ACCESSIBILITY_CAPTIONING_EDGE_COLOR
5066         * @hide
5067         */
5068        public static final String ACCESSIBILITY_CAPTIONING_EDGE_TYPE =
5069                "accessibility_captioning_edge_type";
5070
5071        /**
5072         * Integer property that specifes the edge color for captions as a
5073         * packed 32-bit color.
5074         *
5075         * @see #ACCESSIBILITY_CAPTIONING_EDGE_TYPE
5076         * @see android.graphics.Color#argb
5077         * @hide
5078         */
5079        public static final String ACCESSIBILITY_CAPTIONING_EDGE_COLOR =
5080                "accessibility_captioning_edge_color";
5081
5082        /**
5083         * Integer property that specifes the window color for captions as a
5084         * packed 32-bit color.
5085         *
5086         * @see android.graphics.Color#argb
5087         * @hide
5088         */
5089        public static final String ACCESSIBILITY_CAPTIONING_WINDOW_COLOR =
5090                "accessibility_captioning_window_color";
5091
5092        /**
5093         * String property that specifies the typeface for captions, one of:
5094         * <ul>
5095         * <li>DEFAULT
5096         * <li>MONOSPACE
5097         * <li>SANS_SERIF
5098         * <li>SERIF
5099         * </ul>
5100         *
5101         * @see android.graphics.Typeface
5102         * @hide
5103         */
5104        public static final String ACCESSIBILITY_CAPTIONING_TYPEFACE =
5105                "accessibility_captioning_typeface";
5106
5107        /**
5108         * Floating point property that specifies font scaling for captions.
5109         *
5110         * @hide
5111         */
5112        public static final String ACCESSIBILITY_CAPTIONING_FONT_SCALE =
5113                "accessibility_captioning_font_scale";
5114
5115        /**
5116         * Setting that specifies whether display color inversion is enabled.
5117         */
5118        public static final String ACCESSIBILITY_DISPLAY_INVERSION_ENABLED =
5119                "accessibility_display_inversion_enabled";
5120
5121        /**
5122         * Setting that specifies whether display color space adjustment is
5123         * enabled.
5124         *
5125         * @hide
5126         */
5127        public static final String ACCESSIBILITY_DISPLAY_DALTONIZER_ENABLED =
5128                "accessibility_display_daltonizer_enabled";
5129
5130        /**
5131         * Integer property that specifies the type of color space adjustment to
5132         * perform. Valid values are defined in AccessibilityManager.
5133         *
5134         * @hide
5135         */
5136        public static final String ACCESSIBILITY_DISPLAY_DALTONIZER =
5137                "accessibility_display_daltonizer";
5138
5139        /**
5140         * Float list that specifies the color matrix to apply to
5141         * the display. Valid values are defined in AccessibilityManager.
5142         *
5143         * @hide
5144         */
5145        public static final String ACCESSIBILITY_DISPLAY_COLOR_MATRIX =
5146                "accessibility_display_color_matrix";
5147
5148        /**
5149         * Setting that specifies whether automatic click when the mouse pointer stops moving is
5150         * enabled.
5151         *
5152         * @hide
5153         */
5154        public static final String ACCESSIBILITY_AUTOCLICK_ENABLED =
5155                "accessibility_autoclick_enabled";
5156
5157        /**
5158         * Integer setting specifying amount of time in ms the mouse pointer has to stay still
5159         * before performing click when {@link #ACCESSIBILITY_AUTOCLICK_ENABLED} is set.
5160         *
5161         * @see #ACCESSIBILITY_AUTOCLICK_ENABLED
5162         * @hide
5163         */
5164        public static final String ACCESSIBILITY_AUTOCLICK_DELAY =
5165                "accessibility_autoclick_delay";
5166
5167        /**
5168         * Whether or not larger size icons are used for the pointer of mouse/trackpad for
5169         * accessibility.
5170         * (0 = false, 1 = true)
5171         * @hide
5172         */
5173        public static final String ACCESSIBILITY_LARGE_POINTER_ICON =
5174                "accessibility_large_pointer_icon";
5175
5176        /**
5177         * The timeout for considering a press to be a long press in milliseconds.
5178         * @hide
5179         */
5180        public static final String LONG_PRESS_TIMEOUT = "long_press_timeout";
5181
5182        /**
5183         * List of the enabled print services.
5184         *
5185         * N and beyond uses {@link #DISABLED_PRINT_SERVICES}. But this might be used in an upgrade
5186         * from pre-N.
5187         *
5188         * @hide
5189         */
5190        public static final String ENABLED_PRINT_SERVICES =
5191            "enabled_print_services";
5192
5193        /**
5194         * List of the disabled print services.
5195         *
5196         * @hide
5197         */
5198        public static final String DISABLED_PRINT_SERVICES =
5199            "disabled_print_services";
5200
5201        /**
5202         * The saved value for WindowManagerService.setForcedDisplayDensity()
5203         * formatted as a single integer representing DPI. If unset, then use
5204         * the real display density.
5205         *
5206         * @hide
5207         */
5208        public static final String DISPLAY_DENSITY_FORCED = "display_density_forced";
5209
5210        /**
5211         * Setting to always use the default text-to-speech settings regardless
5212         * of the application settings.
5213         * 1 = override application settings,
5214         * 0 = use application settings (if specified).
5215         *
5216         * @deprecated  The value of this setting is no longer respected by
5217         * the framework text to speech APIs as of the Ice Cream Sandwich release.
5218         */
5219        @Deprecated
5220        public static final String TTS_USE_DEFAULTS = "tts_use_defaults";
5221
5222        /**
5223         * Default text-to-speech engine speech rate. 100 = 1x
5224         */
5225        public static final String TTS_DEFAULT_RATE = "tts_default_rate";
5226
5227        /**
5228         * Default text-to-speech engine pitch. 100 = 1x
5229         */
5230        public static final String TTS_DEFAULT_PITCH = "tts_default_pitch";
5231
5232        /**
5233         * Default text-to-speech engine.
5234         */
5235        public static final String TTS_DEFAULT_SYNTH = "tts_default_synth";
5236
5237        /**
5238         * Default text-to-speech language.
5239         *
5240         * @deprecated this setting is no longer in use, as of the Ice Cream
5241         * Sandwich release. Apps should never need to read this setting directly,
5242         * instead can query the TextToSpeech framework classes for the default
5243         * locale. {@link TextToSpeech#getLanguage()}.
5244         */
5245        @Deprecated
5246        public static final String TTS_DEFAULT_LANG = "tts_default_lang";
5247
5248        /**
5249         * Default text-to-speech country.
5250         *
5251         * @deprecated this setting is no longer in use, as of the Ice Cream
5252         * Sandwich release. Apps should never need to read this setting directly,
5253         * instead can query the TextToSpeech framework classes for the default
5254         * locale. {@link TextToSpeech#getLanguage()}.
5255         */
5256        @Deprecated
5257        public static final String TTS_DEFAULT_COUNTRY = "tts_default_country";
5258
5259        /**
5260         * Default text-to-speech locale variant.
5261         *
5262         * @deprecated this setting is no longer in use, as of the Ice Cream
5263         * Sandwich release. Apps should never need to read this setting directly,
5264         * instead can query the TextToSpeech framework classes for the
5265         * locale that is in use {@link TextToSpeech#getLanguage()}.
5266         */
5267        @Deprecated
5268        public static final String TTS_DEFAULT_VARIANT = "tts_default_variant";
5269
5270        /**
5271         * Stores the default tts locales on a per engine basis. Stored as
5272         * a comma seperated list of values, each value being of the form
5273         * {@code engine_name:locale} for example,
5274         * {@code com.foo.ttsengine:eng-USA,com.bar.ttsengine:esp-ESP}. This
5275         * supersedes {@link #TTS_DEFAULT_LANG}, {@link #TTS_DEFAULT_COUNTRY} and
5276         * {@link #TTS_DEFAULT_VARIANT}. Apps should never need to read this
5277         * setting directly, and can query the TextToSpeech framework classes
5278         * for the locale that is in use.
5279         *
5280         * @hide
5281         */
5282        public static final String TTS_DEFAULT_LOCALE = "tts_default_locale";
5283
5284        /**
5285         * Space delimited list of plugin packages that are enabled.
5286         */
5287        public static final String TTS_ENABLED_PLUGINS = "tts_enabled_plugins";
5288
5289        /**
5290         * @deprecated Use {@link android.provider.Settings.Global#WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON}
5291         * instead.
5292         */
5293        @Deprecated
5294        public static final String WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON =
5295                Global.WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON;
5296
5297        /**
5298         * @deprecated Use {@link android.provider.Settings.Global#WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY}
5299         * instead.
5300         */
5301        @Deprecated
5302        public static final String WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY =
5303                Global.WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY;
5304
5305        /**
5306         * @deprecated Use {@link android.provider.Settings.Global#WIFI_NUM_OPEN_NETWORKS_KEPT}
5307         * instead.
5308         */
5309        @Deprecated
5310        public static final String WIFI_NUM_OPEN_NETWORKS_KEPT =
5311                Global.WIFI_NUM_OPEN_NETWORKS_KEPT;
5312
5313        /**
5314         * @deprecated Use {@link android.provider.Settings.Global#WIFI_ON}
5315         * instead.
5316         */
5317        @Deprecated
5318        public static final String WIFI_ON = Global.WIFI_ON;
5319
5320        /**
5321         * The acceptable packet loss percentage (range 0 - 100) before trying
5322         * another AP on the same network.
5323         * @deprecated This setting is not used.
5324         */
5325        @Deprecated
5326        public static final String WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE =
5327                "wifi_watchdog_acceptable_packet_loss_percentage";
5328
5329        /**
5330         * The number of access points required for a network in order for the
5331         * watchdog to monitor it.
5332         * @deprecated This setting is not used.
5333         */
5334        @Deprecated
5335        public static final String WIFI_WATCHDOG_AP_COUNT = "wifi_watchdog_ap_count";
5336
5337        /**
5338         * The delay between background checks.
5339         * @deprecated This setting is not used.
5340         */
5341        @Deprecated
5342        public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS =
5343                "wifi_watchdog_background_check_delay_ms";
5344
5345        /**
5346         * Whether the Wi-Fi watchdog is enabled for background checking even
5347         * after it thinks the user has connected to a good access point.
5348         * @deprecated This setting is not used.
5349         */
5350        @Deprecated
5351        public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED =
5352                "wifi_watchdog_background_check_enabled";
5353
5354        /**
5355         * The timeout for a background ping
5356         * @deprecated This setting is not used.
5357         */
5358        @Deprecated
5359        public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS =
5360                "wifi_watchdog_background_check_timeout_ms";
5361
5362        /**
5363         * The number of initial pings to perform that *may* be ignored if they
5364         * fail. Again, if these fail, they will *not* be used in packet loss
5365         * calculation. For example, one network always seemed to time out for
5366         * the first couple pings, so this is set to 3 by default.
5367         * @deprecated This setting is not used.
5368         */
5369        @Deprecated
5370        public static final String WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT =
5371            "wifi_watchdog_initial_ignored_ping_count";
5372
5373        /**
5374         * The maximum number of access points (per network) to attempt to test.
5375         * If this number is reached, the watchdog will no longer monitor the
5376         * initial connection state for the network. This is a safeguard for
5377         * networks containing multiple APs whose DNS does not respond to pings.
5378         * @deprecated This setting is not used.
5379         */
5380        @Deprecated
5381        public static final String WIFI_WATCHDOG_MAX_AP_CHECKS = "wifi_watchdog_max_ap_checks";
5382
5383        /**
5384         * @deprecated Use {@link android.provider.Settings.Global#WIFI_WATCHDOG_ON} instead
5385         */
5386        @Deprecated
5387        public static final String WIFI_WATCHDOG_ON = "wifi_watchdog_on";
5388
5389        /**
5390         * A comma-separated list of SSIDs for which the Wi-Fi watchdog should be enabled.
5391         * @deprecated This setting is not used.
5392         */
5393        @Deprecated
5394        public static final String WIFI_WATCHDOG_WATCH_LIST = "wifi_watchdog_watch_list";
5395
5396        /**
5397         * The number of pings to test if an access point is a good connection.
5398         * @deprecated This setting is not used.
5399         */
5400        @Deprecated
5401        public static final String WIFI_WATCHDOG_PING_COUNT = "wifi_watchdog_ping_count";
5402
5403        /**
5404         * The delay between pings.
5405         * @deprecated This setting is not used.
5406         */
5407        @Deprecated
5408        public static final String WIFI_WATCHDOG_PING_DELAY_MS = "wifi_watchdog_ping_delay_ms";
5409
5410        /**
5411         * The timeout per ping.
5412         * @deprecated This setting is not used.
5413         */
5414        @Deprecated
5415        public static final String WIFI_WATCHDOG_PING_TIMEOUT_MS = "wifi_watchdog_ping_timeout_ms";
5416
5417        /**
5418         * @deprecated Use
5419         * {@link android.provider.Settings.Global#WIFI_MAX_DHCP_RETRY_COUNT} instead
5420         */
5421        @Deprecated
5422        public static final String WIFI_MAX_DHCP_RETRY_COUNT = Global.WIFI_MAX_DHCP_RETRY_COUNT;
5423
5424        /**
5425         * @deprecated Use
5426         * {@link android.provider.Settings.Global#WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS} instead
5427         */
5428        @Deprecated
5429        public static final String WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS =
5430                Global.WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS;
5431
5432        /**
5433         * The number of milliseconds to hold on to a PendingIntent based request. This delay gives
5434         * the receivers of the PendingIntent an opportunity to make a new network request before
5435         * the Network satisfying the request is potentially removed.
5436         *
5437         * @hide
5438         */
5439        public static final String CONNECTIVITY_RELEASE_PENDING_INTENT_DELAY_MS =
5440                "connectivity_release_pending_intent_delay_ms";
5441
5442        /**
5443         * Whether background data usage is allowed.
5444         *
5445         * @deprecated As of {@link VERSION_CODES#ICE_CREAM_SANDWICH},
5446         *             availability of background data depends on several
5447         *             combined factors. When background data is unavailable,
5448         *             {@link ConnectivityManager#getActiveNetworkInfo()} will
5449         *             now appear disconnected.
5450         */
5451        @Deprecated
5452        public static final String BACKGROUND_DATA = "background_data";
5453
5454        /**
5455         * Origins for which browsers should allow geolocation by default.
5456         * The value is a space-separated list of origins.
5457         */
5458        public static final String ALLOWED_GEOLOCATION_ORIGINS
5459                = "allowed_geolocation_origins";
5460
5461        /**
5462         * The preferred TTY mode     0 = TTy Off, CDMA default
5463         *                            1 = TTY Full
5464         *                            2 = TTY HCO
5465         *                            3 = TTY VCO
5466         * @hide
5467         */
5468        public static final String PREFERRED_TTY_MODE =
5469                "preferred_tty_mode";
5470
5471        /**
5472         * Whether the enhanced voice privacy mode is enabled.
5473         * 0 = normal voice privacy
5474         * 1 = enhanced voice privacy
5475         * @hide
5476         */
5477        public static final String ENHANCED_VOICE_PRIVACY_ENABLED = "enhanced_voice_privacy_enabled";
5478
5479        /**
5480         * Whether the TTY mode mode is enabled.
5481         * 0 = disabled
5482         * 1 = enabled
5483         * @hide
5484         */
5485        public static final String TTY_MODE_ENABLED = "tty_mode_enabled";
5486
5487        /**
5488         * Controls whether settings backup is enabled.
5489         * Type: int ( 0 = disabled, 1 = enabled )
5490         * @hide
5491         */
5492        public static final String BACKUP_ENABLED = "backup_enabled";
5493
5494        /**
5495         * Controls whether application data is automatically restored from backup
5496         * at install time.
5497         * Type: int ( 0 = disabled, 1 = enabled )
5498         * @hide
5499         */
5500        public static final String BACKUP_AUTO_RESTORE = "backup_auto_restore";
5501
5502        /**
5503         * Indicates whether settings backup has been fully provisioned.
5504         * Type: int ( 0 = unprovisioned, 1 = fully provisioned )
5505         * @hide
5506         */
5507        public static final String BACKUP_PROVISIONED = "backup_provisioned";
5508
5509        /**
5510         * Component of the transport to use for backup/restore.
5511         * @hide
5512         */
5513        public static final String BACKUP_TRANSPORT = "backup_transport";
5514
5515        /**
5516         * Version for which the setup wizard was last shown.  Bumped for
5517         * each release when there is new setup information to show.
5518         * @hide
5519         */
5520        public static final String LAST_SETUP_SHOWN = "last_setup_shown";
5521
5522        /**
5523         * The interval in milliseconds after which Wi-Fi is considered idle.
5524         * When idle, it is possible for the device to be switched from Wi-Fi to
5525         * the mobile data network.
5526         * @hide
5527         * @deprecated Use {@link android.provider.Settings.Global#WIFI_IDLE_MS}
5528         * instead.
5529         */
5530        @Deprecated
5531        public static final String WIFI_IDLE_MS = Global.WIFI_IDLE_MS;
5532
5533        /**
5534         * The global search provider chosen by the user (if multiple global
5535         * search providers are installed). This will be the provider returned
5536         * by {@link SearchManager#getGlobalSearchActivity()} if it's still
5537         * installed. This setting is stored as a flattened component name as
5538         * per {@link ComponentName#flattenToString()}.
5539         *
5540         * @hide
5541         */
5542        public static final String SEARCH_GLOBAL_SEARCH_ACTIVITY =
5543                "search_global_search_activity";
5544
5545        /**
5546         * The number of promoted sources in GlobalSearch.
5547         * @hide
5548         */
5549        public static final String SEARCH_NUM_PROMOTED_SOURCES = "search_num_promoted_sources";
5550        /**
5551         * The maximum number of suggestions returned by GlobalSearch.
5552         * @hide
5553         */
5554        public static final String SEARCH_MAX_RESULTS_TO_DISPLAY = "search_max_results_to_display";
5555        /**
5556         * The number of suggestions GlobalSearch will ask each non-web search source for.
5557         * @hide
5558         */
5559        public static final String SEARCH_MAX_RESULTS_PER_SOURCE = "search_max_results_per_source";
5560        /**
5561         * The number of suggestions the GlobalSearch will ask the web search source for.
5562         * @hide
5563         */
5564        public static final String SEARCH_WEB_RESULTS_OVERRIDE_LIMIT =
5565                "search_web_results_override_limit";
5566        /**
5567         * The number of milliseconds that GlobalSearch will wait for suggestions from
5568         * promoted sources before continuing with all other sources.
5569         * @hide
5570         */
5571        public static final String SEARCH_PROMOTED_SOURCE_DEADLINE_MILLIS =
5572                "search_promoted_source_deadline_millis";
5573        /**
5574         * The number of milliseconds before GlobalSearch aborts search suggesiton queries.
5575         * @hide
5576         */
5577        public static final String SEARCH_SOURCE_TIMEOUT_MILLIS = "search_source_timeout_millis";
5578        /**
5579         * The maximum number of milliseconds that GlobalSearch shows the previous results
5580         * after receiving a new query.
5581         * @hide
5582         */
5583        public static final String SEARCH_PREFILL_MILLIS = "search_prefill_millis";
5584        /**
5585         * The maximum age of log data used for shortcuts in GlobalSearch.
5586         * @hide
5587         */
5588        public static final String SEARCH_MAX_STAT_AGE_MILLIS = "search_max_stat_age_millis";
5589        /**
5590         * The maximum age of log data used for source ranking in GlobalSearch.
5591         * @hide
5592         */
5593        public static final String SEARCH_MAX_SOURCE_EVENT_AGE_MILLIS =
5594                "search_max_source_event_age_millis";
5595        /**
5596         * The minimum number of impressions needed to rank a source in GlobalSearch.
5597         * @hide
5598         */
5599        public static final String SEARCH_MIN_IMPRESSIONS_FOR_SOURCE_RANKING =
5600                "search_min_impressions_for_source_ranking";
5601        /**
5602         * The minimum number of clicks needed to rank a source in GlobalSearch.
5603         * @hide
5604         */
5605        public static final String SEARCH_MIN_CLICKS_FOR_SOURCE_RANKING =
5606                "search_min_clicks_for_source_ranking";
5607        /**
5608         * The maximum number of shortcuts shown by GlobalSearch.
5609         * @hide
5610         */
5611        public static final String SEARCH_MAX_SHORTCUTS_RETURNED = "search_max_shortcuts_returned";
5612        /**
5613         * The size of the core thread pool for suggestion queries in GlobalSearch.
5614         * @hide
5615         */
5616        public static final String SEARCH_QUERY_THREAD_CORE_POOL_SIZE =
5617                "search_query_thread_core_pool_size";
5618        /**
5619         * The maximum size of the thread pool for suggestion queries in GlobalSearch.
5620         * @hide
5621         */
5622        public static final String SEARCH_QUERY_THREAD_MAX_POOL_SIZE =
5623                "search_query_thread_max_pool_size";
5624        /**
5625         * The size of the core thread pool for shortcut refreshing in GlobalSearch.
5626         * @hide
5627         */
5628        public static final String SEARCH_SHORTCUT_REFRESH_CORE_POOL_SIZE =
5629                "search_shortcut_refresh_core_pool_size";
5630        /**
5631         * The maximum size of the thread pool for shortcut refreshing in GlobalSearch.
5632         * @hide
5633         */
5634        public static final String SEARCH_SHORTCUT_REFRESH_MAX_POOL_SIZE =
5635                "search_shortcut_refresh_max_pool_size";
5636        /**
5637         * The maximun time that excess threads in the GlobalSeach thread pools will
5638         * wait before terminating.
5639         * @hide
5640         */
5641        public static final String SEARCH_THREAD_KEEPALIVE_SECONDS =
5642                "search_thread_keepalive_seconds";
5643        /**
5644         * The maximum number of concurrent suggestion queries to each source.
5645         * @hide
5646         */
5647        public static final String SEARCH_PER_SOURCE_CONCURRENT_QUERY_LIMIT =
5648                "search_per_source_concurrent_query_limit";
5649
5650        /**
5651         * Whether or not alert sounds are played on MountService events. (0 = false, 1 = true)
5652         * @hide
5653         */
5654        public static final String MOUNT_PLAY_NOTIFICATION_SND = "mount_play_not_snd";
5655
5656        /**
5657         * Whether or not UMS auto-starts on UMS host detection. (0 = false, 1 = true)
5658         * @hide
5659         */
5660        public static final String MOUNT_UMS_AUTOSTART = "mount_ums_autostart";
5661
5662        /**
5663         * Whether or not a notification is displayed on UMS host detection. (0 = false, 1 = true)
5664         * @hide
5665         */
5666        public static final String MOUNT_UMS_PROMPT = "mount_ums_prompt";
5667
5668        /**
5669         * Whether or not a notification is displayed while UMS is enabled. (0 = false, 1 = true)
5670         * @hide
5671         */
5672        public static final String MOUNT_UMS_NOTIFY_ENABLED = "mount_ums_notify_enabled";
5673
5674        /**
5675         * If nonzero, ANRs in invisible background processes bring up a dialog.
5676         * Otherwise, the process will be silently killed.
5677         * @hide
5678         */
5679        public static final String ANR_SHOW_BACKGROUND = "anr_show_background";
5680
5681        /**
5682         * The {@link ComponentName} string of the service to be used as the voice recognition
5683         * service.
5684         *
5685         * @hide
5686         */
5687        public static final String VOICE_RECOGNITION_SERVICE = "voice_recognition_service";
5688
5689        /**
5690         * Stores whether an user has consented to have apps verified through PAM.
5691         * The value is boolean (1 or 0).
5692         *
5693         * @hide
5694         */
5695        public static final String PACKAGE_VERIFIER_USER_CONSENT =
5696            "package_verifier_user_consent";
5697
5698        /**
5699         * The {@link ComponentName} string of the selected spell checker service which is
5700         * one of the services managed by the text service manager.
5701         *
5702         * @hide
5703         */
5704        public static final String SELECTED_SPELL_CHECKER = "selected_spell_checker";
5705
5706        /**
5707         * The {@link ComponentName} string of the selected subtype of the selected spell checker
5708         * service which is one of the services managed by the text service manager.
5709         *
5710         * @hide
5711         */
5712        public static final String SELECTED_SPELL_CHECKER_SUBTYPE =
5713                "selected_spell_checker_subtype";
5714
5715        /**
5716         * The {@link ComponentName} string whether spell checker is enabled or not.
5717         *
5718         * @hide
5719         */
5720        public static final String SPELL_CHECKER_ENABLED = "spell_checker_enabled";
5721
5722        /**
5723         * What happens when the user presses the Power button while in-call
5724         * and the screen is on.<br/>
5725         * <b>Values:</b><br/>
5726         * 1 - The Power button turns off the screen and locks the device. (Default behavior)<br/>
5727         * 2 - The Power button hangs up the current call.<br/>
5728         *
5729         * @hide
5730         */
5731        public static final String INCALL_POWER_BUTTON_BEHAVIOR = "incall_power_button_behavior";
5732
5733        /**
5734         * INCALL_POWER_BUTTON_BEHAVIOR value for "turn off screen".
5735         * @hide
5736         */
5737        public static final int INCALL_POWER_BUTTON_BEHAVIOR_SCREEN_OFF = 0x1;
5738
5739        /**
5740         * INCALL_POWER_BUTTON_BEHAVIOR value for "hang up".
5741         * @hide
5742         */
5743        public static final int INCALL_POWER_BUTTON_BEHAVIOR_HANGUP = 0x2;
5744
5745        /**
5746         * INCALL_POWER_BUTTON_BEHAVIOR default value.
5747         * @hide
5748         */
5749        public static final int INCALL_POWER_BUTTON_BEHAVIOR_DEFAULT =
5750                INCALL_POWER_BUTTON_BEHAVIOR_SCREEN_OFF;
5751
5752        /**
5753         * Whether the device should wake when the wake gesture sensor detects motion.
5754         * @hide
5755         */
5756        public static final String WAKE_GESTURE_ENABLED = "wake_gesture_enabled";
5757
5758        /**
5759         * Whether the device should doze if configured.
5760         * @hide
5761         */
5762        public static final String DOZE_ENABLED = "doze_enabled";
5763
5764        /**
5765         * The current night mode that has been selected by the user.  Owned
5766         * and controlled by UiModeManagerService.  Constants are as per
5767         * UiModeManager.
5768         * @hide
5769         */
5770        public static final String UI_NIGHT_MODE = "ui_night_mode";
5771
5772        /**
5773         * Whether screensavers are enabled.
5774         * @hide
5775         */
5776        public static final String SCREENSAVER_ENABLED = "screensaver_enabled";
5777
5778        /**
5779         * The user's chosen screensaver components.
5780         *
5781         * These will be launched by the PhoneWindowManager after a timeout when not on
5782         * battery, or upon dock insertion (if SCREENSAVER_ACTIVATE_ON_DOCK is set to 1).
5783         * @hide
5784         */
5785        public static final String SCREENSAVER_COMPONENTS = "screensaver_components";
5786
5787        /**
5788         * If screensavers are enabled, whether the screensaver should be automatically launched
5789         * when the device is inserted into a (desk) dock.
5790         * @hide
5791         */
5792        public static final String SCREENSAVER_ACTIVATE_ON_DOCK = "screensaver_activate_on_dock";
5793
5794        /**
5795         * If screensavers are enabled, whether the screensaver should be automatically launched
5796         * when the screen times out when not on battery.
5797         * @hide
5798         */
5799        public static final String SCREENSAVER_ACTIVATE_ON_SLEEP = "screensaver_activate_on_sleep";
5800
5801        /**
5802         * If screensavers are enabled, the default screensaver component.
5803         * @hide
5804         */
5805        public static final String SCREENSAVER_DEFAULT_COMPONENT = "screensaver_default_component";
5806
5807        /**
5808         * The default NFC payment component
5809         * @hide
5810         */
5811        public static final String NFC_PAYMENT_DEFAULT_COMPONENT = "nfc_payment_default_component";
5812
5813        /**
5814         * Whether NFC payment is handled by the foreground application or a default.
5815         * @hide
5816         */
5817        public static final String NFC_PAYMENT_FOREGROUND = "nfc_payment_foreground";
5818
5819        /**
5820         * Specifies the package name currently configured to be the primary sms application
5821         * @hide
5822         */
5823        public static final String SMS_DEFAULT_APPLICATION = "sms_default_application";
5824
5825        /**
5826         * Specifies the package name currently configured to be the default dialer application
5827         * @hide
5828         */
5829        public static final String DIALER_DEFAULT_APPLICATION = "dialer_default_application";
5830
5831        /**
5832         * Specifies the package name currently configured to be the emergency assistance application
5833         *
5834         * @see android.telephony.TelephonyManager#ACTION_EMERGENCY_ASSISTANCE
5835         *
5836         * @hide
5837         */
5838        public static final String EMERGENCY_ASSISTANCE_APPLICATION = "emergency_assistance_application";
5839
5840        /**
5841         * Specifies whether the current app context on scren (assist data) will be sent to the
5842         * assist application (active voice interaction service).
5843         *
5844         * @hide
5845         */
5846        public static final String ASSIST_STRUCTURE_ENABLED = "assist_structure_enabled";
5847
5848        /**
5849         * Specifies whether a screenshot of the screen contents will be sent to the assist
5850         * application (active voice interaction service).
5851         *
5852         * @hide
5853         */
5854        public static final String ASSIST_SCREENSHOT_ENABLED = "assist_screenshot_enabled";
5855
5856        /**
5857         * Names of the service component that the current user has explicitly allowed to
5858         * see and change the importance of all of the user's notifications.
5859         *
5860         * @hide
5861         */
5862        public static final String ENABLED_NOTIFICATION_ASSISTANT
5863                = "enabled_notification_assistant";
5864
5865        /**
5866         * Names of the service components that the current user has explicitly allowed to
5867         * see all of the user's notifications, separated by ':'.
5868         *
5869         * @hide
5870         */
5871        public static final String ENABLED_NOTIFICATION_LISTENERS = "enabled_notification_listeners";
5872
5873        /**
5874         * Names of the packages that the current user has explicitly allowed to
5875         * manage notification policy configuration, separated by ':'.
5876         */
5877        public static final String ENABLED_NOTIFICATION_POLICY_ACCESS_PACKAGES =
5878                "enabled_notification_policy_access_packages";
5879
5880        /** @hide */
5881        public static final String BAR_SERVICE_COMPONENT = "bar_service_component";
5882
5883        /** @hide */
5884        public static final String VOLUME_CONTROLLER_SERVICE_COMPONENT
5885                = "volume_controller_service_component";
5886
5887        /** @hide */
5888        public static final String IMMERSIVE_MODE_CONFIRMATIONS = "immersive_mode_confirmations";
5889
5890        /**
5891         * This is the query URI for finding a print service to install.
5892         *
5893         * @hide
5894         */
5895        public static final String PRINT_SERVICE_SEARCH_URI = "print_service_search_uri";
5896
5897        /**
5898         * This is the query URI for finding a NFC payment service to install.
5899         *
5900         * @hide
5901         */
5902        public static final String PAYMENT_SERVICE_SEARCH_URI = "payment_service_search_uri";
5903
5904        /**
5905         * If enabled, apps should try to skip any introductory hints on first launch. This might
5906         * apply to users that are already familiar with the environment or temporary users.
5907         * <p>
5908         * Type : int (0 to show hints, 1 to skip showing hints)
5909         */
5910        public static final String SKIP_FIRST_USE_HINTS = "skip_first_use_hints";
5911
5912        /**
5913         * Persisted playback time after a user confirmation of an unsafe volume level.
5914         *
5915         * @hide
5916         */
5917        public static final String UNSAFE_VOLUME_MUSIC_ACTIVE_MS = "unsafe_volume_music_active_ms";
5918
5919        /**
5920         * This preference enables notification display on the lockscreen.
5921         * @hide
5922         */
5923        public static final String LOCK_SCREEN_SHOW_NOTIFICATIONS =
5924                "lock_screen_show_notifications";
5925
5926        /**
5927         * List of TV inputs that are currently hidden. This is a string
5928         * containing the IDs of all hidden TV inputs. Each ID is encoded by
5929         * {@link android.net.Uri#encode(String)} and separated by ':'.
5930         * @hide
5931         */
5932        public static final String TV_INPUT_HIDDEN_INPUTS = "tv_input_hidden_inputs";
5933
5934        /**
5935         * List of custom TV input labels. This is a string containing <TV input id, custom name>
5936         * pairs. TV input id and custom name are encoded by {@link android.net.Uri#encode(String)}
5937         * and separated by ','. Each pair is separated by ':'.
5938         * @hide
5939         */
5940        public static final String TV_INPUT_CUSTOM_LABELS = "tv_input_custom_labels";
5941
5942        /**
5943         * Whether automatic routing of system audio to USB audio peripheral is disabled.
5944         * The value is boolean (1 or 0), where 1 means automatic routing is disabled,
5945         * and 0 means automatic routing is enabled.
5946         *
5947         * @hide
5948         */
5949        public static final String USB_AUDIO_AUTOMATIC_ROUTING_DISABLED =
5950                "usb_audio_automatic_routing_disabled";
5951
5952        /**
5953         * The timeout in milliseconds before the device fully goes to sleep after
5954         * a period of inactivity.  This value sets an upper bound on how long the device
5955         * will stay awake or dreaming without user activity.  It should generally
5956         * be longer than {@link Settings.System#SCREEN_OFF_TIMEOUT} as otherwise the device
5957         * will sleep before it ever has a chance to dream.
5958         * <p>
5959         * Use -1 to disable this timeout.
5960         * </p>
5961         *
5962         * @hide
5963         */
5964        public static final String SLEEP_TIMEOUT = "sleep_timeout";
5965
5966        /**
5967         * Controls whether double tap to wake is enabled.
5968         * @hide
5969         */
5970        public static final String DOUBLE_TAP_TO_WAKE = "double_tap_to_wake";
5971
5972        /**
5973         * The current assistant component. It could be a voice interaction service,
5974         * or an activity that handles ACTION_ASSIST, or empty which means using the default
5975         * handling.
5976         *
5977         * @hide
5978         */
5979        public static final String ASSISTANT = "assistant";
5980
5981        /**
5982         * Whether the camera launch gesture should be disabled.
5983         *
5984         * @hide
5985         */
5986        public static final String CAMERA_GESTURE_DISABLED = "camera_gesture_disabled";
5987
5988        /**
5989         * Whether the camera launch gesture to double tap the power button when the screen is off
5990         * should be disabled.
5991         *
5992         * @hide
5993         */
5994        public static final String CAMERA_DOUBLE_TAP_POWER_GESTURE_DISABLED =
5995                "camera_double_tap_power_gesture_disabled";
5996
5997        /**
5998
5999        /**
6000         * Behavior of twilight on the device.
6001         * One of {@link #TWILIGHT_MODE_LOCKED_OFF}, {@link #TWILIGHT_MODE_LOCKED_ON}
6002         * or {@link #TWILIGHT_MODE_AUTO}.
6003         * @hide
6004         */
6005        public static final String TWILIGHT_MODE = "twilight_mode";
6006
6007        /**
6008         * Twilight mode always off.
6009         * @hide
6010         */
6011        public static final int TWILIGHT_MODE_LOCKED_OFF = 0;
6012
6013        /**
6014         * Twilight mode always on.
6015         * @hide
6016         */
6017        public static final int TWILIGHT_MODE_LOCKED_ON = 1;
6018
6019        /**
6020         * Twilight mode auto.
6021         * @hide
6022         */
6023        public static final int TWILIGHT_MODE_AUTO = 2;
6024
6025        /**
6026         * Twilight mode auto, temporarily overriden to on.
6027         * @hide
6028         */
6029        public static final int TWILIGHT_MODE_AUTO_OVERRIDE_OFF = 3;
6030
6031        /**
6032         * Twilight mode auto, temporarily overriden to off.
6033         * @hide
6034         */
6035        public static final int TWILIGHT_MODE_AUTO_OVERRIDE_ON = 4;
6036
6037        /**
6038         * Whether brightness should automatically adjust based on twilight state.
6039         * @hide
6040         */
6041        public static final String BRIGHTNESS_USE_TWILIGHT = "brightness_use_twilight";
6042
6043        /**
6044         * This are the settings to be backed up.
6045         *
6046         * NOTE: Settings are backed up and restored in the order they appear
6047         *       in this array. If you have one setting depending on another,
6048         *       make sure that they are ordered appropriately.
6049         *
6050         * @hide
6051         */
6052        public static final String[] SETTINGS_TO_BACKUP = {
6053            BUGREPORT_IN_POWER_MENU,                            // moved to global
6054            ALLOW_MOCK_LOCATION,
6055            PARENTAL_CONTROL_ENABLED,
6056            PARENTAL_CONTROL_REDIRECT_URL,
6057            USB_MASS_STORAGE_ENABLED,                           // moved to global
6058            ACCESSIBILITY_DISPLAY_INVERSION_ENABLED,
6059            ACCESSIBILITY_DISPLAY_DALTONIZER,
6060            ACCESSIBILITY_DISPLAY_COLOR_MATRIX,
6061            ACCESSIBILITY_DISPLAY_DALTONIZER_ENABLED,
6062            ACCESSIBILITY_DISPLAY_MAGNIFICATION_ENABLED,
6063            ACCESSIBILITY_DISPLAY_MAGNIFICATION_SCALE,
6064            ACCESSIBILITY_DISPLAY_MAGNIFICATION_AUTO_UPDATE,
6065            ACCESSIBILITY_SCRIPT_INJECTION,
6066            ACCESSIBILITY_WEB_CONTENT_KEY_BINDINGS,
6067            BACKUP_AUTO_RESTORE,
6068            ENABLED_ACCESSIBILITY_SERVICES,
6069            ENABLED_NOTIFICATION_LISTENERS,
6070            ENABLED_INPUT_METHODS,
6071            TOUCH_EXPLORATION_GRANTED_ACCESSIBILITY_SERVICES,
6072            TOUCH_EXPLORATION_ENABLED,
6073            ACCESSIBILITY_ENABLED,
6074            ACCESSIBILITY_SPEAK_PASSWORD,
6075            ACCESSIBILITY_HIGH_TEXT_CONTRAST_ENABLED,
6076            ACCESSIBILITY_CAPTIONING_PRESET,
6077            ACCESSIBILITY_CAPTIONING_ENABLED,
6078            ACCESSIBILITY_CAPTIONING_LOCALE,
6079            ACCESSIBILITY_CAPTIONING_BACKGROUND_COLOR,
6080            ACCESSIBILITY_CAPTIONING_FOREGROUND_COLOR,
6081            ACCESSIBILITY_CAPTIONING_EDGE_TYPE,
6082            ACCESSIBILITY_CAPTIONING_EDGE_COLOR,
6083            ACCESSIBILITY_CAPTIONING_TYPEFACE,
6084            ACCESSIBILITY_CAPTIONING_FONT_SCALE,
6085            ACCESSIBILITY_CAPTIONING_WINDOW_COLOR,
6086            TTS_USE_DEFAULTS,
6087            TTS_DEFAULT_RATE,
6088            TTS_DEFAULT_PITCH,
6089            TTS_DEFAULT_SYNTH,
6090            TTS_DEFAULT_LANG,
6091            TTS_DEFAULT_COUNTRY,
6092            TTS_ENABLED_PLUGINS,
6093            TTS_DEFAULT_LOCALE,
6094            SHOW_IME_WITH_HARD_KEYBOARD,
6095            WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON,            // moved to global
6096            WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY,               // moved to global
6097            WIFI_NUM_OPEN_NETWORKS_KEPT,                        // moved to global
6098            SELECTED_SPELL_CHECKER,
6099            SELECTED_SPELL_CHECKER_SUBTYPE,
6100            SPELL_CHECKER_ENABLED,
6101            MOUNT_PLAY_NOTIFICATION_SND,
6102            MOUNT_UMS_AUTOSTART,
6103            MOUNT_UMS_PROMPT,
6104            MOUNT_UMS_NOTIFY_ENABLED,
6105            UI_NIGHT_MODE,
6106            SLEEP_TIMEOUT,
6107            DOUBLE_TAP_TO_WAKE,
6108            WAKE_GESTURE_ENABLED,
6109            LONG_PRESS_TIMEOUT,
6110            CAMERA_GESTURE_DISABLED,
6111            ACCESSIBILITY_AUTOCLICK_ENABLED,
6112            ACCESSIBILITY_AUTOCLICK_DELAY,
6113            ACCESSIBILITY_LARGE_POINTER_ICON,
6114            PREFERRED_TTY_MODE,
6115            ENHANCED_VOICE_PRIVACY_ENABLED,
6116            TTY_MODE_ENABLED,
6117            INCALL_POWER_BUTTON_BEHAVIOR
6118        };
6119
6120        /**
6121         * These entries are considered common between the personal and the managed profile,
6122         * since the managed profile doesn't get to change them.
6123         */
6124        private static final Set<String> CLONE_TO_MANAGED_PROFILE = new ArraySet<>();
6125
6126        static {
6127            CLONE_TO_MANAGED_PROFILE.add(ACCESSIBILITY_ENABLED);
6128            CLONE_TO_MANAGED_PROFILE.add(ALLOW_MOCK_LOCATION);
6129            CLONE_TO_MANAGED_PROFILE.add(ALLOWED_GEOLOCATION_ORIGINS);
6130            CLONE_TO_MANAGED_PROFILE.add(DEFAULT_INPUT_METHOD);
6131            CLONE_TO_MANAGED_PROFILE.add(ENABLED_ACCESSIBILITY_SERVICES);
6132            CLONE_TO_MANAGED_PROFILE.add(ENABLED_INPUT_METHODS);
6133            CLONE_TO_MANAGED_PROFILE.add(LOCATION_MODE);
6134            CLONE_TO_MANAGED_PROFILE.add(LOCATION_PREVIOUS_MODE);
6135            CLONE_TO_MANAGED_PROFILE.add(LOCATION_PROVIDERS_ALLOWED);
6136            CLONE_TO_MANAGED_PROFILE.add(SELECTED_INPUT_METHOD_SUBTYPE);
6137            CLONE_TO_MANAGED_PROFILE.add(SELECTED_SPELL_CHECKER);
6138            CLONE_TO_MANAGED_PROFILE.add(SELECTED_SPELL_CHECKER_SUBTYPE);
6139        }
6140
6141        /** @hide */
6142        public static void getCloneToManagedProfileSettings(Set<String> outKeySet) {
6143            outKeySet.addAll(CLONE_TO_MANAGED_PROFILE);
6144        }
6145
6146        /**
6147         * Helper method for determining if a location provider is enabled.
6148         *
6149         * @param cr the content resolver to use
6150         * @param provider the location provider to query
6151         * @return true if the provider is enabled
6152         *
6153         * @deprecated use {@link #LOCATION_MODE} or
6154         *             {@link LocationManager#isProviderEnabled(String)}
6155         */
6156        @Deprecated
6157        public static final boolean isLocationProviderEnabled(ContentResolver cr, String provider) {
6158            return isLocationProviderEnabledForUser(cr, provider, UserHandle.myUserId());
6159        }
6160
6161        /**
6162         * Helper method for determining if a location provider is enabled.
6163         * @param cr the content resolver to use
6164         * @param provider the location provider to query
6165         * @param userId the userId to query
6166         * @return true if the provider is enabled
6167         * @deprecated use {@link #LOCATION_MODE} or
6168         *             {@link LocationManager#isProviderEnabled(String)}
6169         * @hide
6170         */
6171        @Deprecated
6172        public static final boolean isLocationProviderEnabledForUser(ContentResolver cr, String provider, int userId) {
6173            String allowedProviders = Settings.Secure.getStringForUser(cr,
6174                    LOCATION_PROVIDERS_ALLOWED, userId);
6175            return TextUtils.delimitedStringContains(allowedProviders, ',', provider);
6176        }
6177
6178        /**
6179         * Thread-safe method for enabling or disabling a single location provider.
6180         * @param cr the content resolver to use
6181         * @param provider the location provider to enable or disable
6182         * @param enabled true if the provider should be enabled
6183         * @deprecated use {@link #putInt(ContentResolver, String, int)} and {@link #LOCATION_MODE}
6184         */
6185        @Deprecated
6186        public static final void setLocationProviderEnabled(ContentResolver cr,
6187                String provider, boolean enabled) {
6188            setLocationProviderEnabledForUser(cr, provider, enabled, UserHandle.myUserId());
6189        }
6190
6191        /**
6192         * Thread-safe method for enabling or disabling a single location provider.
6193         *
6194         * @param cr the content resolver to use
6195         * @param provider the location provider to enable or disable
6196         * @param enabled true if the provider should be enabled
6197         * @param userId the userId for which to enable/disable providers
6198         * @return true if the value was set, false on database errors
6199         * @deprecated use {@link #putIntForUser(ContentResolver, String, int, int)} and
6200         *             {@link #LOCATION_MODE}
6201         * @hide
6202         */
6203        @Deprecated
6204        public static final boolean setLocationProviderEnabledForUser(ContentResolver cr,
6205                String provider, boolean enabled, int userId) {
6206            synchronized (mLocationSettingsLock) {
6207                // to ensure thread safety, we write the provider name with a '+' or '-'
6208                // and let the SettingsProvider handle it rather than reading and modifying
6209                // the list of enabled providers.
6210                if (enabled) {
6211                    provider = "+" + provider;
6212                } else {
6213                    provider = "-" + provider;
6214                }
6215                return putStringForUser(cr, Settings.Secure.LOCATION_PROVIDERS_ALLOWED, provider,
6216                        userId);
6217            }
6218        }
6219
6220        /**
6221         * Saves the current location mode into {@link #LOCATION_PREVIOUS_MODE}.
6222         */
6223        private static final boolean saveLocationModeForUser(ContentResolver cr, int userId) {
6224            final int mode = getLocationModeForUser(cr, userId);
6225            return putIntForUser(cr, Settings.Secure.LOCATION_PREVIOUS_MODE, mode, userId);
6226        }
6227
6228        /**
6229         * Restores the current location mode from {@link #LOCATION_PREVIOUS_MODE}.
6230         */
6231        private static final boolean restoreLocationModeForUser(ContentResolver cr, int userId) {
6232            int mode = getIntForUser(cr, Settings.Secure.LOCATION_PREVIOUS_MODE,
6233                    LOCATION_MODE_HIGH_ACCURACY, userId);
6234            // Make sure that the previous mode is never "off". Otherwise the user won't be able to
6235            // turn on location any longer.
6236            if (mode == LOCATION_MODE_OFF) {
6237                mode = LOCATION_MODE_HIGH_ACCURACY;
6238            }
6239            return setLocationModeForUser(cr, mode, userId);
6240        }
6241
6242        /**
6243         * Thread-safe method for setting the location mode to one of
6244         * {@link #LOCATION_MODE_HIGH_ACCURACY}, {@link #LOCATION_MODE_SENSORS_ONLY},
6245         * {@link #LOCATION_MODE_BATTERY_SAVING}, or {@link #LOCATION_MODE_OFF}.
6246         *
6247         * @param cr the content resolver to use
6248         * @param mode such as {@link #LOCATION_MODE_HIGH_ACCURACY}
6249         * @param userId the userId for which to change mode
6250         * @return true if the value was set, false on database errors
6251         *
6252         * @throws IllegalArgumentException if mode is not one of the supported values
6253         */
6254        private static final boolean setLocationModeForUser(ContentResolver cr, int mode,
6255                int userId) {
6256            synchronized (mLocationSettingsLock) {
6257                boolean gps = false;
6258                boolean network = false;
6259                switch (mode) {
6260                    case LOCATION_MODE_PREVIOUS:
6261                        // Retrieve the actual mode and set to that mode.
6262                        return restoreLocationModeForUser(cr, userId);
6263                    case LOCATION_MODE_OFF:
6264                        saveLocationModeForUser(cr, userId);
6265                        break;
6266                    case LOCATION_MODE_SENSORS_ONLY:
6267                        gps = true;
6268                        break;
6269                    case LOCATION_MODE_BATTERY_SAVING:
6270                        network = true;
6271                        break;
6272                    case LOCATION_MODE_HIGH_ACCURACY:
6273                        gps = true;
6274                        network = true;
6275                        break;
6276                    default:
6277                        throw new IllegalArgumentException("Invalid location mode: " + mode);
6278                }
6279                // Note it's important that we set the NLP mode first. The Google implementation
6280                // of NLP clears its NLP consent setting any time it receives a
6281                // LocationManager.PROVIDERS_CHANGED_ACTION broadcast and NLP is disabled. Also,
6282                // it shows an NLP consent dialog any time it receives the broadcast, NLP is
6283                // enabled, and the NLP consent is not set. If 1) we were to enable GPS first,
6284                // 2) a setup wizard has its own NLP consent UI that sets the NLP consent setting,
6285                // and 3) the receiver happened to complete before we enabled NLP, then the Google
6286                // NLP would detect the attempt to enable NLP and show a redundant NLP consent
6287                // dialog. Then the people who wrote the setup wizard would be sad.
6288                boolean nlpSuccess = Settings.Secure.setLocationProviderEnabledForUser(
6289                        cr, LocationManager.NETWORK_PROVIDER, network, userId);
6290                boolean gpsSuccess = Settings.Secure.setLocationProviderEnabledForUser(
6291                        cr, LocationManager.GPS_PROVIDER, gps, userId);
6292                return gpsSuccess && nlpSuccess;
6293            }
6294        }
6295
6296        /**
6297         * Thread-safe method for reading the location mode, returns one of
6298         * {@link #LOCATION_MODE_HIGH_ACCURACY}, {@link #LOCATION_MODE_SENSORS_ONLY},
6299         * {@link #LOCATION_MODE_BATTERY_SAVING}, or {@link #LOCATION_MODE_OFF}.
6300         *
6301         * @param cr the content resolver to use
6302         * @param userId the userId for which to read the mode
6303         * @return the location mode
6304         */
6305        private static final int getLocationModeForUser(ContentResolver cr, int userId) {
6306            synchronized (mLocationSettingsLock) {
6307                boolean gpsEnabled = Settings.Secure.isLocationProviderEnabledForUser(
6308                        cr, LocationManager.GPS_PROVIDER, userId);
6309                boolean networkEnabled = Settings.Secure.isLocationProviderEnabledForUser(
6310                        cr, LocationManager.NETWORK_PROVIDER, userId);
6311                if (gpsEnabled && networkEnabled) {
6312                    return LOCATION_MODE_HIGH_ACCURACY;
6313                } else if (gpsEnabled) {
6314                    return LOCATION_MODE_SENSORS_ONLY;
6315                } else if (networkEnabled) {
6316                    return LOCATION_MODE_BATTERY_SAVING;
6317                } else {
6318                    return LOCATION_MODE_OFF;
6319                }
6320            }
6321        }
6322    }
6323
6324    /**
6325     * Global system settings, containing preferences that always apply identically
6326     * to all defined users.  Applications can read these but are not allowed to write;
6327     * like the "Secure" settings, these are for preferences that the user must
6328     * explicitly modify through the system UI or specialized APIs for those values.
6329     */
6330    public static final class Global extends NameValueTable {
6331        public static final String SYS_PROP_SETTING_VERSION = "sys.settings_global_version";
6332
6333        /**
6334         * The content:// style URL for global secure settings items.  Not public.
6335         */
6336        public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/global");
6337
6338        /**
6339         * Whether users are allowed to add more users or guest from lockscreen.
6340         * <p>
6341         * Type: int
6342         * @hide
6343         */
6344        public static final String ADD_USERS_WHEN_LOCKED = "add_users_when_locked";
6345
6346        /**
6347         * Setting whether the global gesture for enabling accessibility is enabled.
6348         * If this gesture is enabled the user will be able to perfrom it to enable
6349         * the accessibility state without visiting the settings app.
6350         * @hide
6351         */
6352        public static final String ENABLE_ACCESSIBILITY_GLOBAL_GESTURE_ENABLED =
6353                "enable_accessibility_global_gesture_enabled";
6354
6355        /**
6356         * Whether Airplane Mode is on.
6357         */
6358        public static final String AIRPLANE_MODE_ON = "airplane_mode_on";
6359
6360        /**
6361         * Whether Theater Mode is on.
6362         * {@hide}
6363         */
6364        @SystemApi
6365        public static final String THEATER_MODE_ON = "theater_mode_on";
6366
6367        /**
6368         * Constant for use in AIRPLANE_MODE_RADIOS to specify Bluetooth radio.
6369         */
6370        public static final String RADIO_BLUETOOTH = "bluetooth";
6371
6372        /**
6373         * Constant for use in AIRPLANE_MODE_RADIOS to specify Wi-Fi radio.
6374         */
6375        public static final String RADIO_WIFI = "wifi";
6376
6377        /**
6378         * {@hide}
6379         */
6380        public static final String RADIO_WIMAX = "wimax";
6381        /**
6382         * Constant for use in AIRPLANE_MODE_RADIOS to specify Cellular radio.
6383         */
6384        public static final String RADIO_CELL = "cell";
6385
6386        /**
6387         * Constant for use in AIRPLANE_MODE_RADIOS to specify NFC radio.
6388         */
6389        public static final String RADIO_NFC = "nfc";
6390
6391        /**
6392         * A comma separated list of radios that need to be disabled when airplane mode
6393         * is on. This overrides WIFI_ON and BLUETOOTH_ON, if Wi-Fi and bluetooth are
6394         * included in the comma separated list.
6395         */
6396        public static final String AIRPLANE_MODE_RADIOS = "airplane_mode_radios";
6397
6398        /**
6399         * A comma separated list of radios that should to be disabled when airplane mode
6400         * is on, but can be manually reenabled by the user.  For example, if RADIO_WIFI is
6401         * added to both AIRPLANE_MODE_RADIOS and AIRPLANE_MODE_TOGGLEABLE_RADIOS, then Wifi
6402         * will be turned off when entering airplane mode, but the user will be able to reenable
6403         * Wifi in the Settings app.
6404         *
6405         * {@hide}
6406         */
6407        public static final String AIRPLANE_MODE_TOGGLEABLE_RADIOS = "airplane_mode_toggleable_radios";
6408
6409        /**
6410         * A Long representing a bitmap of profiles that should be disabled when bluetooth starts.
6411         * See {@link android.bluetooth.BluetoothProfile}.
6412         * {@hide}
6413         */
6414        public static final String BLUETOOTH_DISABLED_PROFILES = "bluetooth_disabled_profiles";
6415
6416        /**
6417         * A semi-colon separated list of Bluetooth interoperability workarounds.
6418         * Each entry is a partial Bluetooth device address string and an integer representing
6419         * the feature to be disabled, separated by a comma. The integer must correspond
6420         * to a interoperability feature as defined in "interop.h" in /system/bt.
6421         * <p>
6422         * Example: <br/>
6423         *   "00:11:22,0;01:02:03:04,2"
6424         * @hide
6425         */
6426       public static final String BLUETOOTH_INTEROPERABILITY_LIST = "bluetooth_interoperability_list";
6427
6428        /**
6429         * The policy for deciding when Wi-Fi should go to sleep (which will in
6430         * turn switch to using the mobile data as an Internet connection).
6431         * <p>
6432         * Set to one of {@link #WIFI_SLEEP_POLICY_DEFAULT},
6433         * {@link #WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED}, or
6434         * {@link #WIFI_SLEEP_POLICY_NEVER}.
6435         */
6436        public static final String WIFI_SLEEP_POLICY = "wifi_sleep_policy";
6437
6438        /**
6439         * Value for {@link #WIFI_SLEEP_POLICY} to use the default Wi-Fi sleep
6440         * policy, which is to sleep shortly after the turning off
6441         * according to the {@link #STAY_ON_WHILE_PLUGGED_IN} setting.
6442         */
6443        public static final int WIFI_SLEEP_POLICY_DEFAULT = 0;
6444
6445        /**
6446         * Value for {@link #WIFI_SLEEP_POLICY} to use the default policy when
6447         * the device is on battery, and never go to sleep when the device is
6448         * plugged in.
6449         */
6450        public static final int WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED = 1;
6451
6452        /**
6453         * Value for {@link #WIFI_SLEEP_POLICY} to never go to sleep.
6454         */
6455        public static final int WIFI_SLEEP_POLICY_NEVER = 2;
6456
6457        /**
6458         * Value to specify if the user prefers the date, time and time zone
6459         * to be automatically fetched from the network (NITZ). 1=yes, 0=no
6460         */
6461        public static final String AUTO_TIME = "auto_time";
6462
6463        /**
6464         * Value to specify if the user prefers the time zone
6465         * to be automatically fetched from the network (NITZ). 1=yes, 0=no
6466         */
6467        public static final String AUTO_TIME_ZONE = "auto_time_zone";
6468
6469        /**
6470         * URI for the car dock "in" event sound.
6471         * @hide
6472         */
6473        public static final String CAR_DOCK_SOUND = "car_dock_sound";
6474
6475        /**
6476         * URI for the car dock "out" event sound.
6477         * @hide
6478         */
6479        public static final String CAR_UNDOCK_SOUND = "car_undock_sound";
6480
6481        /**
6482         * URI for the desk dock "in" event sound.
6483         * @hide
6484         */
6485        public static final String DESK_DOCK_SOUND = "desk_dock_sound";
6486
6487        /**
6488         * URI for the desk dock "out" event sound.
6489         * @hide
6490         */
6491        public static final String DESK_UNDOCK_SOUND = "desk_undock_sound";
6492
6493        /**
6494         * Whether to play a sound for dock events.
6495         * @hide
6496         */
6497        public static final String DOCK_SOUNDS_ENABLED = "dock_sounds_enabled";
6498
6499        /**
6500         * URI for the "device locked" (keyguard shown) sound.
6501         * @hide
6502         */
6503        public static final String LOCK_SOUND = "lock_sound";
6504
6505        /**
6506         * URI for the "device unlocked" sound.
6507         * @hide
6508         */
6509        public static final String UNLOCK_SOUND = "unlock_sound";
6510
6511        /**
6512         * URI for the "device is trusted" sound, which is played when the device enters the trusted
6513         * state without unlocking.
6514         * @hide
6515         */
6516        public static final String TRUSTED_SOUND = "trusted_sound";
6517
6518        /**
6519         * URI for the low battery sound file.
6520         * @hide
6521         */
6522        public static final String LOW_BATTERY_SOUND = "low_battery_sound";
6523
6524        /**
6525         * Whether to play a sound for low-battery alerts.
6526         * @hide
6527         */
6528        public static final String POWER_SOUNDS_ENABLED = "power_sounds_enabled";
6529
6530        /**
6531         * URI for the "wireless charging started" sound.
6532         * @hide
6533         */
6534        public static final String WIRELESS_CHARGING_STARTED_SOUND =
6535                "wireless_charging_started_sound";
6536
6537        /**
6538         * Whether to play a sound for charging events.
6539         * @hide
6540         */
6541        public static final String CHARGING_SOUNDS_ENABLED = "charging_sounds_enabled";
6542
6543        /**
6544         * Whether we keep the device on while the device is plugged in.
6545         * Supported values are:
6546         * <ul>
6547         * <li>{@code 0} to never stay on while plugged in</li>
6548         * <li>{@link BatteryManager#BATTERY_PLUGGED_AC} to stay on for AC charger</li>
6549         * <li>{@link BatteryManager#BATTERY_PLUGGED_USB} to stay on for USB charger</li>
6550         * <li>{@link BatteryManager#BATTERY_PLUGGED_WIRELESS} to stay on for wireless charger</li>
6551         * </ul>
6552         * These values can be OR-ed together.
6553         */
6554        public static final String STAY_ON_WHILE_PLUGGED_IN = "stay_on_while_plugged_in";
6555
6556        /**
6557         * When the user has enable the option to have a "bug report" command
6558         * in the power menu.
6559         * @hide
6560         */
6561        public static final String BUGREPORT_IN_POWER_MENU = "bugreport_in_power_menu";
6562
6563        /**
6564         * Whether ADB is enabled.
6565         */
6566        public static final String ADB_ENABLED = "adb_enabled";
6567
6568        /**
6569         * Whether Views are allowed to save their attribute data.
6570         * @hide
6571         */
6572        public static final String DEBUG_VIEW_ATTRIBUTES = "debug_view_attributes";
6573
6574        /**
6575         * Whether assisted GPS should be enabled or not.
6576         * @hide
6577         */
6578        public static final String ASSISTED_GPS_ENABLED = "assisted_gps_enabled";
6579
6580        /**
6581         * Whether bluetooth is enabled/disabled
6582         * 0=disabled. 1=enabled.
6583         */
6584        public static final String BLUETOOTH_ON = "bluetooth_on";
6585
6586        /**
6587         * CDMA Cell Broadcast SMS
6588         *                            0 = CDMA Cell Broadcast SMS disabled
6589         *                            1 = CDMA Cell Broadcast SMS enabled
6590         * @hide
6591         */
6592        public static final String CDMA_CELL_BROADCAST_SMS =
6593                "cdma_cell_broadcast_sms";
6594
6595        /**
6596         * The CDMA roaming mode 0 = Home Networks, CDMA default
6597         *                       1 = Roaming on Affiliated networks
6598         *                       2 = Roaming on any networks
6599         * @hide
6600         */
6601        public static final String CDMA_ROAMING_MODE = "roaming_settings";
6602
6603        /**
6604         * The CDMA subscription mode 0 = RUIM/SIM (default)
6605         *                                1 = NV
6606         * @hide
6607         */
6608        public static final String CDMA_SUBSCRIPTION_MODE = "subscription_mode";
6609
6610        /** Inactivity timeout to track mobile data activity.
6611        *
6612        * If set to a positive integer, it indicates the inactivity timeout value in seconds to
6613        * infer the data activity of mobile network. After a period of no activity on mobile
6614        * networks with length specified by the timeout, an {@code ACTION_DATA_ACTIVITY_CHANGE}
6615        * intent is fired to indicate a transition of network status from "active" to "idle". Any
6616        * subsequent activity on mobile networks triggers the firing of {@code
6617        * ACTION_DATA_ACTIVITY_CHANGE} intent indicating transition from "idle" to "active".
6618        *
6619        * Network activity refers to transmitting or receiving data on the network interfaces.
6620        *
6621        * Tracking is disabled if set to zero or negative value.
6622        *
6623        * @hide
6624        */
6625       public static final String DATA_ACTIVITY_TIMEOUT_MOBILE = "data_activity_timeout_mobile";
6626
6627       /** Timeout to tracking Wifi data activity. Same as {@code DATA_ACTIVITY_TIMEOUT_MOBILE}
6628        * but for Wifi network.
6629        * @hide
6630        */
6631       public static final String DATA_ACTIVITY_TIMEOUT_WIFI = "data_activity_timeout_wifi";
6632
6633       /**
6634        * Whether or not data roaming is enabled. (0 = false, 1 = true)
6635        */
6636       public static final String DATA_ROAMING = "data_roaming";
6637
6638       /**
6639        * The value passed to a Mobile DataConnection via bringUp which defines the
6640        * number of retries to preform when setting up the initial connection. The default
6641        * value defined in DataConnectionTrackerBase#DEFAULT_MDC_INITIAL_RETRY is currently 1.
6642        * @hide
6643        */
6644       public static final String MDC_INITIAL_MAX_RETRY = "mdc_initial_max_retry";
6645
6646       /**
6647        * Whether any package can be on external storage. When this is true, any
6648        * package, regardless of manifest values, is a candidate for installing
6649        * or moving onto external storage. (0 = false, 1 = true)
6650        * @hide
6651        */
6652       public static final String FORCE_ALLOW_ON_EXTERNAL = "force_allow_on_external";
6653
6654        /**
6655         * Whether any activity can be resized. When this is true, any
6656         * activity, regardless of manifest values, can be resized for multi-window.
6657         * (0 = false, 1 = true)
6658         * @hide
6659         */
6660        public static final String DEVELOPMENT_FORCE_RESIZABLE_ACTIVITIES
6661                = "force_resizable_activities";
6662
6663        /**
6664         * Whether to enable experimental freeform support for windows.
6665         * @hide
6666         */
6667        public static final String DEVELOPMENT_ENABLE_FREEFORM_WINDOWS_SUPPORT
6668                = "enable_freeform_support";
6669
6670       /**
6671        * Whether user has enabled development settings.
6672        */
6673       public static final String DEVELOPMENT_SETTINGS_ENABLED = "development_settings_enabled";
6674
6675       /**
6676        * Whether the device has been provisioned (0 = false, 1 = true).
6677        * <p>On a multiuser device with a separate system user, the screen may be locked
6678        * as soon as this is set to true and further activities cannot be launched on the
6679        * system user unless they are marked to show over keyguard.
6680        */
6681       public static final String DEVICE_PROVISIONED = "device_provisioned";
6682
6683       /**
6684        * The saved value for WindowManagerService.setForcedDisplaySize().
6685        * Two integers separated by a comma.  If unset, then use the real display size.
6686        * @hide
6687        */
6688       public static final String DISPLAY_SIZE_FORCED = "display_size_forced";
6689
6690       /**
6691        * The saved value for WindowManagerService.setForcedDisplayScalingMode().
6692        * 0 or unset if scaling is automatic, 1 if scaling is disabled.
6693        * @hide
6694        */
6695       public static final String DISPLAY_SCALING_FORCE = "display_scaling_force";
6696
6697       /**
6698        * The maximum size, in bytes, of a download that the download manager will transfer over
6699        * a non-wifi connection.
6700        * @hide
6701        */
6702       public static final String DOWNLOAD_MAX_BYTES_OVER_MOBILE =
6703               "download_manager_max_bytes_over_mobile";
6704
6705       /**
6706        * The recommended maximum size, in bytes, of a download that the download manager should
6707        * transfer over a non-wifi connection. Over this size, the use will be warned, but will
6708        * have the option to start the download over the mobile connection anyway.
6709        * @hide
6710        */
6711       public static final String DOWNLOAD_RECOMMENDED_MAX_BYTES_OVER_MOBILE =
6712               "download_manager_recommended_max_bytes_over_mobile";
6713
6714       /**
6715        * @deprecated Use {@link android.provider.Settings.Secure#INSTALL_NON_MARKET_APPS} instead
6716        */
6717       @Deprecated
6718       public static final String INSTALL_NON_MARKET_APPS = Secure.INSTALL_NON_MARKET_APPS;
6719
6720       /**
6721        * Whether HDMI control shall be enabled. If disabled, no CEC/MHL command will be
6722        * sent or processed. (0 = false, 1 = true)
6723        * @hide
6724        */
6725       public static final String HDMI_CONTROL_ENABLED = "hdmi_control_enabled";
6726
6727       /**
6728        * Whether HDMI system audio is enabled. If enabled, TV internal speaker is muted,
6729        * and the output is redirected to AV Receiver connected via
6730        * {@Global#HDMI_SYSTEM_AUDIO_OUTPUT}.
6731        * @hide
6732        */
6733       public static final String HDMI_SYSTEM_AUDIO_ENABLED = "hdmi_system_audio_enabled";
6734
6735       /**
6736        * Whether TV will automatically turn on upon reception of the CEC command
6737        * &lt;Text View On&gt; or &lt;Image View On&gt;. (0 = false, 1 = true)
6738        * @hide
6739        */
6740       public static final String HDMI_CONTROL_AUTO_WAKEUP_ENABLED =
6741               "hdmi_control_auto_wakeup_enabled";
6742
6743       /**
6744        * Whether TV will also turn off other CEC devices when it goes to standby mode.
6745        * (0 = false, 1 = true)
6746        * @hide
6747        */
6748       public static final String HDMI_CONTROL_AUTO_DEVICE_OFF_ENABLED =
6749               "hdmi_control_auto_device_off_enabled";
6750
6751       /**
6752        * Whether to use the DHCP client from Lollipop and earlier instead of the newer Android DHCP
6753        * client.
6754        * (0 = false, 1 = true)
6755        * @hide
6756        */
6757       public static final String LEGACY_DHCP_CLIENT = "legacy_dhcp_client";
6758
6759       /**
6760        * Whether TV will switch to MHL port when a mobile device is plugged in.
6761        * (0 = false, 1 = true)
6762        * @hide
6763        */
6764       public static final String MHL_INPUT_SWITCHING_ENABLED = "mhl_input_switching_enabled";
6765
6766       /**
6767        * Whether TV will charge the mobile device connected at MHL port. (0 = false, 1 = true)
6768        * @hide
6769        */
6770       public static final String MHL_POWER_CHARGE_ENABLED = "mhl_power_charge_enabled";
6771
6772       /**
6773        * Whether mobile data connections are allowed by the user.  See
6774        * ConnectivityManager for more info.
6775        * @hide
6776        */
6777       public static final String MOBILE_DATA = "mobile_data";
6778
6779       /**
6780        * Whether the mobile data connection should remain active even when higher
6781        * priority networks like WiFi are active, to help make network switching faster.
6782        *
6783        * See ConnectivityService for more info.
6784        *
6785        * (0 = disabled, 1 = enabled)
6786        * @hide
6787        */
6788       public static final String MOBILE_DATA_ALWAYS_ON = "mobile_data_always_on";
6789
6790       /** {@hide} */
6791       public static final String NETSTATS_ENABLED = "netstats_enabled";
6792       /** {@hide} */
6793       public static final String NETSTATS_POLL_INTERVAL = "netstats_poll_interval";
6794       /** {@hide} */
6795       public static final String NETSTATS_TIME_CACHE_MAX_AGE = "netstats_time_cache_max_age";
6796       /** {@hide} */
6797       public static final String NETSTATS_GLOBAL_ALERT_BYTES = "netstats_global_alert_bytes";
6798       /** {@hide} */
6799       public static final String NETSTATS_SAMPLE_ENABLED = "netstats_sample_enabled";
6800
6801       /** {@hide} */
6802       public static final String NETSTATS_DEV_BUCKET_DURATION = "netstats_dev_bucket_duration";
6803       /** {@hide} */
6804       public static final String NETSTATS_DEV_PERSIST_BYTES = "netstats_dev_persist_bytes";
6805       /** {@hide} */
6806       public static final String NETSTATS_DEV_ROTATE_AGE = "netstats_dev_rotate_age";
6807       /** {@hide} */
6808       public static final String NETSTATS_DEV_DELETE_AGE = "netstats_dev_delete_age";
6809
6810       /** {@hide} */
6811       public static final String NETSTATS_UID_BUCKET_DURATION = "netstats_uid_bucket_duration";
6812       /** {@hide} */
6813       public static final String NETSTATS_UID_PERSIST_BYTES = "netstats_uid_persist_bytes";
6814       /** {@hide} */
6815       public static final String NETSTATS_UID_ROTATE_AGE = "netstats_uid_rotate_age";
6816       /** {@hide} */
6817       public static final String NETSTATS_UID_DELETE_AGE = "netstats_uid_delete_age";
6818
6819       /** {@hide} */
6820       public static final String NETSTATS_UID_TAG_BUCKET_DURATION = "netstats_uid_tag_bucket_duration";
6821       /** {@hide} */
6822       public static final String NETSTATS_UID_TAG_PERSIST_BYTES = "netstats_uid_tag_persist_bytes";
6823       /** {@hide} */
6824       public static final String NETSTATS_UID_TAG_ROTATE_AGE = "netstats_uid_tag_rotate_age";
6825       /** {@hide} */
6826       public static final String NETSTATS_UID_TAG_DELETE_AGE = "netstats_uid_tag_delete_age";
6827
6828       /**
6829        * User preference for which network(s) should be used. Only the
6830        * connectivity service should touch this.
6831        */
6832       public static final String NETWORK_PREFERENCE = "network_preference";
6833
6834       /**
6835        * Which package name to use for network scoring. If null, or if the package is not a valid
6836        * scorer app, external network scores will neither be requested nor accepted.
6837        * @hide
6838        */
6839       public static final String NETWORK_SCORER_APP = "network_scorer_app";
6840
6841       /**
6842        * If the NITZ_UPDATE_DIFF time is exceeded then an automatic adjustment
6843        * to SystemClock will be allowed even if NITZ_UPDATE_SPACING has not been
6844        * exceeded.
6845        * @hide
6846        */
6847       public static final String NITZ_UPDATE_DIFF = "nitz_update_diff";
6848
6849       /**
6850        * The length of time in milli-seconds that automatic small adjustments to
6851        * SystemClock are ignored if NITZ_UPDATE_DIFF is not exceeded.
6852        * @hide
6853        */
6854       public static final String NITZ_UPDATE_SPACING = "nitz_update_spacing";
6855
6856       /** Preferred NTP server. {@hide} */
6857       public static final String NTP_SERVER = "ntp_server";
6858       /** Timeout in milliseconds to wait for NTP server. {@hide} */
6859       public static final String NTP_TIMEOUT = "ntp_timeout";
6860
6861       /** {@hide} */
6862       public static final String STORAGE_BENCHMARK_INTERVAL = "storage_benchmark_interval";
6863
6864       /**
6865        * Whether to disable the automatic scheduling of system updates.
6866        * 1 = system updates won't be automatically scheduled (will always
6867        * present notification instead).
6868        * 0 = system updates will be automatically scheduled. (default)
6869        * @hide
6870        */
6871       @SystemApi
6872       public static final String OTA_DISABLE_AUTOMATIC_UPDATE = "ota_disable_automatic_update";
6873
6874       /**
6875        * Whether the package manager should send package verification broadcasts for verifiers to
6876        * review apps prior to installation.
6877        * 1 = request apps to be verified prior to installation, if a verifier exists.
6878        * 0 = do not verify apps before installation
6879        * @hide
6880        */
6881       public static final String PACKAGE_VERIFIER_ENABLE = "package_verifier_enable";
6882
6883       /** Timeout for package verification.
6884        * @hide */
6885       public static final String PACKAGE_VERIFIER_TIMEOUT = "verifier_timeout";
6886
6887       /** Default response code for package verification.
6888        * @hide */
6889       public static final String PACKAGE_VERIFIER_DEFAULT_RESPONSE = "verifier_default_response";
6890
6891       /**
6892        * Show package verification setting in the Settings app.
6893        * 1 = show (default)
6894        * 0 = hide
6895        * @hide
6896        */
6897       public static final String PACKAGE_VERIFIER_SETTING_VISIBLE = "verifier_setting_visible";
6898
6899       /**
6900        * Run package verification on apps installed through ADB/ADT/USB
6901        * 1 = perform package verification on ADB installs (default)
6902        * 0 = bypass package verification on ADB installs
6903        * @hide
6904        */
6905       public static final String PACKAGE_VERIFIER_INCLUDE_ADB = "verifier_verify_adb_installs";
6906
6907       /**
6908        * Time since last fstrim (milliseconds) after which we force one to happen
6909        * during device startup.  If unset, the default is 3 days.
6910        * @hide
6911        */
6912       public static final String FSTRIM_MANDATORY_INTERVAL = "fstrim_mandatory_interval";
6913
6914       /**
6915        * The interval in milliseconds at which to check packet counts on the
6916        * mobile data interface when screen is on, to detect possible data
6917        * connection problems.
6918        * @hide
6919        */
6920       public static final String PDP_WATCHDOG_POLL_INTERVAL_MS =
6921               "pdp_watchdog_poll_interval_ms";
6922
6923       /**
6924        * The interval in milliseconds at which to check packet counts on the
6925        * mobile data interface when screen is off, to detect possible data
6926        * connection problems.
6927        * @hide
6928        */
6929       public static final String PDP_WATCHDOG_LONG_POLL_INTERVAL_MS =
6930               "pdp_watchdog_long_poll_interval_ms";
6931
6932       /**
6933        * The interval in milliseconds at which to check packet counts on the
6934        * mobile data interface after {@link #PDP_WATCHDOG_TRIGGER_PACKET_COUNT}
6935        * outgoing packets has been reached without incoming packets.
6936        * @hide
6937        */
6938       public static final String PDP_WATCHDOG_ERROR_POLL_INTERVAL_MS =
6939               "pdp_watchdog_error_poll_interval_ms";
6940
6941       /**
6942        * The number of outgoing packets sent without seeing an incoming packet
6943        * that triggers a countdown (of {@link #PDP_WATCHDOG_ERROR_POLL_COUNT}
6944        * device is logged to the event log
6945        * @hide
6946        */
6947       public static final String PDP_WATCHDOG_TRIGGER_PACKET_COUNT =
6948               "pdp_watchdog_trigger_packet_count";
6949
6950       /**
6951        * The number of polls to perform (at {@link #PDP_WATCHDOG_ERROR_POLL_INTERVAL_MS})
6952        * after hitting {@link #PDP_WATCHDOG_TRIGGER_PACKET_COUNT} before
6953        * attempting data connection recovery.
6954        * @hide
6955        */
6956       public static final String PDP_WATCHDOG_ERROR_POLL_COUNT =
6957               "pdp_watchdog_error_poll_count";
6958
6959       /**
6960        * The number of failed PDP reset attempts before moving to something more
6961        * drastic: re-registering to the network.
6962        * @hide
6963        */
6964       public static final String PDP_WATCHDOG_MAX_PDP_RESET_FAIL_COUNT =
6965               "pdp_watchdog_max_pdp_reset_fail_count";
6966
6967       /**
6968        * A positive value indicates how often the SamplingProfiler
6969        * should take snapshots. Zero value means SamplingProfiler
6970        * is disabled.
6971        *
6972        * @hide
6973        */
6974       public static final String SAMPLING_PROFILER_MS = "sampling_profiler_ms";
6975
6976       /**
6977        * URL to open browser on to allow user to manage a prepay account
6978        * @hide
6979        */
6980       public static final String SETUP_PREPAID_DATA_SERVICE_URL =
6981               "setup_prepaid_data_service_url";
6982
6983       /**
6984        * URL to attempt a GET on to see if this is a prepay device
6985        * @hide
6986        */
6987       public static final String SETUP_PREPAID_DETECTION_TARGET_URL =
6988               "setup_prepaid_detection_target_url";
6989
6990       /**
6991        * Host to check for a redirect to after an attempt to GET
6992        * SETUP_PREPAID_DETECTION_TARGET_URL. (If we redirected there,
6993        * this is a prepaid device with zero balance.)
6994        * @hide
6995        */
6996       public static final String SETUP_PREPAID_DETECTION_REDIR_HOST =
6997               "setup_prepaid_detection_redir_host";
6998
6999       /**
7000        * The interval in milliseconds at which to check the number of SMS sent out without asking
7001        * for use permit, to limit the un-authorized SMS usage.
7002        *
7003        * @hide
7004        */
7005       public static final String SMS_OUTGOING_CHECK_INTERVAL_MS =
7006               "sms_outgoing_check_interval_ms";
7007
7008       /**
7009        * The number of outgoing SMS sent without asking for user permit (of {@link
7010        * #SMS_OUTGOING_CHECK_INTERVAL_MS}
7011        *
7012        * @hide
7013        */
7014       public static final String SMS_OUTGOING_CHECK_MAX_COUNT =
7015               "sms_outgoing_check_max_count";
7016
7017       /**
7018        * Used to disable SMS short code confirmation - defaults to true.
7019        * True indcates we will do the check, etc.  Set to false to disable.
7020        * @see com.android.internal.telephony.SmsUsageMonitor
7021        * @hide
7022        */
7023       public static final String SMS_SHORT_CODE_CONFIRMATION = "sms_short_code_confirmation";
7024
7025        /**
7026         * Used to select which country we use to determine premium sms codes.
7027         * One of com.android.internal.telephony.SMSDispatcher.PREMIUM_RULE_USE_SIM,
7028         * com.android.internal.telephony.SMSDispatcher.PREMIUM_RULE_USE_NETWORK,
7029         * or com.android.internal.telephony.SMSDispatcher.PREMIUM_RULE_USE_BOTH.
7030         * @hide
7031         */
7032        public static final String SMS_SHORT_CODE_RULE = "sms_short_code_rule";
7033
7034       /**
7035        * Used to select TCP's default initial receiver window size in segments - defaults to a build config value
7036        * @hide
7037        */
7038       public static final String TCP_DEFAULT_INIT_RWND = "tcp_default_init_rwnd";
7039
7040       /**
7041        * Used to disable Tethering on a device - defaults to true
7042        * @hide
7043        */
7044       public static final String TETHER_SUPPORTED = "tether_supported";
7045
7046       /**
7047        * Used to require DUN APN on the device or not - defaults to a build config value
7048        * which defaults to false
7049        * @hide
7050        */
7051       public static final String TETHER_DUN_REQUIRED = "tether_dun_required";
7052
7053       /**
7054        * Used to hold a gservices-provisioned apn value for DUN.  If set, or the
7055        * corresponding build config values are set it will override the APN DB
7056        * values.
7057        * Consists of a comma seperated list of strings:
7058        * "name,apn,proxy,port,username,password,server,mmsc,mmsproxy,mmsport,mcc,mnc,auth,type"
7059        * note that empty fields can be ommitted: "name,apn,,,,,,,,,310,260,,DUN"
7060        * @hide
7061        */
7062       public static final String TETHER_DUN_APN = "tether_dun_apn";
7063
7064       /**
7065        * List of carrier apps which are whitelisted to prompt the user for install when
7066        * a sim card with matching uicc carrier privilege rules is inserted.
7067        *
7068        * The value is "package1;package2;..."
7069        * @hide
7070        */
7071       public static final String CARRIER_APP_WHITELIST = "carrier_app_whitelist";
7072
7073       /**
7074        * USB Mass Storage Enabled
7075        */
7076       public static final String USB_MASS_STORAGE_ENABLED = "usb_mass_storage_enabled";
7077
7078       /**
7079        * If this setting is set (to anything), then all references
7080        * to Gmail on the device must change to Google Mail.
7081        */
7082       public static final String USE_GOOGLE_MAIL = "use_google_mail";
7083
7084        /**
7085         * Webview Data reduction proxy key.
7086         * @hide
7087         */
7088        public static final String WEBVIEW_DATA_REDUCTION_PROXY_KEY =
7089                "webview_data_reduction_proxy_key";
7090
7091        /**
7092         * Whether or not the WebView fallback mechanism should be enabled.
7093         * 0=disabled, 1=enabled.
7094         * @hide
7095         */
7096        public static final String WEBVIEW_FALLBACK_LOGIC_ENABLED =
7097                "webview_fallback_logic_enabled";
7098
7099        /**
7100         * Name of the package used as WebView provider (if unset the provider is instead determined
7101         * by the system).
7102         * @hide
7103         */
7104        public static final String WEBVIEW_PROVIDER = "webview_provider";
7105
7106        /**
7107         * Developer setting to enable WebView multiprocess rendering.
7108         * @hide
7109         */
7110        @SystemApi
7111        public static final String WEBVIEW_MULTIPROCESS = "webview_multiprocess";
7112
7113       /**
7114        * Whether Wifi display is enabled/disabled
7115        * 0=disabled. 1=enabled.
7116        * @hide
7117        */
7118       public static final String WIFI_DISPLAY_ON = "wifi_display_on";
7119
7120       /**
7121        * Whether Wifi display certification mode is enabled/disabled
7122        * 0=disabled. 1=enabled.
7123        * @hide
7124        */
7125       public static final String WIFI_DISPLAY_CERTIFICATION_ON =
7126               "wifi_display_certification_on";
7127
7128       /**
7129        * WPS Configuration method used by Wifi display, this setting only
7130        * takes effect when WIFI_DISPLAY_CERTIFICATION_ON is 1 (enabled).
7131        *
7132        * Possible values are:
7133        *
7134        * WpsInfo.INVALID: use default WPS method chosen by framework
7135        * WpsInfo.PBC    : use Push button
7136        * WpsInfo.KEYPAD : use Keypad
7137        * WpsInfo.DISPLAY: use Display
7138        * @hide
7139        */
7140       public static final String WIFI_DISPLAY_WPS_CONFIG =
7141           "wifi_display_wps_config";
7142
7143       /**
7144        * Whether to notify the user of open networks.
7145        * <p>
7146        * If not connected and the scan results have an open network, we will
7147        * put this notification up. If we attempt to connect to a network or
7148        * the open network(s) disappear, we remove the notification. When we
7149        * show the notification, we will not show it again for
7150        * {@link android.provider.Settings.Secure#WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY} time.
7151        */
7152       public static final String WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON =
7153               "wifi_networks_available_notification_on";
7154       /**
7155        * {@hide}
7156        */
7157       public static final String WIMAX_NETWORKS_AVAILABLE_NOTIFICATION_ON =
7158               "wimax_networks_available_notification_on";
7159
7160       /**
7161        * Delay (in seconds) before repeating the Wi-Fi networks available notification.
7162        * Connecting to a network will reset the timer.
7163        */
7164       public static final String WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY =
7165               "wifi_networks_available_repeat_delay";
7166
7167       /**
7168        * 802.11 country code in ISO 3166 format
7169        * @hide
7170        */
7171       public static final String WIFI_COUNTRY_CODE = "wifi_country_code";
7172
7173       /**
7174        * The interval in milliseconds to issue wake up scans when wifi needs
7175        * to connect. This is necessary to connect to an access point when
7176        * device is on the move and the screen is off.
7177        * @hide
7178        */
7179       public static final String WIFI_FRAMEWORK_SCAN_INTERVAL_MS =
7180               "wifi_framework_scan_interval_ms";
7181
7182       /**
7183        * The interval in milliseconds after which Wi-Fi is considered idle.
7184        * When idle, it is possible for the device to be switched from Wi-Fi to
7185        * the mobile data network.
7186        * @hide
7187        */
7188       public static final String WIFI_IDLE_MS = "wifi_idle_ms";
7189
7190       /**
7191        * When the number of open networks exceeds this number, the
7192        * least-recently-used excess networks will be removed.
7193        */
7194       public static final String WIFI_NUM_OPEN_NETWORKS_KEPT = "wifi_num_open_networks_kept";
7195
7196       /**
7197        * Whether the Wi-Fi should be on.  Only the Wi-Fi service should touch this.
7198        */
7199       public static final String WIFI_ON = "wifi_on";
7200
7201       /**
7202        * Setting to allow scans to be enabled even wifi is turned off for connectivity.
7203        * @hide
7204        */
7205       public static final String WIFI_SCAN_ALWAYS_AVAILABLE =
7206                "wifi_scan_always_enabled";
7207
7208       /**
7209        * Settings to allow BLE scans to be enabled even when Bluetooth is turned off for
7210        * connectivity.
7211        * @hide
7212        */
7213       public static final String BLE_SCAN_ALWAYS_AVAILABLE =
7214               "ble_scan_always_enabled";
7215
7216       /**
7217        * Used to save the Wifi_ON state prior to tethering.
7218        * This state will be checked to restore Wifi after
7219        * the user turns off tethering.
7220        *
7221        * @hide
7222        */
7223       public static final String WIFI_SAVED_STATE = "wifi_saved_state";
7224
7225       /**
7226        * The interval in milliseconds to scan as used by the wifi supplicant
7227        * @hide
7228        */
7229       public static final String WIFI_SUPPLICANT_SCAN_INTERVAL_MS =
7230               "wifi_supplicant_scan_interval_ms";
7231
7232        /**
7233         * whether frameworks handles wifi auto-join
7234         * @hide
7235         */
7236       public static final String WIFI_ENHANCED_AUTO_JOIN =
7237                "wifi_enhanced_auto_join";
7238
7239        /**
7240         * whether settings show RSSI
7241         * @hide
7242         */
7243        public static final String WIFI_NETWORK_SHOW_RSSI =
7244                "wifi_network_show_rssi";
7245
7246        /**
7247        * The interval in milliseconds to scan at supplicant when p2p is connected
7248        * @hide
7249        */
7250       public static final String WIFI_SCAN_INTERVAL_WHEN_P2P_CONNECTED_MS =
7251               "wifi_scan_interval_p2p_connected_ms";
7252
7253       /**
7254        * Whether the Wi-Fi watchdog is enabled.
7255        */
7256       public static final String WIFI_WATCHDOG_ON = "wifi_watchdog_on";
7257
7258       /**
7259        * Setting to turn off poor network avoidance on Wi-Fi. Feature is enabled by default and
7260        * the setting needs to be set to 0 to disable it.
7261        * @hide
7262        */
7263       public static final String WIFI_WATCHDOG_POOR_NETWORK_TEST_ENABLED =
7264               "wifi_watchdog_poor_network_test_enabled";
7265
7266       /**
7267        * Setting to turn on suspend optimizations at screen off on Wi-Fi. Enabled by default and
7268        * needs to be set to 0 to disable it.
7269        * @hide
7270        */
7271       public static final String WIFI_SUSPEND_OPTIMIZATIONS_ENABLED =
7272               "wifi_suspend_optimizations_enabled";
7273
7274       /**
7275        * The maximum number of times we will retry a connection to an access
7276        * point for which we have failed in acquiring an IP address from DHCP.
7277        * A value of N means that we will make N+1 connection attempts in all.
7278        */
7279       public static final String WIFI_MAX_DHCP_RETRY_COUNT = "wifi_max_dhcp_retry_count";
7280
7281       /**
7282        * Maximum amount of time in milliseconds to hold a wakelock while waiting for mobile
7283        * data connectivity to be established after a disconnect from Wi-Fi.
7284        */
7285       public static final String WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS =
7286           "wifi_mobile_data_transition_wakelock_timeout_ms";
7287
7288       /**
7289        * This setting controls whether WiFi configurations created by a Device Owner app
7290        * should be locked down (that is, be editable or removable only by the Device Owner App,
7291        * not even by Settings app).
7292        * This setting takes integer values. Non-zero values mean DO created configurations
7293        * are locked down. Value of zero means they are not. Default value in the absence of
7294        * actual value to this setting is 0.
7295        */
7296       public static final String WIFI_DEVICE_OWNER_CONFIGS_LOCKDOWN =
7297               "wifi_device_owner_configs_lockdown";
7298
7299       /**
7300        * The operational wifi frequency band
7301        * Set to one of {@link WifiManager#WIFI_FREQUENCY_BAND_AUTO},
7302        * {@link WifiManager#WIFI_FREQUENCY_BAND_5GHZ} or
7303        * {@link WifiManager#WIFI_FREQUENCY_BAND_2GHZ}
7304        *
7305        * @hide
7306        */
7307       public static final String WIFI_FREQUENCY_BAND = "wifi_frequency_band";
7308
7309       /**
7310        * The Wi-Fi peer-to-peer device name
7311        * @hide
7312        */
7313       public static final String WIFI_P2P_DEVICE_NAME = "wifi_p2p_device_name";
7314
7315       /**
7316        * The min time between wifi disable and wifi enable
7317        * @hide
7318        */
7319       public static final String WIFI_REENABLE_DELAY_MS = "wifi_reenable_delay";
7320
7321       /**
7322        * Timeout for ephemeral networks when all known BSSIDs go out of range. We will disconnect
7323        * from an ephemeral network if there is no BSSID for that network with a non-null score that
7324        * has been seen in this time period.
7325        *
7326        * If this is less than or equal to zero, we use a more conservative behavior and only check
7327        * for a non-null score from the currently connected or target BSSID.
7328        * @hide
7329        */
7330       public static final String WIFI_EPHEMERAL_OUT_OF_RANGE_TIMEOUT_MS =
7331               "wifi_ephemeral_out_of_range_timeout_ms";
7332
7333       /**
7334        * The number of milliseconds to delay when checking for data stalls during
7335        * non-aggressive detection. (screen is turned off.)
7336        * @hide
7337        */
7338       public static final String DATA_STALL_ALARM_NON_AGGRESSIVE_DELAY_IN_MS =
7339               "data_stall_alarm_non_aggressive_delay_in_ms";
7340
7341       /**
7342        * The number of milliseconds to delay when checking for data stalls during
7343        * aggressive detection. (screen on or suspected data stall)
7344        * @hide
7345        */
7346       public static final String DATA_STALL_ALARM_AGGRESSIVE_DELAY_IN_MS =
7347               "data_stall_alarm_aggressive_delay_in_ms";
7348
7349       /**
7350        * The number of milliseconds to allow the provisioning apn to remain active
7351        * @hide
7352        */
7353       public static final String PROVISIONING_APN_ALARM_DELAY_IN_MS =
7354               "provisioning_apn_alarm_delay_in_ms";
7355
7356       /**
7357        * The interval in milliseconds at which to check gprs registration
7358        * after the first registration mismatch of gprs and voice service,
7359        * to detect possible data network registration problems.
7360        *
7361        * @hide
7362        */
7363       public static final String GPRS_REGISTER_CHECK_PERIOD_MS =
7364               "gprs_register_check_period_ms";
7365
7366       /**
7367        * Nonzero causes Log.wtf() to crash.
7368        * @hide
7369        */
7370       public static final String WTF_IS_FATAL = "wtf_is_fatal";
7371
7372       /**
7373        * Ringer mode. This is used internally, changing this value will not
7374        * change the ringer mode. See AudioManager.
7375        */
7376       public static final String MODE_RINGER = "mode_ringer";
7377
7378       /**
7379        * Overlay display devices setting.
7380        * The associated value is a specially formatted string that describes the
7381        * size and density of simulated secondary display devices.
7382        * <p>
7383        * Format: {width}x{height}/{dpi};...
7384        * </p><p>
7385        * Example:
7386        * <ul>
7387        * <li><code>1280x720/213</code>: make one overlay that is 1280x720 at 213dpi.</li>
7388        * <li><code>1920x1080/320;1280x720/213</code>: make two overlays, the first
7389        * at 1080p and the second at 720p.</li>
7390        * <li>If the value is empty, then no overlay display devices are created.</li>
7391        * </ul></p>
7392        *
7393        * @hide
7394        */
7395       public static final String OVERLAY_DISPLAY_DEVICES = "overlay_display_devices";
7396
7397        /**
7398         * Threshold values for the duration and level of a discharge cycle,
7399         * under which we log discharge cycle info.
7400         *
7401         * @hide
7402         */
7403        public static final String
7404                BATTERY_DISCHARGE_DURATION_THRESHOLD = "battery_discharge_duration_threshold";
7405
7406        /** @hide */
7407        public static final String BATTERY_DISCHARGE_THRESHOLD = "battery_discharge_threshold";
7408
7409        /**
7410         * Flag for allowing ActivityManagerService to send ACTION_APP_ERROR
7411         * intents on application crashes and ANRs. If this is disabled, the
7412         * crash/ANR dialog will never display the "Report" button.
7413         * <p>
7414         * Type: int (0 = disallow, 1 = allow)
7415         *
7416         * @hide
7417         */
7418        public static final String SEND_ACTION_APP_ERROR = "send_action_app_error";
7419
7420        /**
7421         * Maximum age of entries kept by {@link DropBoxManager}.
7422         *
7423         * @hide
7424         */
7425        public static final String DROPBOX_AGE_SECONDS = "dropbox_age_seconds";
7426
7427        /**
7428         * Maximum number of entry files which {@link DropBoxManager} will keep
7429         * around.
7430         *
7431         * @hide
7432         */
7433        public static final String DROPBOX_MAX_FILES = "dropbox_max_files";
7434
7435        /**
7436         * Maximum amount of disk space used by {@link DropBoxManager} no matter
7437         * what.
7438         *
7439         * @hide
7440         */
7441        public static final String DROPBOX_QUOTA_KB = "dropbox_quota_kb";
7442
7443        /**
7444         * Percent of free disk (excluding reserve) which {@link DropBoxManager}
7445         * will use.
7446         *
7447         * @hide
7448         */
7449        public static final String DROPBOX_QUOTA_PERCENT = "dropbox_quota_percent";
7450
7451        /**
7452         * Percent of total disk which {@link DropBoxManager} will never dip
7453         * into.
7454         *
7455         * @hide
7456         */
7457        public static final String DROPBOX_RESERVE_PERCENT = "dropbox_reserve_percent";
7458
7459        /**
7460         * Prefix for per-tag dropbox disable/enable settings.
7461         *
7462         * @hide
7463         */
7464        public static final String DROPBOX_TAG_PREFIX = "dropbox:";
7465
7466        /**
7467         * Lines of logcat to include with system crash/ANR/etc. reports, as a
7468         * prefix of the dropbox tag of the report type. For example,
7469         * "logcat_for_system_server_anr" controls the lines of logcat captured
7470         * with system server ANR reports. 0 to disable.
7471         *
7472         * @hide
7473         */
7474        public static final String ERROR_LOGCAT_PREFIX = "logcat_for_";
7475
7476        /**
7477         * The interval in minutes after which the amount of free storage left
7478         * on the device is logged to the event log
7479         *
7480         * @hide
7481         */
7482        public static final String SYS_FREE_STORAGE_LOG_INTERVAL = "sys_free_storage_log_interval";
7483
7484        /**
7485         * Threshold for the amount of change in disk free space required to
7486         * report the amount of free space. Used to prevent spamming the logs
7487         * when the disk free space isn't changing frequently.
7488         *
7489         * @hide
7490         */
7491        public static final String
7492                DISK_FREE_CHANGE_REPORTING_THRESHOLD = "disk_free_change_reporting_threshold";
7493
7494        /**
7495         * Minimum percentage of free storage on the device that is used to
7496         * determine if the device is running low on storage. The default is 10.
7497         * <p>
7498         * Say this value is set to 10, the device is considered running low on
7499         * storage if 90% or more of the device storage is filled up.
7500         *
7501         * @hide
7502         */
7503        public static final String
7504                SYS_STORAGE_THRESHOLD_PERCENTAGE = "sys_storage_threshold_percentage";
7505
7506        /**
7507         * Maximum byte size of the low storage threshold. This is to ensure
7508         * that {@link #SYS_STORAGE_THRESHOLD_PERCENTAGE} does not result in an
7509         * overly large threshold for large storage devices. Currently this must
7510         * be less than 2GB. This default is 500MB.
7511         *
7512         * @hide
7513         */
7514        public static final String
7515                SYS_STORAGE_THRESHOLD_MAX_BYTES = "sys_storage_threshold_max_bytes";
7516
7517        /**
7518         * Minimum bytes of free storage on the device before the data partition
7519         * is considered full. By default, 1 MB is reserved to avoid system-wide
7520         * SQLite disk full exceptions.
7521         *
7522         * @hide
7523         */
7524        public static final String
7525                SYS_STORAGE_FULL_THRESHOLD_BYTES = "sys_storage_full_threshold_bytes";
7526
7527        /**
7528         * The maximum reconnect delay for short network outages or when the
7529         * network is suspended due to phone use.
7530         *
7531         * @hide
7532         */
7533        public static final String
7534                SYNC_MAX_RETRY_DELAY_IN_SECONDS = "sync_max_retry_delay_in_seconds";
7535
7536        /**
7537         * The number of milliseconds to delay before sending out
7538         * {@link ConnectivityManager#CONNECTIVITY_ACTION} broadcasts. Ignored.
7539         *
7540         * @hide
7541         */
7542        public static final String CONNECTIVITY_CHANGE_DELAY = "connectivity_change_delay";
7543
7544
7545        /**
7546         * Network sampling interval, in seconds. We'll generate link information
7547         * about bytes/packets sent and error rates based on data sampled in this interval
7548         *
7549         * @hide
7550         */
7551
7552        public static final String CONNECTIVITY_SAMPLING_INTERVAL_IN_SECONDS =
7553                "connectivity_sampling_interval_in_seconds";
7554
7555        /**
7556         * The series of successively longer delays used in retrying to download PAC file.
7557         * Last delay is used between successful PAC downloads.
7558         *
7559         * @hide
7560         */
7561        public static final String PAC_CHANGE_DELAY = "pac_change_delay";
7562
7563        /**
7564         * Setting to turn off captive portal detection. Feature is enabled by
7565         * default and the setting needs to be set to 0 to disable it.
7566         *
7567         * @hide
7568         */
7569        public static final String
7570                CAPTIVE_PORTAL_DETECTION_ENABLED = "captive_portal_detection_enabled";
7571
7572        /**
7573         * The server used for captive portal detection upon a new conection. A
7574         * 204 response code from the server is used for validation.
7575         *
7576         * @hide
7577         */
7578        public static final String CAPTIVE_PORTAL_SERVER = "captive_portal_server";
7579
7580        /**
7581         * Whether network service discovery is enabled.
7582         *
7583         * @hide
7584         */
7585        public static final String NSD_ON = "nsd_on";
7586
7587        /**
7588         * Let user pick default install location.
7589         *
7590         * @hide
7591         */
7592        public static final String SET_INSTALL_LOCATION = "set_install_location";
7593
7594        /**
7595         * Default install location value.
7596         * 0 = auto, let system decide
7597         * 1 = internal
7598         * 2 = sdcard
7599         * @hide
7600         */
7601        public static final String DEFAULT_INSTALL_LOCATION = "default_install_location";
7602
7603        /**
7604         * ms during which to consume extra events related to Inet connection
7605         * condition after a transtion to fully-connected
7606         *
7607         * @hide
7608         */
7609        public static final String
7610                INET_CONDITION_DEBOUNCE_UP_DELAY = "inet_condition_debounce_up_delay";
7611
7612        /**
7613         * ms during which to consume extra events related to Inet connection
7614         * condtion after a transtion to partly-connected
7615         *
7616         * @hide
7617         */
7618        public static final String
7619                INET_CONDITION_DEBOUNCE_DOWN_DELAY = "inet_condition_debounce_down_delay";
7620
7621        /** {@hide} */
7622        public static final String
7623                READ_EXTERNAL_STORAGE_ENFORCED_DEFAULT = "read_external_storage_enforced_default";
7624
7625        /**
7626         * Host name and port for global http proxy. Uses ':' seperator for
7627         * between host and port.
7628         */
7629        public static final String HTTP_PROXY = "http_proxy";
7630
7631        /**
7632         * Host name for global http proxy. Set via ConnectivityManager.
7633         *
7634         * @hide
7635         */
7636        public static final String GLOBAL_HTTP_PROXY_HOST = "global_http_proxy_host";
7637
7638        /**
7639         * Integer host port for global http proxy. Set via ConnectivityManager.
7640         *
7641         * @hide
7642         */
7643        public static final String GLOBAL_HTTP_PROXY_PORT = "global_http_proxy_port";
7644
7645        /**
7646         * Exclusion list for global proxy. This string contains a list of
7647         * comma-separated domains where the global proxy does not apply.
7648         * Domains should be listed in a comma- separated list. Example of
7649         * acceptable formats: ".domain1.com,my.domain2.com" Use
7650         * ConnectivityManager to set/get.
7651         *
7652         * @hide
7653         */
7654        public static final String
7655                GLOBAL_HTTP_PROXY_EXCLUSION_LIST = "global_http_proxy_exclusion_list";
7656
7657        /**
7658         * The location PAC File for the proxy.
7659         * @hide
7660         */
7661        public static final String
7662                GLOBAL_HTTP_PROXY_PAC = "global_proxy_pac_url";
7663
7664        /**
7665         * Enables the UI setting to allow the user to specify the global HTTP
7666         * proxy and associated exclusion list.
7667         *
7668         * @hide
7669         */
7670        public static final String SET_GLOBAL_HTTP_PROXY = "set_global_http_proxy";
7671
7672        /**
7673         * Setting for default DNS in case nobody suggests one
7674         *
7675         * @hide
7676         */
7677        public static final String DEFAULT_DNS_SERVER = "default_dns_server";
7678
7679        /** {@hide} */
7680        public static final String
7681                BLUETOOTH_HEADSET_PRIORITY_PREFIX = "bluetooth_headset_priority_";
7682        /** {@hide} */
7683        public static final String
7684                BLUETOOTH_A2DP_SINK_PRIORITY_PREFIX = "bluetooth_a2dp_sink_priority_";
7685        /** {@hide} */
7686        public static final String
7687                BLUETOOTH_A2DP_SRC_PRIORITY_PREFIX = "bluetooth_a2dp_src_priority_";
7688        /** {@hide} */
7689        public static final String
7690                BLUETOOTH_INPUT_DEVICE_PRIORITY_PREFIX = "bluetooth_input_device_priority_";
7691        /** {@hide} */
7692        public static final String
7693                BLUETOOTH_MAP_PRIORITY_PREFIX = "bluetooth_map_priority_";
7694        /** {@hide} */
7695        public static final String
7696                BLUETOOTH_SAP_PRIORITY_PREFIX = "bluetooth_sap_priority_";
7697
7698        /**
7699         * Device Idle (Doze) specific settings.
7700         * This is encoded as a key=value list, separated by commas. Ex:
7701         *
7702         * "inactive_timeout=60000,sensing_timeout=400000"
7703         *
7704         * The following keys are supported:
7705         *
7706         * <pre>
7707         * inactive_to                      (long)
7708         * sensing_to                       (long)
7709         * motion_inactive_to               (long)
7710         * idle_after_inactive_to           (long)
7711         * idle_pending_to                  (long)
7712         * max_idle_pending_to              (long)
7713         * idle_pending_factor              (float)
7714         * idle_to                          (long)
7715         * max_idle_to                      (long)
7716         * idle_factor                      (float)
7717         * min_time_to_alarm                (long)
7718         * max_temp_app_whitelist_duration  (long)
7719         * </pre>
7720         *
7721         * <p>
7722         * Type: string
7723         * @hide
7724         * @see com.android.server.DeviceIdleController.Constants
7725         */
7726        public static final String DEVICE_IDLE_CONSTANTS = "device_idle_constants";
7727
7728        /**
7729         * App standby (app idle) specific settings.
7730         * This is encoded as a key=value list, separated by commas. Ex:
7731         *
7732         * "idle_duration=5000,parole_interval=4500"
7733         *
7734         * The following keys are supported:
7735         *
7736         * <pre>
7737         * idle_duration2       (long)
7738         * wallclock_threshold  (long)
7739         * parole_interval      (long)
7740         * parole_duration      (long)
7741         *
7742         * idle_duration        (long) // This is deprecated and used to circumvent b/26355386.
7743         * </pre>
7744         *
7745         * <p>
7746         * Type: string
7747         * @hide
7748         * @see com.android.server.usage.UsageStatsService.SettingsObserver
7749         */
7750        public static final String APP_IDLE_CONSTANTS = "app_idle_constants";
7751
7752        /**
7753         * Alarm manager specific settings.
7754         * This is encoded as a key=value list, separated by commas. Ex:
7755         *
7756         * "min_futurity=5000,allow_while_idle_short_time=4500"
7757         *
7758         * The following keys are supported:
7759         *
7760         * <pre>
7761         * min_futurity                         (long)
7762         * min_interval                         (long)
7763         * allow_while_idle_short_time          (long)
7764         * allow_while_idle_long_time           (long)
7765         * allow_while_idle_whitelist_duration  (long)
7766         * </pre>
7767         *
7768         * <p>
7769         * Type: string
7770         * @hide
7771         * @see com.android.server.AlarmManagerService.Constants
7772         */
7773        public static final String ALARM_MANAGER_CONSTANTS = "alarm_manager_constants";
7774
7775        /**
7776         * Get the key that retrieves a bluetooth headset's priority.
7777         * @hide
7778         */
7779        public static final String getBluetoothHeadsetPriorityKey(String address) {
7780            return BLUETOOTH_HEADSET_PRIORITY_PREFIX + address.toUpperCase(Locale.ROOT);
7781        }
7782
7783        /**
7784         * Get the key that retrieves a bluetooth a2dp sink's priority.
7785         * @hide
7786         */
7787        public static final String getBluetoothA2dpSinkPriorityKey(String address) {
7788            return BLUETOOTH_A2DP_SINK_PRIORITY_PREFIX + address.toUpperCase(Locale.ROOT);
7789        }
7790
7791        /**
7792         * Get the key that retrieves a bluetooth a2dp src's priority.
7793         * @hide
7794         */
7795        public static final String getBluetoothA2dpSrcPriorityKey(String address) {
7796            return BLUETOOTH_A2DP_SRC_PRIORITY_PREFIX + address.toUpperCase(Locale.ROOT);
7797        }
7798
7799        /**
7800         * Get the key that retrieves a bluetooth Input Device's priority.
7801         * @hide
7802         */
7803        public static final String getBluetoothInputDevicePriorityKey(String address) {
7804            return BLUETOOTH_INPUT_DEVICE_PRIORITY_PREFIX + address.toUpperCase(Locale.ROOT);
7805        }
7806
7807        /**
7808         * Get the key that retrieves a bluetooth map priority.
7809         * @hide
7810         */
7811        public static final String getBluetoothMapPriorityKey(String address) {
7812            return BLUETOOTH_MAP_PRIORITY_PREFIX + address.toUpperCase(Locale.ROOT);
7813        }
7814
7815        /**
7816         * Get the key that retrieves a bluetooth map priority.
7817         * @hide
7818         */
7819        public static final String getBluetoothSapPriorityKey(String address) {
7820            return BLUETOOTH_SAP_PRIORITY_PREFIX + address.toUpperCase(Locale.ROOT);
7821        }
7822
7823        /**
7824         * Scaling factor for normal window animations. Setting to 0 will
7825         * disable window animations.
7826         */
7827        public static final String WINDOW_ANIMATION_SCALE = "window_animation_scale";
7828
7829        /**
7830         * Scaling factor for activity transition animations. Setting to 0 will
7831         * disable window animations.
7832         */
7833        public static final String TRANSITION_ANIMATION_SCALE = "transition_animation_scale";
7834
7835        /**
7836         * Scaling factor for Animator-based animations. This affects both the
7837         * start delay and duration of all such animations. Setting to 0 will
7838         * cause animations to end immediately. The default value is 1.
7839         */
7840        public static final String ANIMATOR_DURATION_SCALE = "animator_duration_scale";
7841
7842        /**
7843         * Scaling factor for normal window animations. Setting to 0 will
7844         * disable window animations.
7845         *
7846         * @hide
7847         */
7848        public static final String FANCY_IME_ANIMATIONS = "fancy_ime_animations";
7849
7850        /**
7851         * If 0, the compatibility mode is off for all applications.
7852         * If 1, older applications run under compatibility mode.
7853         * TODO: remove this settings before code freeze (bug/1907571)
7854         * @hide
7855         */
7856        public static final String COMPATIBILITY_MODE = "compatibility_mode";
7857
7858        /**
7859         * CDMA only settings
7860         * Emergency Tone  0 = Off
7861         *                 1 = Alert
7862         *                 2 = Vibrate
7863         * @hide
7864         */
7865        public static final String EMERGENCY_TONE = "emergency_tone";
7866
7867        /**
7868         * CDMA only settings
7869         * Whether the auto retry is enabled. The value is
7870         * boolean (1 or 0).
7871         * @hide
7872         */
7873        public static final String CALL_AUTO_RETRY = "call_auto_retry";
7874
7875        /**
7876         * See RIL_PreferredNetworkType in ril.h
7877         * @hide
7878         */
7879        public static final String PREFERRED_NETWORK_MODE =
7880                "preferred_network_mode";
7881
7882        /**
7883         * Name of an application package to be debugged.
7884         */
7885        public static final String DEBUG_APP = "debug_app";
7886
7887        /**
7888         * If 1, when launching DEBUG_APP it will wait for the debugger before
7889         * starting user code.  If 0, it will run normally.
7890         */
7891        public static final String WAIT_FOR_DEBUGGER = "wait_for_debugger";
7892
7893        /**
7894         * Control whether the process CPU usage meter should be shown.
7895         */
7896        public static final String SHOW_PROCESSES = "show_processes";
7897
7898        /**
7899         * If 1 low power mode is enabled.
7900         * @hide
7901         */
7902        public static final String LOW_POWER_MODE = "low_power";
7903
7904        /**
7905         * Battery level [1-99] at which low power mode automatically turns on.
7906         * If 0, it will not automatically turn on.
7907         * @hide
7908         */
7909        public static final String LOW_POWER_MODE_TRIGGER_LEVEL = "low_power_trigger_level";
7910
7911         /**
7912         * If not 0, the activity manager will aggressively finish activities and
7913         * processes as soon as they are no longer needed.  If 0, the normal
7914         * extended lifetime is used.
7915         */
7916        public static final String ALWAYS_FINISH_ACTIVITIES = "always_finish_activities";
7917
7918        /**
7919         * @hide
7920         * If not 0, the activity manager will implement a looser version of background
7921         * check that is more compatible with existing apps.
7922         */
7923        public static final String LENIENT_BACKGROUND_CHECK = "lenient_background_check";
7924
7925        /**
7926         * Use Dock audio output for media:
7927         *      0 = disabled
7928         *      1 = enabled
7929         * @hide
7930         */
7931        public static final String DOCK_AUDIO_MEDIA_ENABLED = "dock_audio_media_enabled";
7932
7933        /**
7934         * The surround sound formats AC3, DTS or IEC61937 are
7935         * available for use if they are detected.
7936         * This is the default mode.
7937         *
7938         * Note that AUTO is equivalent to ALWAYS for Android TVs and other
7939         * devices that have an S/PDIF output. This is because S/PDIF
7940         * is unidirectional and the TV cannot know if a decoder is
7941         * connected. So it assumes they are always available.
7942         * @hide
7943         */
7944         public static final int ENCODED_SURROUND_OUTPUT_AUTO = 0;
7945
7946        /**
7947         * AC3, DTS or IEC61937 are NEVER available, even if they
7948         * are detected by the hardware. Those formats will not be
7949         * reported.
7950         *
7951         * An example use case would be an AVR reports that it is capable of
7952         * surround sound decoding but is broken. If NEVER is chosen
7953         * then apps must use PCM output instead of encoded output.
7954         * @hide
7955         */
7956         public static final int ENCODED_SURROUND_OUTPUT_NEVER = 1;
7957
7958        /**
7959         * AC3, DTS or IEC61937 are ALWAYS available, even if they
7960         * are not detected by the hardware. Those formats will be
7961         * reported as part of the HDMI output capability. Applications
7962         * are then free to use either PCM or encoded output.
7963         *
7964         * An example use case would be a when TV was connected over
7965         * TOS-link to an AVR. But the TV could not see it because TOS-link
7966         * is unidirectional.
7967         * @hide
7968         */
7969         public static final int ENCODED_SURROUND_OUTPUT_ALWAYS = 2;
7970
7971        /**
7972         * Set to ENCODED_SURROUND_OUTPUT_AUTO,
7973         * ENCODED_SURROUND_OUTPUT_NEVER or
7974         * ENCODED_SURROUND_OUTPUT_ALWAYS
7975         * @hide
7976         */
7977        public static final String ENCODED_SURROUND_OUTPUT = "encoded_surround_output";
7978
7979        /**
7980         * Persisted safe headphone volume management state by AudioService
7981         * @hide
7982         */
7983        public static final String AUDIO_SAFE_VOLUME_STATE = "audio_safe_volume_state";
7984
7985        /**
7986         * URL for tzinfo (time zone) updates
7987         * @hide
7988         */
7989        public static final String TZINFO_UPDATE_CONTENT_URL = "tzinfo_content_url";
7990
7991        /**
7992         * URL for tzinfo (time zone) update metadata
7993         * @hide
7994         */
7995        public static final String TZINFO_UPDATE_METADATA_URL = "tzinfo_metadata_url";
7996
7997        /**
7998         * URL for selinux (mandatory access control) updates
7999         * @hide
8000         */
8001        public static final String SELINUX_UPDATE_CONTENT_URL = "selinux_content_url";
8002
8003        /**
8004         * URL for selinux (mandatory access control) update metadata
8005         * @hide
8006         */
8007        public static final String SELINUX_UPDATE_METADATA_URL = "selinux_metadata_url";
8008
8009        /**
8010         * URL for sms short code updates
8011         * @hide
8012         */
8013        public static final String SMS_SHORT_CODES_UPDATE_CONTENT_URL =
8014                "sms_short_codes_content_url";
8015
8016        /**
8017         * URL for sms short code update metadata
8018         * @hide
8019         */
8020        public static final String SMS_SHORT_CODES_UPDATE_METADATA_URL =
8021                "sms_short_codes_metadata_url";
8022
8023        /**
8024         * URL for apn_db updates
8025         * @hide
8026         */
8027        public static final String APN_DB_UPDATE_CONTENT_URL = "apn_db_content_url";
8028
8029        /**
8030         * URL for apn_db update metadata
8031         * @hide
8032         */
8033        public static final String APN_DB_UPDATE_METADATA_URL = "apn_db_metadata_url";
8034
8035        /**
8036         * URL for cert pinlist updates
8037         * @hide
8038         */
8039        public static final String CERT_PIN_UPDATE_CONTENT_URL = "cert_pin_content_url";
8040
8041        /**
8042         * URL for cert pinlist updates
8043         * @hide
8044         */
8045        public static final String CERT_PIN_UPDATE_METADATA_URL = "cert_pin_metadata_url";
8046
8047        /**
8048         * URL for intent firewall updates
8049         * @hide
8050         */
8051        public static final String INTENT_FIREWALL_UPDATE_CONTENT_URL =
8052                "intent_firewall_content_url";
8053
8054        /**
8055         * URL for intent firewall update metadata
8056         * @hide
8057         */
8058        public static final String INTENT_FIREWALL_UPDATE_METADATA_URL =
8059                "intent_firewall_metadata_url";
8060
8061        /**
8062         * SELinux enforcement status. If 0, permissive; if 1, enforcing.
8063         * @hide
8064         */
8065        public static final String SELINUX_STATUS = "selinux_status";
8066
8067        /**
8068         * Developer setting to force RTL layout.
8069         * @hide
8070         */
8071        public static final String DEVELOPMENT_FORCE_RTL = "debug.force_rtl";
8072
8073        /**
8074         * Milliseconds after screen-off after which low battery sounds will be silenced.
8075         *
8076         * If zero, battery sounds will always play.
8077         * Defaults to @integer/def_low_battery_sound_timeout in SettingsProvider.
8078         *
8079         * @hide
8080         */
8081        public static final String LOW_BATTERY_SOUND_TIMEOUT = "low_battery_sound_timeout";
8082
8083        /**
8084         * Milliseconds to wait before bouncing Wi-Fi after settings is restored. Note that after
8085         * the caller is done with this, they should call {@link ContentResolver#delete} to
8086         * clean up any value that they may have written.
8087         *
8088         * @hide
8089         */
8090        public static final String WIFI_BOUNCE_DELAY_OVERRIDE_MS = "wifi_bounce_delay_override_ms";
8091
8092        /**
8093         * Defines global runtime overrides to window policy.
8094         *
8095         * See {@link com.android.server.policy.PolicyControl} for value format.
8096         *
8097         * @hide
8098         */
8099        public static final String POLICY_CONTROL = "policy_control";
8100
8101        /**
8102         * Defines global zen mode.  ZEN_MODE_OFF, ZEN_MODE_IMPORTANT_INTERRUPTIONS,
8103         * or ZEN_MODE_NO_INTERRUPTIONS.
8104         *
8105         * @hide
8106         */
8107        public static final String ZEN_MODE = "zen_mode";
8108
8109        /** @hide */ public static final int ZEN_MODE_OFF = 0;
8110        /** @hide */ public static final int ZEN_MODE_IMPORTANT_INTERRUPTIONS = 1;
8111        /** @hide */ public static final int ZEN_MODE_NO_INTERRUPTIONS = 2;
8112        /** @hide */ public static final int ZEN_MODE_ALARMS = 3;
8113
8114        /** @hide */ public static String zenModeToString(int mode) {
8115            if (mode == ZEN_MODE_IMPORTANT_INTERRUPTIONS) return "ZEN_MODE_IMPORTANT_INTERRUPTIONS";
8116            if (mode == ZEN_MODE_ALARMS) return "ZEN_MODE_ALARMS";
8117            if (mode == ZEN_MODE_NO_INTERRUPTIONS) return "ZEN_MODE_NO_INTERRUPTIONS";
8118            return "ZEN_MODE_OFF";
8119        }
8120
8121        /** @hide */ public static boolean isValidZenMode(int value) {
8122            switch (value) {
8123                case Global.ZEN_MODE_OFF:
8124                case Global.ZEN_MODE_IMPORTANT_INTERRUPTIONS:
8125                case Global.ZEN_MODE_ALARMS:
8126                case Global.ZEN_MODE_NO_INTERRUPTIONS:
8127                    return true;
8128                default:
8129                    return false;
8130            }
8131        }
8132
8133        /**
8134         * Value of the ringer before entering zen mode.
8135         *
8136         * @hide
8137         */
8138        public static final String ZEN_MODE_RINGER_LEVEL = "zen_mode_ringer_level";
8139
8140        /**
8141         * Opaque value, changes when persisted zen mode configuration changes.
8142         *
8143         * @hide
8144         */
8145        public static final String ZEN_MODE_CONFIG_ETAG = "zen_mode_config_etag";
8146
8147        /**
8148         * Defines global heads up toggle.  One of HEADS_UP_OFF, HEADS_UP_ON.
8149         *
8150         * @hide
8151         */
8152        public static final String HEADS_UP_NOTIFICATIONS_ENABLED =
8153                "heads_up_notifications_enabled";
8154
8155        /** @hide */ public static final int HEADS_UP_OFF = 0;
8156        /** @hide */ public static final int HEADS_UP_ON = 1;
8157
8158        /**
8159         * The name of the device
8160         *
8161         * @hide
8162         */
8163        public static final String DEVICE_NAME = "device_name";
8164
8165        /**
8166         * Whether the NetworkScoringService has been first initialized.
8167         * <p>
8168         * Type: int (0 for false, 1 for true)
8169         * @hide
8170         */
8171        public static final String NETWORK_SCORING_PROVISIONED = "network_scoring_provisioned";
8172
8173        /**
8174         * Whether the user wants to be prompted for password to decrypt the device on boot.
8175         * This only matters if the storage is encrypted.
8176         * <p>
8177         * Type: int (0 for false, 1 for true)
8178         * @hide
8179         */
8180        public static final String REQUIRE_PASSWORD_TO_DECRYPT = "require_password_to_decrypt";
8181
8182        /**
8183         * Whether the Volte is enabled
8184         * <p>
8185         * Type: int (0 for false, 1 for true)
8186         * @hide
8187         */
8188        public static final String ENHANCED_4G_MODE_ENABLED = "volte_vt_enabled";
8189
8190        /**
8191         * Whether VT (Video Telephony over IMS) is enabled
8192         * <p>
8193         * Type: int (0 for false, 1 for true)
8194         *
8195         * @hide
8196         */
8197        public static final String VT_IMS_ENABLED = "vt_ims_enabled";
8198
8199        /**
8200         * Whether WFC is enabled
8201         * <p>
8202         * Type: int (0 for false, 1 for true)
8203         *
8204         * @hide
8205         */
8206        public static final String WFC_IMS_ENABLED = "wfc_ims_enabled";
8207
8208        /**
8209         * WFC Mode.
8210         * <p>
8211         * Type: int - 2=Wi-Fi preferred, 1=Cellular preferred, 0=Wi-Fi only
8212         *
8213         * @hide
8214         */
8215        public static final String WFC_IMS_MODE = "wfc_ims_mode";
8216
8217        /**
8218         * Whether WFC roaming is enabled
8219         * <p>
8220         * Type: int (0 for false, 1 for true)
8221         *
8222         * @hide
8223         */
8224        public static final String WFC_IMS_ROAMING_ENABLED = "wfc_ims_roaming_enabled";
8225
8226        /**
8227         * Whether user can enable/disable LTE as a preferred network. A carrier might control
8228         * this via gservices, OMA-DM, carrier app, etc.
8229         * <p>
8230         * Type: int (0 for false, 1 for true)
8231         * @hide
8232         */
8233        public static final String LTE_SERVICE_FORCED = "lte_service_forced";
8234
8235        /**
8236         * Ephemeral app cookie max size in bytes.
8237         * <p>
8238         * Type: int
8239         * @hide
8240         */
8241        public static final String EPHEMERAL_COOKIE_MAX_SIZE_BYTES =
8242                "ephemeral_cookie_max_size_bytes";
8243
8244        /**
8245         * The duration for caching uninstalled ephemeral apps.
8246         * <p>
8247         * Type: long
8248         * @hide
8249         */
8250        public static final String UNINSTALLED_EPHEMERAL_APP_CACHE_DURATION_MILLIS =
8251                "uninstalled_ephemeral_app_cache_duration_millis";
8252
8253        /**
8254         * Allows switching users when system user is locked.
8255         * <p>
8256         * Type: int
8257         * @hide
8258         */
8259        public static final String ALLOW_USER_SWITCHING_WHEN_SYSTEM_USER_LOCKED =
8260                "allow_user_switching_when_system_user_locked";
8261
8262        /**
8263         * Boot count since the device starts running APK level 24.
8264         * <p>
8265         * Type: int
8266         */
8267        public static final String BOOT_COUNT = "boot_count";
8268
8269        /**
8270         * Settings to backup. This is here so that it's in the same place as the settings
8271         * keys and easy to update.
8272         *
8273         * These keys may be mentioned in the SETTINGS_TO_BACKUP arrays in System
8274         * and Secure as well.  This is because those tables drive both backup and
8275         * restore, and restore needs to properly whitelist keys that used to live
8276         * in those namespaces.  The keys will only actually be backed up / restored
8277         * if they are also mentioned in this table (Global.SETTINGS_TO_BACKUP).
8278         *
8279         * NOTE: Settings are backed up and restored in the order they appear
8280         *       in this array. If you have one setting depending on another,
8281         *       make sure that they are ordered appropriately.
8282         *
8283         * @hide
8284         */
8285        public static final String[] SETTINGS_TO_BACKUP = {
8286            BUGREPORT_IN_POWER_MENU,
8287            STAY_ON_WHILE_PLUGGED_IN,
8288            AUTO_TIME,
8289            AUTO_TIME_ZONE,
8290            POWER_SOUNDS_ENABLED,
8291            DOCK_SOUNDS_ENABLED,
8292            CHARGING_SOUNDS_ENABLED,
8293            USB_MASS_STORAGE_ENABLED,
8294            ENABLE_ACCESSIBILITY_GLOBAL_GESTURE_ENABLED,
8295            WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON,
8296            WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY,
8297            WIFI_WATCHDOG_POOR_NETWORK_TEST_ENABLED,
8298            WIFI_NUM_OPEN_NETWORKS_KEPT,
8299            EMERGENCY_TONE,
8300            CALL_AUTO_RETRY,
8301            DOCK_AUDIO_MEDIA_ENABLED,
8302            ENCODED_SURROUND_OUTPUT,
8303            LOW_POWER_MODE_TRIGGER_LEVEL
8304        };
8305
8306        // Populated lazily, guarded by class object:
8307        private static NameValueCache sNameValueCache = new NameValueCache(
8308                    SYS_PROP_SETTING_VERSION,
8309                    CONTENT_URI,
8310                    CALL_METHOD_GET_GLOBAL,
8311                    CALL_METHOD_PUT_GLOBAL);
8312
8313        // Certain settings have been moved from global to the per-user secure namespace
8314        private static final HashSet<String> MOVED_TO_SECURE;
8315        static {
8316            MOVED_TO_SECURE = new HashSet<String>(1);
8317            MOVED_TO_SECURE.add(Settings.Global.INSTALL_NON_MARKET_APPS);
8318        }
8319
8320        /** @hide */
8321        public static void getMovedToSecureSettings(Set<String> outKeySet) {
8322            outKeySet.addAll(MOVED_TO_SECURE);
8323        }
8324
8325        /**
8326         * Look up a name in the database.
8327         * @param resolver to access the database with
8328         * @param name to look up in the table
8329         * @return the corresponding value, or null if not present
8330         */
8331        public static String getString(ContentResolver resolver, String name) {
8332            return getStringForUser(resolver, name, UserHandle.myUserId());
8333        }
8334
8335        /** @hide */
8336        public static String getStringForUser(ContentResolver resolver, String name,
8337                int userHandle) {
8338            if (MOVED_TO_SECURE.contains(name)) {
8339                Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.Global"
8340                        + " to android.provider.Settings.Secure, returning read-only value.");
8341                return Secure.getStringForUser(resolver, name, userHandle);
8342            }
8343            return sNameValueCache.getStringForUser(resolver, name, userHandle);
8344        }
8345
8346        /**
8347         * Store a name/value pair into the database.
8348         * @param resolver to access the database with
8349         * @param name to store
8350         * @param value to associate with the name
8351         * @return true if the value was set, false on database errors
8352         */
8353        public static boolean putString(ContentResolver resolver,
8354                String name, String value) {
8355            return putStringForUser(resolver, name, value, UserHandle.myUserId());
8356        }
8357
8358        /** @hide */
8359        public static boolean putStringForUser(ContentResolver resolver,
8360                String name, String value, int userHandle) {
8361            if (LOCAL_LOGV) {
8362                Log.v(TAG, "Global.putString(name=" + name + ", value=" + value
8363                        + " for " + userHandle);
8364            }
8365            // Global and Secure have the same access policy so we can forward writes
8366            if (MOVED_TO_SECURE.contains(name)) {
8367                Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.Global"
8368                        + " to android.provider.Settings.Secure, value is unchanged.");
8369                return Secure.putStringForUser(resolver, name, value, userHandle);
8370            }
8371            return sNameValueCache.putStringForUser(resolver, name, value, userHandle);
8372        }
8373
8374        /**
8375         * Construct the content URI for a particular name/value pair,
8376         * useful for monitoring changes with a ContentObserver.
8377         * @param name to look up in the table
8378         * @return the corresponding content URI, or null if not present
8379         */
8380        public static Uri getUriFor(String name) {
8381            return getUriFor(CONTENT_URI, name);
8382        }
8383
8384        /**
8385         * Convenience function for retrieving a single secure settings value
8386         * as an integer.  Note that internally setting values are always
8387         * stored as strings; this function converts the string to an integer
8388         * for you.  The default value will be returned if the setting is
8389         * not defined or not an integer.
8390         *
8391         * @param cr The ContentResolver to access.
8392         * @param name The name of the setting to retrieve.
8393         * @param def Value to return if the setting is not defined.
8394         *
8395         * @return The setting's current value, or 'def' if it is not defined
8396         * or not a valid integer.
8397         */
8398        public static int getInt(ContentResolver cr, String name, int def) {
8399            String v = getString(cr, name);
8400            try {
8401                return v != null ? Integer.parseInt(v) : def;
8402            } catch (NumberFormatException e) {
8403                return def;
8404            }
8405        }
8406
8407        /**
8408         * Convenience function for retrieving a single secure settings value
8409         * as an integer.  Note that internally setting values are always
8410         * stored as strings; this function converts the string to an integer
8411         * for you.
8412         * <p>
8413         * This version does not take a default value.  If the setting has not
8414         * been set, or the string value is not a number,
8415         * it throws {@link SettingNotFoundException}.
8416         *
8417         * @param cr The ContentResolver to access.
8418         * @param name The name of the setting to retrieve.
8419         *
8420         * @throws SettingNotFoundException Thrown if a setting by the given
8421         * name can't be found or the setting value is not an integer.
8422         *
8423         * @return The setting's current value.
8424         */
8425        public static int getInt(ContentResolver cr, String name)
8426                throws SettingNotFoundException {
8427            String v = getString(cr, name);
8428            try {
8429                return Integer.parseInt(v);
8430            } catch (NumberFormatException e) {
8431                throw new SettingNotFoundException(name);
8432            }
8433        }
8434
8435        /**
8436         * Convenience function for updating a single settings value as an
8437         * integer. This will either create a new entry in the table if the
8438         * given name does not exist, or modify the value of the existing row
8439         * with that name.  Note that internally setting values are always
8440         * stored as strings, so this function converts the given value to a
8441         * string before storing it.
8442         *
8443         * @param cr The ContentResolver to access.
8444         * @param name The name of the setting to modify.
8445         * @param value The new value for the setting.
8446         * @return true if the value was set, false on database errors
8447         */
8448        public static boolean putInt(ContentResolver cr, String name, int value) {
8449            return putString(cr, name, Integer.toString(value));
8450        }
8451
8452        /**
8453         * Convenience function for retrieving a single secure settings value
8454         * as a {@code long}.  Note that internally setting values are always
8455         * stored as strings; this function converts the string to a {@code long}
8456         * for you.  The default value will be returned if the setting is
8457         * not defined or not a {@code long}.
8458         *
8459         * @param cr The ContentResolver to access.
8460         * @param name The name of the setting to retrieve.
8461         * @param def Value to return if the setting is not defined.
8462         *
8463         * @return The setting's current value, or 'def' if it is not defined
8464         * or not a valid {@code long}.
8465         */
8466        public static long getLong(ContentResolver cr, String name, long def) {
8467            String valString = getString(cr, name);
8468            long value;
8469            try {
8470                value = valString != null ? Long.parseLong(valString) : def;
8471            } catch (NumberFormatException e) {
8472                value = def;
8473            }
8474            return value;
8475        }
8476
8477        /**
8478         * Convenience function for retrieving a single secure settings value
8479         * as a {@code long}.  Note that internally setting values are always
8480         * stored as strings; this function converts the string to a {@code long}
8481         * for you.
8482         * <p>
8483         * This version does not take a default value.  If the setting has not
8484         * been set, or the string value is not a number,
8485         * it throws {@link SettingNotFoundException}.
8486         *
8487         * @param cr The ContentResolver to access.
8488         * @param name The name of the setting to retrieve.
8489         *
8490         * @return The setting's current value.
8491         * @throws SettingNotFoundException Thrown if a setting by the given
8492         * name can't be found or the setting value is not an integer.
8493         */
8494        public static long getLong(ContentResolver cr, String name)
8495                throws SettingNotFoundException {
8496            String valString = getString(cr, name);
8497            try {
8498                return Long.parseLong(valString);
8499            } catch (NumberFormatException e) {
8500                throw new SettingNotFoundException(name);
8501            }
8502        }
8503
8504        /**
8505         * Convenience function for updating a secure settings value as a long
8506         * integer. This will either create a new entry in the table if the
8507         * given name does not exist, or modify the value of the existing row
8508         * with that name.  Note that internally setting values are always
8509         * stored as strings, so this function converts the given value to a
8510         * string before storing it.
8511         *
8512         * @param cr The ContentResolver to access.
8513         * @param name The name of the setting to modify.
8514         * @param value The new value for the setting.
8515         * @return true if the value was set, false on database errors
8516         */
8517        public static boolean putLong(ContentResolver cr, String name, long value) {
8518            return putString(cr, name, Long.toString(value));
8519        }
8520
8521        /**
8522         * Convenience function for retrieving a single secure settings value
8523         * as a floating point number.  Note that internally setting values are
8524         * always stored as strings; this function converts the string to an
8525         * float for you. The default value will be returned if the setting
8526         * is not defined or not a valid float.
8527         *
8528         * @param cr The ContentResolver to access.
8529         * @param name The name of the setting to retrieve.
8530         * @param def Value to return if the setting is not defined.
8531         *
8532         * @return The setting's current value, or 'def' if it is not defined
8533         * or not a valid float.
8534         */
8535        public static float getFloat(ContentResolver cr, String name, float def) {
8536            String v = getString(cr, name);
8537            try {
8538                return v != null ? Float.parseFloat(v) : def;
8539            } catch (NumberFormatException e) {
8540                return def;
8541            }
8542        }
8543
8544        /**
8545         * Convenience function for retrieving a single secure settings value
8546         * as a float.  Note that internally setting values are always
8547         * stored as strings; this function converts the string to a float
8548         * for you.
8549         * <p>
8550         * This version does not take a default value.  If the setting has not
8551         * been set, or the string value is not a number,
8552         * it throws {@link SettingNotFoundException}.
8553         *
8554         * @param cr The ContentResolver to access.
8555         * @param name The name of the setting to retrieve.
8556         *
8557         * @throws SettingNotFoundException Thrown if a setting by the given
8558         * name can't be found or the setting value is not a float.
8559         *
8560         * @return The setting's current value.
8561         */
8562        public static float getFloat(ContentResolver cr, String name)
8563                throws SettingNotFoundException {
8564            String v = getString(cr, name);
8565            if (v == null) {
8566                throw new SettingNotFoundException(name);
8567            }
8568            try {
8569                return Float.parseFloat(v);
8570            } catch (NumberFormatException e) {
8571                throw new SettingNotFoundException(name);
8572            }
8573        }
8574
8575        /**
8576         * Convenience function for updating a single settings value as a
8577         * floating point number. This will either create a new entry in the
8578         * table if the given name does not exist, or modify the value of the
8579         * existing row with that name.  Note that internally setting values
8580         * are always stored as strings, so this function converts the given
8581         * value to a string before storing it.
8582         *
8583         * @param cr The ContentResolver to access.
8584         * @param name The name of the setting to modify.
8585         * @param value The new value for the setting.
8586         * @return true if the value was set, false on database errors
8587         */
8588        public static boolean putFloat(ContentResolver cr, String name, float value) {
8589            return putString(cr, name, Float.toString(value));
8590        }
8591
8592
8593        /**
8594          * Subscription to be used for voice call on a multi sim device. The supported values
8595          * are 0 = SUB1, 1 = SUB2 and etc.
8596          * @hide
8597          */
8598        public static final String MULTI_SIM_VOICE_CALL_SUBSCRIPTION = "multi_sim_voice_call";
8599
8600        /**
8601          * Used to provide option to user to select subscription during dial.
8602          * The supported values are 0 = disable or 1 = enable prompt.
8603          * @hide
8604          */
8605        public static final String MULTI_SIM_VOICE_PROMPT = "multi_sim_voice_prompt";
8606
8607        /**
8608          * Subscription to be used for data call on a multi sim device. The supported values
8609          * are 0 = SUB1, 1 = SUB2 and etc.
8610          * @hide
8611          */
8612        public static final String MULTI_SIM_DATA_CALL_SUBSCRIPTION = "multi_sim_data_call";
8613
8614        /**
8615          * Subscription to be used for SMS on a multi sim device. The supported values
8616          * are 0 = SUB1, 1 = SUB2 and etc.
8617          * @hide
8618          */
8619        public static final String MULTI_SIM_SMS_SUBSCRIPTION = "multi_sim_sms";
8620
8621       /**
8622          * Used to provide option to user to select subscription during send SMS.
8623          * The value 1 - enable, 0 - disable
8624          * @hide
8625          */
8626        public static final String MULTI_SIM_SMS_PROMPT = "multi_sim_sms_prompt";
8627
8628
8629
8630        /** User preferred subscriptions setting.
8631          * This holds the details of the user selected subscription from the card and
8632          * the activation status. Each settings string have the coma separated values
8633          * iccId,appType,appId,activationStatus,3gppIndex,3gpp2Index
8634          * @hide
8635         */
8636        public static final String[] MULTI_SIM_USER_PREFERRED_SUBS = {"user_preferred_sub1",
8637                "user_preferred_sub2","user_preferred_sub3"};
8638
8639        /**
8640         * Whether to enable new contacts aggregator or not.
8641         * The value 1 - enable, 0 - disable
8642         * @hide
8643         */
8644        public static final String NEW_CONTACT_AGGREGATOR = "new_contact_aggregator";
8645
8646        /**
8647         * Whether to enable contacts metadata syncing or not
8648         * The value 1 - enable, 0 - disable
8649         */
8650        public static final String CONTACT_METADATA_SYNC = "contact_metadata_sync";
8651
8652        /**
8653         * Whether to enable cellular on boot.
8654         * The value 1 - enable, 0 - disable
8655         * @hide
8656         */
8657        public static final String ENABLE_CELLULAR_ON_BOOT = "enable_cellular_on_boot";
8658    }
8659
8660    /**
8661     * User-defined bookmarks and shortcuts.  The target of each bookmark is an
8662     * Intent URL, allowing it to be either a web page or a particular
8663     * application activity.
8664     *
8665     * @hide
8666     */
8667    public static final class Bookmarks implements BaseColumns
8668    {
8669        private static final String TAG = "Bookmarks";
8670
8671        /**
8672         * The content:// style URL for this table
8673         */
8674        public static final Uri CONTENT_URI =
8675            Uri.parse("content://" + AUTHORITY + "/bookmarks");
8676
8677        /**
8678         * The row ID.
8679         * <p>Type: INTEGER</p>
8680         */
8681        public static final String ID = "_id";
8682
8683        /**
8684         * Descriptive name of the bookmark that can be displayed to the user.
8685         * If this is empty, the title should be resolved at display time (use
8686         * {@link #getTitle(Context, Cursor)} any time you want to display the
8687         * title of a bookmark.)
8688         * <P>
8689         * Type: TEXT
8690         * </P>
8691         */
8692        public static final String TITLE = "title";
8693
8694        /**
8695         * Arbitrary string (displayed to the user) that allows bookmarks to be
8696         * organized into categories.  There are some special names for
8697         * standard folders, which all start with '@'.  The label displayed for
8698         * the folder changes with the locale (via {@link #getLabelForFolder}) but
8699         * the folder name does not change so you can consistently query for
8700         * the folder regardless of the current locale.
8701         *
8702         * <P>Type: TEXT</P>
8703         *
8704         */
8705        public static final String FOLDER = "folder";
8706
8707        /**
8708         * The Intent URL of the bookmark, describing what it points to.  This
8709         * value is given to {@link android.content.Intent#getIntent} to create
8710         * an Intent that can be launched.
8711         * <P>Type: TEXT</P>
8712         */
8713        public static final String INTENT = "intent";
8714
8715        /**
8716         * Optional shortcut character associated with this bookmark.
8717         * <P>Type: INTEGER</P>
8718         */
8719        public static final String SHORTCUT = "shortcut";
8720
8721        /**
8722         * The order in which the bookmark should be displayed
8723         * <P>Type: INTEGER</P>
8724         */
8725        public static final String ORDERING = "ordering";
8726
8727        private static final String[] sIntentProjection = { INTENT };
8728        private static final String[] sShortcutProjection = { ID, SHORTCUT };
8729        private static final String sShortcutSelection = SHORTCUT + "=?";
8730
8731        /**
8732         * Convenience function to retrieve the bookmarked Intent for a
8733         * particular shortcut key.
8734         *
8735         * @param cr The ContentResolver to query.
8736         * @param shortcut The shortcut key.
8737         *
8738         * @return Intent The bookmarked URL, or null if there is no bookmark
8739         *         matching the given shortcut.
8740         */
8741        public static Intent getIntentForShortcut(ContentResolver cr, char shortcut)
8742        {
8743            Intent intent = null;
8744
8745            Cursor c = cr.query(CONTENT_URI,
8746                    sIntentProjection, sShortcutSelection,
8747                    new String[] { String.valueOf((int) shortcut) }, ORDERING);
8748            // Keep trying until we find a valid shortcut
8749            try {
8750                while (intent == null && c.moveToNext()) {
8751                    try {
8752                        String intentURI = c.getString(c.getColumnIndexOrThrow(INTENT));
8753                        intent = Intent.parseUri(intentURI, 0);
8754                    } catch (java.net.URISyntaxException e) {
8755                        // The stored URL is bad...  ignore it.
8756                    } catch (IllegalArgumentException e) {
8757                        // Column not found
8758                        Log.w(TAG, "Intent column not found", e);
8759                    }
8760                }
8761            } finally {
8762                if (c != null) c.close();
8763            }
8764
8765            return intent;
8766        }
8767
8768        /**
8769         * Add a new bookmark to the system.
8770         *
8771         * @param cr The ContentResolver to query.
8772         * @param intent The desired target of the bookmark.
8773         * @param title Bookmark title that is shown to the user; null if none
8774         *            or it should be resolved to the intent's title.
8775         * @param folder Folder in which to place the bookmark; null if none.
8776         * @param shortcut Shortcut that will invoke the bookmark; 0 if none. If
8777         *            this is non-zero and there is an existing bookmark entry
8778         *            with this same shortcut, then that existing shortcut is
8779         *            cleared (the bookmark is not removed).
8780         * @return The unique content URL for the new bookmark entry.
8781         */
8782        public static Uri add(ContentResolver cr,
8783                                           Intent intent,
8784                                           String title,
8785                                           String folder,
8786                                           char shortcut,
8787                                           int ordering)
8788        {
8789            // If a shortcut is supplied, and it is already defined for
8790            // another bookmark, then remove the old definition.
8791            if (shortcut != 0) {
8792                cr.delete(CONTENT_URI, sShortcutSelection,
8793                        new String[] { String.valueOf((int) shortcut) });
8794            }
8795
8796            ContentValues values = new ContentValues();
8797            if (title != null) values.put(TITLE, title);
8798            if (folder != null) values.put(FOLDER, folder);
8799            values.put(INTENT, intent.toUri(0));
8800            if (shortcut != 0) values.put(SHORTCUT, (int) shortcut);
8801            values.put(ORDERING, ordering);
8802            return cr.insert(CONTENT_URI, values);
8803        }
8804
8805        /**
8806         * Return the folder name as it should be displayed to the user.  This
8807         * takes care of localizing special folders.
8808         *
8809         * @param r Resources object for current locale; only need access to
8810         *          system resources.
8811         * @param folder The value found in the {@link #FOLDER} column.
8812         *
8813         * @return CharSequence The label for this folder that should be shown
8814         *         to the user.
8815         */
8816        public static CharSequence getLabelForFolder(Resources r, String folder) {
8817            return folder;
8818        }
8819
8820        /**
8821         * Return the title as it should be displayed to the user. This takes
8822         * care of localizing bookmarks that point to activities.
8823         *
8824         * @param context A context.
8825         * @param cursor A cursor pointing to the row whose title should be
8826         *        returned. The cursor must contain at least the {@link #TITLE}
8827         *        and {@link #INTENT} columns.
8828         * @return A title that is localized and can be displayed to the user,
8829         *         or the empty string if one could not be found.
8830         */
8831        public static CharSequence getTitle(Context context, Cursor cursor) {
8832            int titleColumn = cursor.getColumnIndex(TITLE);
8833            int intentColumn = cursor.getColumnIndex(INTENT);
8834            if (titleColumn == -1 || intentColumn == -1) {
8835                throw new IllegalArgumentException(
8836                        "The cursor must contain the TITLE and INTENT columns.");
8837            }
8838
8839            String title = cursor.getString(titleColumn);
8840            if (!TextUtils.isEmpty(title)) {
8841                return title;
8842            }
8843
8844            String intentUri = cursor.getString(intentColumn);
8845            if (TextUtils.isEmpty(intentUri)) {
8846                return "";
8847            }
8848
8849            Intent intent;
8850            try {
8851                intent = Intent.parseUri(intentUri, 0);
8852            } catch (URISyntaxException e) {
8853                return "";
8854            }
8855
8856            PackageManager packageManager = context.getPackageManager();
8857            ResolveInfo info = packageManager.resolveActivity(intent, 0);
8858            return info != null ? info.loadLabel(packageManager) : "";
8859        }
8860    }
8861
8862    /**
8863     * Returns the device ID that we should use when connecting to the mobile gtalk server.
8864     * This is a string like "android-0x1242", where the hex string is the Android ID obtained
8865     * from the GoogleLoginService.
8866     *
8867     * @param androidId The Android ID for this device.
8868     * @return The device ID that should be used when connecting to the mobile gtalk server.
8869     * @hide
8870     */
8871    public static String getGTalkDeviceId(long androidId) {
8872        return "android-" + Long.toHexString(androidId);
8873    }
8874
8875    private static final String[] PM_WRITE_SETTINGS = {
8876        android.Manifest.permission.WRITE_SETTINGS
8877    };
8878    private static final String[] PM_CHANGE_NETWORK_STATE = {
8879        android.Manifest.permission.CHANGE_NETWORK_STATE,
8880        android.Manifest.permission.WRITE_SETTINGS
8881    };
8882    private static final String[] PM_SYSTEM_ALERT_WINDOW = {
8883        android.Manifest.permission.SYSTEM_ALERT_WINDOW
8884    };
8885
8886    /**
8887     * Performs a strict and comprehensive check of whether a calling package is allowed to
8888     * write/modify system settings, as the condition differs for pre-M, M+, and
8889     * privileged/preinstalled apps. If the provided uid does not match the
8890     * callingPackage, a negative result will be returned.
8891     * @hide
8892     */
8893    public static boolean isCallingPackageAllowedToWriteSettings(Context context, int uid,
8894            String callingPackage, boolean throwException) {
8895        return isCallingPackageAllowedToPerformAppOpsProtectedOperation(context, uid,
8896                callingPackage, throwException, AppOpsManager.OP_WRITE_SETTINGS,
8897                PM_WRITE_SETTINGS, false);
8898    }
8899
8900    /**
8901     * Performs a strict and comprehensive check of whether a calling package is allowed to
8902     * write/modify system settings, as the condition differs for pre-M, M+, and
8903     * privileged/preinstalled apps. If the provided uid does not match the
8904     * callingPackage, a negative result will be returned. The caller is expected to have
8905     * the WRITE_SETTINGS permission declared.
8906     *
8907     * Note: if the check is successful, the operation of this app will be updated to the
8908     * current time.
8909     * @hide
8910     */
8911    public static boolean checkAndNoteWriteSettingsOperation(Context context, int uid,
8912            String callingPackage, boolean throwException) {
8913        return isCallingPackageAllowedToPerformAppOpsProtectedOperation(context, uid,
8914                callingPackage, throwException, AppOpsManager.OP_WRITE_SETTINGS,
8915                PM_WRITE_SETTINGS, true);
8916    }
8917
8918    /**
8919     * Performs a strict and comprehensive check of whether a calling package is allowed to
8920     * change the state of network, as the condition differs for pre-M, M+, and
8921     * privileged/preinstalled apps. The caller is expected to have either the
8922     * CHANGE_NETWORK_STATE or the WRITE_SETTINGS permission declared. Either of these
8923     * permissions allow changing network state; WRITE_SETTINGS is a runtime permission and
8924     * can be revoked, but (except in M, excluding M MRs), CHANGE_NETWORK_STATE is a normal
8925     * permission and cannot be revoked. See http://b/23597341
8926     *
8927     * Note: if the check succeeds because the application holds WRITE_SETTINGS, the operation
8928     * of this app will be updated to the current time.
8929     * @hide
8930     */
8931    public static boolean checkAndNoteChangeNetworkStateOperation(Context context, int uid,
8932            String callingPackage, boolean throwException) {
8933        if (context.checkCallingOrSelfPermission(android.Manifest.permission.CHANGE_NETWORK_STATE)
8934                == PackageManager.PERMISSION_GRANTED) {
8935            return true;
8936        }
8937        return isCallingPackageAllowedToPerformAppOpsProtectedOperation(context, uid,
8938                callingPackage, throwException, AppOpsManager.OP_WRITE_SETTINGS,
8939                PM_CHANGE_NETWORK_STATE, true);
8940    }
8941
8942    /**
8943     * Performs a strict and comprehensive check of whether a calling package is allowed to
8944     * draw on top of other apps, as the conditions differs for pre-M, M+, and
8945     * privileged/preinstalled apps. If the provided uid does not match the callingPackage,
8946     * a negative result will be returned.
8947     * @hide
8948     */
8949    public static boolean isCallingPackageAllowedToDrawOverlays(Context context, int uid,
8950            String callingPackage, boolean throwException) {
8951        return isCallingPackageAllowedToPerformAppOpsProtectedOperation(context, uid,
8952                callingPackage, throwException, AppOpsManager.OP_SYSTEM_ALERT_WINDOW,
8953                PM_SYSTEM_ALERT_WINDOW, false);
8954    }
8955
8956    /**
8957     * Performs a strict and comprehensive check of whether a calling package is allowed to
8958     * draw on top of other apps, as the conditions differs for pre-M, M+, and
8959     * privileged/preinstalled apps. If the provided uid does not match the callingPackage,
8960     * a negative result will be returned.
8961     *
8962     * Note: if the check is successful, the operation of this app will be updated to the
8963     * current time.
8964     * @hide
8965     */
8966    public static boolean checkAndNoteDrawOverlaysOperation(Context context, int uid, String
8967            callingPackage, boolean throwException) {
8968        return isCallingPackageAllowedToPerformAppOpsProtectedOperation(context, uid,
8969                callingPackage, throwException, AppOpsManager.OP_SYSTEM_ALERT_WINDOW,
8970                PM_SYSTEM_ALERT_WINDOW, true);
8971    }
8972
8973    /**
8974     * Helper method to perform a general and comprehensive check of whether an operation that is
8975     * protected by appops can be performed by a caller or not. e.g. OP_SYSTEM_ALERT_WINDOW and
8976     * OP_WRITE_SETTINGS
8977     * @hide
8978     */
8979    public static boolean isCallingPackageAllowedToPerformAppOpsProtectedOperation(Context context,
8980            int uid, String callingPackage, boolean throwException, int appOpsOpCode, String[]
8981            permissions, boolean makeNote) {
8982        if (callingPackage == null) {
8983            return false;
8984        }
8985
8986        AppOpsManager appOpsMgr = (AppOpsManager)context.getSystemService(Context.APP_OPS_SERVICE);
8987        int mode = AppOpsManager.MODE_DEFAULT;
8988        if (makeNote) {
8989            mode = appOpsMgr.noteOpNoThrow(appOpsOpCode, uid, callingPackage);
8990        } else {
8991            mode = appOpsMgr.checkOpNoThrow(appOpsOpCode, uid, callingPackage);
8992        }
8993
8994        switch (mode) {
8995            case AppOpsManager.MODE_ALLOWED:
8996                return true;
8997
8998            case AppOpsManager.MODE_DEFAULT:
8999                // this is the default operating mode after an app's installation
9000                // In this case we will check all associated static permission to see
9001                // if it is granted during install time.
9002                for (String permission : permissions) {
9003                    if (context.checkCallingOrSelfPermission(permission) == PackageManager
9004                            .PERMISSION_GRANTED) {
9005                        // if either of the permissions are granted, we will allow it
9006                        return true;
9007                    }
9008                }
9009
9010            default:
9011                // this is for all other cases trickled down here...
9012                if (!throwException) {
9013                    return false;
9014                }
9015        }
9016
9017        // prepare string to throw SecurityException
9018        StringBuilder exceptionMessage = new StringBuilder();
9019        exceptionMessage.append(callingPackage);
9020        exceptionMessage.append(" was not granted ");
9021        if (permissions.length > 1) {
9022            exceptionMessage.append(" either of these permissions: ");
9023        } else {
9024            exceptionMessage.append(" this permission: ");
9025        }
9026        for (int i = 0; i < permissions.length; i++) {
9027            exceptionMessage.append(permissions[i]);
9028            exceptionMessage.append((i == permissions.length - 1) ? "." : ", ");
9029        }
9030
9031        throw new SecurityException(exceptionMessage.toString());
9032    }
9033
9034    /**
9035     * Retrieves a correponding package name for a given uid. It will query all
9036     * packages that are associated with the given uid, but it will return only
9037     * the zeroth result.
9038     * Note: If package could not be found, a null is returned.
9039     * @hide
9040     */
9041    public static String getPackageNameForUid(Context context, int uid) {
9042        String[] packages = context.getPackageManager().getPackagesForUid(uid);
9043        if (packages == null) {
9044            return null;
9045        }
9046        return packages[0];
9047    }
9048}
9049