Settings.java revision c42a1e1071937ae48b7aa5d6291a32c29078b74b
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.app.SearchManager;
22import android.app.WallpaperManager;
23import android.content.ComponentName;
24import android.content.ContentResolver;
25import android.content.ContentValues;
26import android.content.Context;
27import android.content.IContentProvider;
28import android.content.Intent;
29import android.content.pm.ActivityInfo;
30import android.content.pm.PackageManager;
31import android.content.pm.ResolveInfo;
32import android.content.res.Configuration;
33import android.content.res.Resources;
34import android.database.Cursor;
35import android.database.SQLException;
36import android.location.LocationManager;
37import android.net.ConnectivityManager;
38import android.net.Uri;
39import android.net.wifi.WifiManager;
40import android.os.BatteryManager;
41import android.os.Bundle;
42import android.os.DropBoxManager;
43import android.os.IBinder;
44import android.os.Process;
45import android.os.RemoteException;
46import android.os.ServiceManager;
47import android.os.SystemProperties;
48import android.os.UserHandle;
49import android.os.Build.VERSION_CODES;
50import android.speech.tts.TextToSpeech;
51import android.text.TextUtils;
52import android.util.AndroidException;
53import android.util.Log;
54
55import com.android.internal.widget.ILockSettings;
56
57import java.net.URISyntaxException;
58import java.util.HashMap;
59import java.util.HashSet;
60import java.util.Locale;
61
62/**
63 * The Settings provider contains global system-level device preferences.
64 */
65public final class Settings {
66
67    // Intent actions for Settings
68
69    /**
70     * Activity Action: Show system settings.
71     * <p>
72     * Input: Nothing.
73     * <p>
74     * Output: Nothing.
75     */
76    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
77    public static final String ACTION_SETTINGS = "android.settings.SETTINGS";
78
79    /**
80     * Activity Action: Show settings to allow configuration of APNs.
81     * <p>
82     * Input: Nothing.
83     * <p>
84     * Output: Nothing.
85     */
86    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
87    public static final String ACTION_APN_SETTINGS = "android.settings.APN_SETTINGS";
88
89    /**
90     * Activity Action: Show settings to allow configuration of current location
91     * sources.
92     * <p>
93     * In some cases, a matching Activity may not exist, so ensure you
94     * safeguard against this.
95     * <p>
96     * Input: Nothing.
97     * <p>
98     * Output: Nothing.
99     */
100    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
101    public static final String ACTION_LOCATION_SOURCE_SETTINGS =
102            "android.settings.LOCATION_SOURCE_SETTINGS";
103
104    /**
105     * Activity Action: Show settings to allow configuration of wireless controls
106     * such as Wi-Fi, Bluetooth and Mobile networks.
107     * <p>
108     * In some cases, a matching Activity may not exist, so ensure you
109     * safeguard against this.
110     * <p>
111     * Input: Nothing.
112     * <p>
113     * Output: Nothing.
114     */
115    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
116    public static final String ACTION_WIRELESS_SETTINGS =
117            "android.settings.WIRELESS_SETTINGS";
118
119    /**
120     * Activity Action: Show settings to allow entering/exiting airplane mode.
121     * <p>
122     * In some cases, a matching Activity may not exist, so ensure you
123     * safeguard against this.
124     * <p>
125     * Input: Nothing.
126     * <p>
127     * Output: Nothing.
128     */
129    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
130    public static final String ACTION_AIRPLANE_MODE_SETTINGS =
131            "android.settings.AIRPLANE_MODE_SETTINGS";
132
133    /**
134     * Activity Action: Show settings for accessibility modules.
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_ACCESSIBILITY_SETTINGS =
145            "android.settings.ACCESSIBILITY_SETTINGS";
146
147    /**
148     * Activity Action: Show settings to allow configuration of security and
149     * location privacy.
150     * <p>
151     * In some cases, a matching Activity may not exist, so ensure you
152     * safeguard against this.
153     * <p>
154     * Input: Nothing.
155     * <p>
156     * Output: Nothing.
157     */
158    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
159    public static final String ACTION_SECURITY_SETTINGS =
160            "android.settings.SECURITY_SETTINGS";
161
162    /**
163     * Activity Action: Show trusted credentials settings, opening to the user tab,
164     * to allow management of installed credentials.
165     * <p>
166     * In some cases, a matching Activity may not exist, so ensure you
167     * safeguard against this.
168     * <p>
169     * Input: Nothing.
170     * <p>
171     * Output: Nothing.
172     * @hide
173     */
174    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
175    public static final String ACTION_TRUSTED_CREDENTIALS_USER =
176            "com.android.settings.TRUSTED_CREDENTIALS_USER";
177
178    /**
179     * Activity Action: Show dialog explaining that an installed CA cert may enable
180     * monitoring of encrypted network traffic.
181     * <p>
182     * In some cases, a matching Activity may not exist, so ensure you
183     * safeguard against this.
184     * <p>
185     * Input: Nothing.
186     * <p>
187     * Output: Nothing.
188     * @hide
189     */
190    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
191    public static final String ACTION_MONITORING_CERT_INFO =
192            "com.android.settings.MONITORING_CERT_INFO";
193
194    /**
195     * Activity Action: Show settings to allow configuration of privacy options.
196     * <p>
197     * In some cases, a matching Activity may not exist, so ensure you
198     * safeguard against this.
199     * <p>
200     * Input: Nothing.
201     * <p>
202     * Output: Nothing.
203     */
204    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
205    public static final String ACTION_PRIVACY_SETTINGS =
206            "android.settings.PRIVACY_SETTINGS";
207
208    /**
209     * Activity Action: Show settings to allow configuration of Wi-Fi.
210
211     * <p>
212     * In some cases, a matching Activity may not exist, so ensure you
213     * safeguard against this.
214     * <p>
215     * Input: Nothing.
216     * <p>
217     * Output: Nothing.
218
219     */
220    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
221    public static final String ACTION_WIFI_SETTINGS =
222            "android.settings.WIFI_SETTINGS";
223
224    /**
225     * Activity Action: Show settings to allow configuration of a static IP
226     * address for Wi-Fi.
227     * <p>
228     * In some cases, a matching Activity may not exist, so ensure you safeguard
229     * against this.
230     * <p>
231     * Input: Nothing.
232     * <p>
233     * Output: Nothing.
234     */
235    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
236    public static final String ACTION_WIFI_IP_SETTINGS =
237            "android.settings.WIFI_IP_SETTINGS";
238
239    /**
240     * Activity Action: Show settings to allow configuration of Bluetooth.
241     * <p>
242     * In some cases, a matching Activity may not exist, so ensure you
243     * safeguard against this.
244     * <p>
245     * Input: Nothing.
246     * <p>
247     * Output: Nothing.
248     */
249    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
250    public static final String ACTION_BLUETOOTH_SETTINGS =
251            "android.settings.BLUETOOTH_SETTINGS";
252
253    /**
254     * Activity Action: Show settings to allow configuration of Wifi Displays.
255     * <p>
256     * In some cases, a matching Activity may not exist, so ensure you
257     * safeguard against this.
258     * <p>
259     * Input: Nothing.
260     * <p>
261     * Output: Nothing.
262     * @hide
263     */
264    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
265    public static final String ACTION_WIFI_DISPLAY_SETTINGS =
266            "android.settings.WIFI_DISPLAY_SETTINGS";
267
268    /**
269     * Activity Action: Show settings to allow configuration of date and time.
270     * <p>
271     * In some cases, a matching Activity may not exist, so ensure you
272     * safeguard against this.
273     * <p>
274     * Input: Nothing.
275     * <p>
276     * Output: Nothing.
277     */
278    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
279    public static final String ACTION_DATE_SETTINGS =
280            "android.settings.DATE_SETTINGS";
281
282    /**
283     * Activity Action: Show settings to allow configuration of sound and volume.
284     * <p>
285     * In some cases, a matching Activity may not exist, so ensure you
286     * safeguard against this.
287     * <p>
288     * Input: Nothing.
289     * <p>
290     * Output: Nothing.
291     */
292    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
293    public static final String ACTION_SOUND_SETTINGS =
294            "android.settings.SOUND_SETTINGS";
295
296    /**
297     * Activity Action: Show settings to allow configuration of display.
298     * <p>
299     * In some cases, a matching Activity may not exist, so ensure you
300     * safeguard against this.
301     * <p>
302     * Input: Nothing.
303     * <p>
304     * Output: Nothing.
305     */
306    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
307    public static final String ACTION_DISPLAY_SETTINGS =
308            "android.settings.DISPLAY_SETTINGS";
309
310    /**
311     * Activity Action: Show settings to allow configuration of locale.
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     */
320    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
321    public static final String ACTION_LOCALE_SETTINGS =
322            "android.settings.LOCALE_SETTINGS";
323
324    /**
325     * Activity Action: Show settings to configure input methods, in particular
326     * allowing the user to enable input methods.
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_INPUT_METHOD_SETTINGS =
337            "android.settings.INPUT_METHOD_SETTINGS";
338
339    /**
340     * Activity Action: Show settings to enable/disable input method subtypes.
341     * <p>
342     * In some cases, a matching Activity may not exist, so ensure you
343     * safeguard against this.
344     * <p>
345     * To tell which input method's subtypes are displayed in the settings, add
346     * {@link #EXTRA_INPUT_METHOD_ID} extra to this Intent with the input method id.
347     * If there is no extra in this Intent, subtypes from all installed input methods
348     * will be displayed in the settings.
349     *
350     * @see android.view.inputmethod.InputMethodInfo#getId
351     * <p>
352     * Input: Nothing.
353     * <p>
354     * Output: Nothing.
355     */
356    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
357    public static final String ACTION_INPUT_METHOD_SUBTYPE_SETTINGS =
358            "android.settings.INPUT_METHOD_SUBTYPE_SETTINGS";
359
360    /**
361     * Activity Action: Show a dialog to select input method.
362     * <p>
363     * In some cases, a matching Activity may not exist, so ensure you
364     * safeguard against this.
365     * <p>
366     * Input: Nothing.
367     * <p>
368     * Output: Nothing.
369     * @hide
370     */
371    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
372    public static final String ACTION_SHOW_INPUT_METHOD_PICKER =
373            "android.settings.SHOW_INPUT_METHOD_PICKER";
374
375    /**
376     * Activity Action: Show settings to manage the user input dictionary.
377     * <p>
378     * Starting with {@link android.os.Build.VERSION_CODES#KITKAT},
379     * it is guaranteed there will always be an appropriate implementation for this Intent action.
380     * In prior releases of the platform this was optional, so ensure you safeguard against it.
381     * <p>
382     * Input: Nothing.
383     * <p>
384     * Output: Nothing.
385     */
386    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
387    public static final String ACTION_USER_DICTIONARY_SETTINGS =
388            "android.settings.USER_DICTIONARY_SETTINGS";
389
390    /**
391     * Activity Action: Adds a word to the user dictionary.
392     * <p>
393     * In some cases, a matching Activity may not exist, so ensure you
394     * safeguard against this.
395     * <p>
396     * Input: An extra with key <code>word</code> that contains the word
397     * that should be added to the dictionary.
398     * <p>
399     * Output: Nothing.
400     *
401     * @hide
402     */
403    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
404    public static final String ACTION_USER_DICTIONARY_INSERT =
405            "com.android.settings.USER_DICTIONARY_INSERT";
406
407    /**
408     * Activity Action: Show settings to allow configuration of application-related settings.
409     * <p>
410     * In some cases, a matching Activity may not exist, so ensure you
411     * safeguard against this.
412     * <p>
413     * Input: Nothing.
414     * <p>
415     * Output: Nothing.
416     */
417    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
418    public static final String ACTION_APPLICATION_SETTINGS =
419            "android.settings.APPLICATION_SETTINGS";
420
421    /**
422     * Activity Action: Show settings to allow configuration of application
423     * development-related settings.  As of
424     * {@link android.os.Build.VERSION_CODES#JELLY_BEAN_MR1} this action is
425     * a required part of the platform.
426     * <p>
427     * Input: Nothing.
428     * <p>
429     * Output: Nothing.
430     */
431    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
432    public static final String ACTION_APPLICATION_DEVELOPMENT_SETTINGS =
433            "android.settings.APPLICATION_DEVELOPMENT_SETTINGS";
434
435    /**
436     * Activity Action: Show settings to allow configuration of quick launch shortcuts.
437     * <p>
438     * In some cases, a matching Activity may not exist, so ensure you
439     * safeguard against this.
440     * <p>
441     * Input: Nothing.
442     * <p>
443     * Output: Nothing.
444     */
445    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
446    public static final String ACTION_QUICK_LAUNCH_SETTINGS =
447            "android.settings.QUICK_LAUNCH_SETTINGS";
448
449    /**
450     * Activity Action: Show settings to manage installed applications.
451     * <p>
452     * In some cases, a matching Activity may not exist, so ensure you
453     * safeguard against this.
454     * <p>
455     * Input: Nothing.
456     * <p>
457     * Output: Nothing.
458     */
459    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
460    public static final String ACTION_MANAGE_APPLICATIONS_SETTINGS =
461            "android.settings.MANAGE_APPLICATIONS_SETTINGS";
462
463    /**
464     * Activity Action: Show settings to manage all applications.
465     * <p>
466     * In some cases, a matching Activity may not exist, so ensure you
467     * safeguard against this.
468     * <p>
469     * Input: Nothing.
470     * <p>
471     * Output: Nothing.
472     */
473    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
474    public static final String ACTION_MANAGE_ALL_APPLICATIONS_SETTINGS =
475            "android.settings.MANAGE_ALL_APPLICATIONS_SETTINGS";
476
477    /**
478     * Activity Action: Show screen of details about a particular application.
479     * <p>
480     * In some cases, a matching Activity may not exist, so ensure you
481     * safeguard against this.
482     * <p>
483     * Input: The Intent's data URI specifies the application package name
484     * to be shown, with the "package" scheme.  That is "package:com.my.app".
485     * <p>
486     * Output: Nothing.
487     */
488    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
489    public static final String ACTION_APPLICATION_DETAILS_SETTINGS =
490            "android.settings.APPLICATION_DETAILS_SETTINGS";
491
492    /**
493     * @hide
494     * Activity Action: Show the "app ops" settings screen.
495     * <p>
496     * Input: Nothing.
497     * <p>
498     * Output: Nothing.
499     */
500    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
501    public static final String ACTION_APP_OPS_SETTINGS =
502            "android.settings.APP_OPS_SETTINGS";
503
504    /**
505     * Activity Action: Show settings for system update functionality.
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     *
514     * @hide
515     */
516    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
517    public static final String ACTION_SYSTEM_UPDATE_SETTINGS =
518            "android.settings.SYSTEM_UPDATE_SETTINGS";
519
520    /**
521     * Activity Action: Show settings to allow configuration of sync settings.
522     * <p>
523     * In some cases, a matching Activity may not exist, so ensure you
524     * safeguard against this.
525     * <p>
526     * The account types available to add via the add account button may be restricted by adding an
527     * {@link #EXTRA_AUTHORITIES} extra to this Intent with one or more syncable content provider's
528     * authorities. Only account types which can sync with that content provider will be offered to
529     * the user.
530     * <p>
531     * Input: Nothing.
532     * <p>
533     * Output: Nothing.
534     */
535    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
536    public static final String ACTION_SYNC_SETTINGS =
537            "android.settings.SYNC_SETTINGS";
538
539    /**
540     * Activity Action: Show add account screen for creating a new account.
541     * <p>
542     * In some cases, a matching Activity may not exist, so ensure you
543     * safeguard against this.
544     * <p>
545     * The account types available to add may be restricted by adding an {@link #EXTRA_AUTHORITIES}
546     * extra to the Intent with one or more syncable content provider's authorities.  Only account
547     * types which can sync with that content provider will be offered to the user.
548     * <p>
549     * Account types can also be filtered by adding an {@link #EXTRA_ACCOUNT_TYPES} extra to the
550     * Intent with one or more account types.
551     * <p>
552     * Input: Nothing.
553     * <p>
554     * Output: Nothing.
555     */
556    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
557    public static final String ACTION_ADD_ACCOUNT =
558            "android.settings.ADD_ACCOUNT_SETTINGS";
559
560    /**
561     * Activity Action: Show settings for selecting the network operator.
562     * <p>
563     * In some cases, a matching Activity may not exist, so ensure you
564     * safeguard against this.
565     * <p>
566     * Input: Nothing.
567     * <p>
568     * Output: Nothing.
569     */
570    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
571    public static final String ACTION_NETWORK_OPERATOR_SETTINGS =
572            "android.settings.NETWORK_OPERATOR_SETTINGS";
573
574    /**
575     * Activity Action: Show settings for selection of 2G/3G.
576     * <p>
577     * In some cases, a matching Activity may not exist, so ensure you
578     * safeguard against this.
579     * <p>
580     * Input: Nothing.
581     * <p>
582     * Output: Nothing.
583     */
584    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
585    public static final String ACTION_DATA_ROAMING_SETTINGS =
586            "android.settings.DATA_ROAMING_SETTINGS";
587
588    /**
589     * Activity Action: Show settings for internal storage.
590     * <p>
591     * In some cases, a matching Activity may not exist, so ensure you
592     * safeguard against this.
593     * <p>
594     * Input: Nothing.
595     * <p>
596     * Output: Nothing.
597     */
598    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
599    public static final String ACTION_INTERNAL_STORAGE_SETTINGS =
600            "android.settings.INTERNAL_STORAGE_SETTINGS";
601    /**
602     * Activity Action: Show settings for memory card storage.
603     * <p>
604     * In some cases, a matching Activity may not exist, so ensure you
605     * safeguard against this.
606     * <p>
607     * Input: Nothing.
608     * <p>
609     * Output: Nothing.
610     */
611    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
612    public static final String ACTION_MEMORY_CARD_SETTINGS =
613            "android.settings.MEMORY_CARD_SETTINGS";
614
615    /**
616     * Activity Action: Show settings for global search.
617     * <p>
618     * In some cases, a matching Activity may not exist, so ensure you
619     * safeguard against this.
620     * <p>
621     * Input: Nothing.
622     * <p>
623     * Output: Nothing
624     */
625    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
626    public static final String ACTION_SEARCH_SETTINGS =
627        "android.search.action.SEARCH_SETTINGS";
628
629    /**
630     * Activity Action: Show general device information settings (serial
631     * number, software version, phone number, etc.).
632     * <p>
633     * In some cases, a matching Activity may not exist, so ensure you
634     * safeguard against this.
635     * <p>
636     * Input: Nothing.
637     * <p>
638     * Output: Nothing
639     */
640    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
641    public static final String ACTION_DEVICE_INFO_SETTINGS =
642        "android.settings.DEVICE_INFO_SETTINGS";
643
644    /**
645     * Activity Action: Show NFC settings.
646     * <p>
647     * This shows UI that allows NFC to be turned on or off.
648     * <p>
649     * In some cases, a matching Activity may not exist, so ensure you
650     * safeguard against this.
651     * <p>
652     * Input: Nothing.
653     * <p>
654     * Output: Nothing
655     * @see android.nfc.NfcAdapter#isEnabled()
656     */
657    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
658    public static final String ACTION_NFC_SETTINGS = "android.settings.NFC_SETTINGS";
659
660    /**
661     * Activity Action: Show NFC Sharing settings.
662     * <p>
663     * This shows UI that allows NDEF Push (Android Beam) to be turned on or
664     * off.
665     * <p>
666     * In some cases, a matching Activity may not exist, so ensure you
667     * safeguard against this.
668     * <p>
669     * Input: Nothing.
670     * <p>
671     * Output: Nothing
672     * @see android.nfc.NfcAdapter#isNdefPushEnabled()
673     */
674    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
675    public static final String ACTION_NFCSHARING_SETTINGS =
676        "android.settings.NFCSHARING_SETTINGS";
677
678    /**
679     * Activity Action: Show NFC Tap & Pay settings
680     * <p>
681     * This shows UI that allows the user to configure Tap&Pay
682     * settings.
683     * <p>
684     * In some cases, a matching Activity may not exist, so ensure you
685     * safeguard against this.
686     * <p>
687     * Input: Nothing.
688     * <p>
689     * Output: Nothing
690     */
691    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
692    public static final String ACTION_NFC_PAYMENT_SETTINGS =
693        "android.settings.NFC_PAYMENT_SETTINGS";
694
695    /**
696     * Activity Action: Show Daydream settings.
697     * <p>
698     * In some cases, a matching Activity may not exist, so ensure you
699     * safeguard against this.
700     * <p>
701     * Input: Nothing.
702     * <p>
703     * Output: Nothing.
704     * @see android.service.dreams.DreamService
705     */
706    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
707    public static final String ACTION_DREAM_SETTINGS = "android.settings.DREAM_SETTINGS";
708
709    /**
710     * Activity Action: Show Notification listener settings.
711     * <p>
712     * In some cases, a matching Activity may not exist, so ensure you
713     * safeguard against this.
714     * <p>
715     * Input: Nothing.
716     * <p>
717     * Output: Nothing.
718     * @see android.service.notification.NotificationListenerService
719     * @hide
720     */
721    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
722    public static final String ACTION_NOTIFICATION_LISTENER_SETTINGS
723            = "android.settings.NOTIFICATION_LISTENER_SETTINGS";
724
725    /**
726     * @hide
727     */
728    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
729    public static final String ACTION_CONDITION_PROVIDER_SETTINGS
730            = "android.settings.ACTION_CONDITION_PROVIDER_SETTINGS";
731
732    /**
733     * Activity Action: Show settings for video captioning.
734     * <p>
735     * In some cases, a matching Activity may not exist, so ensure you safeguard
736     * against this.
737     * <p>
738     * Input: Nothing.
739     * <p>
740     * Output: Nothing.
741     */
742    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
743    public static final String ACTION_CAPTIONING_SETTINGS = "android.settings.CAPTIONING_SETTINGS";
744
745    /**
746     * Activity Action: Show the top level print settings.
747     * <p>
748     * In some cases, a matching Activity may not exist, so ensure you
749     * safeguard against this.
750     * <p>
751     * Input: Nothing.
752     * <p>
753     * Output: Nothing.
754     */
755    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
756    public static final String ACTION_PRINT_SETTINGS =
757            "android.settings.ACTION_PRINT_SETTINGS";
758
759    /**
760     * Activity Action: Show Zen Mode configuration settings.
761     *
762     * @hide
763     */
764    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
765    public static final String ACTION_ZEN_MODE_SETTINGS = "android.settings.ZEN_MODE_SETTINGS";
766
767    /**
768     * Activity Action: Show the regulatory information screen for the device.
769     * <p>
770     * In some cases, a matching Activity may not exist, so ensure you safeguard
771     * against this.
772     * <p>
773     * Input: Nothing.
774     * <p>
775     * Output: Nothing.
776     */
777    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
778    public static final String
779            ACTION_SHOW_REGULATORY_INFO = "android.settings.SHOW_REGULATORY_INFO";
780
781    /**
782     * Activity Action: Show Device Name Settings.
783     * <p>
784     * In some cases, a matching Activity may not exist, so ensure you safeguard
785     * against this.
786     *
787     * @hide
788     */
789    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
790    public static final String DEVICE_NAME_SETTINGS = "android.settings.DEVICE_NAME";
791
792    /**
793     * Activity Action: Show pairing settings.
794     * <p>
795     * In some cases, a matching Activity may not exist, so ensure you safeguard
796     * against this.
797     *
798     * @hide
799     */
800    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
801    public static final String ACTION_PAIRING_SETTINGS = "android.settings.PAIRING_SETTINGS";
802
803    /**
804     * Activity Action: Show battery saver settings.
805     *
806     * @hide
807     */
808    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
809    public static final String ACTION_BATTERY_SAVER_SETTINGS
810            = "android.settings.BATTERY_SAVER_SETTINGS";
811
812    // End of Intent actions for Settings
813
814    /**
815     * @hide - Private call() method on SettingsProvider to read from 'system' table.
816     */
817    public static final String CALL_METHOD_GET_SYSTEM = "GET_system";
818
819    /**
820     * @hide - Private call() method on SettingsProvider to read from 'secure' table.
821     */
822    public static final String CALL_METHOD_GET_SECURE = "GET_secure";
823
824    /**
825     * @hide - Private call() method on SettingsProvider to read from 'global' table.
826     */
827    public static final String CALL_METHOD_GET_GLOBAL = "GET_global";
828
829    /**
830     * @hide - User handle argument extra to the fast-path call()-based requests
831     */
832    public static final String CALL_METHOD_USER_KEY = "_user";
833
834    /** @hide - Private call() method to write to 'system' table */
835    public static final String CALL_METHOD_PUT_SYSTEM = "PUT_system";
836
837    /** @hide - Private call() method to write to 'secure' table */
838    public static final String CALL_METHOD_PUT_SECURE = "PUT_secure";
839
840    /** @hide - Private call() method to write to 'global' table */
841    public static final String CALL_METHOD_PUT_GLOBAL= "PUT_global";
842
843    /**
844     * Activity Extra: Limit available options in launched activity based on the given authority.
845     * <p>
846     * This can be passed as an extra field in an Activity Intent with one or more syncable content
847     * provider's authorities as a String[]. This field is used by some intents to alter the
848     * behavior of the called activity.
849     * <p>
850     * Example: The {@link #ACTION_ADD_ACCOUNT} intent restricts the account types available based
851     * on the authority given.
852     */
853    public static final String EXTRA_AUTHORITIES = "authorities";
854
855    /**
856     * Activity Extra: Limit available options in launched activity based on the given account
857     * types.
858     * <p>
859     * This can be passed as an extra field in an Activity Intent with one or more account types
860     * as a String[]. This field is used by some intents to alter the behavior of the called
861     * activity.
862     * <p>
863     * Example: The {@link #ACTION_ADD_ACCOUNT} intent restricts the account types to the specified
864     * list.
865     */
866    public static final String EXTRA_ACCOUNT_TYPES = "account_types";
867
868    public static final String EXTRA_INPUT_METHOD_ID = "input_method_id";
869
870    private static final String JID_RESOURCE_PREFIX = "android";
871
872    public static final String AUTHORITY = "settings";
873
874    private static final String TAG = "Settings";
875    private static final boolean LOCAL_LOGV = false;
876
877    // Lock ensures that when enabling/disabling the master location switch, we don't end up
878    // with a partial enable/disable state in multi-threaded situations.
879    private static final Object mLocationSettingsLock = new Object();
880
881    public static class SettingNotFoundException extends AndroidException {
882        public SettingNotFoundException(String msg) {
883            super(msg);
884        }
885    }
886
887    /**
888     * Common base for tables of name/value settings.
889     */
890    public static class NameValueTable implements BaseColumns {
891        public static final String NAME = "name";
892        public static final String VALUE = "value";
893
894        protected static boolean putString(ContentResolver resolver, Uri uri,
895                String name, String value) {
896            // The database will take care of replacing duplicates.
897            try {
898                ContentValues values = new ContentValues();
899                values.put(NAME, name);
900                values.put(VALUE, value);
901                resolver.insert(uri, values);
902                return true;
903            } catch (SQLException e) {
904                Log.w(TAG, "Can't set key " + name + " in " + uri, e);
905                return false;
906            }
907        }
908
909        public static Uri getUriFor(Uri uri, String name) {
910            return Uri.withAppendedPath(uri, name);
911        }
912    }
913
914    // Thread-safe.
915    private static class NameValueCache {
916        private final String mVersionSystemProperty;
917        private final Uri mUri;
918
919        private static final String[] SELECT_VALUE =
920            new String[] { Settings.NameValueTable.VALUE };
921        private static final String NAME_EQ_PLACEHOLDER = "name=?";
922
923        // Must synchronize on 'this' to access mValues and mValuesVersion.
924        private final HashMap<String, String> mValues = new HashMap<String, String>();
925        private long mValuesVersion = 0;
926
927        // Initially null; set lazily and held forever.  Synchronized on 'this'.
928        private IContentProvider mContentProvider = null;
929
930        // The method we'll call (or null, to not use) on the provider
931        // for the fast path of retrieving settings.
932        private final String mCallGetCommand;
933        private final String mCallSetCommand;
934
935        public NameValueCache(String versionSystemProperty, Uri uri,
936                String getCommand, String setCommand) {
937            mVersionSystemProperty = versionSystemProperty;
938            mUri = uri;
939            mCallGetCommand = getCommand;
940            mCallSetCommand = setCommand;
941        }
942
943        private IContentProvider lazyGetProvider(ContentResolver cr) {
944            IContentProvider cp = null;
945            synchronized (this) {
946                cp = mContentProvider;
947                if (cp == null) {
948                    cp = mContentProvider = cr.acquireProvider(mUri.getAuthority());
949                }
950            }
951            return cp;
952        }
953
954        public boolean putStringForUser(ContentResolver cr, String name, String value,
955                final int userHandle) {
956            try {
957                Bundle arg = new Bundle();
958                arg.putString(Settings.NameValueTable.VALUE, value);
959                arg.putInt(CALL_METHOD_USER_KEY, userHandle);
960                IContentProvider cp = lazyGetProvider(cr);
961                cp.call(cr.getPackageName(), mCallSetCommand, name, arg);
962            } catch (RemoteException e) {
963                Log.w(TAG, "Can't set key " + name + " in " + mUri, e);
964                return false;
965            }
966            return true;
967        }
968
969        public String getStringForUser(ContentResolver cr, String name, final int userHandle) {
970            final boolean isSelf = (userHandle == UserHandle.myUserId());
971            if (isSelf) {
972                long newValuesVersion = SystemProperties.getLong(mVersionSystemProperty, 0);
973
974                // Our own user's settings data uses a client-side cache
975                synchronized (this) {
976                    if (mValuesVersion != newValuesVersion) {
977                        if (LOCAL_LOGV || false) {
978                            Log.v(TAG, "invalidate [" + mUri.getLastPathSegment() + "]: current "
979                                    + newValuesVersion + " != cached " + mValuesVersion);
980                        }
981
982                        mValues.clear();
983                        mValuesVersion = newValuesVersion;
984                    }
985
986                    if (mValues.containsKey(name)) {
987                        return mValues.get(name);  // Could be null, that's OK -- negative caching
988                    }
989                }
990            } else {
991                if (LOCAL_LOGV) Log.v(TAG, "get setting for user " + userHandle
992                        + " by user " + UserHandle.myUserId() + " so skipping cache");
993            }
994
995            IContentProvider cp = lazyGetProvider(cr);
996
997            // Try the fast path first, not using query().  If this
998            // fails (alternate Settings provider that doesn't support
999            // this interface?) then we fall back to the query/table
1000            // interface.
1001            if (mCallGetCommand != null) {
1002                try {
1003                    Bundle args = null;
1004                    if (!isSelf) {
1005                        args = new Bundle();
1006                        args.putInt(CALL_METHOD_USER_KEY, userHandle);
1007                    }
1008                    Bundle b = cp.call(cr.getPackageName(), mCallGetCommand, name, args);
1009                    if (b != null) {
1010                        String value = b.getPairValue();
1011                        // Don't update our cache for reads of other users' data
1012                        if (isSelf) {
1013                            synchronized (this) {
1014                                mValues.put(name, value);
1015                            }
1016                        } else {
1017                            if (LOCAL_LOGV) Log.i(TAG, "call-query of user " + userHandle
1018                                    + " by " + UserHandle.myUserId()
1019                                    + " so not updating cache");
1020                        }
1021                        return value;
1022                    }
1023                    // If the response Bundle is null, we fall through
1024                    // to the query interface below.
1025                } catch (RemoteException e) {
1026                    // Not supported by the remote side?  Fall through
1027                    // to query().
1028                }
1029            }
1030
1031            Cursor c = null;
1032            try {
1033                c = cp.query(cr.getPackageName(), mUri, SELECT_VALUE, NAME_EQ_PLACEHOLDER,
1034                             new String[]{name}, null, null);
1035                if (c == null) {
1036                    Log.w(TAG, "Can't get key " + name + " from " + mUri);
1037                    return null;
1038                }
1039
1040                String value = c.moveToNext() ? c.getString(0) : null;
1041                synchronized (this) {
1042                    mValues.put(name, value);
1043                }
1044                if (LOCAL_LOGV) {
1045                    Log.v(TAG, "cache miss [" + mUri.getLastPathSegment() + "]: " +
1046                            name + " = " + (value == null ? "(null)" : value));
1047                }
1048                return value;
1049            } catch (RemoteException e) {
1050                Log.w(TAG, "Can't get key " + name + " from " + mUri, e);
1051                return null;  // Return null, but don't cache it.
1052            } finally {
1053                if (c != null) c.close();
1054            }
1055        }
1056    }
1057
1058    /**
1059     * System settings, containing miscellaneous system preferences.  This
1060     * table holds simple name/value pairs.  There are convenience
1061     * functions for accessing individual settings entries.
1062     */
1063    public static final class System extends NameValueTable {
1064        public static final String SYS_PROP_SETTING_VERSION = "sys.settings_system_version";
1065
1066        /**
1067         * The content:// style URL for this table
1068         */
1069        public static final Uri CONTENT_URI =
1070            Uri.parse("content://" + AUTHORITY + "/system");
1071
1072        private static final NameValueCache sNameValueCache = new NameValueCache(
1073                SYS_PROP_SETTING_VERSION,
1074                CONTENT_URI,
1075                CALL_METHOD_GET_SYSTEM,
1076                CALL_METHOD_PUT_SYSTEM);
1077
1078        private static final HashSet<String> MOVED_TO_SECURE;
1079        static {
1080            MOVED_TO_SECURE = new HashSet<String>(30);
1081            MOVED_TO_SECURE.add(Secure.ANDROID_ID);
1082            MOVED_TO_SECURE.add(Secure.HTTP_PROXY);
1083            MOVED_TO_SECURE.add(Secure.LOCATION_PROVIDERS_ALLOWED);
1084            MOVED_TO_SECURE.add(Secure.LOCK_BIOMETRIC_WEAK_FLAGS);
1085            MOVED_TO_SECURE.add(Secure.LOCK_PATTERN_ENABLED);
1086            MOVED_TO_SECURE.add(Secure.LOCK_PATTERN_VISIBLE);
1087            MOVED_TO_SECURE.add(Secure.LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED);
1088            MOVED_TO_SECURE.add(Secure.LOGGING_ID);
1089            MOVED_TO_SECURE.add(Secure.PARENTAL_CONTROL_ENABLED);
1090            MOVED_TO_SECURE.add(Secure.PARENTAL_CONTROL_LAST_UPDATE);
1091            MOVED_TO_SECURE.add(Secure.PARENTAL_CONTROL_REDIRECT_URL);
1092            MOVED_TO_SECURE.add(Secure.SETTINGS_CLASSNAME);
1093            MOVED_TO_SECURE.add(Secure.USE_GOOGLE_MAIL);
1094            MOVED_TO_SECURE.add(Secure.WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON);
1095            MOVED_TO_SECURE.add(Secure.WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY);
1096            MOVED_TO_SECURE.add(Secure.WIFI_NUM_OPEN_NETWORKS_KEPT);
1097            MOVED_TO_SECURE.add(Secure.WIFI_ON);
1098            MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE);
1099            MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_AP_COUNT);
1100            MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS);
1101            MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED);
1102            MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS);
1103            MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT);
1104            MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_MAX_AP_CHECKS);
1105            MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_ON);
1106            MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_PING_COUNT);
1107            MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_PING_DELAY_MS);
1108            MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_PING_TIMEOUT_MS);
1109
1110            // At one time in System, then Global, but now back in Secure
1111            MOVED_TO_SECURE.add(Secure.INSTALL_NON_MARKET_APPS);
1112        }
1113
1114        private static final HashSet<String> MOVED_TO_GLOBAL;
1115        private static final HashSet<String> MOVED_TO_SECURE_THEN_GLOBAL;
1116        static {
1117            MOVED_TO_GLOBAL = new HashSet<String>();
1118            MOVED_TO_SECURE_THEN_GLOBAL = new HashSet<String>();
1119
1120            // these were originally in system but migrated to secure in the past,
1121            // so are duplicated in the Secure.* namespace
1122            MOVED_TO_SECURE_THEN_GLOBAL.add(Global.ADB_ENABLED);
1123            MOVED_TO_SECURE_THEN_GLOBAL.add(Global.BLUETOOTH_ON);
1124            MOVED_TO_SECURE_THEN_GLOBAL.add(Global.DATA_ROAMING);
1125            MOVED_TO_SECURE_THEN_GLOBAL.add(Global.DEVICE_PROVISIONED);
1126            MOVED_TO_SECURE_THEN_GLOBAL.add(Global.USB_MASS_STORAGE_ENABLED);
1127            MOVED_TO_SECURE_THEN_GLOBAL.add(Global.HTTP_PROXY);
1128
1129            // these are moving directly from system to global
1130            MOVED_TO_GLOBAL.add(Settings.Global.AIRPLANE_MODE_ON);
1131            MOVED_TO_GLOBAL.add(Settings.Global.AIRPLANE_MODE_RADIOS);
1132            MOVED_TO_GLOBAL.add(Settings.Global.AIRPLANE_MODE_TOGGLEABLE_RADIOS);
1133            MOVED_TO_GLOBAL.add(Settings.Global.AUTO_TIME);
1134            MOVED_TO_GLOBAL.add(Settings.Global.AUTO_TIME_ZONE);
1135            MOVED_TO_GLOBAL.add(Settings.Global.CAR_DOCK_SOUND);
1136            MOVED_TO_GLOBAL.add(Settings.Global.CAR_UNDOCK_SOUND);
1137            MOVED_TO_GLOBAL.add(Settings.Global.DESK_DOCK_SOUND);
1138            MOVED_TO_GLOBAL.add(Settings.Global.DESK_UNDOCK_SOUND);
1139            MOVED_TO_GLOBAL.add(Settings.Global.DOCK_SOUNDS_ENABLED);
1140            MOVED_TO_GLOBAL.add(Settings.Global.LOCK_SOUND);
1141            MOVED_TO_GLOBAL.add(Settings.Global.UNLOCK_SOUND);
1142            MOVED_TO_GLOBAL.add(Settings.Global.LOW_BATTERY_SOUND);
1143            MOVED_TO_GLOBAL.add(Settings.Global.POWER_SOUNDS_ENABLED);
1144            MOVED_TO_GLOBAL.add(Settings.Global.STAY_ON_WHILE_PLUGGED_IN);
1145            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_SLEEP_POLICY);
1146            MOVED_TO_GLOBAL.add(Settings.Global.MODE_RINGER);
1147            MOVED_TO_GLOBAL.add(Settings.Global.WINDOW_ANIMATION_SCALE);
1148            MOVED_TO_GLOBAL.add(Settings.Global.TRANSITION_ANIMATION_SCALE);
1149            MOVED_TO_GLOBAL.add(Settings.Global.ANIMATOR_DURATION_SCALE);
1150            MOVED_TO_GLOBAL.add(Settings.Global.FANCY_IME_ANIMATIONS);
1151            MOVED_TO_GLOBAL.add(Settings.Global.COMPATIBILITY_MODE);
1152            MOVED_TO_GLOBAL.add(Settings.Global.EMERGENCY_TONE);
1153            MOVED_TO_GLOBAL.add(Settings.Global.CALL_AUTO_RETRY);
1154            MOVED_TO_GLOBAL.add(Settings.Global.DEBUG_APP);
1155            MOVED_TO_GLOBAL.add(Settings.Global.WAIT_FOR_DEBUGGER);
1156            MOVED_TO_GLOBAL.add(Settings.Global.SHOW_PROCESSES);
1157            MOVED_TO_GLOBAL.add(Settings.Global.ALWAYS_FINISH_ACTIVITIES);
1158            MOVED_TO_GLOBAL.add(Settings.Global.TZINFO_UPDATE_CONTENT_URL);
1159            MOVED_TO_GLOBAL.add(Settings.Global.TZINFO_UPDATE_METADATA_URL);
1160            MOVED_TO_GLOBAL.add(Settings.Global.SELINUX_UPDATE_CONTENT_URL);
1161            MOVED_TO_GLOBAL.add(Settings.Global.SELINUX_UPDATE_METADATA_URL);
1162            MOVED_TO_GLOBAL.add(Settings.Global.SMS_SHORT_CODES_UPDATE_CONTENT_URL);
1163            MOVED_TO_GLOBAL.add(Settings.Global.SMS_SHORT_CODES_UPDATE_METADATA_URL);
1164            MOVED_TO_GLOBAL.add(Settings.Global.CERT_PIN_UPDATE_CONTENT_URL);
1165            MOVED_TO_GLOBAL.add(Settings.Global.CERT_PIN_UPDATE_METADATA_URL);
1166        }
1167
1168        /** @hide */
1169        public static void getMovedKeys(HashSet<String> outKeySet) {
1170            outKeySet.addAll(MOVED_TO_GLOBAL);
1171            outKeySet.addAll(MOVED_TO_SECURE_THEN_GLOBAL);
1172        }
1173
1174        /** @hide */
1175        public static void getNonLegacyMovedKeys(HashSet<String> outKeySet) {
1176            outKeySet.addAll(MOVED_TO_GLOBAL);
1177        }
1178
1179        /**
1180         * Look up a name in the database.
1181         * @param resolver to access the database with
1182         * @param name to look up in the table
1183         * @return the corresponding value, or null if not present
1184         */
1185        public static String getString(ContentResolver resolver, String name) {
1186            return getStringForUser(resolver, name, UserHandle.myUserId());
1187        }
1188
1189        /** @hide */
1190        public static String getStringForUser(ContentResolver resolver, String name,
1191                int userHandle) {
1192            if (MOVED_TO_SECURE.contains(name)) {
1193                Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.System"
1194                        + " to android.provider.Settings.Secure, returning read-only value.");
1195                return Secure.getStringForUser(resolver, name, userHandle);
1196            }
1197            if (MOVED_TO_GLOBAL.contains(name) || MOVED_TO_SECURE_THEN_GLOBAL.contains(name)) {
1198                Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.System"
1199                        + " to android.provider.Settings.Global, returning read-only value.");
1200                return Global.getStringForUser(resolver, name, userHandle);
1201            }
1202            return sNameValueCache.getStringForUser(resolver, name, userHandle);
1203        }
1204
1205        /**
1206         * Store a name/value pair into the database.
1207         * @param resolver to access the database with
1208         * @param name to store
1209         * @param value to associate with the name
1210         * @return true if the value was set, false on database errors
1211         */
1212        public static boolean putString(ContentResolver resolver, String name, String value) {
1213            return putStringForUser(resolver, name, value, UserHandle.myUserId());
1214        }
1215
1216        /** @hide */
1217        public static boolean putStringForUser(ContentResolver resolver, String name, String value,
1218                int userHandle) {
1219            if (MOVED_TO_SECURE.contains(name)) {
1220                Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.System"
1221                        + " to android.provider.Settings.Secure, value is unchanged.");
1222                return false;
1223            }
1224            if (MOVED_TO_GLOBAL.contains(name) || MOVED_TO_SECURE_THEN_GLOBAL.contains(name)) {
1225                Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.System"
1226                        + " to android.provider.Settings.Global, value is unchanged.");
1227                return false;
1228            }
1229            return sNameValueCache.putStringForUser(resolver, name, value, userHandle);
1230        }
1231
1232        /**
1233         * Construct the content URI for a particular name/value pair,
1234         * useful for monitoring changes with a ContentObserver.
1235         * @param name to look up in the table
1236         * @return the corresponding content URI, or null if not present
1237         */
1238        public static Uri getUriFor(String name) {
1239            if (MOVED_TO_SECURE.contains(name)) {
1240                Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.System"
1241                    + " to android.provider.Settings.Secure, returning Secure URI.");
1242                return Secure.getUriFor(Secure.CONTENT_URI, name);
1243            }
1244            if (MOVED_TO_GLOBAL.contains(name) || MOVED_TO_SECURE_THEN_GLOBAL.contains(name)) {
1245                Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.System"
1246                        + " to android.provider.Settings.Global, returning read-only global URI.");
1247                return Global.getUriFor(Global.CONTENT_URI, name);
1248            }
1249            return getUriFor(CONTENT_URI, name);
1250        }
1251
1252        /**
1253         * Convenience function for retrieving a single system settings value
1254         * as an integer.  Note that internally setting values are always
1255         * stored as strings; this function converts the string to an integer
1256         * for you.  The default value will be returned if the setting is
1257         * not defined or not an integer.
1258         *
1259         * @param cr The ContentResolver to access.
1260         * @param name The name of the setting to retrieve.
1261         * @param def Value to return if the setting is not defined.
1262         *
1263         * @return The setting's current value, or 'def' if it is not defined
1264         * or not a valid integer.
1265         */
1266        public static int getInt(ContentResolver cr, String name, int def) {
1267            return getIntForUser(cr, name, def, UserHandle.myUserId());
1268        }
1269
1270        /** @hide */
1271        public static int getIntForUser(ContentResolver cr, String name, int def, int userHandle) {
1272            String v = getStringForUser(cr, name, userHandle);
1273            try {
1274                return v != null ? Integer.parseInt(v) : def;
1275            } catch (NumberFormatException e) {
1276                return def;
1277            }
1278        }
1279
1280        /**
1281         * Convenience function for retrieving a single system settings value
1282         * as an integer.  Note that internally setting values are always
1283         * stored as strings; this function converts the string to an integer
1284         * for you.
1285         * <p>
1286         * This version does not take a default value.  If the setting has not
1287         * been set, or the string value is not a number,
1288         * it throws {@link SettingNotFoundException}.
1289         *
1290         * @param cr The ContentResolver to access.
1291         * @param name The name of the setting to retrieve.
1292         *
1293         * @throws SettingNotFoundException Thrown if a setting by the given
1294         * name can't be found or the setting value is not an integer.
1295         *
1296         * @return The setting's current value.
1297         */
1298        public static int getInt(ContentResolver cr, String name)
1299                throws SettingNotFoundException {
1300            return getIntForUser(cr, name, UserHandle.myUserId());
1301        }
1302
1303        /** @hide */
1304        public static int getIntForUser(ContentResolver cr, String name, int userHandle)
1305                throws SettingNotFoundException {
1306            String v = getStringForUser(cr, name, userHandle);
1307            try {
1308                return Integer.parseInt(v);
1309            } catch (NumberFormatException e) {
1310                throw new SettingNotFoundException(name);
1311            }
1312        }
1313
1314        /**
1315         * Convenience function for updating a single settings value as an
1316         * integer. This will either create a new entry in the table if the
1317         * given name does not exist, or modify the value of the existing row
1318         * with that name.  Note that internally setting values are always
1319         * stored as strings, so this function converts the given value to a
1320         * string before storing it.
1321         *
1322         * @param cr The ContentResolver to access.
1323         * @param name The name of the setting to modify.
1324         * @param value The new value for the setting.
1325         * @return true if the value was set, false on database errors
1326         */
1327        public static boolean putInt(ContentResolver cr, String name, int value) {
1328            return putIntForUser(cr, name, value, UserHandle.myUserId());
1329        }
1330
1331        /** @hide */
1332        public static boolean putIntForUser(ContentResolver cr, String name, int value,
1333                int userHandle) {
1334            return putStringForUser(cr, name, Integer.toString(value), userHandle);
1335        }
1336
1337        /**
1338         * Convenience function for retrieving a single system settings value
1339         * as a {@code long}.  Note that internally setting values are always
1340         * stored as strings; this function converts the string to a {@code long}
1341         * for you.  The default value will be returned if the setting is
1342         * not defined or not a {@code long}.
1343         *
1344         * @param cr The ContentResolver to access.
1345         * @param name The name of the setting to retrieve.
1346         * @param def Value to return if the setting is not defined.
1347         *
1348         * @return The setting's current value, or 'def' if it is not defined
1349         * or not a valid {@code long}.
1350         */
1351        public static long getLong(ContentResolver cr, String name, long def) {
1352            return getLongForUser(cr, name, def, UserHandle.myUserId());
1353        }
1354
1355        /** @hide */
1356        public static long getLongForUser(ContentResolver cr, String name, long def,
1357                int userHandle) {
1358            String valString = getStringForUser(cr, name, userHandle);
1359            long value;
1360            try {
1361                value = valString != null ? Long.parseLong(valString) : def;
1362            } catch (NumberFormatException e) {
1363                value = def;
1364            }
1365            return value;
1366        }
1367
1368        /**
1369         * Convenience function for retrieving a single system settings value
1370         * as a {@code long}.  Note that internally setting values are always
1371         * stored as strings; this function converts the string to a {@code long}
1372         * for you.
1373         * <p>
1374         * This version does not take a default value.  If the setting has not
1375         * been set, or the string value is not a number,
1376         * it throws {@link SettingNotFoundException}.
1377         *
1378         * @param cr The ContentResolver to access.
1379         * @param name The name of the setting to retrieve.
1380         *
1381         * @return The setting's current value.
1382         * @throws SettingNotFoundException Thrown if a setting by the given
1383         * name can't be found or the setting value is not an integer.
1384         */
1385        public static long getLong(ContentResolver cr, String name)
1386                throws SettingNotFoundException {
1387            return getLongForUser(cr, name, UserHandle.myUserId());
1388        }
1389
1390        /** @hide */
1391        public static long getLongForUser(ContentResolver cr, String name, int userHandle)
1392                throws SettingNotFoundException {
1393            String valString = getStringForUser(cr, name, userHandle);
1394            try {
1395                return Long.parseLong(valString);
1396            } catch (NumberFormatException e) {
1397                throw new SettingNotFoundException(name);
1398            }
1399        }
1400
1401        /**
1402         * Convenience function for updating a single settings value as a long
1403         * integer. This will either create a new entry in the table if the
1404         * given name does not exist, or modify the value of the existing row
1405         * with that name.  Note that internally setting values are always
1406         * stored as strings, so this function converts the given value to a
1407         * string before storing it.
1408         *
1409         * @param cr The ContentResolver to access.
1410         * @param name The name of the setting to modify.
1411         * @param value The new value for the setting.
1412         * @return true if the value was set, false on database errors
1413         */
1414        public static boolean putLong(ContentResolver cr, String name, long value) {
1415            return putLongForUser(cr, name, value, UserHandle.myUserId());
1416        }
1417
1418        /** @hide */
1419        public static boolean putLongForUser(ContentResolver cr, String name, long value,
1420                int userHandle) {
1421            return putStringForUser(cr, name, Long.toString(value), userHandle);
1422        }
1423
1424        /**
1425         * Convenience function for retrieving a single system settings value
1426         * as a floating point number.  Note that internally setting values are
1427         * always stored as strings; this function converts the string to an
1428         * float for you. The default value will be returned if the setting
1429         * is not defined or not a valid float.
1430         *
1431         * @param cr The ContentResolver to access.
1432         * @param name The name of the setting to retrieve.
1433         * @param def Value to return if the setting is not defined.
1434         *
1435         * @return The setting's current value, or 'def' if it is not defined
1436         * or not a valid float.
1437         */
1438        public static float getFloat(ContentResolver cr, String name, float def) {
1439            return getFloatForUser(cr, name, def, UserHandle.myUserId());
1440        }
1441
1442        /** @hide */
1443        public static float getFloatForUser(ContentResolver cr, String name, float def,
1444                int userHandle) {
1445            String v = getStringForUser(cr, name, userHandle);
1446            try {
1447                return v != null ? Float.parseFloat(v) : def;
1448            } catch (NumberFormatException e) {
1449                return def;
1450            }
1451        }
1452
1453        /**
1454         * Convenience function for retrieving a single system settings value
1455         * as a float.  Note that internally setting values are always
1456         * stored as strings; this function converts the string to a float
1457         * for you.
1458         * <p>
1459         * This version does not take a default value.  If the setting has not
1460         * been set, or the string value is not a number,
1461         * it throws {@link SettingNotFoundException}.
1462         *
1463         * @param cr The ContentResolver to access.
1464         * @param name The name of the setting to retrieve.
1465         *
1466         * @throws SettingNotFoundException Thrown if a setting by the given
1467         * name can't be found or the setting value is not a float.
1468         *
1469         * @return The setting's current value.
1470         */
1471        public static float getFloat(ContentResolver cr, String name)
1472                throws SettingNotFoundException {
1473            return getFloatForUser(cr, name, UserHandle.myUserId());
1474        }
1475
1476        /** @hide */
1477        public static float getFloatForUser(ContentResolver cr, String name, int userHandle)
1478                throws SettingNotFoundException {
1479            String v = getStringForUser(cr, name, userHandle);
1480            if (v == null) {
1481                throw new SettingNotFoundException(name);
1482            }
1483            try {
1484                return Float.parseFloat(v);
1485            } catch (NumberFormatException e) {
1486                throw new SettingNotFoundException(name);
1487            }
1488        }
1489
1490        /**
1491         * Convenience function for updating a single settings value as a
1492         * floating point number. This will either create a new entry in the
1493         * table if the given name does not exist, or modify the value of the
1494         * existing row with that name.  Note that internally setting values
1495         * are always stored as strings, so this function converts the given
1496         * value to a string before storing it.
1497         *
1498         * @param cr The ContentResolver to access.
1499         * @param name The name of the setting to modify.
1500         * @param value The new value for the setting.
1501         * @return true if the value was set, false on database errors
1502         */
1503        public static boolean putFloat(ContentResolver cr, String name, float value) {
1504            return putFloatForUser(cr, name, value, UserHandle.myUserId());
1505        }
1506
1507        /** @hide */
1508        public static boolean putFloatForUser(ContentResolver cr, String name, float value,
1509                int userHandle) {
1510            return putStringForUser(cr, name, Float.toString(value), userHandle);
1511        }
1512
1513        /**
1514         * Convenience function to read all of the current
1515         * configuration-related settings into a
1516         * {@link Configuration} object.
1517         *
1518         * @param cr The ContentResolver to access.
1519         * @param outConfig Where to place the configuration settings.
1520         */
1521        public static void getConfiguration(ContentResolver cr, Configuration outConfig) {
1522            getConfigurationForUser(cr, outConfig, UserHandle.myUserId());
1523        }
1524
1525        /** @hide */
1526        public static void getConfigurationForUser(ContentResolver cr, Configuration outConfig,
1527                int userHandle) {
1528            outConfig.fontScale = Settings.System.getFloatForUser(
1529                cr, FONT_SCALE, outConfig.fontScale, userHandle);
1530            if (outConfig.fontScale < 0) {
1531                outConfig.fontScale = 1;
1532            }
1533        }
1534
1535        /**
1536         * @hide Erase the fields in the Configuration that should be applied
1537         * by the settings.
1538         */
1539        public static void clearConfiguration(Configuration inoutConfig) {
1540            inoutConfig.fontScale = 0;
1541        }
1542
1543        /**
1544         * Convenience function to write a batch of configuration-related
1545         * settings from a {@link Configuration} object.
1546         *
1547         * @param cr The ContentResolver to access.
1548         * @param config The settings to write.
1549         * @return true if the values were set, false on database errors
1550         */
1551        public static boolean putConfiguration(ContentResolver cr, Configuration config) {
1552            return putConfigurationForUser(cr, config, UserHandle.myUserId());
1553        }
1554
1555        /** @hide */
1556        public static boolean putConfigurationForUser(ContentResolver cr, Configuration config,
1557                int userHandle) {
1558            return Settings.System.putFloatForUser(cr, FONT_SCALE, config.fontScale, userHandle);
1559        }
1560
1561        /** @hide */
1562        public static boolean hasInterestingConfigurationChanges(int changes) {
1563            return (changes&ActivityInfo.CONFIG_FONT_SCALE) != 0;
1564        }
1565
1566        /** @deprecated - Do not use */
1567        @Deprecated
1568        public static boolean getShowGTalkServiceStatus(ContentResolver cr) {
1569            return getShowGTalkServiceStatusForUser(cr, UserHandle.myUserId());
1570        }
1571
1572        /**
1573         * @hide
1574         * @deprecated - Do not use
1575         */
1576        public static boolean getShowGTalkServiceStatusForUser(ContentResolver cr,
1577                int userHandle) {
1578            return getIntForUser(cr, SHOW_GTALK_SERVICE_STATUS, 0, userHandle) != 0;
1579        }
1580
1581        /** @deprecated - Do not use */
1582        @Deprecated
1583        public static void setShowGTalkServiceStatus(ContentResolver cr, boolean flag) {
1584            setShowGTalkServiceStatusForUser(cr, flag, UserHandle.myUserId());
1585        }
1586
1587        /**
1588         * @hide
1589         * @deprecated - Do not use
1590         */
1591        @Deprecated
1592        public static void setShowGTalkServiceStatusForUser(ContentResolver cr, boolean flag,
1593                int userHandle) {
1594            putIntForUser(cr, SHOW_GTALK_SERVICE_STATUS, flag ? 1 : 0, userHandle);
1595        }
1596
1597        /**
1598         * @deprecated Use {@link android.provider.Settings.Global#STAY_ON_WHILE_PLUGGED_IN} instead
1599         */
1600        @Deprecated
1601        public static final String STAY_ON_WHILE_PLUGGED_IN = Global.STAY_ON_WHILE_PLUGGED_IN;
1602
1603        /**
1604         * What happens when the user presses the end call button if they're not
1605         * on a call.<br/>
1606         * <b>Values:</b><br/>
1607         * 0 - The end button does nothing.<br/>
1608         * 1 - The end button goes to the home screen.<br/>
1609         * 2 - The end button puts the device to sleep and locks the keyguard.<br/>
1610         * 3 - The end button goes to the home screen.  If the user is already on the
1611         * home screen, it puts the device to sleep.
1612         */
1613        public static final String END_BUTTON_BEHAVIOR = "end_button_behavior";
1614
1615        /**
1616         * END_BUTTON_BEHAVIOR value for "go home".
1617         * @hide
1618         */
1619        public static final int END_BUTTON_BEHAVIOR_HOME = 0x1;
1620
1621        /**
1622         * END_BUTTON_BEHAVIOR value for "go to sleep".
1623         * @hide
1624         */
1625        public static final int END_BUTTON_BEHAVIOR_SLEEP = 0x2;
1626
1627        /**
1628         * END_BUTTON_BEHAVIOR default value.
1629         * @hide
1630         */
1631        public static final int END_BUTTON_BEHAVIOR_DEFAULT = END_BUTTON_BEHAVIOR_SLEEP;
1632
1633        /**
1634         * Is advanced settings mode turned on. 0 == no, 1 == yes
1635         * @hide
1636         */
1637        public static final String ADVANCED_SETTINGS = "advanced_settings";
1638
1639        /**
1640         * ADVANCED_SETTINGS default value.
1641         * @hide
1642         */
1643        public static final int ADVANCED_SETTINGS_DEFAULT = 0;
1644
1645        /**
1646         * @deprecated Use {@link android.provider.Settings.Global#AIRPLANE_MODE_ON} instead
1647         */
1648        @Deprecated
1649        public static final String AIRPLANE_MODE_ON = Global.AIRPLANE_MODE_ON;
1650
1651        /**
1652         * @deprecated Use {@link android.provider.Settings.Global#RADIO_BLUETOOTH} instead
1653         */
1654        @Deprecated
1655        public static final String RADIO_BLUETOOTH = Global.RADIO_BLUETOOTH;
1656
1657        /**
1658         * @deprecated Use {@link android.provider.Settings.Global#RADIO_WIFI} instead
1659         */
1660        @Deprecated
1661        public static final String RADIO_WIFI = Global.RADIO_WIFI;
1662
1663        /**
1664         * @deprecated Use {@link android.provider.Settings.Global#RADIO_WIMAX} instead
1665         * {@hide}
1666         */
1667        @Deprecated
1668        public static final String RADIO_WIMAX = Global.RADIO_WIMAX;
1669
1670        /**
1671         * @deprecated Use {@link android.provider.Settings.Global#RADIO_CELL} instead
1672         */
1673        @Deprecated
1674        public static final String RADIO_CELL = Global.RADIO_CELL;
1675
1676        /**
1677         * @deprecated Use {@link android.provider.Settings.Global#RADIO_NFC} instead
1678         */
1679        @Deprecated
1680        public static final String RADIO_NFC = Global.RADIO_NFC;
1681
1682        /**
1683         * @deprecated Use {@link android.provider.Settings.Global#AIRPLANE_MODE_RADIOS} instead
1684         */
1685        @Deprecated
1686        public static final String AIRPLANE_MODE_RADIOS = Global.AIRPLANE_MODE_RADIOS;
1687
1688        /**
1689         * @deprecated Use {@link android.provider.Settings.Global#AIRPLANE_MODE_TOGGLEABLE_RADIOS} instead
1690         *
1691         * {@hide}
1692         */
1693        @Deprecated
1694        public static final String AIRPLANE_MODE_TOGGLEABLE_RADIOS =
1695                Global.AIRPLANE_MODE_TOGGLEABLE_RADIOS;
1696
1697        /**
1698         * @deprecated Use {@link android.provider.Settings.Global#WIFI_SLEEP_POLICY} instead
1699         */
1700        @Deprecated
1701        public static final String WIFI_SLEEP_POLICY = Global.WIFI_SLEEP_POLICY;
1702
1703        /**
1704         * @deprecated Use {@link android.provider.Settings.Global#WIFI_SLEEP_POLICY_DEFAULT} instead
1705         */
1706        @Deprecated
1707        public static final int WIFI_SLEEP_POLICY_DEFAULT = Global.WIFI_SLEEP_POLICY_DEFAULT;
1708
1709        /**
1710         * @deprecated Use {@link android.provider.Settings.Global#WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED} instead
1711         */
1712        @Deprecated
1713        public static final int WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED =
1714                Global.WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED;
1715
1716        /**
1717         * @deprecated Use {@link android.provider.Settings.Global#WIFI_SLEEP_POLICY_NEVER} instead
1718         */
1719        @Deprecated
1720        public static final int WIFI_SLEEP_POLICY_NEVER = Global.WIFI_SLEEP_POLICY_NEVER;
1721
1722        /**
1723         * @deprecated Use {@link android.provider.Settings.Global#MODE_RINGER} instead
1724         */
1725        @Deprecated
1726        public static final String MODE_RINGER = Global.MODE_RINGER;
1727
1728        /**
1729         * Whether to use static IP and other static network attributes.
1730         * <p>
1731         * Set to 1 for true and 0 for false.
1732         *
1733         * @deprecated Use {@link WifiManager} instead
1734         */
1735        @Deprecated
1736        public static final String WIFI_USE_STATIC_IP = "wifi_use_static_ip";
1737
1738        /**
1739         * The static IP address.
1740         * <p>
1741         * Example: "192.168.1.51"
1742         *
1743         * @deprecated Use {@link WifiManager} instead
1744         */
1745        @Deprecated
1746        public static final String WIFI_STATIC_IP = "wifi_static_ip";
1747
1748        /**
1749         * If using static IP, the gateway's IP address.
1750         * <p>
1751         * Example: "192.168.1.1"
1752         *
1753         * @deprecated Use {@link WifiManager} instead
1754         */
1755        @Deprecated
1756        public static final String WIFI_STATIC_GATEWAY = "wifi_static_gateway";
1757
1758        /**
1759         * If using static IP, the net mask.
1760         * <p>
1761         * Example: "255.255.255.0"
1762         *
1763         * @deprecated Use {@link WifiManager} instead
1764         */
1765        @Deprecated
1766        public static final String WIFI_STATIC_NETMASK = "wifi_static_netmask";
1767
1768        /**
1769         * If using static IP, the primary DNS's IP address.
1770         * <p>
1771         * Example: "192.168.1.1"
1772         *
1773         * @deprecated Use {@link WifiManager} instead
1774         */
1775        @Deprecated
1776        public static final String WIFI_STATIC_DNS1 = "wifi_static_dns1";
1777
1778        /**
1779         * If using static IP, the secondary DNS's IP address.
1780         * <p>
1781         * Example: "192.168.1.2"
1782         *
1783         * @deprecated Use {@link WifiManager} instead
1784         */
1785        @Deprecated
1786        public static final String WIFI_STATIC_DNS2 = "wifi_static_dns2";
1787
1788
1789        /**
1790         * Determines whether remote devices may discover and/or connect to
1791         * this device.
1792         * <P>Type: INT</P>
1793         * 2 -- discoverable and connectable
1794         * 1 -- connectable but not discoverable
1795         * 0 -- neither connectable nor discoverable
1796         */
1797        public static final String BLUETOOTH_DISCOVERABILITY =
1798            "bluetooth_discoverability";
1799
1800        /**
1801         * Bluetooth discoverability timeout.  If this value is nonzero, then
1802         * Bluetooth becomes discoverable for a certain number of seconds,
1803         * after which is becomes simply connectable.  The value is in seconds.
1804         */
1805        public static final String BLUETOOTH_DISCOVERABILITY_TIMEOUT =
1806            "bluetooth_discoverability_timeout";
1807
1808        /**
1809         * @deprecated Use {@link android.provider.Settings.Secure#LOCK_PATTERN_ENABLED}
1810         * instead
1811         */
1812        @Deprecated
1813        public static final String LOCK_PATTERN_ENABLED = Secure.LOCK_PATTERN_ENABLED;
1814
1815        /**
1816         * @deprecated Use {@link android.provider.Settings.Secure#LOCK_PATTERN_VISIBLE}
1817         * instead
1818         */
1819        @Deprecated
1820        public static final String LOCK_PATTERN_VISIBLE = "lock_pattern_visible_pattern";
1821
1822        /**
1823         * @deprecated Use
1824         * {@link android.provider.Settings.Secure#LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED}
1825         * instead
1826         */
1827        @Deprecated
1828        public static final String LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED =
1829            "lock_pattern_tactile_feedback_enabled";
1830
1831
1832        /**
1833         * A formatted string of the next alarm that is set, or the empty string
1834         * if there is no alarm set.
1835         *
1836         * @deprecated Use {@link android.app.AlarmManager#getNextAlarmClock()}.
1837         */
1838        @Deprecated
1839        public static final String NEXT_ALARM_FORMATTED = "next_alarm_formatted";
1840
1841        /**
1842         * Scaling factor for fonts, float.
1843         */
1844        public static final String FONT_SCALE = "font_scale";
1845
1846        /**
1847         * Name of an application package to be debugged.
1848         *
1849         * @deprecated Use {@link Global#DEBUG_APP} instead
1850         */
1851        @Deprecated
1852        public static final String DEBUG_APP = Global.DEBUG_APP;
1853
1854        /**
1855         * If 1, when launching DEBUG_APP it will wait for the debugger before
1856         * starting user code.  If 0, it will run normally.
1857         *
1858         * @deprecated Use {@link Global#WAIT_FOR_DEBUGGER} instead
1859         */
1860        @Deprecated
1861        public static final String WAIT_FOR_DEBUGGER = Global.WAIT_FOR_DEBUGGER;
1862
1863        /**
1864         * Whether or not to dim the screen. 0=no  1=yes
1865         * @deprecated This setting is no longer used.
1866         */
1867        @Deprecated
1868        public static final String DIM_SCREEN = "dim_screen";
1869
1870        /**
1871         * The timeout before the screen turns off.
1872         */
1873        public static final String SCREEN_OFF_TIMEOUT = "screen_off_timeout";
1874
1875        /**
1876         * The screen backlight brightness between 0 and 255.
1877         */
1878        public static final String SCREEN_BRIGHTNESS = "screen_brightness";
1879
1880        /**
1881         * Control whether to enable automatic brightness mode.
1882         */
1883        public static final String SCREEN_BRIGHTNESS_MODE = "screen_brightness_mode";
1884
1885        /**
1886         * Adjustment to auto-brightness to make it generally more (>0.0 <1.0)
1887         * or less (<0.0 >-1.0) bright.
1888         * @hide
1889         */
1890        public static final String SCREEN_AUTO_BRIGHTNESS_ADJ = "screen_auto_brightness_adj";
1891
1892        /**
1893         * SCREEN_BRIGHTNESS_MODE value for manual mode.
1894         */
1895        public static final int SCREEN_BRIGHTNESS_MODE_MANUAL = 0;
1896
1897        /**
1898         * SCREEN_BRIGHTNESS_MODE value for automatic mode.
1899         */
1900        public static final int SCREEN_BRIGHTNESS_MODE_AUTOMATIC = 1;
1901
1902        /**
1903         * Control whether the process CPU usage meter should be shown.
1904         *
1905         * @deprecated Use {@link Global#SHOW_PROCESSES} instead
1906         */
1907        @Deprecated
1908        public static final String SHOW_PROCESSES = Global.SHOW_PROCESSES;
1909
1910        /**
1911         * If 1, the activity manager will aggressively finish activities and
1912         * processes as soon as they are no longer needed.  If 0, the normal
1913         * extended lifetime is used.
1914         *
1915         * @deprecated Use {@link Global#ALWAYS_FINISH_ACTIVITIES} instead
1916         */
1917        @Deprecated
1918        public static final String ALWAYS_FINISH_ACTIVITIES = Global.ALWAYS_FINISH_ACTIVITIES;
1919
1920        /**
1921         * Determines which streams are affected by ringer mode changes. The
1922         * stream type's bit should be set to 1 if it should be muted when going
1923         * into an inaudible ringer mode.
1924         */
1925        public static final String MODE_RINGER_STREAMS_AFFECTED = "mode_ringer_streams_affected";
1926
1927         /**
1928          * Determines which streams are affected by mute. The
1929          * stream type's bit should be set to 1 if it should be muted when a mute request
1930          * is received.
1931          */
1932         public static final String MUTE_STREAMS_AFFECTED = "mute_streams_affected";
1933
1934        /**
1935         * Whether vibrate is on for different events. This is used internally,
1936         * changing this value will not change the vibrate. See AudioManager.
1937         */
1938        public static final String VIBRATE_ON = "vibrate_on";
1939
1940        /**
1941         * If 1, redirects the system vibrator to all currently attached input devices
1942         * that support vibration.  If there are no such input devices, then the system
1943         * vibrator is used instead.
1944         * If 0, does not register the system vibrator.
1945         *
1946         * This setting is mainly intended to provide a compatibility mechanism for
1947         * applications that only know about the system vibrator and do not use the
1948         * input device vibrator API.
1949         *
1950         * @hide
1951         */
1952        public static final String VIBRATE_INPUT_DEVICES = "vibrate_input_devices";
1953
1954        /**
1955         * Ringer volume. This is used internally, changing this value will not
1956         * change the volume. See AudioManager.
1957         */
1958        public static final String VOLUME_RING = "volume_ring";
1959
1960        /**
1961         * System/notifications volume. This is used internally, changing this
1962         * value will not change the volume. See AudioManager.
1963         */
1964        public static final String VOLUME_SYSTEM = "volume_system";
1965
1966        /**
1967         * Voice call volume. This is used internally, changing this value will
1968         * not change the volume. See AudioManager.
1969         */
1970        public static final String VOLUME_VOICE = "volume_voice";
1971
1972        /**
1973         * Music/media/gaming volume. This is used internally, changing this
1974         * value will not change the volume. See AudioManager.
1975         */
1976        public static final String VOLUME_MUSIC = "volume_music";
1977
1978        /**
1979         * Alarm volume. This is used internally, changing this
1980         * value will not change the volume. See AudioManager.
1981         */
1982        public static final String VOLUME_ALARM = "volume_alarm";
1983
1984        /**
1985         * Notification volume. This is used internally, changing this
1986         * value will not change the volume. See AudioManager.
1987         */
1988        public static final String VOLUME_NOTIFICATION = "volume_notification";
1989
1990        /**
1991         * Bluetooth Headset volume. This is used internally, changing this value will
1992         * not change the volume. See AudioManager.
1993         */
1994        public static final String VOLUME_BLUETOOTH_SCO = "volume_bluetooth_sco";
1995
1996        /**
1997         * Master volume (float in the range 0.0f to 1.0f).
1998         * @hide
1999         */
2000        public static final String VOLUME_MASTER = "volume_master";
2001
2002        /**
2003         * Master volume mute (int 1 = mute, 0 = not muted).
2004         *
2005         * @hide
2006         */
2007        public static final String VOLUME_MASTER_MUTE = "volume_master_mute";
2008
2009        /**
2010         * Whether the notifications should use the ring volume (value of 1) or
2011         * a separate notification volume (value of 0). In most cases, users
2012         * will have this enabled so the notification and ringer volumes will be
2013         * the same. However, power users can disable this and use the separate
2014         * notification volume control.
2015         * <p>
2016         * Note: This is a one-off setting that will be removed in the future
2017         * when there is profile support. For this reason, it is kept hidden
2018         * from the public APIs.
2019         *
2020         * @hide
2021         * @deprecated
2022         */
2023        @Deprecated
2024        public static final String NOTIFICATIONS_USE_RING_VOLUME =
2025            "notifications_use_ring_volume";
2026
2027        /**
2028         * Whether silent mode should allow vibration feedback. This is used
2029         * internally in AudioService and the Sound settings activity to
2030         * coordinate decoupling of vibrate and silent modes. This setting
2031         * will likely be removed in a future release with support for
2032         * audio/vibe feedback profiles.
2033         *
2034         * Not used anymore. On devices with vibrator, the user explicitly selects
2035         * silent or vibrate mode.
2036         * Kept for use by legacy database upgrade code in DatabaseHelper.
2037         * @hide
2038         */
2039        public static final String VIBRATE_IN_SILENT = "vibrate_in_silent";
2040
2041        /**
2042         * The mapping of stream type (integer) to its setting.
2043         */
2044        public static final String[] VOLUME_SETTINGS = {
2045            VOLUME_VOICE, VOLUME_SYSTEM, VOLUME_RING, VOLUME_MUSIC,
2046            VOLUME_ALARM, VOLUME_NOTIFICATION, VOLUME_BLUETOOTH_SCO
2047        };
2048
2049        /**
2050         * Appended to various volume related settings to record the previous
2051         * values before they the settings were affected by a silent/vibrate
2052         * ringer mode change.
2053         */
2054        public static final String APPEND_FOR_LAST_AUDIBLE = "_last_audible";
2055
2056        /**
2057         * Persistent store for the system-wide default ringtone URI.
2058         * <p>
2059         * If you need to play the default ringtone at any given time, it is recommended
2060         * you give {@link #DEFAULT_RINGTONE_URI} to the media player.  It will resolve
2061         * to the set default ringtone at the time of playing.
2062         *
2063         * @see #DEFAULT_RINGTONE_URI
2064         */
2065        public static final String RINGTONE = "ringtone";
2066
2067        /**
2068         * A {@link Uri} that will point to the current default ringtone at any
2069         * given time.
2070         * <p>
2071         * If the current default ringtone is in the DRM provider and the caller
2072         * does not have permission, the exception will be a
2073         * FileNotFoundException.
2074         */
2075        public static final Uri DEFAULT_RINGTONE_URI = getUriFor(RINGTONE);
2076
2077        /**
2078         * Persistent store for the system-wide default notification sound.
2079         *
2080         * @see #RINGTONE
2081         * @see #DEFAULT_NOTIFICATION_URI
2082         */
2083        public static final String NOTIFICATION_SOUND = "notification_sound";
2084
2085        /**
2086         * A {@link Uri} that will point to the current default notification
2087         * sound at any given time.
2088         *
2089         * @see #DEFAULT_RINGTONE_URI
2090         */
2091        public static final Uri DEFAULT_NOTIFICATION_URI = getUriFor(NOTIFICATION_SOUND);
2092
2093        /**
2094         * Persistent store for the system-wide default alarm alert.
2095         *
2096         * @see #RINGTONE
2097         * @see #DEFAULT_ALARM_ALERT_URI
2098         */
2099        public static final String ALARM_ALERT = "alarm_alert";
2100
2101        /**
2102         * A {@link Uri} that will point to the current default alarm alert at
2103         * any given time.
2104         *
2105         * @see #DEFAULT_ALARM_ALERT_URI
2106         */
2107        public static final Uri DEFAULT_ALARM_ALERT_URI = getUriFor(ALARM_ALERT);
2108
2109        /**
2110         * Persistent store for the system default media button event receiver.
2111         *
2112         * @hide
2113         */
2114        public static final String MEDIA_BUTTON_RECEIVER = "media_button_receiver";
2115
2116        /**
2117         * Setting to enable Auto Replace (AutoText) in text editors. 1 = On, 0 = Off
2118         */
2119        public static final String TEXT_AUTO_REPLACE = "auto_replace";
2120
2121        /**
2122         * Setting to enable Auto Caps in text editors. 1 = On, 0 = Off
2123         */
2124        public static final String TEXT_AUTO_CAPS = "auto_caps";
2125
2126        /**
2127         * Setting to enable Auto Punctuate in text editors. 1 = On, 0 = Off. This
2128         * feature converts two spaces to a "." and space.
2129         */
2130        public static final String TEXT_AUTO_PUNCTUATE = "auto_punctuate";
2131
2132        /**
2133         * Setting to showing password characters in text editors. 1 = On, 0 = Off
2134         */
2135        public static final String TEXT_SHOW_PASSWORD = "show_password";
2136
2137        public static final String SHOW_GTALK_SERVICE_STATUS =
2138                "SHOW_GTALK_SERVICE_STATUS";
2139
2140        /**
2141         * Name of activity to use for wallpaper on the home screen.
2142         *
2143         * @deprecated Use {@link WallpaperManager} instead.
2144         */
2145        @Deprecated
2146        public static final String WALLPAPER_ACTIVITY = "wallpaper_activity";
2147
2148        /**
2149         * @deprecated Use {@link android.provider.Settings.Global#AUTO_TIME}
2150         * instead
2151         */
2152        @Deprecated
2153        public static final String AUTO_TIME = Global.AUTO_TIME;
2154
2155        /**
2156         * @deprecated Use {@link android.provider.Settings.Global#AUTO_TIME_ZONE}
2157         * instead
2158         */
2159        @Deprecated
2160        public static final String AUTO_TIME_ZONE = Global.AUTO_TIME_ZONE;
2161
2162        /**
2163         * Display times as 12 or 24 hours
2164         *   12
2165         *   24
2166         */
2167        public static final String TIME_12_24 = "time_12_24";
2168
2169        /**
2170         * Date format string
2171         *   mm/dd/yyyy
2172         *   dd/mm/yyyy
2173         *   yyyy/mm/dd
2174         */
2175        public static final String DATE_FORMAT = "date_format";
2176
2177        /**
2178         * Whether the setup wizard has been run before (on first boot), or if
2179         * it still needs to be run.
2180         *
2181         * nonzero = it has been run in the past
2182         * 0 = it has not been run in the past
2183         */
2184        public static final String SETUP_WIZARD_HAS_RUN = "setup_wizard_has_run";
2185
2186        /**
2187         * Scaling factor for normal window animations. Setting to 0 will disable window
2188         * animations.
2189         *
2190         * @deprecated Use {@link Global#WINDOW_ANIMATION_SCALE} instead
2191         */
2192        @Deprecated
2193        public static final String WINDOW_ANIMATION_SCALE = Global.WINDOW_ANIMATION_SCALE;
2194
2195        /**
2196         * Scaling factor for activity transition animations. Setting to 0 will disable window
2197         * animations.
2198         *
2199         * @deprecated Use {@link Global#TRANSITION_ANIMATION_SCALE} instead
2200         */
2201        @Deprecated
2202        public static final String TRANSITION_ANIMATION_SCALE = Global.TRANSITION_ANIMATION_SCALE;
2203
2204        /**
2205         * Scaling factor for Animator-based animations. This affects both the start delay and
2206         * duration of all such animations. Setting to 0 will cause animations to end immediately.
2207         * The default value is 1.
2208         *
2209         * @deprecated Use {@link Global#ANIMATOR_DURATION_SCALE} instead
2210         */
2211        @Deprecated
2212        public static final String ANIMATOR_DURATION_SCALE = Global.ANIMATOR_DURATION_SCALE;
2213
2214        /**
2215         * Control whether the accelerometer will be used to change screen
2216         * orientation.  If 0, it will not be used unless explicitly requested
2217         * by the application; if 1, it will be used by default unless explicitly
2218         * disabled by the application.
2219         */
2220        public static final String ACCELEROMETER_ROTATION = "accelerometer_rotation";
2221
2222        /**
2223         * Default screen rotation when no other policy applies.
2224         * When {@link #ACCELEROMETER_ROTATION} is zero and no on-screen Activity expresses a
2225         * preference, this rotation value will be used. Must be one of the
2226         * {@link android.view.Surface#ROTATION_0 Surface rotation constants}.
2227         *
2228         * @see Display#getRotation
2229         */
2230        public static final String USER_ROTATION = "user_rotation";
2231
2232        /**
2233         * Control whether the rotation lock toggle in the System UI should be hidden.
2234         * Typically this is done for accessibility purposes to make it harder for
2235         * the user to accidentally toggle the rotation lock while the display rotation
2236         * has been locked for accessibility.
2237         *
2238         * If 0, then rotation lock toggle is not hidden for accessibility (although it may be
2239         * unavailable for other reasons).  If 1, then the rotation lock toggle is hidden.
2240         *
2241         * @hide
2242         */
2243        public static final String HIDE_ROTATION_LOCK_TOGGLE_FOR_ACCESSIBILITY =
2244                "hide_rotation_lock_toggle_for_accessibility";
2245
2246        /**
2247         * Whether the phone vibrates when it is ringing due to an incoming call. This will
2248         * be used by Phone and Setting apps; it shouldn't affect other apps.
2249         * The value is boolean (1 or 0).
2250         *
2251         * Note: this is not same as "vibrate on ring", which had been available until ICS.
2252         * It was about AudioManager's setting and thus affected all the applications which
2253         * relied on the setting, while this is purely about the vibration setting for incoming
2254         * calls.
2255         *
2256         * @hide
2257         */
2258        public static final String VIBRATE_WHEN_RINGING = "vibrate_when_ringing";
2259
2260        /**
2261         * Whether the audible DTMF tones are played by the dialer when dialing. The value is
2262         * boolean (1 or 0).
2263         */
2264        public static final String DTMF_TONE_WHEN_DIALING = "dtmf_tone";
2265
2266        /**
2267         * CDMA only settings
2268         * DTMF tone type played by the dialer when dialing.
2269         *                 0 = Normal
2270         *                 1 = Long
2271         * @hide
2272         */
2273        public static final String DTMF_TONE_TYPE_WHEN_DIALING = "dtmf_tone_type";
2274
2275        /**
2276         * Whether the hearing aid is enabled. The value is
2277         * boolean (1 or 0).
2278         * @hide
2279         */
2280        public static final String HEARING_AID = "hearing_aid";
2281
2282        /**
2283         * CDMA only settings
2284         * TTY Mode
2285         * 0 = OFF
2286         * 1 = FULL
2287         * 2 = VCO
2288         * 3 = HCO
2289         * @hide
2290         */
2291        public static final String TTY_MODE = "tty_mode";
2292
2293        /**
2294         * Whether the sounds effects (key clicks, lid open ...) are enabled. The value is
2295         * boolean (1 or 0).
2296         */
2297        public static final String SOUND_EFFECTS_ENABLED = "sound_effects_enabled";
2298
2299        /**
2300         * Whether the haptic feedback (long presses, ...) are enabled. The value is
2301         * boolean (1 or 0).
2302         */
2303        public static final String HAPTIC_FEEDBACK_ENABLED = "haptic_feedback_enabled";
2304
2305        /**
2306         * @deprecated Each application that shows web suggestions should have its own
2307         * setting for this.
2308         */
2309        @Deprecated
2310        public static final String SHOW_WEB_SUGGESTIONS = "show_web_suggestions";
2311
2312        /**
2313         * Whether the notification LED should repeatedly flash when a notification is
2314         * pending. The value is boolean (1 or 0).
2315         * @hide
2316         */
2317        public static final String NOTIFICATION_LIGHT_PULSE = "notification_light_pulse";
2318
2319        /**
2320         * Show pointer location on screen?
2321         * 0 = no
2322         * 1 = yes
2323         * @hide
2324         */
2325        public static final String POINTER_LOCATION = "pointer_location";
2326
2327        /**
2328         * Show touch positions on screen?
2329         * 0 = no
2330         * 1 = yes
2331         * @hide
2332         */
2333        public static final String SHOW_TOUCHES = "show_touches";
2334
2335        /**
2336         * Log raw orientation data from {@link WindowOrientationListener} for use with the
2337         * orientationplot.py tool.
2338         * 0 = no
2339         * 1 = yes
2340         * @hide
2341         */
2342        public static final String WINDOW_ORIENTATION_LISTENER_LOG =
2343                "window_orientation_listener_log";
2344
2345        /**
2346         * @deprecated Use {@link android.provider.Settings.Global#POWER_SOUNDS_ENABLED}
2347         * instead
2348         * @hide
2349         */
2350        @Deprecated
2351        public static final String POWER_SOUNDS_ENABLED = Global.POWER_SOUNDS_ENABLED;
2352
2353        /**
2354         * @deprecated Use {@link android.provider.Settings.Global#DOCK_SOUNDS_ENABLED}
2355         * instead
2356         * @hide
2357         */
2358        @Deprecated
2359        public static final String DOCK_SOUNDS_ENABLED = Global.DOCK_SOUNDS_ENABLED;
2360
2361        /**
2362         * Whether to play sounds when the keyguard is shown and dismissed.
2363         * @hide
2364         */
2365        public static final String LOCKSCREEN_SOUNDS_ENABLED = "lockscreen_sounds_enabled";
2366
2367        /**
2368         * Whether the lockscreen should be completely disabled.
2369         * @hide
2370         */
2371        public static final String LOCKSCREEN_DISABLED = "lockscreen.disabled";
2372
2373        /**
2374         * @deprecated Use {@link android.provider.Settings.Global#LOW_BATTERY_SOUND}
2375         * instead
2376         * @hide
2377         */
2378        @Deprecated
2379        public static final String LOW_BATTERY_SOUND = Global.LOW_BATTERY_SOUND;
2380
2381        /**
2382         * @deprecated Use {@link android.provider.Settings.Global#DESK_DOCK_SOUND}
2383         * instead
2384         * @hide
2385         */
2386        @Deprecated
2387        public static final String DESK_DOCK_SOUND = Global.DESK_DOCK_SOUND;
2388
2389        /**
2390         * @deprecated Use {@link android.provider.Settings.Global#DESK_UNDOCK_SOUND}
2391         * instead
2392         * @hide
2393         */
2394        @Deprecated
2395        public static final String DESK_UNDOCK_SOUND = Global.DESK_UNDOCK_SOUND;
2396
2397        /**
2398         * @deprecated Use {@link android.provider.Settings.Global#CAR_DOCK_SOUND}
2399         * instead
2400         * @hide
2401         */
2402        @Deprecated
2403        public static final String CAR_DOCK_SOUND = Global.CAR_DOCK_SOUND;
2404
2405        /**
2406         * @deprecated Use {@link android.provider.Settings.Global#CAR_UNDOCK_SOUND}
2407         * instead
2408         * @hide
2409         */
2410        @Deprecated
2411        public static final String CAR_UNDOCK_SOUND = Global.CAR_UNDOCK_SOUND;
2412
2413        /**
2414         * @deprecated Use {@link android.provider.Settings.Global#LOCK_SOUND}
2415         * instead
2416         * @hide
2417         */
2418        @Deprecated
2419        public static final String LOCK_SOUND = Global.LOCK_SOUND;
2420
2421        /**
2422         * @deprecated Use {@link android.provider.Settings.Global#UNLOCK_SOUND}
2423         * instead
2424         * @hide
2425         */
2426        @Deprecated
2427        public static final String UNLOCK_SOUND = Global.UNLOCK_SOUND;
2428
2429        /**
2430         * Receive incoming SIP calls?
2431         * 0 = no
2432         * 1 = yes
2433         * @hide
2434         */
2435        public static final String SIP_RECEIVE_CALLS = "sip_receive_calls";
2436
2437        /**
2438         * Call Preference String.
2439         * "SIP_ALWAYS" : Always use SIP with network access
2440         * "SIP_ADDRESS_ONLY" : Only if destination is a SIP address
2441         * "SIP_ASK_ME_EACH_TIME" : Always ask me each time
2442         * @hide
2443         */
2444        public static final String SIP_CALL_OPTIONS = "sip_call_options";
2445
2446        /**
2447         * One of the sip call options: Always use SIP with network access.
2448         * @hide
2449         */
2450        public static final String SIP_ALWAYS = "SIP_ALWAYS";
2451
2452        /**
2453         * One of the sip call options: Only if destination is a SIP address.
2454         * @hide
2455         */
2456        public static final String SIP_ADDRESS_ONLY = "SIP_ADDRESS_ONLY";
2457
2458        /**
2459         * One of the sip call options: Always ask me each time.
2460         * @hide
2461         */
2462        public static final String SIP_ASK_ME_EACH_TIME = "SIP_ASK_ME_EACH_TIME";
2463
2464        /**
2465         * Pointer speed setting.
2466         * This is an integer value in a range between -7 and +7, so there are 15 possible values.
2467         *   -7 = slowest
2468         *    0 = default speed
2469         *   +7 = fastest
2470         * @hide
2471         */
2472        public static final String POINTER_SPEED = "pointer_speed";
2473
2474        /**
2475         * Whether lock-to-app will be triggered by long-press on recents.
2476         * @hide
2477         */
2478        public static final String LOCK_TO_APP_ENABLED = "lock_to_app_enabled";
2479
2480        /**
2481         * Whether lock-to-app will lock the keyguard when exiting.
2482         * @hide
2483         */
2484        public static final String LOCK_TO_APP_EXIT_LOCKED = "lock_to_app_exit_locked";
2485
2486        /**
2487         * I am the lolrus.
2488         * <p>
2489         * Nonzero values indicate that the user has a bukkit.
2490         * Backward-compatible with <code>PrefGetPreference(prefAllowEasterEggs)</code>.
2491         * @hide
2492         */
2493        public static final String EGG_MODE = "egg_mode";
2494
2495        /**
2496         * Settings to backup. This is here so that it's in the same place as the settings
2497         * keys and easy to update.
2498         *
2499         * NOTE: Settings are backed up and restored in the order they appear
2500         *       in this array. If you have one setting depending on another,
2501         *       make sure that they are ordered appropriately.
2502         *
2503         * @hide
2504         */
2505        public static final String[] SETTINGS_TO_BACKUP = {
2506            STAY_ON_WHILE_PLUGGED_IN,   // moved to global
2507            WIFI_USE_STATIC_IP,
2508            WIFI_STATIC_IP,
2509            WIFI_STATIC_GATEWAY,
2510            WIFI_STATIC_NETMASK,
2511            WIFI_STATIC_DNS1,
2512            WIFI_STATIC_DNS2,
2513            BLUETOOTH_DISCOVERABILITY,
2514            BLUETOOTH_DISCOVERABILITY_TIMEOUT,
2515            DIM_SCREEN,
2516            SCREEN_OFF_TIMEOUT,
2517            SCREEN_BRIGHTNESS,
2518            SCREEN_BRIGHTNESS_MODE,
2519            SCREEN_AUTO_BRIGHTNESS_ADJ,
2520            VIBRATE_INPUT_DEVICES,
2521            MODE_RINGER_STREAMS_AFFECTED,
2522            VOLUME_VOICE,
2523            VOLUME_SYSTEM,
2524            VOLUME_RING,
2525            VOLUME_MUSIC,
2526            VOLUME_ALARM,
2527            VOLUME_NOTIFICATION,
2528            VOLUME_BLUETOOTH_SCO,
2529            VOLUME_VOICE + APPEND_FOR_LAST_AUDIBLE,
2530            VOLUME_SYSTEM + APPEND_FOR_LAST_AUDIBLE,
2531            VOLUME_RING + APPEND_FOR_LAST_AUDIBLE,
2532            VOLUME_MUSIC + APPEND_FOR_LAST_AUDIBLE,
2533            VOLUME_ALARM + APPEND_FOR_LAST_AUDIBLE,
2534            VOLUME_NOTIFICATION + APPEND_FOR_LAST_AUDIBLE,
2535            VOLUME_BLUETOOTH_SCO + APPEND_FOR_LAST_AUDIBLE,
2536            TEXT_AUTO_REPLACE,
2537            TEXT_AUTO_CAPS,
2538            TEXT_AUTO_PUNCTUATE,
2539            TEXT_SHOW_PASSWORD,
2540            AUTO_TIME,                  // moved to global
2541            AUTO_TIME_ZONE,             // moved to global
2542            TIME_12_24,
2543            DATE_FORMAT,
2544            DTMF_TONE_WHEN_DIALING,
2545            DTMF_TONE_TYPE_WHEN_DIALING,
2546            HEARING_AID,
2547            TTY_MODE,
2548            SOUND_EFFECTS_ENABLED,
2549            HAPTIC_FEEDBACK_ENABLED,
2550            POWER_SOUNDS_ENABLED,       // moved to global
2551            DOCK_SOUNDS_ENABLED,        // moved to global
2552            LOCKSCREEN_SOUNDS_ENABLED,
2553            SHOW_WEB_SUGGESTIONS,
2554            NOTIFICATION_LIGHT_PULSE,
2555            SIP_CALL_OPTIONS,
2556            SIP_RECEIVE_CALLS,
2557            POINTER_SPEED,
2558            VIBRATE_WHEN_RINGING,
2559            RINGTONE,
2560            NOTIFICATION_SOUND
2561        };
2562
2563        /**
2564         * When to use Wi-Fi calling
2565         *
2566         * @see android.telephony.TelephonyManager.WifiCallingChoices
2567         * @hide
2568         */
2569        public static final String WHEN_TO_MAKE_WIFI_CALLS = "when_to_make_wifi_calls";
2570
2571        // Settings moved to Settings.Secure
2572
2573        /**
2574         * @deprecated Use {@link android.provider.Settings.Global#ADB_ENABLED}
2575         * instead
2576         */
2577        @Deprecated
2578        public static final String ADB_ENABLED = Global.ADB_ENABLED;
2579
2580        /**
2581         * @deprecated Use {@link android.provider.Settings.Secure#ANDROID_ID} instead
2582         */
2583        @Deprecated
2584        public static final String ANDROID_ID = Secure.ANDROID_ID;
2585
2586        /**
2587         * @deprecated Use {@link android.provider.Settings.Global#BLUETOOTH_ON} instead
2588         */
2589        @Deprecated
2590        public static final String BLUETOOTH_ON = Global.BLUETOOTH_ON;
2591
2592        /**
2593         * @deprecated Use {@link android.provider.Settings.Global#DATA_ROAMING} instead
2594         */
2595        @Deprecated
2596        public static final String DATA_ROAMING = Global.DATA_ROAMING;
2597
2598        /**
2599         * @deprecated Use {@link android.provider.Settings.Global#DEVICE_PROVISIONED} instead
2600         */
2601        @Deprecated
2602        public static final String DEVICE_PROVISIONED = Global.DEVICE_PROVISIONED;
2603
2604        /**
2605         * @deprecated Use {@link android.provider.Settings.Global#HTTP_PROXY} instead
2606         */
2607        @Deprecated
2608        public static final String HTTP_PROXY = Global.HTTP_PROXY;
2609
2610        /**
2611         * @deprecated Use {@link android.provider.Settings.Secure#INSTALL_NON_MARKET_APPS} instead
2612         */
2613        @Deprecated
2614        public static final String INSTALL_NON_MARKET_APPS = Secure.INSTALL_NON_MARKET_APPS;
2615
2616        /**
2617         * @deprecated Use {@link android.provider.Settings.Secure#LOCATION_PROVIDERS_ALLOWED}
2618         * instead
2619         */
2620        @Deprecated
2621        public static final String LOCATION_PROVIDERS_ALLOWED = Secure.LOCATION_PROVIDERS_ALLOWED;
2622
2623        /**
2624         * @deprecated Use {@link android.provider.Settings.Secure#LOGGING_ID} instead
2625         */
2626        @Deprecated
2627        public static final String LOGGING_ID = Secure.LOGGING_ID;
2628
2629        /**
2630         * @deprecated Use {@link android.provider.Settings.Global#NETWORK_PREFERENCE} instead
2631         */
2632        @Deprecated
2633        public static final String NETWORK_PREFERENCE = Global.NETWORK_PREFERENCE;
2634
2635        /**
2636         * @deprecated Use {@link android.provider.Settings.Secure#PARENTAL_CONTROL_ENABLED}
2637         * instead
2638         */
2639        @Deprecated
2640        public static final String PARENTAL_CONTROL_ENABLED = Secure.PARENTAL_CONTROL_ENABLED;
2641
2642        /**
2643         * @deprecated Use {@link android.provider.Settings.Secure#PARENTAL_CONTROL_LAST_UPDATE}
2644         * instead
2645         */
2646        @Deprecated
2647        public static final String PARENTAL_CONTROL_LAST_UPDATE = Secure.PARENTAL_CONTROL_LAST_UPDATE;
2648
2649        /**
2650         * @deprecated Use {@link android.provider.Settings.Secure#PARENTAL_CONTROL_REDIRECT_URL}
2651         * instead
2652         */
2653        @Deprecated
2654        public static final String PARENTAL_CONTROL_REDIRECT_URL =
2655            Secure.PARENTAL_CONTROL_REDIRECT_URL;
2656
2657        /**
2658         * @deprecated Use {@link android.provider.Settings.Secure#SETTINGS_CLASSNAME} instead
2659         */
2660        @Deprecated
2661        public static final String SETTINGS_CLASSNAME = Secure.SETTINGS_CLASSNAME;
2662
2663        /**
2664         * @deprecated Use {@link android.provider.Settings.Global#USB_MASS_STORAGE_ENABLED} instead
2665         */
2666        @Deprecated
2667        public static final String USB_MASS_STORAGE_ENABLED = Global.USB_MASS_STORAGE_ENABLED;
2668
2669        /**
2670         * @deprecated Use {@link android.provider.Settings.Global#USE_GOOGLE_MAIL} instead
2671         */
2672        @Deprecated
2673        public static final String USE_GOOGLE_MAIL = Global.USE_GOOGLE_MAIL;
2674
2675       /**
2676         * @deprecated Use
2677         * {@link android.provider.Settings.Global#WIFI_MAX_DHCP_RETRY_COUNT} instead
2678         */
2679        @Deprecated
2680        public static final String WIFI_MAX_DHCP_RETRY_COUNT = Global.WIFI_MAX_DHCP_RETRY_COUNT;
2681
2682        /**
2683         * @deprecated Use
2684         * {@link android.provider.Settings.Global#WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS} instead
2685         */
2686        @Deprecated
2687        public static final String WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS =
2688                Global.WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS;
2689
2690        /**
2691         * @deprecated Use
2692         * {@link android.provider.Settings.Global#WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON} instead
2693         */
2694        @Deprecated
2695        public static final String WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON =
2696                Global.WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON;
2697
2698        /**
2699         * @deprecated Use
2700         * {@link android.provider.Settings.Global#WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY} instead
2701         */
2702        @Deprecated
2703        public static final String WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY =
2704                Global.WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY;
2705
2706        /**
2707         * @deprecated Use {@link android.provider.Settings.Global#WIFI_NUM_OPEN_NETWORKS_KEPT}
2708         * instead
2709         */
2710        @Deprecated
2711        public static final String WIFI_NUM_OPEN_NETWORKS_KEPT = Global.WIFI_NUM_OPEN_NETWORKS_KEPT;
2712
2713        /**
2714         * @deprecated Use {@link android.provider.Settings.Global#WIFI_ON} instead
2715         */
2716        @Deprecated
2717        public static final String WIFI_ON = Global.WIFI_ON;
2718
2719        /**
2720         * @deprecated Use
2721         * {@link android.provider.Settings.Secure#WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE}
2722         * instead
2723         */
2724        @Deprecated
2725        public static final String WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE =
2726                Secure.WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE;
2727
2728        /**
2729         * @deprecated Use {@link android.provider.Settings.Secure#WIFI_WATCHDOG_AP_COUNT} instead
2730         */
2731        @Deprecated
2732        public static final String WIFI_WATCHDOG_AP_COUNT = Secure.WIFI_WATCHDOG_AP_COUNT;
2733
2734        /**
2735         * @deprecated Use
2736         * {@link android.provider.Settings.Secure#WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS} instead
2737         */
2738        @Deprecated
2739        public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS =
2740                Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS;
2741
2742        /**
2743         * @deprecated Use
2744         * {@link android.provider.Settings.Secure#WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED} instead
2745         */
2746        @Deprecated
2747        public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED =
2748                Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED;
2749
2750        /**
2751         * @deprecated Use
2752         * {@link android.provider.Settings.Secure#WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS}
2753         * instead
2754         */
2755        @Deprecated
2756        public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS =
2757                Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS;
2758
2759        /**
2760         * @deprecated Use
2761         * {@link android.provider.Settings.Secure#WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT} instead
2762         */
2763        @Deprecated
2764        public static final String WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT =
2765            Secure.WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT;
2766
2767        /**
2768         * @deprecated Use {@link android.provider.Settings.Secure#WIFI_WATCHDOG_MAX_AP_CHECKS}
2769         * instead
2770         */
2771        @Deprecated
2772        public static final String WIFI_WATCHDOG_MAX_AP_CHECKS = Secure.WIFI_WATCHDOG_MAX_AP_CHECKS;
2773
2774        /**
2775         * @deprecated Use {@link android.provider.Settings.Global#WIFI_WATCHDOG_ON} instead
2776         */
2777        @Deprecated
2778        public static final String WIFI_WATCHDOG_ON = Global.WIFI_WATCHDOG_ON;
2779
2780        /**
2781         * @deprecated Use {@link android.provider.Settings.Secure#WIFI_WATCHDOG_PING_COUNT} instead
2782         */
2783        @Deprecated
2784        public static final String WIFI_WATCHDOG_PING_COUNT = Secure.WIFI_WATCHDOG_PING_COUNT;
2785
2786        /**
2787         * @deprecated Use {@link android.provider.Settings.Secure#WIFI_WATCHDOG_PING_DELAY_MS}
2788         * instead
2789         */
2790        @Deprecated
2791        public static final String WIFI_WATCHDOG_PING_DELAY_MS = Secure.WIFI_WATCHDOG_PING_DELAY_MS;
2792
2793        /**
2794         * @deprecated Use {@link android.provider.Settings.Secure#WIFI_WATCHDOG_PING_TIMEOUT_MS}
2795         * instead
2796         */
2797        @Deprecated
2798        public static final String WIFI_WATCHDOG_PING_TIMEOUT_MS =
2799            Secure.WIFI_WATCHDOG_PING_TIMEOUT_MS;
2800    }
2801
2802    /**
2803     * Secure system settings, containing system preferences that applications
2804     * can read but are not allowed to write.  These are for preferences that
2805     * the user must explicitly modify through the system UI or specialized
2806     * APIs for those values, not modified directly by applications.
2807     */
2808    public static final class Secure extends NameValueTable {
2809        public static final String SYS_PROP_SETTING_VERSION = "sys.settings_secure_version";
2810
2811        /**
2812         * The content:// style URL for this table
2813         */
2814        public static final Uri CONTENT_URI =
2815            Uri.parse("content://" + AUTHORITY + "/secure");
2816
2817        // Populated lazily, guarded by class object:
2818        private static final NameValueCache sNameValueCache = new NameValueCache(
2819                SYS_PROP_SETTING_VERSION,
2820                CONTENT_URI,
2821                CALL_METHOD_GET_SECURE,
2822                CALL_METHOD_PUT_SECURE);
2823
2824        private static ILockSettings sLockSettings = null;
2825
2826        private static boolean sIsSystemProcess;
2827        private static final HashSet<String> MOVED_TO_LOCK_SETTINGS;
2828        private static final HashSet<String> MOVED_TO_GLOBAL;
2829        static {
2830            MOVED_TO_LOCK_SETTINGS = new HashSet<String>(3);
2831            MOVED_TO_LOCK_SETTINGS.add(Secure.LOCK_PATTERN_ENABLED);
2832            MOVED_TO_LOCK_SETTINGS.add(Secure.LOCK_PATTERN_VISIBLE);
2833            MOVED_TO_LOCK_SETTINGS.add(Secure.LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED);
2834
2835            MOVED_TO_GLOBAL = new HashSet<String>();
2836            MOVED_TO_GLOBAL.add(Settings.Global.ADB_ENABLED);
2837            MOVED_TO_GLOBAL.add(Settings.Global.ASSISTED_GPS_ENABLED);
2838            MOVED_TO_GLOBAL.add(Settings.Global.BLUETOOTH_ON);
2839            MOVED_TO_GLOBAL.add(Settings.Global.BUGREPORT_IN_POWER_MENU);
2840            MOVED_TO_GLOBAL.add(Settings.Global.CDMA_CELL_BROADCAST_SMS);
2841            MOVED_TO_GLOBAL.add(Settings.Global.CDMA_ROAMING_MODE);
2842            MOVED_TO_GLOBAL.add(Settings.Global.CDMA_SUBSCRIPTION_MODE);
2843            MOVED_TO_GLOBAL.add(Settings.Global.DATA_ACTIVITY_TIMEOUT_MOBILE);
2844            MOVED_TO_GLOBAL.add(Settings.Global.DATA_ACTIVITY_TIMEOUT_WIFI);
2845            MOVED_TO_GLOBAL.add(Settings.Global.DATA_ROAMING);
2846            MOVED_TO_GLOBAL.add(Settings.Global.DEVELOPMENT_SETTINGS_ENABLED);
2847            MOVED_TO_GLOBAL.add(Settings.Global.DEVICE_PROVISIONED);
2848            MOVED_TO_GLOBAL.add(Settings.Global.DISPLAY_DENSITY_FORCED);
2849            MOVED_TO_GLOBAL.add(Settings.Global.DISPLAY_SIZE_FORCED);
2850            MOVED_TO_GLOBAL.add(Settings.Global.DOWNLOAD_MAX_BYTES_OVER_MOBILE);
2851            MOVED_TO_GLOBAL.add(Settings.Global.DOWNLOAD_RECOMMENDED_MAX_BYTES_OVER_MOBILE);
2852            MOVED_TO_GLOBAL.add(Settings.Global.MOBILE_DATA);
2853            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_DEV_BUCKET_DURATION);
2854            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_DEV_DELETE_AGE);
2855            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_DEV_PERSIST_BYTES);
2856            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_DEV_ROTATE_AGE);
2857            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_ENABLED);
2858            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_GLOBAL_ALERT_BYTES);
2859            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_POLL_INTERVAL);
2860            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_REPORT_XT_OVER_DEV);
2861            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_SAMPLE_ENABLED);
2862            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_TIME_CACHE_MAX_AGE);
2863            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_UID_BUCKET_DURATION);
2864            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_UID_DELETE_AGE);
2865            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_UID_PERSIST_BYTES);
2866            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_UID_ROTATE_AGE);
2867            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_UID_TAG_BUCKET_DURATION);
2868            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_UID_TAG_DELETE_AGE);
2869            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_UID_TAG_PERSIST_BYTES);
2870            MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_UID_TAG_ROTATE_AGE);
2871            MOVED_TO_GLOBAL.add(Settings.Global.NETWORK_PREFERENCE);
2872            MOVED_TO_GLOBAL.add(Settings.Global.NITZ_UPDATE_DIFF);
2873            MOVED_TO_GLOBAL.add(Settings.Global.NITZ_UPDATE_SPACING);
2874            MOVED_TO_GLOBAL.add(Settings.Global.NTP_SERVER);
2875            MOVED_TO_GLOBAL.add(Settings.Global.NTP_TIMEOUT);
2876            MOVED_TO_GLOBAL.add(Settings.Global.PDP_WATCHDOG_ERROR_POLL_COUNT);
2877            MOVED_TO_GLOBAL.add(Settings.Global.PDP_WATCHDOG_LONG_POLL_INTERVAL_MS);
2878            MOVED_TO_GLOBAL.add(Settings.Global.PDP_WATCHDOG_MAX_PDP_RESET_FAIL_COUNT);
2879            MOVED_TO_GLOBAL.add(Settings.Global.PDP_WATCHDOG_POLL_INTERVAL_MS);
2880            MOVED_TO_GLOBAL.add(Settings.Global.PDP_WATCHDOG_TRIGGER_PACKET_COUNT);
2881            MOVED_TO_GLOBAL.add(Settings.Global.SAMPLING_PROFILER_MS);
2882            MOVED_TO_GLOBAL.add(Settings.Global.SETUP_PREPAID_DATA_SERVICE_URL);
2883            MOVED_TO_GLOBAL.add(Settings.Global.SETUP_PREPAID_DETECTION_REDIR_HOST);
2884            MOVED_TO_GLOBAL.add(Settings.Global.SETUP_PREPAID_DETECTION_TARGET_URL);
2885            MOVED_TO_GLOBAL.add(Settings.Global.TETHER_DUN_APN);
2886            MOVED_TO_GLOBAL.add(Settings.Global.TETHER_DUN_REQUIRED);
2887            MOVED_TO_GLOBAL.add(Settings.Global.TETHER_SUPPORTED);
2888            MOVED_TO_GLOBAL.add(Settings.Global.USB_MASS_STORAGE_ENABLED);
2889            MOVED_TO_GLOBAL.add(Settings.Global.USE_GOOGLE_MAIL);
2890            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_COUNTRY_CODE);
2891            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_FRAMEWORK_SCAN_INTERVAL_MS);
2892            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_FREQUENCY_BAND);
2893            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_IDLE_MS);
2894            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_MAX_DHCP_RETRY_COUNT);
2895            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS);
2896            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON);
2897            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY);
2898            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_NUM_OPEN_NETWORKS_KEPT);
2899            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_ON);
2900            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_P2P_DEVICE_NAME);
2901            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_SAVED_STATE);
2902            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_SUPPLICANT_SCAN_INTERVAL_MS);
2903            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_SUSPEND_OPTIMIZATIONS_ENABLED);
2904            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_ENHANCED_AUTO_JOIN);
2905            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_NETWORK_SHOW_RSSI);
2906            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_WATCHDOG_ON);
2907            MOVED_TO_GLOBAL.add(Settings.Global.WIFI_WATCHDOG_POOR_NETWORK_TEST_ENABLED);
2908            MOVED_TO_GLOBAL.add(Settings.Global.WIMAX_NETWORKS_AVAILABLE_NOTIFICATION_ON);
2909            MOVED_TO_GLOBAL.add(Settings.Global.PACKAGE_VERIFIER_ENABLE);
2910            MOVED_TO_GLOBAL.add(Settings.Global.PACKAGE_VERIFIER_TIMEOUT);
2911            MOVED_TO_GLOBAL.add(Settings.Global.PACKAGE_VERIFIER_DEFAULT_RESPONSE);
2912            MOVED_TO_GLOBAL.add(Settings.Global.DATA_STALL_ALARM_NON_AGGRESSIVE_DELAY_IN_MS);
2913            MOVED_TO_GLOBAL.add(Settings.Global.DATA_STALL_ALARM_AGGRESSIVE_DELAY_IN_MS);
2914            MOVED_TO_GLOBAL.add(Settings.Global.GPRS_REGISTER_CHECK_PERIOD_MS);
2915            MOVED_TO_GLOBAL.add(Settings.Global.WTF_IS_FATAL);
2916            MOVED_TO_GLOBAL.add(Settings.Global.BATTERY_DISCHARGE_DURATION_THRESHOLD);
2917            MOVED_TO_GLOBAL.add(Settings.Global.BATTERY_DISCHARGE_THRESHOLD);
2918            MOVED_TO_GLOBAL.add(Settings.Global.SEND_ACTION_APP_ERROR);
2919            MOVED_TO_GLOBAL.add(Settings.Global.DROPBOX_AGE_SECONDS);
2920            MOVED_TO_GLOBAL.add(Settings.Global.DROPBOX_MAX_FILES);
2921            MOVED_TO_GLOBAL.add(Settings.Global.DROPBOX_QUOTA_KB);
2922            MOVED_TO_GLOBAL.add(Settings.Global.DROPBOX_QUOTA_PERCENT);
2923            MOVED_TO_GLOBAL.add(Settings.Global.DROPBOX_RESERVE_PERCENT);
2924            MOVED_TO_GLOBAL.add(Settings.Global.DROPBOX_TAG_PREFIX);
2925            MOVED_TO_GLOBAL.add(Settings.Global.ERROR_LOGCAT_PREFIX);
2926            MOVED_TO_GLOBAL.add(Settings.Global.SYS_FREE_STORAGE_LOG_INTERVAL);
2927            MOVED_TO_GLOBAL.add(Settings.Global.DISK_FREE_CHANGE_REPORTING_THRESHOLD);
2928            MOVED_TO_GLOBAL.add(Settings.Global.SYS_STORAGE_THRESHOLD_PERCENTAGE);
2929            MOVED_TO_GLOBAL.add(Settings.Global.SYS_STORAGE_THRESHOLD_MAX_BYTES);
2930            MOVED_TO_GLOBAL.add(Settings.Global.SYS_STORAGE_FULL_THRESHOLD_BYTES);
2931            MOVED_TO_GLOBAL.add(Settings.Global.SYNC_MAX_RETRY_DELAY_IN_SECONDS);
2932            MOVED_TO_GLOBAL.add(Settings.Global.CONNECTIVITY_CHANGE_DELAY);
2933            MOVED_TO_GLOBAL.add(Settings.Global.CAPTIVE_PORTAL_DETECTION_ENABLED);
2934            MOVED_TO_GLOBAL.add(Settings.Global.CAPTIVE_PORTAL_SERVER);
2935            MOVED_TO_GLOBAL.add(Settings.Global.NSD_ON);
2936            MOVED_TO_GLOBAL.add(Settings.Global.SET_INSTALL_LOCATION);
2937            MOVED_TO_GLOBAL.add(Settings.Global.DEFAULT_INSTALL_LOCATION);
2938            MOVED_TO_GLOBAL.add(Settings.Global.INET_CONDITION_DEBOUNCE_UP_DELAY);
2939            MOVED_TO_GLOBAL.add(Settings.Global.INET_CONDITION_DEBOUNCE_DOWN_DELAY);
2940            MOVED_TO_GLOBAL.add(Settings.Global.READ_EXTERNAL_STORAGE_ENFORCED_DEFAULT);
2941            MOVED_TO_GLOBAL.add(Settings.Global.HTTP_PROXY);
2942            MOVED_TO_GLOBAL.add(Settings.Global.GLOBAL_HTTP_PROXY_HOST);
2943            MOVED_TO_GLOBAL.add(Settings.Global.GLOBAL_HTTP_PROXY_PORT);
2944            MOVED_TO_GLOBAL.add(Settings.Global.GLOBAL_HTTP_PROXY_EXCLUSION_LIST);
2945            MOVED_TO_GLOBAL.add(Settings.Global.SET_GLOBAL_HTTP_PROXY);
2946            MOVED_TO_GLOBAL.add(Settings.Global.DEFAULT_DNS_SERVER);
2947            MOVED_TO_GLOBAL.add(Settings.Global.PREFERRED_NETWORK_MODE);
2948            MOVED_TO_GLOBAL.add(Settings.Global.WEBVIEW_DATA_REDUCTION_PROXY_KEY);
2949        }
2950
2951        /** @hide */
2952        public static void getMovedKeys(HashSet<String> outKeySet) {
2953            outKeySet.addAll(MOVED_TO_GLOBAL);
2954        }
2955
2956        /**
2957         * Look up a name in the database.
2958         * @param resolver to access the database with
2959         * @param name to look up in the table
2960         * @return the corresponding value, or null if not present
2961         */
2962        public static String getString(ContentResolver resolver, String name) {
2963            return getStringForUser(resolver, name, UserHandle.myUserId());
2964        }
2965
2966        /** @hide */
2967        public static String getStringForUser(ContentResolver resolver, String name,
2968                int userHandle) {
2969            if (MOVED_TO_GLOBAL.contains(name)) {
2970                Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.Secure"
2971                        + " to android.provider.Settings.Global.");
2972                return Global.getStringForUser(resolver, name, userHandle);
2973            }
2974
2975            if (MOVED_TO_LOCK_SETTINGS.contains(name)) {
2976                synchronized (Secure.class) {
2977                    if (sLockSettings == null) {
2978                        sLockSettings = ILockSettings.Stub.asInterface(
2979                                (IBinder) ServiceManager.getService("lock_settings"));
2980                        sIsSystemProcess = Process.myUid() == Process.SYSTEM_UID;
2981                    }
2982                }
2983                if (sLockSettings != null && !sIsSystemProcess) {
2984                    try {
2985                        return sLockSettings.getString(name, "0", userHandle);
2986                    } catch (RemoteException re) {
2987                        // Fall through
2988                    }
2989                }
2990            }
2991
2992            return sNameValueCache.getStringForUser(resolver, name, userHandle);
2993        }
2994
2995        /**
2996         * Store a name/value pair into the database.
2997         * @param resolver to access the database with
2998         * @param name to store
2999         * @param value to associate with the name
3000         * @return true if the value was set, false on database errors
3001         */
3002        public static boolean putString(ContentResolver resolver, String name, String value) {
3003            return putStringForUser(resolver, name, value, UserHandle.myUserId());
3004        }
3005
3006        /** @hide */
3007        public static boolean putStringForUser(ContentResolver resolver, String name, String value,
3008                int userHandle) {
3009            if (MOVED_TO_GLOBAL.contains(name)) {
3010                Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.System"
3011                        + " to android.provider.Settings.Global");
3012                return Global.putStringForUser(resolver, name, value, userHandle);
3013            }
3014            return sNameValueCache.putStringForUser(resolver, name, value, userHandle);
3015        }
3016
3017        /**
3018         * Construct the content URI for a particular name/value pair,
3019         * useful for monitoring changes with a ContentObserver.
3020         * @param name to look up in the table
3021         * @return the corresponding content URI, or null if not present
3022         */
3023        public static Uri getUriFor(String name) {
3024            if (MOVED_TO_GLOBAL.contains(name)) {
3025                Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.Secure"
3026                        + " to android.provider.Settings.Global, returning global URI.");
3027                return Global.getUriFor(Global.CONTENT_URI, name);
3028            }
3029            return getUriFor(CONTENT_URI, name);
3030        }
3031
3032        /**
3033         * Convenience function for retrieving a single secure settings value
3034         * as an integer.  Note that internally setting values are always
3035         * stored as strings; this function converts the string to an integer
3036         * for you.  The default value will be returned if the setting is
3037         * not defined or not an integer.
3038         *
3039         * @param cr The ContentResolver to access.
3040         * @param name The name of the setting to retrieve.
3041         * @param def Value to return if the setting is not defined.
3042         *
3043         * @return The setting's current value, or 'def' if it is not defined
3044         * or not a valid integer.
3045         */
3046        public static int getInt(ContentResolver cr, String name, int def) {
3047            return getIntForUser(cr, name, def, UserHandle.myUserId());
3048        }
3049
3050        /** @hide */
3051        public static int getIntForUser(ContentResolver cr, String name, int def, int userHandle) {
3052            if (LOCATION_MODE.equals(name)) {
3053                // HACK ALERT: temporary hack to work around b/10491283.
3054                // TODO: once b/10491283 fixed, remove this hack
3055                return getLocationModeForUser(cr, userHandle);
3056            }
3057            String v = getStringForUser(cr, name, userHandle);
3058            try {
3059                return v != null ? Integer.parseInt(v) : def;
3060            } catch (NumberFormatException e) {
3061                return def;
3062            }
3063        }
3064
3065        /**
3066         * Convenience function for retrieving a single secure settings value
3067         * as an integer.  Note that internally setting values are always
3068         * stored as strings; this function converts the string to an integer
3069         * for you.
3070         * <p>
3071         * This version does not take a default value.  If the setting has not
3072         * been set, or the string value is not a number,
3073         * it throws {@link SettingNotFoundException}.
3074         *
3075         * @param cr The ContentResolver to access.
3076         * @param name The name of the setting to retrieve.
3077         *
3078         * @throws SettingNotFoundException Thrown if a setting by the given
3079         * name can't be found or the setting value is not an integer.
3080         *
3081         * @return The setting's current value.
3082         */
3083        public static int getInt(ContentResolver cr, String name)
3084                throws SettingNotFoundException {
3085            return getIntForUser(cr, name, UserHandle.myUserId());
3086        }
3087
3088        /** @hide */
3089        public static int getIntForUser(ContentResolver cr, String name, int userHandle)
3090                throws SettingNotFoundException {
3091            if (LOCATION_MODE.equals(name)) {
3092                // HACK ALERT: temporary hack to work around b/10491283.
3093                // TODO: once b/10491283 fixed, remove this hack
3094                return getLocationModeForUser(cr, userHandle);
3095            }
3096            String v = getStringForUser(cr, name, userHandle);
3097            try {
3098                return Integer.parseInt(v);
3099            } catch (NumberFormatException e) {
3100                throw new SettingNotFoundException(name);
3101            }
3102        }
3103
3104        /**
3105         * Convenience function for updating a single settings value as an
3106         * integer. This will either create a new entry in the table if the
3107         * given name does not exist, or modify the value of the existing row
3108         * with that name.  Note that internally setting values are always
3109         * stored as strings, so this function converts the given value to a
3110         * string before storing it.
3111         *
3112         * @param cr The ContentResolver to access.
3113         * @param name The name of the setting to modify.
3114         * @param value The new value for the setting.
3115         * @return true if the value was set, false on database errors
3116         */
3117        public static boolean putInt(ContentResolver cr, String name, int value) {
3118            return putIntForUser(cr, name, value, UserHandle.myUserId());
3119        }
3120
3121        /** @hide */
3122        public static boolean putIntForUser(ContentResolver cr, String name, int value,
3123                int userHandle) {
3124            if (LOCATION_MODE.equals(name)) {
3125                // HACK ALERT: temporary hack to work around b/10491283.
3126                // TODO: once b/10491283 fixed, remove this hack
3127                return setLocationModeForUser(cr, value, userHandle);
3128            }
3129            return putStringForUser(cr, name, Integer.toString(value), userHandle);
3130        }
3131
3132        /**
3133         * Convenience function for retrieving a single secure settings value
3134         * as a {@code long}.  Note that internally setting values are always
3135         * stored as strings; this function converts the string to a {@code long}
3136         * for you.  The default value will be returned if the setting is
3137         * not defined or not a {@code long}.
3138         *
3139         * @param cr The ContentResolver to access.
3140         * @param name The name of the setting to retrieve.
3141         * @param def Value to return if the setting is not defined.
3142         *
3143         * @return The setting's current value, or 'def' if it is not defined
3144         * or not a valid {@code long}.
3145         */
3146        public static long getLong(ContentResolver cr, String name, long def) {
3147            return getLongForUser(cr, name, def, UserHandle.myUserId());
3148        }
3149
3150        /** @hide */
3151        public static long getLongForUser(ContentResolver cr, String name, long def,
3152                int userHandle) {
3153            String valString = getStringForUser(cr, name, userHandle);
3154            long value;
3155            try {
3156                value = valString != null ? Long.parseLong(valString) : def;
3157            } catch (NumberFormatException e) {
3158                value = def;
3159            }
3160            return value;
3161        }
3162
3163        /**
3164         * Convenience function for retrieving a single secure settings value
3165         * as a {@code long}.  Note that internally setting values are always
3166         * stored as strings; this function converts the string to a {@code long}
3167         * for you.
3168         * <p>
3169         * This version does not take a default value.  If the setting has not
3170         * been set, or the string value is not a number,
3171         * it throws {@link SettingNotFoundException}.
3172         *
3173         * @param cr The ContentResolver to access.
3174         * @param name The name of the setting to retrieve.
3175         *
3176         * @return The setting's current value.
3177         * @throws SettingNotFoundException Thrown if a setting by the given
3178         * name can't be found or the setting value is not an integer.
3179         */
3180        public static long getLong(ContentResolver cr, String name)
3181                throws SettingNotFoundException {
3182            return getLongForUser(cr, name, UserHandle.myUserId());
3183        }
3184
3185        /** @hide */
3186        public static long getLongForUser(ContentResolver cr, String name, int userHandle)
3187                throws SettingNotFoundException {
3188            String valString = getStringForUser(cr, name, userHandle);
3189            try {
3190                return Long.parseLong(valString);
3191            } catch (NumberFormatException e) {
3192                throw new SettingNotFoundException(name);
3193            }
3194        }
3195
3196        /**
3197         * Convenience function for updating a secure settings value as a long
3198         * integer. This will either create a new entry in the table if the
3199         * given name does not exist, or modify the value of the existing row
3200         * with that name.  Note that internally setting values are always
3201         * stored as strings, so this function converts the given value to a
3202         * string before storing it.
3203         *
3204         * @param cr The ContentResolver to access.
3205         * @param name The name of the setting to modify.
3206         * @param value The new value for the setting.
3207         * @return true if the value was set, false on database errors
3208         */
3209        public static boolean putLong(ContentResolver cr, String name, long value) {
3210            return putLongForUser(cr, name, value, UserHandle.myUserId());
3211        }
3212
3213        /** @hide */
3214        public static boolean putLongForUser(ContentResolver cr, String name, long value,
3215                int userHandle) {
3216            return putStringForUser(cr, name, Long.toString(value), userHandle);
3217        }
3218
3219        /**
3220         * Convenience function for retrieving a single secure settings value
3221         * as a floating point number.  Note that internally setting values are
3222         * always stored as strings; this function converts the string to an
3223         * float for you. The default value will be returned if the setting
3224         * is not defined or not a valid float.
3225         *
3226         * @param cr The ContentResolver to access.
3227         * @param name The name of the setting to retrieve.
3228         * @param def Value to return if the setting is not defined.
3229         *
3230         * @return The setting's current value, or 'def' if it is not defined
3231         * or not a valid float.
3232         */
3233        public static float getFloat(ContentResolver cr, String name, float def) {
3234            return getFloatForUser(cr, name, def, UserHandle.myUserId());
3235        }
3236
3237        /** @hide */
3238        public static float getFloatForUser(ContentResolver cr, String name, float def,
3239                int userHandle) {
3240            String v = getStringForUser(cr, name, userHandle);
3241            try {
3242                return v != null ? Float.parseFloat(v) : def;
3243            } catch (NumberFormatException e) {
3244                return def;
3245            }
3246        }
3247
3248        /**
3249         * Convenience function for retrieving a single secure settings value
3250         * as a float.  Note that internally setting values are always
3251         * stored as strings; this function converts the string to a float
3252         * for you.
3253         * <p>
3254         * This version does not take a default value.  If the setting has not
3255         * been set, or the string value is not a number,
3256         * it throws {@link SettingNotFoundException}.
3257         *
3258         * @param cr The ContentResolver to access.
3259         * @param name The name of the setting to retrieve.
3260         *
3261         * @throws SettingNotFoundException Thrown if a setting by the given
3262         * name can't be found or the setting value is not a float.
3263         *
3264         * @return The setting's current value.
3265         */
3266        public static float getFloat(ContentResolver cr, String name)
3267                throws SettingNotFoundException {
3268            return getFloatForUser(cr, name, UserHandle.myUserId());
3269        }
3270
3271        /** @hide */
3272        public static float getFloatForUser(ContentResolver cr, String name, int userHandle)
3273                throws SettingNotFoundException {
3274            String v = getStringForUser(cr, name, userHandle);
3275            if (v == null) {
3276                throw new SettingNotFoundException(name);
3277            }
3278            try {
3279                return Float.parseFloat(v);
3280            } catch (NumberFormatException e) {
3281                throw new SettingNotFoundException(name);
3282            }
3283        }
3284
3285        /**
3286         * Convenience function for updating a single settings value as a
3287         * floating point number. This will either create a new entry in the
3288         * table if the given name does not exist, or modify the value of the
3289         * existing row with that name.  Note that internally setting values
3290         * are always stored as strings, so this function converts the given
3291         * value to a string before storing it.
3292         *
3293         * @param cr The ContentResolver to access.
3294         * @param name The name of the setting to modify.
3295         * @param value The new value for the setting.
3296         * @return true if the value was set, false on database errors
3297         */
3298        public static boolean putFloat(ContentResolver cr, String name, float value) {
3299            return putFloatForUser(cr, name, value, UserHandle.myUserId());
3300        }
3301
3302        /** @hide */
3303        public static boolean putFloatForUser(ContentResolver cr, String name, float value,
3304                int userHandle) {
3305            return putStringForUser(cr, name, Float.toString(value), userHandle);
3306        }
3307
3308        /**
3309         * @deprecated Use {@link android.provider.Settings.Global#DEVELOPMENT_SETTINGS_ENABLED}
3310         * instead
3311         */
3312        @Deprecated
3313        public static final String DEVELOPMENT_SETTINGS_ENABLED =
3314                Global.DEVELOPMENT_SETTINGS_ENABLED;
3315
3316        /**
3317         * When the user has enable the option to have a "bug report" command
3318         * in the power menu.
3319         * @deprecated Use {@link android.provider.Settings.Global#BUGREPORT_IN_POWER_MENU} instead
3320         * @hide
3321         */
3322        @Deprecated
3323        public static final String BUGREPORT_IN_POWER_MENU = "bugreport_in_power_menu";
3324
3325        /**
3326         * @deprecated Use {@link android.provider.Settings.Global#ADB_ENABLED} instead
3327         */
3328        @Deprecated
3329        public static final String ADB_ENABLED = Global.ADB_ENABLED;
3330
3331        /**
3332         * Setting to allow mock locations and location provider status to be injected into the
3333         * LocationManager service for testing purposes during application development.  These
3334         * locations and status values  override actual location and status information generated
3335         * by network, gps, or other location providers.
3336         */
3337        public static final String ALLOW_MOCK_LOCATION = "mock_location";
3338
3339        /**
3340         * A 64-bit number (as a hex string) that is randomly
3341         * generated when the user first sets up the device and should remain
3342         * constant for the lifetime of the user's device. The value may
3343         * change if a factory reset is performed on the device.
3344         * <p class="note"><strong>Note:</strong> When a device has <a
3345         * href="{@docRoot}about/versions/android-4.2.html#MultipleUsers">multiple users</a>
3346         * (available on certain devices running Android 4.2 or higher), each user appears as a
3347         * completely separate device, so the {@code ANDROID_ID} value is unique to each
3348         * user.</p>
3349         */
3350        public static final String ANDROID_ID = "android_id";
3351
3352        /**
3353         * @deprecated Use {@link android.provider.Settings.Global#BLUETOOTH_ON} instead
3354         */
3355        @Deprecated
3356        public static final String BLUETOOTH_ON = Global.BLUETOOTH_ON;
3357
3358        /**
3359         * @deprecated Use {@link android.provider.Settings.Global#DATA_ROAMING} instead
3360         */
3361        @Deprecated
3362        public static final String DATA_ROAMING = Global.DATA_ROAMING;
3363
3364        /**
3365         * Setting to record the input method used by default, holding the ID
3366         * of the desired method.
3367         */
3368        public static final String DEFAULT_INPUT_METHOD = "default_input_method";
3369
3370        /**
3371         * Setting to record the input method subtype used by default, holding the ID
3372         * of the desired method.
3373         */
3374        public static final String SELECTED_INPUT_METHOD_SUBTYPE =
3375                "selected_input_method_subtype";
3376
3377        /**
3378         * Setting to record the history of input method subtype, holding the pair of ID of IME
3379         * and its last used subtype.
3380         * @hide
3381         */
3382        public static final String INPUT_METHODS_SUBTYPE_HISTORY =
3383                "input_methods_subtype_history";
3384
3385        /**
3386         * Setting to record the visibility of input method selector
3387         */
3388        public static final String INPUT_METHOD_SELECTOR_VISIBILITY =
3389                "input_method_selector_visibility";
3390
3391        /**
3392         * The currently selected voice interaction service flattened ComponentName.
3393         * @hide
3394         */
3395        public static final String VOICE_INTERACTION_SERVICE = "voice_interaction_service";
3396
3397        /**
3398         * bluetooth HCI snoop log configuration
3399         * @hide
3400         */
3401        public static final String BLUETOOTH_HCI_LOG =
3402                "bluetooth_hci_log";
3403
3404        /**
3405         * @deprecated Use {@link android.provider.Settings.Global#DEVICE_PROVISIONED} instead
3406         */
3407        @Deprecated
3408        public static final String DEVICE_PROVISIONED = Global.DEVICE_PROVISIONED;
3409
3410        /**
3411         * Whether the current user has been set up via setup wizard (0 = false, 1 = true)
3412         * @hide
3413         */
3414        public static final String USER_SETUP_COMPLETE = "user_setup_complete";
3415
3416        /**
3417         * List of input methods that are currently enabled.  This is a string
3418         * containing the IDs of all enabled input methods, each ID separated
3419         * by ':'.
3420         */
3421        public static final String ENABLED_INPUT_METHODS = "enabled_input_methods";
3422
3423        /**
3424         * List of system input methods that are currently disabled.  This is a string
3425         * containing the IDs of all disabled input methods, each ID separated
3426         * by ':'.
3427         * @hide
3428         */
3429        public static final String DISABLED_SYSTEM_INPUT_METHODS = "disabled_system_input_methods";
3430
3431        /**
3432         * Host name and port for global http proxy. Uses ':' seperator for
3433         * between host and port.
3434         *
3435         * @deprecated Use {@link Global#HTTP_PROXY}
3436         */
3437        @Deprecated
3438        public static final String HTTP_PROXY = Global.HTTP_PROXY;
3439
3440        /**
3441         * Whether applications can be installed for this user via the system's
3442         * {@link Intent#ACTION_INSTALL_PACKAGE} mechanism.
3443         *
3444         * <p>1 = permit app installation via the system package installer intent
3445         * <p>0 = do not allow use of the package installer
3446         */
3447        public static final String INSTALL_NON_MARKET_APPS = "install_non_market_apps";
3448
3449        /**
3450         * Comma-separated list of location providers that activities may access. Do not rely on
3451         * this value being present in settings.db or on ContentObserver notifications on the
3452         * corresponding Uri.
3453         *
3454         * @deprecated use {@link #LOCATION_MODE} and
3455         * {@link LocationManager#MODE_CHANGED_ACTION} (or
3456         * {@link LocationManager#PROVIDERS_CHANGED_ACTION})
3457         */
3458        @Deprecated
3459        public static final String LOCATION_PROVIDERS_ALLOWED = "location_providers_allowed";
3460
3461        /**
3462         * The degree of location access enabled by the user.
3463         * <p>
3464         * When used with {@link #putInt(ContentResolver, String, int)}, must be one of {@link
3465         * #LOCATION_MODE_HIGH_ACCURACY}, {@link #LOCATION_MODE_SENSORS_ONLY}, {@link
3466         * #LOCATION_MODE_BATTERY_SAVING}, or {@link #LOCATION_MODE_OFF}. When used with {@link
3467         * #getInt(ContentResolver, String)}, the caller must gracefully handle additional location
3468         * modes that might be added in the future.
3469         * <p>
3470         * Note: do not rely on this value being present in settings.db or on ContentObserver
3471         * notifications for the corresponding Uri. Use {@link LocationManager#MODE_CHANGED_ACTION}
3472         * to receive changes in this value.
3473         */
3474        public static final String LOCATION_MODE = "location_mode";
3475
3476        /**
3477         * Location access disabled.
3478         */
3479        public static final int LOCATION_MODE_OFF = 0;
3480        /**
3481         * Network Location Provider disabled, but GPS and other sensors enabled.
3482         */
3483        public static final int LOCATION_MODE_SENSORS_ONLY = 1;
3484        /**
3485         * Reduced power usage, such as limiting the number of GPS updates per hour. Requests
3486         * with {@link android.location.Criteria#POWER_HIGH} may be downgraded to
3487         * {@link android.location.Criteria#POWER_MEDIUM}.
3488         */
3489        public static final int LOCATION_MODE_BATTERY_SAVING = 2;
3490        /**
3491         * Best-effort location computation allowed.
3492         */
3493        public static final int LOCATION_MODE_HIGH_ACCURACY = 3;
3494
3495        /**
3496         * A flag containing settings used for biometric weak
3497         * @hide
3498         */
3499        public static final String LOCK_BIOMETRIC_WEAK_FLAGS =
3500                "lock_biometric_weak_flags";
3501
3502        /**
3503         * Whether autolock is enabled (0 = false, 1 = true)
3504         */
3505        public static final String LOCK_PATTERN_ENABLED = "lock_pattern_autolock";
3506
3507        /**
3508         * Whether lock pattern is visible as user enters (0 = false, 1 = true)
3509         */
3510        public static final String LOCK_PATTERN_VISIBLE = "lock_pattern_visible_pattern";
3511
3512        /**
3513         * Whether lock pattern will vibrate as user enters (0 = false, 1 =
3514         * true)
3515         *
3516         * @deprecated Starting in {@link VERSION_CODES#JELLY_BEAN_MR1} the
3517         *             lockscreen uses
3518         *             {@link Settings.System#HAPTIC_FEEDBACK_ENABLED}.
3519         */
3520        @Deprecated
3521        public static final String
3522                LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED = "lock_pattern_tactile_feedback_enabled";
3523
3524        /**
3525         * This preference allows the device to be locked given time after screen goes off,
3526         * subject to current DeviceAdmin policy limits.
3527         * @hide
3528         */
3529        public static final String LOCK_SCREEN_LOCK_AFTER_TIMEOUT = "lock_screen_lock_after_timeout";
3530
3531
3532        /**
3533         * This preference contains the string that shows for owner info on LockScreen.
3534         * @hide
3535         * @deprecated
3536         */
3537        public static final String LOCK_SCREEN_OWNER_INFO = "lock_screen_owner_info";
3538
3539        /**
3540         * Ids of the user-selected appwidgets on the lockscreen (comma-delimited).
3541         * @hide
3542         */
3543        public static final String LOCK_SCREEN_APPWIDGET_IDS =
3544            "lock_screen_appwidget_ids";
3545
3546        /**
3547         * List of enrolled fingerprint identifiers (comma-delimited).
3548         * @hide
3549         */
3550        public static final String USER_FINGERPRINT_IDS = "user_fingerprint_ids";
3551
3552        /**
3553         * Id of the appwidget shown on the lock screen when appwidgets are disabled.
3554         * @hide
3555         */
3556        public static final String LOCK_SCREEN_FALLBACK_APPWIDGET_ID =
3557            "lock_screen_fallback_appwidget_id";
3558
3559        /**
3560         * Index of the lockscreen appwidget to restore, -1 if none.
3561         * @hide
3562         */
3563        public static final String LOCK_SCREEN_STICKY_APPWIDGET =
3564            "lock_screen_sticky_appwidget";
3565
3566        /**
3567         * This preference enables showing the owner info on LockScreen.
3568         * @hide
3569         * @deprecated
3570         */
3571        public static final String LOCK_SCREEN_OWNER_INFO_ENABLED =
3572            "lock_screen_owner_info_enabled";
3573
3574        /**
3575         * When set by a user, allows notifications to be shown atop a securely locked screen
3576         * in their full "private" form (same as when the device is unlocked).
3577         * @hide
3578         */
3579        public static final String LOCK_SCREEN_ALLOW_PRIVATE_NOTIFICATIONS =
3580                "lock_screen_allow_private_notifications";
3581
3582        /**
3583         * The Logging ID (a unique 64-bit value) as a hex string.
3584         * Used as a pseudonymous identifier for logging.
3585         * @deprecated This identifier is poorly initialized and has
3586         * many collisions.  It should not be used.
3587         */
3588        @Deprecated
3589        public static final String LOGGING_ID = "logging_id";
3590
3591        /**
3592         * @deprecated Use {@link android.provider.Settings.Global#NETWORK_PREFERENCE} instead
3593         */
3594        @Deprecated
3595        public static final String NETWORK_PREFERENCE = Global.NETWORK_PREFERENCE;
3596
3597        /**
3598         * No longer supported.
3599         */
3600        public static final String PARENTAL_CONTROL_ENABLED = "parental_control_enabled";
3601
3602        /**
3603         * No longer supported.
3604         */
3605        public static final String PARENTAL_CONTROL_LAST_UPDATE = "parental_control_last_update";
3606
3607        /**
3608         * No longer supported.
3609         */
3610        public static final String PARENTAL_CONTROL_REDIRECT_URL = "parental_control_redirect_url";
3611
3612        /**
3613         * Settings classname to launch when Settings is clicked from All
3614         * Applications.  Needed because of user testing between the old
3615         * and new Settings apps.
3616         */
3617        // TODO: 881807
3618        public static final String SETTINGS_CLASSNAME = "settings_classname";
3619
3620        /**
3621         * @deprecated Use {@link android.provider.Settings.Global#USB_MASS_STORAGE_ENABLED} instead
3622         */
3623        @Deprecated
3624        public static final String USB_MASS_STORAGE_ENABLED = Global.USB_MASS_STORAGE_ENABLED;
3625
3626        /**
3627         * @deprecated Use {@link android.provider.Settings.Global#USE_GOOGLE_MAIL} instead
3628         */
3629        @Deprecated
3630        public static final String USE_GOOGLE_MAIL = Global.USE_GOOGLE_MAIL;
3631
3632        /**
3633         * If accessibility is enabled.
3634         */
3635        public static final String ACCESSIBILITY_ENABLED = "accessibility_enabled";
3636
3637        /**
3638         * If touch exploration is enabled.
3639         */
3640        public static final String TOUCH_EXPLORATION_ENABLED = "touch_exploration_enabled";
3641
3642        /**
3643         * List of the enabled accessibility providers.
3644         */
3645        public static final String ENABLED_ACCESSIBILITY_SERVICES =
3646            "enabled_accessibility_services";
3647
3648        /**
3649         * List of the accessibility services to which the user has granted
3650         * permission to put the device into touch exploration mode.
3651         *
3652         * @hide
3653         */
3654        public static final String TOUCH_EXPLORATION_GRANTED_ACCESSIBILITY_SERVICES =
3655            "touch_exploration_granted_accessibility_services";
3656
3657        /**
3658         * Whether to speak passwords while in accessibility mode.
3659         */
3660        public static final String ACCESSIBILITY_SPEAK_PASSWORD = "speak_password";
3661
3662        /**
3663         * If injection of accessibility enhancing JavaScript screen-reader
3664         * is enabled.
3665         * <p>
3666         *   Note: The JavaScript based screen-reader is served by the
3667         *   Google infrastructure and enable users with disabilities to
3668         *   efficiently navigate in and explore web content.
3669         * </p>
3670         * <p>
3671         *   This property represents a boolean value.
3672         * </p>
3673         * @hide
3674         */
3675        public static final String ACCESSIBILITY_SCRIPT_INJECTION =
3676            "accessibility_script_injection";
3677
3678        /**
3679         * The URL for the injected JavaScript based screen-reader used
3680         * for providing accessibility of content in WebView.
3681         * <p>
3682         *   Note: The JavaScript based screen-reader is served by the
3683         *   Google infrastructure and enable users with disabilities to
3684         *   efficiently navigate in and explore web content.
3685         * </p>
3686         * <p>
3687         *   This property represents a string value.
3688         * </p>
3689         * @hide
3690         */
3691        public static final String ACCESSIBILITY_SCREEN_READER_URL =
3692            "accessibility_script_injection_url";
3693
3694        /**
3695         * Key bindings for navigation in built-in accessibility support for web content.
3696         * <p>
3697         *   Note: These key bindings are for the built-in accessibility navigation for
3698         *   web content which is used as a fall back solution if JavaScript in a WebView
3699         *   is not enabled or the user has not opted-in script injection from Google.
3700         * </p>
3701         * <p>
3702         *   The bindings are separated by semi-colon. A binding is a mapping from
3703         *   a key to a sequence of actions (for more details look at
3704         *   android.webkit.AccessibilityInjector). A key is represented as the hexademical
3705         *   string representation of an integer obtained from a meta state (optional) shifted
3706         *   sixteen times left and bitwise ored with a key code. An action is represented
3707         *   as a hexademical string representation of an integer where the first two digits
3708         *   are navigation action index, the second, the third, and the fourth digit pairs
3709         *   represent the action arguments. The separate actions in a binding are colon
3710         *   separated. The key and the action sequence it maps to are separated by equals.
3711         * </p>
3712         * <p>
3713         *   For example, the binding below maps the DPAD right button to traverse the
3714         *   current navigation axis once without firing an accessibility event and to
3715         *   perform the same traversal again but to fire an event:
3716         *   <code>
3717         *     0x16=0x01000100:0x01000101;
3718         *   </code>
3719         * </p>
3720         * <p>
3721         *   The goal of this binding is to enable dynamic rebinding of keys to
3722         *   navigation actions for web content without requiring a framework change.
3723         * </p>
3724         * <p>
3725         *   This property represents a string value.
3726         * </p>
3727         * @hide
3728         */
3729        public static final String ACCESSIBILITY_WEB_CONTENT_KEY_BINDINGS =
3730            "accessibility_web_content_key_bindings";
3731
3732        /**
3733         * Setting that specifies whether the display magnification is enabled.
3734         * Display magnifications allows the user to zoom in the display content
3735         * and is targeted to low vision users. The current magnification scale
3736         * is controlled by {@link #ACCESSIBILITY_DISPLAY_MAGNIFICATION_SCALE}.
3737         *
3738         * @hide
3739         */
3740        public static final String ACCESSIBILITY_DISPLAY_MAGNIFICATION_ENABLED =
3741                "accessibility_display_magnification_enabled";
3742
3743        /**
3744         * Setting that specifies what the display magnification scale is.
3745         * Display magnifications allows the user to zoom in the display
3746         * content and is targeted to low vision users. Whether a display
3747         * magnification is performed is controlled by
3748         * {@link #ACCESSIBILITY_DISPLAY_MAGNIFICATION_ENABLED}
3749         *
3750         * @hide
3751         */
3752        public static final String ACCESSIBILITY_DISPLAY_MAGNIFICATION_SCALE =
3753                "accessibility_display_magnification_scale";
3754
3755        /**
3756         * Setting that specifies whether the display magnification should be
3757         * automatically updated. If this fearture is enabled the system will
3758         * exit magnification mode or pan the viewport when a context change
3759         * occurs. For example, on staring a new activity or rotating the screen,
3760         * the system may zoom out so the user can see the new context he is in.
3761         * Another example is on showing a window that is not visible in the
3762         * magnified viewport the system may pan the viewport to make the window
3763         * the has popped up so the user knows that the context has changed.
3764         * Whether a screen magnification is performed is controlled by
3765         * {@link #ACCESSIBILITY_DISPLAY_MAGNIFICATION_ENABLED}
3766         *
3767         * @hide
3768         */
3769        public static final String ACCESSIBILITY_DISPLAY_MAGNIFICATION_AUTO_UPDATE =
3770                "accessibility_display_magnification_auto_update";
3771
3772        /**
3773         * Setting that specifies whether timed text (captions) should be
3774         * displayed in video content. Text display properties are controlled by
3775         * the following settings:
3776         * <ul>
3777         * <li>{@link #ACCESSIBILITY_CAPTIONING_LOCALE}
3778         * <li>{@link #ACCESSIBILITY_CAPTIONING_BACKGROUND_COLOR}
3779         * <li>{@link #ACCESSIBILITY_CAPTIONING_FOREGROUND_COLOR}
3780         * <li>{@link #ACCESSIBILITY_CAPTIONING_EDGE_COLOR}
3781         * <li>{@link #ACCESSIBILITY_CAPTIONING_EDGE_TYPE}
3782         * <li>{@link #ACCESSIBILITY_CAPTIONING_TYPEFACE}
3783         * <li>{@link #ACCESSIBILITY_CAPTIONING_FONT_SCALE}
3784         * </ul>
3785         *
3786         * @hide
3787         */
3788        public static final String ACCESSIBILITY_CAPTIONING_ENABLED =
3789                "accessibility_captioning_enabled";
3790
3791        /**
3792         * Setting that specifies the language for captions as a locale string,
3793         * e.g. en_US.
3794         *
3795         * @see java.util.Locale#toString
3796         * @hide
3797         */
3798        public static final String ACCESSIBILITY_CAPTIONING_LOCALE =
3799                "accessibility_captioning_locale";
3800
3801        /**
3802         * Integer property that specifies the preset style for captions, one
3803         * of:
3804         * <ul>
3805         * <li>{@link android.view.accessibility.CaptioningManager.CaptionStyle#PRESET_CUSTOM}
3806         * <li>a valid index of {@link android.view.accessibility.CaptioningManager.CaptionStyle#PRESETS}
3807         * </ul>
3808         *
3809         * @see java.util.Locale#toString
3810         * @hide
3811         */
3812        public static final String ACCESSIBILITY_CAPTIONING_PRESET =
3813                "accessibility_captioning_preset";
3814
3815        /**
3816         * Integer property that specifes the background color for captions as a
3817         * packed 32-bit color.
3818         *
3819         * @see android.graphics.Color#argb
3820         * @hide
3821         */
3822        public static final String ACCESSIBILITY_CAPTIONING_BACKGROUND_COLOR =
3823                "accessibility_captioning_background_color";
3824
3825        /**
3826         * Integer property that specifes the foreground color for captions as a
3827         * packed 32-bit color.
3828         *
3829         * @see android.graphics.Color#argb
3830         * @hide
3831         */
3832        public static final String ACCESSIBILITY_CAPTIONING_FOREGROUND_COLOR =
3833                "accessibility_captioning_foreground_color";
3834
3835        /**
3836         * Integer property that specifes the edge type for captions, one of:
3837         * <ul>
3838         * <li>{@link android.view.accessibility.CaptioningManager.CaptionStyle#EDGE_TYPE_NONE}
3839         * <li>{@link android.view.accessibility.CaptioningManager.CaptionStyle#EDGE_TYPE_OUTLINE}
3840         * <li>{@link android.view.accessibility.CaptioningManager.CaptionStyle#EDGE_TYPE_DROP_SHADOW}
3841         * </ul>
3842         *
3843         * @see #ACCESSIBILITY_CAPTIONING_EDGE_COLOR
3844         * @hide
3845         */
3846        public static final String ACCESSIBILITY_CAPTIONING_EDGE_TYPE =
3847                "accessibility_captioning_edge_type";
3848
3849        /**
3850         * Integer property that specifes the edge color for captions as a
3851         * packed 32-bit color.
3852         *
3853         * @see #ACCESSIBILITY_CAPTIONING_EDGE_TYPE
3854         * @see android.graphics.Color#argb
3855         * @hide
3856         */
3857        public static final String ACCESSIBILITY_CAPTIONING_EDGE_COLOR =
3858                "accessibility_captioning_edge_color";
3859
3860        /**
3861         * Integer property that specifes the window color for captions as a
3862         * packed 32-bit color.
3863         *
3864         * @see android.graphics.Color#argb
3865         * @hide
3866         */
3867        public static final String ACCESSIBILITY_CAPTIONING_WINDOW_COLOR =
3868                "accessibility_captioning_window_color";
3869
3870        /**
3871         * String property that specifies the typeface for captions, one of:
3872         * <ul>
3873         * <li>DEFAULT
3874         * <li>MONOSPACE
3875         * <li>SANS_SERIF
3876         * <li>SERIF
3877         * </ul>
3878         *
3879         * @see android.graphics.Typeface
3880         * @hide
3881         */
3882        public static final String ACCESSIBILITY_CAPTIONING_TYPEFACE =
3883                "accessibility_captioning_typeface";
3884
3885        /**
3886         * Floating point property that specifies font scaling for captions.
3887         *
3888         * @hide
3889         */
3890        public static final String ACCESSIBILITY_CAPTIONING_FONT_SCALE =
3891                "accessibility_captioning_font_scale";
3892
3893        /**
3894         * Setting that specifies whether the quick setting tile for display
3895         * color inversion is enabled.
3896         *
3897         * @hide
3898         */
3899        public static final String ACCESSIBILITY_DISPLAY_INVERSION_QUICK_SETTING_ENABLED =
3900                "accessibility_display_inversion_quick_setting_enabled";
3901
3902        /**
3903         * Setting that specifies whether display color inversion is enabled.
3904         */
3905        public static final String ACCESSIBILITY_DISPLAY_INVERSION_ENABLED =
3906                "accessibility_display_inversion_enabled";
3907
3908        /**
3909         * Setting that specifies whether the quick setting tile for display
3910         * color space adjustment is enabled.
3911         *
3912         * @hide
3913         */
3914        public static final String ACCESSIBILITY_DISPLAY_DALTONIZER_QUICK_SETTING_ENABLED =
3915                "accessibility_display_daltonizer_quick_setting_enabled";
3916
3917        /**
3918         * Setting that specifies whether display color space adjustment is
3919         * enabled.
3920         *
3921         * @hide
3922         */
3923        public static final String ACCESSIBILITY_DISPLAY_DALTONIZER_ENABLED =
3924                "accessibility_display_daltonizer_enabled";
3925
3926        /**
3927         * Integer property that specifies the type of color space adjustment to
3928         * perform. Valid values are defined in AccessibilityManager.
3929         *
3930         * @hide
3931         */
3932        public static final String ACCESSIBILITY_DISPLAY_DALTONIZER =
3933                "accessibility_display_daltonizer";
3934
3935        /**
3936         * The timout for considering a press to be a long press in milliseconds.
3937         * @hide
3938         */
3939        public static final String LONG_PRESS_TIMEOUT = "long_press_timeout";
3940
3941        /**
3942         * List of the enabled print services.
3943         * @hide
3944         */
3945        public static final String ENABLED_PRINT_SERVICES =
3946            "enabled_print_services";
3947
3948        /**
3949         * List of the system print services we enabled on first boot. On
3950         * first boot we enable all system, i.e. bundled print services,
3951         * once, so they work out-of-the-box.
3952         * @hide
3953         */
3954        public static final String ENABLED_ON_FIRST_BOOT_SYSTEM_PRINT_SERVICES =
3955            "enabled_on_first_boot_system_print_services";
3956
3957        /**
3958         * Setting to always use the default text-to-speech settings regardless
3959         * of the application settings.
3960         * 1 = override application settings,
3961         * 0 = use application settings (if specified).
3962         *
3963         * @deprecated  The value of this setting is no longer respected by
3964         * the framework text to speech APIs as of the Ice Cream Sandwich release.
3965         */
3966        @Deprecated
3967        public static final String TTS_USE_DEFAULTS = "tts_use_defaults";
3968
3969        /**
3970         * Default text-to-speech engine speech rate. 100 = 1x
3971         */
3972        public static final String TTS_DEFAULT_RATE = "tts_default_rate";
3973
3974        /**
3975         * Default text-to-speech engine pitch. 100 = 1x
3976         */
3977        public static final String TTS_DEFAULT_PITCH = "tts_default_pitch";
3978
3979        /**
3980         * Default text-to-speech engine.
3981         */
3982        public static final String TTS_DEFAULT_SYNTH = "tts_default_synth";
3983
3984        /**
3985         * Default text-to-speech language.
3986         *
3987         * @deprecated this setting is no longer in use, as of the Ice Cream
3988         * Sandwich release. Apps should never need to read this setting directly,
3989         * instead can query the TextToSpeech framework classes for the default
3990         * locale. {@link TextToSpeech#getLanguage()}.
3991         */
3992        @Deprecated
3993        public static final String TTS_DEFAULT_LANG = "tts_default_lang";
3994
3995        /**
3996         * Default text-to-speech country.
3997         *
3998         * @deprecated this setting is no longer in use, as of the Ice Cream
3999         * Sandwich release. Apps should never need to read this setting directly,
4000         * instead can query the TextToSpeech framework classes for the default
4001         * locale. {@link TextToSpeech#getLanguage()}.
4002         */
4003        @Deprecated
4004        public static final String TTS_DEFAULT_COUNTRY = "tts_default_country";
4005
4006        /**
4007         * Default text-to-speech locale variant.
4008         *
4009         * @deprecated this setting is no longer in use, as of the Ice Cream
4010         * Sandwich release. Apps should never need to read this setting directly,
4011         * instead can query the TextToSpeech framework classes for the
4012         * locale that is in use {@link TextToSpeech#getLanguage()}.
4013         */
4014        @Deprecated
4015        public static final String TTS_DEFAULT_VARIANT = "tts_default_variant";
4016
4017        /**
4018         * Stores the default tts locales on a per engine basis. Stored as
4019         * a comma seperated list of values, each value being of the form
4020         * {@code engine_name:locale} for example,
4021         * {@code com.foo.ttsengine:eng-USA,com.bar.ttsengine:esp-ESP}. This
4022         * supersedes {@link #TTS_DEFAULT_LANG}, {@link #TTS_DEFAULT_COUNTRY} and
4023         * {@link #TTS_DEFAULT_VARIANT}. Apps should never need to read this
4024         * setting directly, and can query the TextToSpeech framework classes
4025         * for the locale that is in use.
4026         *
4027         * @hide
4028         */
4029        public static final String TTS_DEFAULT_LOCALE = "tts_default_locale";
4030
4031        /**
4032         * Space delimited list of plugin packages that are enabled.
4033         */
4034        public static final String TTS_ENABLED_PLUGINS = "tts_enabled_plugins";
4035
4036        /**
4037         * @deprecated Use {@link android.provider.Settings.Global#WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON}
4038         * instead.
4039         */
4040        @Deprecated
4041        public static final String WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON =
4042                Global.WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON;
4043
4044        /**
4045         * @deprecated Use {@link android.provider.Settings.Global#WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY}
4046         * instead.
4047         */
4048        @Deprecated
4049        public static final String WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY =
4050                Global.WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY;
4051
4052        /**
4053         * @deprecated Use {@link android.provider.Settings.Global#WIFI_NUM_OPEN_NETWORKS_KEPT}
4054         * instead.
4055         */
4056        @Deprecated
4057        public static final String WIFI_NUM_OPEN_NETWORKS_KEPT =
4058                Global.WIFI_NUM_OPEN_NETWORKS_KEPT;
4059
4060        /**
4061         * @deprecated Use {@link android.provider.Settings.Global#WIFI_ON}
4062         * instead.
4063         */
4064        @Deprecated
4065        public static final String WIFI_ON = Global.WIFI_ON;
4066
4067        /**
4068         * The acceptable packet loss percentage (range 0 - 100) before trying
4069         * another AP on the same network.
4070         * @deprecated This setting is not used.
4071         */
4072        @Deprecated
4073        public static final String WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE =
4074                "wifi_watchdog_acceptable_packet_loss_percentage";
4075
4076        /**
4077         * The number of access points required for a network in order for the
4078         * watchdog to monitor it.
4079         * @deprecated This setting is not used.
4080         */
4081        @Deprecated
4082        public static final String WIFI_WATCHDOG_AP_COUNT = "wifi_watchdog_ap_count";
4083
4084        /**
4085         * The delay between background checks.
4086         * @deprecated This setting is not used.
4087         */
4088        @Deprecated
4089        public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS =
4090                "wifi_watchdog_background_check_delay_ms";
4091
4092        /**
4093         * Whether the Wi-Fi watchdog is enabled for background checking even
4094         * after it thinks the user has connected to a good access point.
4095         * @deprecated This setting is not used.
4096         */
4097        @Deprecated
4098        public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED =
4099                "wifi_watchdog_background_check_enabled";
4100
4101        /**
4102         * The timeout for a background ping
4103         * @deprecated This setting is not used.
4104         */
4105        @Deprecated
4106        public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS =
4107                "wifi_watchdog_background_check_timeout_ms";
4108
4109        /**
4110         * The number of initial pings to perform that *may* be ignored if they
4111         * fail. Again, if these fail, they will *not* be used in packet loss
4112         * calculation. For example, one network always seemed to time out for
4113         * the first couple pings, so this is set to 3 by default.
4114         * @deprecated This setting is not used.
4115         */
4116        @Deprecated
4117        public static final String WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT =
4118            "wifi_watchdog_initial_ignored_ping_count";
4119
4120        /**
4121         * The maximum number of access points (per network) to attempt to test.
4122         * If this number is reached, the watchdog will no longer monitor the
4123         * initial connection state for the network. This is a safeguard for
4124         * networks containing multiple APs whose DNS does not respond to pings.
4125         * @deprecated This setting is not used.
4126         */
4127        @Deprecated
4128        public static final String WIFI_WATCHDOG_MAX_AP_CHECKS = "wifi_watchdog_max_ap_checks";
4129
4130        /**
4131         * @deprecated Use {@link android.provider.Settings.Global#WIFI_WATCHDOG_ON} instead
4132         */
4133        @Deprecated
4134        public static final String WIFI_WATCHDOG_ON = "wifi_watchdog_on";
4135
4136        /**
4137         * A comma-separated list of SSIDs for which the Wi-Fi watchdog should be enabled.
4138         * @deprecated This setting is not used.
4139         */
4140        @Deprecated
4141        public static final String WIFI_WATCHDOG_WATCH_LIST = "wifi_watchdog_watch_list";
4142
4143        /**
4144         * The number of pings to test if an access point is a good connection.
4145         * @deprecated This setting is not used.
4146         */
4147        @Deprecated
4148        public static final String WIFI_WATCHDOG_PING_COUNT = "wifi_watchdog_ping_count";
4149
4150        /**
4151         * The delay between pings.
4152         * @deprecated This setting is not used.
4153         */
4154        @Deprecated
4155        public static final String WIFI_WATCHDOG_PING_DELAY_MS = "wifi_watchdog_ping_delay_ms";
4156
4157        /**
4158         * The timeout per ping.
4159         * @deprecated This setting is not used.
4160         */
4161        @Deprecated
4162        public static final String WIFI_WATCHDOG_PING_TIMEOUT_MS = "wifi_watchdog_ping_timeout_ms";
4163
4164        /**
4165         * @deprecated Use
4166         * {@link android.provider.Settings.Global#WIFI_MAX_DHCP_RETRY_COUNT} instead
4167         */
4168        @Deprecated
4169        public static final String WIFI_MAX_DHCP_RETRY_COUNT = Global.WIFI_MAX_DHCP_RETRY_COUNT;
4170
4171        /**
4172         * @deprecated Use
4173         * {@link android.provider.Settings.Global#WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS} instead
4174         */
4175        @Deprecated
4176        public static final String WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS =
4177                Global.WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS;
4178
4179        /**
4180         * Whether background data usage is allowed.
4181         *
4182         * @deprecated As of {@link VERSION_CODES#ICE_CREAM_SANDWICH},
4183         *             availability of background data depends on several
4184         *             combined factors. When background data is unavailable,
4185         *             {@link ConnectivityManager#getActiveNetworkInfo()} will
4186         *             now appear disconnected.
4187         */
4188        @Deprecated
4189        public static final String BACKGROUND_DATA = "background_data";
4190
4191        /**
4192         * Origins for which browsers should allow geolocation by default.
4193         * The value is a space-separated list of origins.
4194         */
4195        public static final String ALLOWED_GEOLOCATION_ORIGINS
4196                = "allowed_geolocation_origins";
4197
4198        /**
4199         * The preferred TTY mode     0 = TTy Off, CDMA default
4200         *                            1 = TTY Full
4201         *                            2 = TTY HCO
4202         *                            3 = TTY VCO
4203         * @hide
4204         */
4205        public static final String PREFERRED_TTY_MODE =
4206                "preferred_tty_mode";
4207
4208        /**
4209         * Whether the enhanced voice privacy mode is enabled.
4210         * 0 = normal voice privacy
4211         * 1 = enhanced voice privacy
4212         * @hide
4213         */
4214        public static final String ENHANCED_VOICE_PRIVACY_ENABLED = "enhanced_voice_privacy_enabled";
4215
4216        /**
4217         * Whether the TTY mode mode is enabled.
4218         * 0 = disabled
4219         * 1 = enabled
4220         * @hide
4221         */
4222        public static final String TTY_MODE_ENABLED = "tty_mode_enabled";
4223
4224        /**
4225         * Controls whether settings backup is enabled.
4226         * Type: int ( 0 = disabled, 1 = enabled )
4227         * @hide
4228         */
4229        public static final String BACKUP_ENABLED = "backup_enabled";
4230
4231        /**
4232         * Controls whether application data is automatically restored from backup
4233         * at install time.
4234         * Type: int ( 0 = disabled, 1 = enabled )
4235         * @hide
4236         */
4237        public static final String BACKUP_AUTO_RESTORE = "backup_auto_restore";
4238
4239        /**
4240         * Indicates whether settings backup has been fully provisioned.
4241         * Type: int ( 0 = unprovisioned, 1 = fully provisioned )
4242         * @hide
4243         */
4244        public static final String BACKUP_PROVISIONED = "backup_provisioned";
4245
4246        /**
4247         * Component of the transport to use for backup/restore.
4248         * @hide
4249         */
4250        public static final String BACKUP_TRANSPORT = "backup_transport";
4251
4252        /**
4253         * Version for which the setup wizard was last shown.  Bumped for
4254         * each release when there is new setup information to show.
4255         * @hide
4256         */
4257        public static final String LAST_SETUP_SHOWN = "last_setup_shown";
4258
4259        /**
4260         * The interval in milliseconds after which Wi-Fi is considered idle.
4261         * When idle, it is possible for the device to be switched from Wi-Fi to
4262         * the mobile data network.
4263         * @hide
4264         * @deprecated Use {@link android.provider.Settings.Global#WIFI_IDLE_MS}
4265         * instead.
4266         */
4267        @Deprecated
4268        public static final String WIFI_IDLE_MS = Global.WIFI_IDLE_MS;
4269
4270        /**
4271         * The global search provider chosen by the user (if multiple global
4272         * search providers are installed). This will be the provider returned
4273         * by {@link SearchManager#getGlobalSearchActivity()} if it's still
4274         * installed. This setting is stored as a flattened component name as
4275         * per {@link ComponentName#flattenToString()}.
4276         *
4277         * @hide
4278         */
4279        public static final String SEARCH_GLOBAL_SEARCH_ACTIVITY =
4280                "search_global_search_activity";
4281
4282        /**
4283         * The number of promoted sources in GlobalSearch.
4284         * @hide
4285         */
4286        public static final String SEARCH_NUM_PROMOTED_SOURCES = "search_num_promoted_sources";
4287        /**
4288         * The maximum number of suggestions returned by GlobalSearch.
4289         * @hide
4290         */
4291        public static final String SEARCH_MAX_RESULTS_TO_DISPLAY = "search_max_results_to_display";
4292        /**
4293         * The number of suggestions GlobalSearch will ask each non-web search source for.
4294         * @hide
4295         */
4296        public static final String SEARCH_MAX_RESULTS_PER_SOURCE = "search_max_results_per_source";
4297        /**
4298         * The number of suggestions the GlobalSearch will ask the web search source for.
4299         * @hide
4300         */
4301        public static final String SEARCH_WEB_RESULTS_OVERRIDE_LIMIT =
4302                "search_web_results_override_limit";
4303        /**
4304         * The number of milliseconds that GlobalSearch will wait for suggestions from
4305         * promoted sources before continuing with all other sources.
4306         * @hide
4307         */
4308        public static final String SEARCH_PROMOTED_SOURCE_DEADLINE_MILLIS =
4309                "search_promoted_source_deadline_millis";
4310        /**
4311         * The number of milliseconds before GlobalSearch aborts search suggesiton queries.
4312         * @hide
4313         */
4314        public static final String SEARCH_SOURCE_TIMEOUT_MILLIS = "search_source_timeout_millis";
4315        /**
4316         * The maximum number of milliseconds that GlobalSearch shows the previous results
4317         * after receiving a new query.
4318         * @hide
4319         */
4320        public static final String SEARCH_PREFILL_MILLIS = "search_prefill_millis";
4321        /**
4322         * The maximum age of log data used for shortcuts in GlobalSearch.
4323         * @hide
4324         */
4325        public static final String SEARCH_MAX_STAT_AGE_MILLIS = "search_max_stat_age_millis";
4326        /**
4327         * The maximum age of log data used for source ranking in GlobalSearch.
4328         * @hide
4329         */
4330        public static final String SEARCH_MAX_SOURCE_EVENT_AGE_MILLIS =
4331                "search_max_source_event_age_millis";
4332        /**
4333         * The minimum number of impressions needed to rank a source in GlobalSearch.
4334         * @hide
4335         */
4336        public static final String SEARCH_MIN_IMPRESSIONS_FOR_SOURCE_RANKING =
4337                "search_min_impressions_for_source_ranking";
4338        /**
4339         * The minimum number of clicks needed to rank a source in GlobalSearch.
4340         * @hide
4341         */
4342        public static final String SEARCH_MIN_CLICKS_FOR_SOURCE_RANKING =
4343                "search_min_clicks_for_source_ranking";
4344        /**
4345         * The maximum number of shortcuts shown by GlobalSearch.
4346         * @hide
4347         */
4348        public static final String SEARCH_MAX_SHORTCUTS_RETURNED = "search_max_shortcuts_returned";
4349        /**
4350         * The size of the core thread pool for suggestion queries in GlobalSearch.
4351         * @hide
4352         */
4353        public static final String SEARCH_QUERY_THREAD_CORE_POOL_SIZE =
4354                "search_query_thread_core_pool_size";
4355        /**
4356         * The maximum size of the thread pool for suggestion queries in GlobalSearch.
4357         * @hide
4358         */
4359        public static final String SEARCH_QUERY_THREAD_MAX_POOL_SIZE =
4360                "search_query_thread_max_pool_size";
4361        /**
4362         * The size of the core thread pool for shortcut refreshing in GlobalSearch.
4363         * @hide
4364         */
4365        public static final String SEARCH_SHORTCUT_REFRESH_CORE_POOL_SIZE =
4366                "search_shortcut_refresh_core_pool_size";
4367        /**
4368         * The maximum size of the thread pool for shortcut refreshing in GlobalSearch.
4369         * @hide
4370         */
4371        public static final String SEARCH_SHORTCUT_REFRESH_MAX_POOL_SIZE =
4372                "search_shortcut_refresh_max_pool_size";
4373        /**
4374         * The maximun time that excess threads in the GlobalSeach thread pools will
4375         * wait before terminating.
4376         * @hide
4377         */
4378        public static final String SEARCH_THREAD_KEEPALIVE_SECONDS =
4379                "search_thread_keepalive_seconds";
4380        /**
4381         * The maximum number of concurrent suggestion queries to each source.
4382         * @hide
4383         */
4384        public static final String SEARCH_PER_SOURCE_CONCURRENT_QUERY_LIMIT =
4385                "search_per_source_concurrent_query_limit";
4386
4387        /**
4388         * Whether or not alert sounds are played on MountService events. (0 = false, 1 = true)
4389         * @hide
4390         */
4391        public static final String MOUNT_PLAY_NOTIFICATION_SND = "mount_play_not_snd";
4392
4393        /**
4394         * Whether or not UMS auto-starts on UMS host detection. (0 = false, 1 = true)
4395         * @hide
4396         */
4397        public static final String MOUNT_UMS_AUTOSTART = "mount_ums_autostart";
4398
4399        /**
4400         * Whether or not a notification is displayed on UMS host detection. (0 = false, 1 = true)
4401         * @hide
4402         */
4403        public static final String MOUNT_UMS_PROMPT = "mount_ums_prompt";
4404
4405        /**
4406         * Whether or not a notification is displayed while UMS is enabled. (0 = false, 1 = true)
4407         * @hide
4408         */
4409        public static final String MOUNT_UMS_NOTIFY_ENABLED = "mount_ums_notify_enabled";
4410
4411        /**
4412         * If nonzero, ANRs in invisible background processes bring up a dialog.
4413         * Otherwise, the process will be silently killed.
4414         * @hide
4415         */
4416        public static final String ANR_SHOW_BACKGROUND = "anr_show_background";
4417
4418        /**
4419         * (Experimental). If nonzero, WebView uses data reduction proxy to save network
4420         * bandwidth. Otherwise, WebView does not use data reduction proxy.
4421         * @hide
4422         */
4423        public static final String WEBVIEW_DATA_REDUCTION_PROXY = "webview_data_reduction_proxy";
4424
4425        /**
4426         * The {@link ComponentName} string of the service to be used as the voice recognition
4427         * service.
4428         *
4429         * @hide
4430         */
4431        public static final String VOICE_RECOGNITION_SERVICE = "voice_recognition_service";
4432
4433        /**
4434         * Stores whether an user has consented to have apps verified through PAM.
4435         * The value is boolean (1 or 0).
4436         *
4437         * @hide
4438         */
4439        public static final String PACKAGE_VERIFIER_USER_CONSENT =
4440            "package_verifier_user_consent";
4441
4442        /**
4443         * The {@link ComponentName} string of the selected spell checker service which is
4444         * one of the services managed by the text service manager.
4445         *
4446         * @hide
4447         */
4448        public static final String SELECTED_SPELL_CHECKER = "selected_spell_checker";
4449
4450        /**
4451         * The {@link ComponentName} string of the selected subtype of the selected spell checker
4452         * service which is one of the services managed by the text service manager.
4453         *
4454         * @hide
4455         */
4456        public static final String SELECTED_SPELL_CHECKER_SUBTYPE =
4457                "selected_spell_checker_subtype";
4458
4459        /**
4460         * The {@link ComponentName} string whether spell checker is enabled or not.
4461         *
4462         * @hide
4463         */
4464        public static final String SPELL_CHECKER_ENABLED = "spell_checker_enabled";
4465
4466        /**
4467         * What happens when the user presses the Power button while in-call
4468         * and the screen is on.<br/>
4469         * <b>Values:</b><br/>
4470         * 1 - The Power button turns off the screen and locks the device. (Default behavior)<br/>
4471         * 2 - The Power button hangs up the current call.<br/>
4472         *
4473         * @hide
4474         */
4475        public static final String INCALL_POWER_BUTTON_BEHAVIOR = "incall_power_button_behavior";
4476
4477        /**
4478         * INCALL_POWER_BUTTON_BEHAVIOR value for "turn off screen".
4479         * @hide
4480         */
4481        public static final int INCALL_POWER_BUTTON_BEHAVIOR_SCREEN_OFF = 0x1;
4482
4483        /**
4484         * INCALL_POWER_BUTTON_BEHAVIOR value for "hang up".
4485         * @hide
4486         */
4487        public static final int INCALL_POWER_BUTTON_BEHAVIOR_HANGUP = 0x2;
4488
4489        /**
4490         * INCALL_POWER_BUTTON_BEHAVIOR default value.
4491         * @hide
4492         */
4493        public static final int INCALL_POWER_BUTTON_BEHAVIOR_DEFAULT =
4494                INCALL_POWER_BUTTON_BEHAVIOR_SCREEN_OFF;
4495
4496        /**
4497         * Whether the device should wake when the wake gesture sensor detects motion.
4498         * @hide
4499         */
4500        public static final String WAKE_GESTURE_ENABLED = "wake_gesture_enabled";
4501
4502        /**
4503         * The current night mode that has been selected by the user.  Owned
4504         * and controlled by UiModeManagerService.  Constants are as per
4505         * UiModeManager.
4506         * @hide
4507         */
4508        public static final String UI_NIGHT_MODE = "ui_night_mode";
4509
4510        /**
4511         * Whether screensavers are enabled.
4512         * @hide
4513         */
4514        public static final String SCREENSAVER_ENABLED = "screensaver_enabled";
4515
4516        /**
4517         * The user's chosen screensaver components.
4518         *
4519         * These will be launched by the PhoneWindowManager after a timeout when not on
4520         * battery, or upon dock insertion (if SCREENSAVER_ACTIVATE_ON_DOCK is set to 1).
4521         * @hide
4522         */
4523        public static final String SCREENSAVER_COMPONENTS = "screensaver_components";
4524
4525        /**
4526         * If screensavers are enabled, whether the screensaver should be automatically launched
4527         * when the device is inserted into a (desk) dock.
4528         * @hide
4529         */
4530        public static final String SCREENSAVER_ACTIVATE_ON_DOCK = "screensaver_activate_on_dock";
4531
4532        /**
4533         * If screensavers are enabled, whether the screensaver should be automatically launched
4534         * when the screen times out when not on battery.
4535         * @hide
4536         */
4537        public static final String SCREENSAVER_ACTIVATE_ON_SLEEP = "screensaver_activate_on_sleep";
4538
4539        /**
4540         * If screensavers are enabled, the default screensaver component.
4541         * @hide
4542         */
4543        public static final String SCREENSAVER_DEFAULT_COMPONENT = "screensaver_default_component";
4544
4545        /**
4546         * The default NFC payment component
4547         * @hide
4548         */
4549        public static final String NFC_PAYMENT_DEFAULT_COMPONENT = "nfc_payment_default_component";
4550
4551        /**
4552         * Whether NFC payment is handled by the foreground application or a default.
4553         * @hide
4554         */
4555        public static final String NFC_PAYMENT_FOREGROUND = "nfc_payment_foreground";
4556
4557        /**
4558         * Specifies the package name currently configured to be the primary sms application
4559         * @hide
4560         */
4561        public static final String SMS_DEFAULT_APPLICATION = "sms_default_application";
4562
4563        /**
4564         * Name of a package that the current user has explicitly allowed to see all of that
4565         * user's notifications.
4566         *
4567         * @hide
4568         */
4569        public static final String ENABLED_NOTIFICATION_LISTENERS = "enabled_notification_listeners";
4570
4571        /**
4572         * @hide
4573         */
4574        public static final String ENABLED_CONDITION_PROVIDERS = "enabled_condition_providers";
4575
4576        /** @hide */
4577        public static final String BAR_SERVICE_COMPONENT = "bar_service_component";
4578
4579        /** @hide */
4580        public static final String IMMERSIVE_MODE_CONFIRMATIONS = "immersive_mode_confirmations";
4581
4582        /**
4583         * This is the query URI for finding a print service to install.
4584         *
4585         * @hide
4586         */
4587        public static final String PRINT_SERVICE_SEARCH_URI = "print_service_search_uri";
4588
4589        /**
4590         * This is the query URI for finding a NFC payment service to install.
4591         *
4592         * @hide
4593         */
4594        public static final String PAYMENT_SERVICE_SEARCH_URI = "payment_service_search_uri";
4595
4596        /**
4597         * If enabled, apps should try to skip any introductory hints on first launch. This might
4598         * apply to users that are already familiar with the environment or temporary users.
4599         * <p>
4600         * Type : int (0 to show hints, 1 to skip showing hints)
4601         */
4602        public static final String SKIP_FIRST_USE_HINTS = "skip_first_use_hints";
4603
4604        /**
4605         * This are the settings to be backed up.
4606         *
4607         * NOTE: Settings are backed up and restored in the order they appear
4608         *       in this array. If you have one setting depending on another,
4609         *       make sure that they are ordered appropriately.
4610         *
4611         * @hide
4612         */
4613        public static final String[] SETTINGS_TO_BACKUP = {
4614            BUGREPORT_IN_POWER_MENU,                            // moved to global
4615            ALLOW_MOCK_LOCATION,
4616            PARENTAL_CONTROL_ENABLED,
4617            PARENTAL_CONTROL_REDIRECT_URL,
4618            USB_MASS_STORAGE_ENABLED,                           // moved to global
4619            ACCESSIBILITY_DISPLAY_MAGNIFICATION_ENABLED,
4620            ACCESSIBILITY_DISPLAY_MAGNIFICATION_SCALE,
4621            ACCESSIBILITY_DISPLAY_MAGNIFICATION_AUTO_UPDATE,
4622            ACCESSIBILITY_SCRIPT_INJECTION,
4623            BACKUP_AUTO_RESTORE,
4624            ENABLED_ACCESSIBILITY_SERVICES,
4625            TOUCH_EXPLORATION_GRANTED_ACCESSIBILITY_SERVICES,
4626            TOUCH_EXPLORATION_ENABLED,
4627            ACCESSIBILITY_ENABLED,
4628            ACCESSIBILITY_SPEAK_PASSWORD,
4629            ACCESSIBILITY_CAPTIONING_ENABLED,
4630            ACCESSIBILITY_CAPTIONING_LOCALE,
4631            ACCESSIBILITY_CAPTIONING_BACKGROUND_COLOR,
4632            ACCESSIBILITY_CAPTIONING_FOREGROUND_COLOR,
4633            ACCESSIBILITY_CAPTIONING_EDGE_TYPE,
4634            ACCESSIBILITY_CAPTIONING_EDGE_COLOR,
4635            ACCESSIBILITY_CAPTIONING_TYPEFACE,
4636            ACCESSIBILITY_CAPTIONING_FONT_SCALE,
4637            TTS_USE_DEFAULTS,
4638            TTS_DEFAULT_RATE,
4639            TTS_DEFAULT_PITCH,
4640            TTS_DEFAULT_SYNTH,
4641            TTS_DEFAULT_LANG,
4642            TTS_DEFAULT_COUNTRY,
4643            TTS_ENABLED_PLUGINS,
4644            TTS_DEFAULT_LOCALE,
4645            WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON,            // moved to global
4646            WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY,               // moved to global
4647            WIFI_NUM_OPEN_NETWORKS_KEPT,                        // moved to global
4648            MOUNT_PLAY_NOTIFICATION_SND,
4649            MOUNT_UMS_AUTOSTART,
4650            MOUNT_UMS_PROMPT,
4651            MOUNT_UMS_NOTIFY_ENABLED,
4652            UI_NIGHT_MODE
4653        };
4654
4655        /**
4656         * Helper method for determining if a location provider is enabled.
4657         *
4658         * @param cr the content resolver to use
4659         * @param provider the location provider to query
4660         * @return true if the provider is enabled
4661         *
4662         * @deprecated use {@link #LOCATION_MODE} or
4663         *             {@link LocationManager#isProviderEnabled(String)}
4664         */
4665        @Deprecated
4666        public static final boolean isLocationProviderEnabled(ContentResolver cr, String provider) {
4667            return isLocationProviderEnabledForUser(cr, provider, UserHandle.myUserId());
4668        }
4669
4670        /**
4671         * Helper method for determining if a location provider is enabled.
4672         * @param cr the content resolver to use
4673         * @param provider the location provider to query
4674         * @param userId the userId to query
4675         * @return true if the provider is enabled
4676         * @deprecated use {@link #LOCATION_MODE} or
4677         *             {@link LocationManager#isProviderEnabled(String)}
4678         * @hide
4679         */
4680        @Deprecated
4681        public static final boolean isLocationProviderEnabledForUser(ContentResolver cr, String provider, int userId) {
4682            String allowedProviders = Settings.Secure.getStringForUser(cr,
4683                    LOCATION_PROVIDERS_ALLOWED, userId);
4684            return TextUtils.delimitedStringContains(allowedProviders, ',', provider);
4685        }
4686
4687        /**
4688         * Thread-safe method for enabling or disabling a single location provider.
4689         * @param cr the content resolver to use
4690         * @param provider the location provider to enable or disable
4691         * @param enabled true if the provider should be enabled
4692         * @deprecated use {@link #putInt(ContentResolver, String, int)} and {@link #LOCATION_MODE}
4693         */
4694        @Deprecated
4695        public static final void setLocationProviderEnabled(ContentResolver cr,
4696                String provider, boolean enabled) {
4697            setLocationProviderEnabledForUser(cr, provider, enabled, UserHandle.myUserId());
4698        }
4699
4700        /**
4701         * Thread-safe method for enabling or disabling a single location provider.
4702         *
4703         * @param cr the content resolver to use
4704         * @param provider the location provider to enable or disable
4705         * @param enabled true if the provider should be enabled
4706         * @param userId the userId for which to enable/disable providers
4707         * @return true if the value was set, false on database errors
4708         * @deprecated use {@link #putIntForUser(ContentResolver, String, int, int)} and
4709         *             {@link #LOCATION_MODE}
4710         * @hide
4711         */
4712        @Deprecated
4713        public static final boolean setLocationProviderEnabledForUser(ContentResolver cr,
4714                String provider, boolean enabled, int userId) {
4715            synchronized (mLocationSettingsLock) {
4716                // to ensure thread safety, we write the provider name with a '+' or '-'
4717                // and let the SettingsProvider handle it rather than reading and modifying
4718                // the list of enabled providers.
4719                if (enabled) {
4720                    provider = "+" + provider;
4721                } else {
4722                    provider = "-" + provider;
4723                }
4724                return putStringForUser(cr, Settings.Secure.LOCATION_PROVIDERS_ALLOWED, provider,
4725                        userId);
4726            }
4727        }
4728
4729        /**
4730         * Thread-safe method for setting the location mode to one of
4731         * {@link #LOCATION_MODE_HIGH_ACCURACY}, {@link #LOCATION_MODE_SENSORS_ONLY},
4732         * {@link #LOCATION_MODE_BATTERY_SAVING}, or {@link #LOCATION_MODE_OFF}.
4733         *
4734         * @param cr the content resolver to use
4735         * @param mode such as {@link #LOCATION_MODE_HIGH_ACCURACY}
4736         * @param userId the userId for which to change mode
4737         * @return true if the value was set, false on database errors
4738         *
4739         * @throws IllegalArgumentException if mode is not one of the supported values
4740         */
4741        private static final boolean setLocationModeForUser(ContentResolver cr, int mode,
4742                int userId) {
4743            synchronized (mLocationSettingsLock) {
4744                boolean gps = false;
4745                boolean network = false;
4746                switch (mode) {
4747                    case LOCATION_MODE_OFF:
4748                        break;
4749                    case LOCATION_MODE_SENSORS_ONLY:
4750                        gps = true;
4751                        break;
4752                    case LOCATION_MODE_BATTERY_SAVING:
4753                        network = true;
4754                        break;
4755                    case LOCATION_MODE_HIGH_ACCURACY:
4756                        gps = true;
4757                        network = true;
4758                        break;
4759                    default:
4760                        throw new IllegalArgumentException("Invalid location mode: " + mode);
4761                }
4762                boolean gpsSuccess = Settings.Secure.setLocationProviderEnabledForUser(
4763                        cr, LocationManager.GPS_PROVIDER, gps, userId);
4764                boolean nlpSuccess = Settings.Secure.setLocationProviderEnabledForUser(
4765                        cr, LocationManager.NETWORK_PROVIDER, network, userId);
4766                return gpsSuccess && nlpSuccess;
4767            }
4768        }
4769
4770        /**
4771         * Thread-safe method for reading the location mode, returns one of
4772         * {@link #LOCATION_MODE_HIGH_ACCURACY}, {@link #LOCATION_MODE_SENSORS_ONLY},
4773         * {@link #LOCATION_MODE_BATTERY_SAVING}, or {@link #LOCATION_MODE_OFF}.
4774         *
4775         * @param cr the content resolver to use
4776         * @param userId the userId for which to read the mode
4777         * @return the location mode
4778         */
4779        private static final int getLocationModeForUser(ContentResolver cr, int userId) {
4780            synchronized (mLocationSettingsLock) {
4781                boolean gpsEnabled = Settings.Secure.isLocationProviderEnabledForUser(
4782                        cr, LocationManager.GPS_PROVIDER, userId);
4783                boolean networkEnabled = Settings.Secure.isLocationProviderEnabledForUser(
4784                        cr, LocationManager.NETWORK_PROVIDER, userId);
4785                if (gpsEnabled && networkEnabled) {
4786                    return LOCATION_MODE_HIGH_ACCURACY;
4787                } else if (gpsEnabled) {
4788                    return LOCATION_MODE_SENSORS_ONLY;
4789                } else if (networkEnabled) {
4790                    return LOCATION_MODE_BATTERY_SAVING;
4791                } else {
4792                    return LOCATION_MODE_OFF;
4793                }
4794            }
4795        }
4796    }
4797
4798    /**
4799     * Global system settings, containing preferences that always apply identically
4800     * to all defined users.  Applications can read these but are not allowed to write;
4801     * like the "Secure" settings, these are for preferences that the user must
4802     * explicitly modify through the system UI or specialized APIs for those values.
4803     */
4804    public static final class Global extends NameValueTable {
4805        public static final String SYS_PROP_SETTING_VERSION = "sys.settings_global_version";
4806
4807        /**
4808         * The content:// style URL for global secure settings items.  Not public.
4809         */
4810        public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/global");
4811
4812        /**
4813         * Setting whether the global gesture for enabling accessibility is enabled.
4814         * If this gesture is enabled the user will be able to perfrom it to enable
4815         * the accessibility state without visiting the settings app.
4816         * @hide
4817         */
4818        public static final String ENABLE_ACCESSIBILITY_GLOBAL_GESTURE_ENABLED =
4819                "enable_accessibility_global_gesture_enabled";
4820
4821        /**
4822         * Whether Airplane Mode is on.
4823         */
4824        public static final String AIRPLANE_MODE_ON = "airplane_mode_on";
4825
4826        /**
4827         * Constant for use in AIRPLANE_MODE_RADIOS to specify Bluetooth radio.
4828         */
4829        public static final String RADIO_BLUETOOTH = "bluetooth";
4830
4831        /**
4832         * Constant for use in AIRPLANE_MODE_RADIOS to specify Wi-Fi radio.
4833         */
4834        public static final String RADIO_WIFI = "wifi";
4835
4836        /**
4837         * {@hide}
4838         */
4839        public static final String RADIO_WIMAX = "wimax";
4840        /**
4841         * Constant for use in AIRPLANE_MODE_RADIOS to specify Cellular radio.
4842         */
4843        public static final String RADIO_CELL = "cell";
4844
4845        /**
4846         * Constant for use in AIRPLANE_MODE_RADIOS to specify NFC radio.
4847         */
4848        public static final String RADIO_NFC = "nfc";
4849
4850        /**
4851         * A comma separated list of radios that need to be disabled when airplane mode
4852         * is on. This overrides WIFI_ON and BLUETOOTH_ON, if Wi-Fi and bluetooth are
4853         * included in the comma separated list.
4854         */
4855        public static final String AIRPLANE_MODE_RADIOS = "airplane_mode_radios";
4856
4857        /**
4858         * A comma separated list of radios that should to be disabled when airplane mode
4859         * is on, but can be manually reenabled by the user.  For example, if RADIO_WIFI is
4860         * added to both AIRPLANE_MODE_RADIOS and AIRPLANE_MODE_TOGGLEABLE_RADIOS, then Wifi
4861         * will be turned off when entering airplane mode, but the user will be able to reenable
4862         * Wifi in the Settings app.
4863         *
4864         * {@hide}
4865         */
4866        public static final String AIRPLANE_MODE_TOGGLEABLE_RADIOS = "airplane_mode_toggleable_radios";
4867
4868        /**
4869         * The policy for deciding when Wi-Fi should go to sleep (which will in
4870         * turn switch to using the mobile data as an Internet connection).
4871         * <p>
4872         * Set to one of {@link #WIFI_SLEEP_POLICY_DEFAULT},
4873         * {@link #WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED}, or
4874         * {@link #WIFI_SLEEP_POLICY_NEVER}.
4875         */
4876        public static final String WIFI_SLEEP_POLICY = "wifi_sleep_policy";
4877
4878        /**
4879         * Value for {@link #WIFI_SLEEP_POLICY} to use the default Wi-Fi sleep
4880         * policy, which is to sleep shortly after the turning off
4881         * according to the {@link #STAY_ON_WHILE_PLUGGED_IN} setting.
4882         */
4883        public static final int WIFI_SLEEP_POLICY_DEFAULT = 0;
4884
4885        /**
4886         * Value for {@link #WIFI_SLEEP_POLICY} to use the default policy when
4887         * the device is on battery, and never go to sleep when the device is
4888         * plugged in.
4889         */
4890        public static final int WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED = 1;
4891
4892        /**
4893         * Value for {@link #WIFI_SLEEP_POLICY} to never go to sleep.
4894         */
4895        public static final int WIFI_SLEEP_POLICY_NEVER = 2;
4896
4897        /**
4898         * Value to specify if the user prefers the date, time and time zone
4899         * to be automatically fetched from the network (NITZ). 1=yes, 0=no
4900         */
4901        public static final String AUTO_TIME = "auto_time";
4902
4903        /**
4904         * Value to specify if the user prefers the time zone
4905         * to be automatically fetched from the network (NITZ). 1=yes, 0=no
4906         */
4907        public static final String AUTO_TIME_ZONE = "auto_time_zone";
4908
4909        /**
4910         * URI for the car dock "in" event sound.
4911         * @hide
4912         */
4913        public static final String CAR_DOCK_SOUND = "car_dock_sound";
4914
4915        /**
4916         * URI for the car dock "out" event sound.
4917         * @hide
4918         */
4919        public static final String CAR_UNDOCK_SOUND = "car_undock_sound";
4920
4921        /**
4922         * URI for the desk dock "in" event sound.
4923         * @hide
4924         */
4925        public static final String DESK_DOCK_SOUND = "desk_dock_sound";
4926
4927        /**
4928         * URI for the desk dock "out" event sound.
4929         * @hide
4930         */
4931        public static final String DESK_UNDOCK_SOUND = "desk_undock_sound";
4932
4933        /**
4934         * Whether to play a sound for dock events.
4935         * @hide
4936         */
4937        public static final String DOCK_SOUNDS_ENABLED = "dock_sounds_enabled";
4938
4939        /**
4940         * URI for the "device locked" (keyguard shown) sound.
4941         * @hide
4942         */
4943        public static final String LOCK_SOUND = "lock_sound";
4944
4945        /**
4946         * URI for the "device unlocked" sound.
4947         * @hide
4948         */
4949        public static final String UNLOCK_SOUND = "unlock_sound";
4950
4951        /**
4952         * URI for the low battery sound file.
4953         * @hide
4954         */
4955        public static final String LOW_BATTERY_SOUND = "low_battery_sound";
4956
4957        /**
4958         * Whether to play a sound for low-battery alerts.
4959         * @hide
4960         */
4961        public static final String POWER_SOUNDS_ENABLED = "power_sounds_enabled";
4962
4963        /**
4964         * URI for the "wireless charging started" sound.
4965         * @hide
4966         */
4967        public static final String WIRELESS_CHARGING_STARTED_SOUND =
4968                "wireless_charging_started_sound";
4969
4970        /**
4971         * Whether we keep the device on while the device is plugged in.
4972         * Supported values are:
4973         * <ul>
4974         * <li>{@code 0} to never stay on while plugged in</li>
4975         * <li>{@link BatteryManager#BATTERY_PLUGGED_AC} to stay on for AC charger</li>
4976         * <li>{@link BatteryManager#BATTERY_PLUGGED_USB} to stay on for USB charger</li>
4977         * <li>{@link BatteryManager#BATTERY_PLUGGED_WIRELESS} to stay on for wireless charger</li>
4978         * </ul>
4979         * These values can be OR-ed together.
4980         */
4981        public static final String STAY_ON_WHILE_PLUGGED_IN = "stay_on_while_plugged_in";
4982
4983        /**
4984         * When the user has enable the option to have a "bug report" command
4985         * in the power menu.
4986         * @hide
4987         */
4988        public static final String BUGREPORT_IN_POWER_MENU = "bugreport_in_power_menu";
4989
4990        /**
4991         * Whether ADB is enabled.
4992         */
4993        public static final String ADB_ENABLED = "adb_enabled";
4994
4995        /**
4996         * Whether assisted GPS should be enabled or not.
4997         * @hide
4998         */
4999        public static final String ASSISTED_GPS_ENABLED = "assisted_gps_enabled";
5000
5001        /**
5002         * Whether bluetooth is enabled/disabled
5003         * 0=disabled. 1=enabled.
5004         */
5005        public static final String BLUETOOTH_ON = "bluetooth_on";
5006
5007        /**
5008         * CDMA Cell Broadcast SMS
5009         *                            0 = CDMA Cell Broadcast SMS disabled
5010         *                            1 = CDMA Cell Broadcast SMS enabled
5011         * @hide
5012         */
5013        public static final String CDMA_CELL_BROADCAST_SMS =
5014                "cdma_cell_broadcast_sms";
5015
5016        /**
5017         * The CDMA roaming mode 0 = Home Networks, CDMA default
5018         *                       1 = Roaming on Affiliated networks
5019         *                       2 = Roaming on any networks
5020         * @hide
5021         */
5022        public static final String CDMA_ROAMING_MODE = "roaming_settings";
5023
5024        /**
5025         * The CDMA subscription mode 0 = RUIM/SIM (default)
5026         *                                1 = NV
5027         * @hide
5028         */
5029        public static final String CDMA_SUBSCRIPTION_MODE = "subscription_mode";
5030
5031        /** Inactivity timeout to track mobile data activity.
5032        *
5033        * If set to a positive integer, it indicates the inactivity timeout value in seconds to
5034        * infer the data activity of mobile network. After a period of no activity on mobile
5035        * networks with length specified by the timeout, an {@code ACTION_DATA_ACTIVITY_CHANGE}
5036        * intent is fired to indicate a transition of network status from "active" to "idle". Any
5037        * subsequent activity on mobile networks triggers the firing of {@code
5038        * ACTION_DATA_ACTIVITY_CHANGE} intent indicating transition from "idle" to "active".
5039        *
5040        * Network activity refers to transmitting or receiving data on the network interfaces.
5041        *
5042        * Tracking is disabled if set to zero or negative value.
5043        *
5044        * @hide
5045        */
5046       public static final String DATA_ACTIVITY_TIMEOUT_MOBILE = "data_activity_timeout_mobile";
5047
5048       /** Timeout to tracking Wifi data activity. Same as {@code DATA_ACTIVITY_TIMEOUT_MOBILE}
5049        * but for Wifi network.
5050        * @hide
5051        */
5052       public static final String DATA_ACTIVITY_TIMEOUT_WIFI = "data_activity_timeout_wifi";
5053
5054       /**
5055        * Whether or not data roaming is enabled. (0 = false, 1 = true)
5056        */
5057       public static final String DATA_ROAMING = "data_roaming";
5058
5059       /**
5060        * The value passed to a Mobile DataConnection via bringUp which defines the
5061        * number of retries to preform when setting up the initial connection. The default
5062        * value defined in DataConnectionTrackerBase#DEFAULT_MDC_INITIAL_RETRY is currently 1.
5063        * @hide
5064        */
5065       public static final String MDC_INITIAL_MAX_RETRY = "mdc_initial_max_retry";
5066
5067       /**
5068        * Whether user has enabled development settings.
5069        */
5070       public static final String DEVELOPMENT_SETTINGS_ENABLED = "development_settings_enabled";
5071
5072       /**
5073        * Whether the device has been provisioned (0 = false, 1 = true)
5074        */
5075       public static final String DEVICE_PROVISIONED = "device_provisioned";
5076
5077       /**
5078        * The saved value for WindowManagerService.setForcedDisplayDensity().
5079        * One integer in dpi.  If unset, then use the real display density.
5080        * @hide
5081        */
5082       public static final String DISPLAY_DENSITY_FORCED = "display_density_forced";
5083
5084       /**
5085        * The saved value for WindowManagerService.setForcedDisplaySize().
5086        * Two integers separated by a comma.  If unset, then use the real display size.
5087        * @hide
5088        */
5089       public static final String DISPLAY_SIZE_FORCED = "display_size_forced";
5090
5091       /**
5092        * The maximum size, in bytes, of a download that the download manager will transfer over
5093        * a non-wifi connection.
5094        * @hide
5095        */
5096       public static final String DOWNLOAD_MAX_BYTES_OVER_MOBILE =
5097               "download_manager_max_bytes_over_mobile";
5098
5099       /**
5100        * The recommended maximum size, in bytes, of a download that the download manager should
5101        * transfer over a non-wifi connection. Over this size, the use will be warned, but will
5102        * have the option to start the download over the mobile connection anyway.
5103        * @hide
5104        */
5105       public static final String DOWNLOAD_RECOMMENDED_MAX_BYTES_OVER_MOBILE =
5106               "download_manager_recommended_max_bytes_over_mobile";
5107
5108       /**
5109        * @deprecated Use {@link android.provider.Settings.Secure#INSTALL_NON_MARKET_APPS} instead
5110        */
5111       @Deprecated
5112       public static final String INSTALL_NON_MARKET_APPS = Secure.INSTALL_NON_MARKET_APPS;
5113
5114       /**
5115        * Whether mobile data connections are allowed by the user.  See
5116        * ConnectivityManager for more info.
5117        * @hide
5118        */
5119       public static final String MOBILE_DATA = "mobile_data";
5120
5121       /** {@hide} */
5122       public static final String NETSTATS_ENABLED = "netstats_enabled";
5123       /** {@hide} */
5124       public static final String NETSTATS_POLL_INTERVAL = "netstats_poll_interval";
5125       /** {@hide} */
5126       public static final String NETSTATS_TIME_CACHE_MAX_AGE = "netstats_time_cache_max_age";
5127       /** {@hide} */
5128       public static final String NETSTATS_GLOBAL_ALERT_BYTES = "netstats_global_alert_bytes";
5129       /** {@hide} */
5130       public static final String NETSTATS_SAMPLE_ENABLED = "netstats_sample_enabled";
5131       /** {@hide} */
5132       public static final String NETSTATS_REPORT_XT_OVER_DEV = "netstats_report_xt_over_dev";
5133
5134       /** {@hide} */
5135       public static final String NETSTATS_DEV_BUCKET_DURATION = "netstats_dev_bucket_duration";
5136       /** {@hide} */
5137       public static final String NETSTATS_DEV_PERSIST_BYTES = "netstats_dev_persist_bytes";
5138       /** {@hide} */
5139       public static final String NETSTATS_DEV_ROTATE_AGE = "netstats_dev_rotate_age";
5140       /** {@hide} */
5141       public static final String NETSTATS_DEV_DELETE_AGE = "netstats_dev_delete_age";
5142
5143       /** {@hide} */
5144       public static final String NETSTATS_UID_BUCKET_DURATION = "netstats_uid_bucket_duration";
5145       /** {@hide} */
5146       public static final String NETSTATS_UID_PERSIST_BYTES = "netstats_uid_persist_bytes";
5147       /** {@hide} */
5148       public static final String NETSTATS_UID_ROTATE_AGE = "netstats_uid_rotate_age";
5149       /** {@hide} */
5150       public static final String NETSTATS_UID_DELETE_AGE = "netstats_uid_delete_age";
5151
5152       /** {@hide} */
5153       public static final String NETSTATS_UID_TAG_BUCKET_DURATION = "netstats_uid_tag_bucket_duration";
5154       /** {@hide} */
5155       public static final String NETSTATS_UID_TAG_PERSIST_BYTES = "netstats_uid_tag_persist_bytes";
5156       /** {@hide} */
5157       public static final String NETSTATS_UID_TAG_ROTATE_AGE = "netstats_uid_tag_rotate_age";
5158       /** {@hide} */
5159       public static final String NETSTATS_UID_TAG_DELETE_AGE = "netstats_uid_tag_delete_age";
5160
5161       /**
5162        * User preference for which network(s) should be used. Only the
5163        * connectivity service should touch this.
5164        */
5165       public static final String NETWORK_PREFERENCE = "network_preference";
5166
5167       /**
5168        * Which package name to use for network scoring. If null, or if the package is not a valid
5169        * scorer app, external network scores will neither be requested nor accepted.
5170        * @hide
5171        */
5172       public static final String NETWORK_SCORER_APP = "network_scorer_app";
5173
5174       /**
5175        * If the NITZ_UPDATE_DIFF time is exceeded then an automatic adjustment
5176        * to SystemClock will be allowed even if NITZ_UPDATE_SPACING has not been
5177        * exceeded.
5178        * @hide
5179        */
5180       public static final String NITZ_UPDATE_DIFF = "nitz_update_diff";
5181
5182       /**
5183        * The length of time in milli-seconds that automatic small adjustments to
5184        * SystemClock are ignored if NITZ_UPDATE_DIFF is not exceeded.
5185        * @hide
5186        */
5187       public static final String NITZ_UPDATE_SPACING = "nitz_update_spacing";
5188
5189       /** Preferred NTP server. {@hide} */
5190       public static final String NTP_SERVER = "ntp_server";
5191       /** Timeout in milliseconds to wait for NTP server. {@hide} */
5192       public static final String NTP_TIMEOUT = "ntp_timeout";
5193
5194       /**
5195        * Whether the package manager should send package verification broadcasts for verifiers to
5196        * review apps prior to installation.
5197        * 1 = request apps to be verified prior to installation, if a verifier exists.
5198        * 0 = do not verify apps before installation
5199        * @hide
5200        */
5201       public static final String PACKAGE_VERIFIER_ENABLE = "package_verifier_enable";
5202
5203       /** Timeout for package verification.
5204        * @hide */
5205       public static final String PACKAGE_VERIFIER_TIMEOUT = "verifier_timeout";
5206
5207       /** Default response code for package verification.
5208        * @hide */
5209       public static final String PACKAGE_VERIFIER_DEFAULT_RESPONSE = "verifier_default_response";
5210
5211       /**
5212        * Show package verification setting in the Settings app.
5213        * 1 = show (default)
5214        * 0 = hide
5215        * @hide
5216        */
5217       public static final String PACKAGE_VERIFIER_SETTING_VISIBLE = "verifier_setting_visible";
5218
5219       /**
5220        * Run package verificaiton on apps installed through ADB/ADT/USB
5221        * 1 = perform package verification on ADB installs (default)
5222        * 0 = bypass package verification on ADB installs
5223        * @hide
5224        */
5225       public static final String PACKAGE_VERIFIER_INCLUDE_ADB = "verifier_verify_adb_installs";
5226
5227       /**
5228        * The interval in milliseconds at which to check packet counts on the
5229        * mobile data interface when screen is on, to detect possible data
5230        * connection problems.
5231        * @hide
5232        */
5233       public static final String PDP_WATCHDOG_POLL_INTERVAL_MS =
5234               "pdp_watchdog_poll_interval_ms";
5235
5236       /**
5237        * The interval in milliseconds at which to check packet counts on the
5238        * mobile data interface when screen is off, to detect possible data
5239        * connection problems.
5240        * @hide
5241        */
5242       public static final String PDP_WATCHDOG_LONG_POLL_INTERVAL_MS =
5243               "pdp_watchdog_long_poll_interval_ms";
5244
5245       /**
5246        * The interval in milliseconds at which to check packet counts on the
5247        * mobile data interface after {@link #PDP_WATCHDOG_TRIGGER_PACKET_COUNT}
5248        * outgoing packets has been reached without incoming packets.
5249        * @hide
5250        */
5251       public static final String PDP_WATCHDOG_ERROR_POLL_INTERVAL_MS =
5252               "pdp_watchdog_error_poll_interval_ms";
5253
5254       /**
5255        * The number of outgoing packets sent without seeing an incoming packet
5256        * that triggers a countdown (of {@link #PDP_WATCHDOG_ERROR_POLL_COUNT}
5257        * device is logged to the event log
5258        * @hide
5259        */
5260       public static final String PDP_WATCHDOG_TRIGGER_PACKET_COUNT =
5261               "pdp_watchdog_trigger_packet_count";
5262
5263       /**
5264        * The number of polls to perform (at {@link #PDP_WATCHDOG_ERROR_POLL_INTERVAL_MS})
5265        * after hitting {@link #PDP_WATCHDOG_TRIGGER_PACKET_COUNT} before
5266        * attempting data connection recovery.
5267        * @hide
5268        */
5269       public static final String PDP_WATCHDOG_ERROR_POLL_COUNT =
5270               "pdp_watchdog_error_poll_count";
5271
5272       /**
5273        * The number of failed PDP reset attempts before moving to something more
5274        * drastic: re-registering to the network.
5275        * @hide
5276        */
5277       public static final String PDP_WATCHDOG_MAX_PDP_RESET_FAIL_COUNT =
5278               "pdp_watchdog_max_pdp_reset_fail_count";
5279
5280       /**
5281        * A positive value indicates how often the SamplingProfiler
5282        * should take snapshots. Zero value means SamplingProfiler
5283        * is disabled.
5284        *
5285        * @hide
5286        */
5287       public static final String SAMPLING_PROFILER_MS = "sampling_profiler_ms";
5288
5289       /**
5290        * URL to open browser on to allow user to manage a prepay account
5291        * @hide
5292        */
5293       public static final String SETUP_PREPAID_DATA_SERVICE_URL =
5294               "setup_prepaid_data_service_url";
5295
5296       /**
5297        * URL to attempt a GET on to see if this is a prepay device
5298        * @hide
5299        */
5300       public static final String SETUP_PREPAID_DETECTION_TARGET_URL =
5301               "setup_prepaid_detection_target_url";
5302
5303       /**
5304        * Host to check for a redirect to after an attempt to GET
5305        * SETUP_PREPAID_DETECTION_TARGET_URL. (If we redirected there,
5306        * this is a prepaid device with zero balance.)
5307        * @hide
5308        */
5309       public static final String SETUP_PREPAID_DETECTION_REDIR_HOST =
5310               "setup_prepaid_detection_redir_host";
5311
5312       /**
5313        * The interval in milliseconds at which to check the number of SMS sent out without asking
5314        * for use permit, to limit the un-authorized SMS usage.
5315        *
5316        * @hide
5317        */
5318       public static final String SMS_OUTGOING_CHECK_INTERVAL_MS =
5319               "sms_outgoing_check_interval_ms";
5320
5321       /**
5322        * The number of outgoing SMS sent without asking for user permit (of {@link
5323        * #SMS_OUTGOING_CHECK_INTERVAL_MS}
5324        *
5325        * @hide
5326        */
5327       public static final String SMS_OUTGOING_CHECK_MAX_COUNT =
5328               "sms_outgoing_check_max_count";
5329
5330       /**
5331        * Used to disable SMS short code confirmation - defaults to true.
5332        * True indcates we will do the check, etc.  Set to false to disable.
5333        * @see com.android.internal.telephony.SmsUsageMonitor
5334        * @hide
5335        */
5336       public static final String SMS_SHORT_CODE_CONFIRMATION = "sms_short_code_confirmation";
5337
5338        /**
5339         * Used to select which country we use to determine premium sms codes.
5340         * One of com.android.internal.telephony.SMSDispatcher.PREMIUM_RULE_USE_SIM,
5341         * com.android.internal.telephony.SMSDispatcher.PREMIUM_RULE_USE_NETWORK,
5342         * or com.android.internal.telephony.SMSDispatcher.PREMIUM_RULE_USE_BOTH.
5343         * @hide
5344         */
5345        public static final String SMS_SHORT_CODE_RULE = "sms_short_code_rule";
5346
5347       /**
5348        * Used to select TCP's default initial receiver window size in segments - defaults to a build config value
5349        * @hide
5350        */
5351       public static final String TCP_DEFAULT_INIT_RWND = "tcp_default_init_rwnd";
5352
5353       /**
5354        * Used to disable Tethering on a device - defaults to true
5355        * @hide
5356        */
5357       public static final String TETHER_SUPPORTED = "tether_supported";
5358
5359       /**
5360        * Used to require DUN APN on the device or not - defaults to a build config value
5361        * which defaults to false
5362        * @hide
5363        */
5364       public static final String TETHER_DUN_REQUIRED = "tether_dun_required";
5365
5366       /**
5367        * Used to hold a gservices-provisioned apn value for DUN.  If set, or the
5368        * corresponding build config values are set it will override the APN DB
5369        * values.
5370        * Consists of a comma seperated list of strings:
5371        * "name,apn,proxy,port,username,password,server,mmsc,mmsproxy,mmsport,mcc,mnc,auth,type"
5372        * note that empty fields can be ommitted: "name,apn,,,,,,,,,310,260,,DUN"
5373        * @hide
5374        */
5375       public static final String TETHER_DUN_APN = "tether_dun_apn";
5376
5377       /**
5378        * USB Mass Storage Enabled
5379        */
5380       public static final String USB_MASS_STORAGE_ENABLED = "usb_mass_storage_enabled";
5381
5382       /**
5383        * If this setting is set (to anything), then all references
5384        * to Gmail on the device must change to Google Mail.
5385        */
5386       public static final String USE_GOOGLE_MAIL = "use_google_mail";
5387
5388        /**
5389         * Webview Data reduction proxy key.
5390         * @hide
5391         */
5392        public static final String WEBVIEW_DATA_REDUCTION_PROXY_KEY =
5393                "webview_data_reduction_proxy_key";
5394
5395       /**
5396        * Whether Wifi display is enabled/disabled
5397        * 0=disabled. 1=enabled.
5398        * @hide
5399        */
5400       public static final String WIFI_DISPLAY_ON = "wifi_display_on";
5401
5402       /**
5403        * Whether Wifi display certification mode is enabled/disabled
5404        * 0=disabled. 1=enabled.
5405        * @hide
5406        */
5407       public static final String WIFI_DISPLAY_CERTIFICATION_ON =
5408               "wifi_display_certification_on";
5409
5410       /**
5411        * WPS Configuration method used by Wifi display, this setting only
5412        * takes effect when WIFI_DISPLAY_CERTIFICATION_ON is 1 (enabled).
5413        *
5414        * Possible values are:
5415        *
5416        * WpsInfo.INVALID: use default WPS method chosen by framework
5417        * WpsInfo.PBC    : use Push button
5418        * WpsInfo.KEYPAD : use Keypad
5419        * WpsInfo.DISPLAY: use Display
5420        * @hide
5421        */
5422       public static final String WIFI_DISPLAY_WPS_CONFIG =
5423           "wifi_display_wps_config";
5424
5425       /**
5426        * Whether to notify the user of open networks.
5427        * <p>
5428        * If not connected and the scan results have an open network, we will
5429        * put this notification up. If we attempt to connect to a network or
5430        * the open network(s) disappear, we remove the notification. When we
5431        * show the notification, we will not show it again for
5432        * {@link android.provider.Settings.Secure#WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY} time.
5433        */
5434       public static final String WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON =
5435               "wifi_networks_available_notification_on";
5436       /**
5437        * {@hide}
5438        */
5439       public static final String WIMAX_NETWORKS_AVAILABLE_NOTIFICATION_ON =
5440               "wimax_networks_available_notification_on";
5441
5442       /**
5443        * Delay (in seconds) before repeating the Wi-Fi networks available notification.
5444        * Connecting to a network will reset the timer.
5445        */
5446       public static final String WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY =
5447               "wifi_networks_available_repeat_delay";
5448
5449       /**
5450        * 802.11 country code in ISO 3166 format
5451        * @hide
5452        */
5453       public static final String WIFI_COUNTRY_CODE = "wifi_country_code";
5454
5455       /**
5456        * The interval in milliseconds to issue wake up scans when wifi needs
5457        * to connect. This is necessary to connect to an access point when
5458        * device is on the move and the screen is off.
5459        * @hide
5460        */
5461       public static final String WIFI_FRAMEWORK_SCAN_INTERVAL_MS =
5462               "wifi_framework_scan_interval_ms";
5463
5464       /**
5465        * The interval in milliseconds after which Wi-Fi is considered idle.
5466        * When idle, it is possible for the device to be switched from Wi-Fi to
5467        * the mobile data network.
5468        * @hide
5469        */
5470       public static final String WIFI_IDLE_MS = "wifi_idle_ms";
5471
5472       /**
5473        * When the number of open networks exceeds this number, the
5474        * least-recently-used excess networks will be removed.
5475        */
5476       public static final String WIFI_NUM_OPEN_NETWORKS_KEPT = "wifi_num_open_networks_kept";
5477
5478       /**
5479        * Whether the Wi-Fi should be on.  Only the Wi-Fi service should touch this.
5480        */
5481       public static final String WIFI_ON = "wifi_on";
5482
5483       /**
5484        * Setting to allow scans to be enabled even wifi is turned off for connectivity.
5485        * @hide
5486        */
5487       public static final String WIFI_SCAN_ALWAYS_AVAILABLE =
5488                "wifi_scan_always_enabled";
5489
5490       /**
5491        * Used to save the Wifi_ON state prior to tethering.
5492        * This state will be checked to restore Wifi after
5493        * the user turns off tethering.
5494        *
5495        * @hide
5496        */
5497       public static final String WIFI_SAVED_STATE = "wifi_saved_state";
5498
5499       /**
5500        * The interval in milliseconds to scan as used by the wifi supplicant
5501        * @hide
5502        */
5503       public static final String WIFI_SUPPLICANT_SCAN_INTERVAL_MS =
5504               "wifi_supplicant_scan_interval_ms";
5505
5506        /**
5507         * whether frameworks handles wifi auto-join
5508         * @hide
5509         */
5510       public static final String WIFI_ENHANCED_AUTO_JOIN =
5511                "wifi_enhanced_auto_join";
5512
5513        /**
5514         * whether settings show RSSI
5515         * @hide
5516         */
5517        public static final String WIFI_NETWORK_SHOW_RSSI =
5518                "wifi_network_show_rssi";
5519
5520        /**
5521        * The interval in milliseconds to scan at supplicant when p2p is connected
5522        * @hide
5523        */
5524       public static final String WIFI_SCAN_INTERVAL_WHEN_P2P_CONNECTED_MS =
5525               "wifi_scan_interval_p2p_connected_ms";
5526
5527       /**
5528        * Whether the Wi-Fi watchdog is enabled.
5529        */
5530       public static final String WIFI_WATCHDOG_ON = "wifi_watchdog_on";
5531
5532       /**
5533        * Setting to turn off poor network avoidance on Wi-Fi. Feature is enabled by default and
5534        * the setting needs to be set to 0 to disable it.
5535        * @hide
5536        */
5537       public static final String WIFI_WATCHDOG_POOR_NETWORK_TEST_ENABLED =
5538               "wifi_watchdog_poor_network_test_enabled";
5539
5540       /**
5541        * Setting to turn on suspend optimizations at screen off on Wi-Fi. Enabled by default and
5542        * needs to be set to 0 to disable it.
5543        * @hide
5544        */
5545       public static final String WIFI_SUSPEND_OPTIMIZATIONS_ENABLED =
5546               "wifi_suspend_optimizations_enabled";
5547
5548       /**
5549        * The maximum number of times we will retry a connection to an access
5550        * point for which we have failed in acquiring an IP address from DHCP.
5551        * A value of N means that we will make N+1 connection attempts in all.
5552        */
5553       public static final String WIFI_MAX_DHCP_RETRY_COUNT = "wifi_max_dhcp_retry_count";
5554
5555       /**
5556        * Maximum amount of time in milliseconds to hold a wakelock while waiting for mobile
5557        * data connectivity to be established after a disconnect from Wi-Fi.
5558        */
5559       public static final String WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS =
5560           "wifi_mobile_data_transition_wakelock_timeout_ms";
5561
5562       /**
5563        * The operational wifi frequency band
5564        * Set to one of {@link WifiManager#WIFI_FREQUENCY_BAND_AUTO},
5565        * {@link WifiManager#WIFI_FREQUENCY_BAND_5GHZ} or
5566        * {@link WifiManager#WIFI_FREQUENCY_BAND_2GHZ}
5567        *
5568        * @hide
5569        */
5570       public static final String WIFI_FREQUENCY_BAND = "wifi_frequency_band";
5571
5572       /**
5573        * The Wi-Fi peer-to-peer device name
5574        * @hide
5575        */
5576       public static final String WIFI_P2P_DEVICE_NAME = "wifi_p2p_device_name";
5577
5578       /**
5579        * The min time between wifi disable and wifi enable
5580        * @hide
5581        */
5582       public static final String WIFI_REENABLE_DELAY_MS = "wifi_reenable_delay";
5583
5584       /**
5585        * The number of milliseconds to delay when checking for data stalls during
5586        * non-aggressive detection. (screen is turned off.)
5587        * @hide
5588        */
5589       public static final String DATA_STALL_ALARM_NON_AGGRESSIVE_DELAY_IN_MS =
5590               "data_stall_alarm_non_aggressive_delay_in_ms";
5591
5592       /**
5593        * The number of milliseconds to delay when checking for data stalls during
5594        * aggressive detection. (screen on or suspected data stall)
5595        * @hide
5596        */
5597       public static final String DATA_STALL_ALARM_AGGRESSIVE_DELAY_IN_MS =
5598               "data_stall_alarm_aggressive_delay_in_ms";
5599
5600       /**
5601        * The number of milliseconds to allow the provisioning apn to remain active
5602        * @hide
5603        */
5604       public static final String PROVISIONING_APN_ALARM_DELAY_IN_MS =
5605               "provisioning_apn_alarm_delay_in_ms";
5606
5607       /**
5608        * The interval in milliseconds at which to check gprs registration
5609        * after the first registration mismatch of gprs and voice service,
5610        * to detect possible data network registration problems.
5611        *
5612        * @hide
5613        */
5614       public static final String GPRS_REGISTER_CHECK_PERIOD_MS =
5615               "gprs_register_check_period_ms";
5616
5617       /**
5618        * Nonzero causes Log.wtf() to crash.
5619        * @hide
5620        */
5621       public static final String WTF_IS_FATAL = "wtf_is_fatal";
5622
5623       /**
5624        * Ringer mode. This is used internally, changing this value will not
5625        * change the ringer mode. See AudioManager.
5626        */
5627       public static final String MODE_RINGER = "mode_ringer";
5628
5629       /**
5630        * Overlay display devices setting.
5631        * The associated value is a specially formatted string that describes the
5632        * size and density of simulated secondary display devices.
5633        * <p>
5634        * Format: {width}x{height}/{dpi};...
5635        * </p><p>
5636        * Example:
5637        * <ul>
5638        * <li><code>1280x720/213</code>: make one overlay that is 1280x720 at 213dpi.</li>
5639        * <li><code>1920x1080/320;1280x720/213</code>: make two overlays, the first
5640        * at 1080p and the second at 720p.</li>
5641        * <li>If the value is empty, then no overlay display devices are created.</li>
5642        * </ul></p>
5643        *
5644        * @hide
5645        */
5646       public static final String OVERLAY_DISPLAY_DEVICES = "overlay_display_devices";
5647
5648        /**
5649         * Threshold values for the duration and level of a discharge cycle,
5650         * under which we log discharge cycle info.
5651         *
5652         * @hide
5653         */
5654        public static final String
5655                BATTERY_DISCHARGE_DURATION_THRESHOLD = "battery_discharge_duration_threshold";
5656
5657        /** @hide */
5658        public static final String BATTERY_DISCHARGE_THRESHOLD = "battery_discharge_threshold";
5659
5660        /**
5661         * Flag for allowing ActivityManagerService to send ACTION_APP_ERROR
5662         * intents on application crashes and ANRs. If this is disabled, the
5663         * crash/ANR dialog will never display the "Report" button.
5664         * <p>
5665         * Type: int (0 = disallow, 1 = allow)
5666         *
5667         * @hide
5668         */
5669        public static final String SEND_ACTION_APP_ERROR = "send_action_app_error";
5670
5671        /**
5672         * Maximum age of entries kept by {@link DropBoxManager}.
5673         *
5674         * @hide
5675         */
5676        public static final String DROPBOX_AGE_SECONDS = "dropbox_age_seconds";
5677
5678        /**
5679         * Maximum number of entry files which {@link DropBoxManager} will keep
5680         * around.
5681         *
5682         * @hide
5683         */
5684        public static final String DROPBOX_MAX_FILES = "dropbox_max_files";
5685
5686        /**
5687         * Maximum amount of disk space used by {@link DropBoxManager} no matter
5688         * what.
5689         *
5690         * @hide
5691         */
5692        public static final String DROPBOX_QUOTA_KB = "dropbox_quota_kb";
5693
5694        /**
5695         * Percent of free disk (excluding reserve) which {@link DropBoxManager}
5696         * will use.
5697         *
5698         * @hide
5699         */
5700        public static final String DROPBOX_QUOTA_PERCENT = "dropbox_quota_percent";
5701
5702        /**
5703         * Percent of total disk which {@link DropBoxManager} will never dip
5704         * into.
5705         *
5706         * @hide
5707         */
5708        public static final String DROPBOX_RESERVE_PERCENT = "dropbox_reserve_percent";
5709
5710        /**
5711         * Prefix for per-tag dropbox disable/enable settings.
5712         *
5713         * @hide
5714         */
5715        public static final String DROPBOX_TAG_PREFIX = "dropbox:";
5716
5717        /**
5718         * Lines of logcat to include with system crash/ANR/etc. reports, as a
5719         * prefix of the dropbox tag of the report type. For example,
5720         * "logcat_for_system_server_anr" controls the lines of logcat captured
5721         * with system server ANR reports. 0 to disable.
5722         *
5723         * @hide
5724         */
5725        public static final String ERROR_LOGCAT_PREFIX = "logcat_for_";
5726
5727        /**
5728         * The interval in minutes after which the amount of free storage left
5729         * on the device is logged to the event log
5730         *
5731         * @hide
5732         */
5733        public static final String SYS_FREE_STORAGE_LOG_INTERVAL = "sys_free_storage_log_interval";
5734
5735        /**
5736         * Threshold for the amount of change in disk free space required to
5737         * report the amount of free space. Used to prevent spamming the logs
5738         * when the disk free space isn't changing frequently.
5739         *
5740         * @hide
5741         */
5742        public static final String
5743                DISK_FREE_CHANGE_REPORTING_THRESHOLD = "disk_free_change_reporting_threshold";
5744
5745        /**
5746         * Minimum percentage of free storage on the device that is used to
5747         * determine if the device is running low on storage. The default is 10.
5748         * <p>
5749         * Say this value is set to 10, the device is considered running low on
5750         * storage if 90% or more of the device storage is filled up.
5751         *
5752         * @hide
5753         */
5754        public static final String
5755                SYS_STORAGE_THRESHOLD_PERCENTAGE = "sys_storage_threshold_percentage";
5756
5757        /**
5758         * Maximum byte size of the low storage threshold. This is to ensure
5759         * that {@link #SYS_STORAGE_THRESHOLD_PERCENTAGE} does not result in an
5760         * overly large threshold for large storage devices. Currently this must
5761         * be less than 2GB. This default is 500MB.
5762         *
5763         * @hide
5764         */
5765        public static final String
5766                SYS_STORAGE_THRESHOLD_MAX_BYTES = "sys_storage_threshold_max_bytes";
5767
5768        /**
5769         * Minimum bytes of free storage on the device before the data partition
5770         * is considered full. By default, 1 MB is reserved to avoid system-wide
5771         * SQLite disk full exceptions.
5772         *
5773         * @hide
5774         */
5775        public static final String
5776                SYS_STORAGE_FULL_THRESHOLD_BYTES = "sys_storage_full_threshold_bytes";
5777
5778        /**
5779         * The maximum reconnect delay for short network outages or when the
5780         * network is suspended due to phone use.
5781         *
5782         * @hide
5783         */
5784        public static final String
5785                SYNC_MAX_RETRY_DELAY_IN_SECONDS = "sync_max_retry_delay_in_seconds";
5786
5787        /**
5788         * The number of milliseconds to delay before sending out
5789         * {@link ConnectivityManager#CONNECTIVITY_ACTION} broadcasts.
5790         *
5791         * @hide
5792         */
5793        public static final String CONNECTIVITY_CHANGE_DELAY = "connectivity_change_delay";
5794
5795
5796        /**
5797         * Network sampling interval, in seconds. We'll generate link information
5798         * about bytes/packets sent and error rates based on data sampled in this interval
5799         *
5800         * @hide
5801         */
5802
5803        public static final String CONNECTIVITY_SAMPLING_INTERVAL_IN_SECONDS =
5804                "connectivity_sampling_interval_in_seconds";
5805
5806        /**
5807         * The series of successively longer delays used in retrying to download PAC file.
5808         * Last delay is used between successful PAC downloads.
5809         *
5810         * @hide
5811         */
5812        public static final String PAC_CHANGE_DELAY = "pac_change_delay";
5813
5814        /**
5815         * Setting to turn off captive portal detection. Feature is enabled by
5816         * default and the setting needs to be set to 0 to disable it.
5817         *
5818         * @hide
5819         */
5820        public static final String
5821                CAPTIVE_PORTAL_DETECTION_ENABLED = "captive_portal_detection_enabled";
5822
5823        /**
5824         * The server used for captive portal detection upon a new conection. A
5825         * 204 response code from the server is used for validation.
5826         *
5827         * @hide
5828         */
5829        public static final String CAPTIVE_PORTAL_SERVER = "captive_portal_server";
5830
5831        /**
5832         * Whether network service discovery is enabled.
5833         *
5834         * @hide
5835         */
5836        public static final String NSD_ON = "nsd_on";
5837
5838        /**
5839         * Let user pick default install location.
5840         *
5841         * @hide
5842         */
5843        public static final String SET_INSTALL_LOCATION = "set_install_location";
5844
5845        /**
5846         * Default install location value.
5847         * 0 = auto, let system decide
5848         * 1 = internal
5849         * 2 = sdcard
5850         * @hide
5851         */
5852        public static final String DEFAULT_INSTALL_LOCATION = "default_install_location";
5853
5854        /**
5855         * ms during which to consume extra events related to Inet connection
5856         * condition after a transtion to fully-connected
5857         *
5858         * @hide
5859         */
5860        public static final String
5861                INET_CONDITION_DEBOUNCE_UP_DELAY = "inet_condition_debounce_up_delay";
5862
5863        /**
5864         * ms during which to consume extra events related to Inet connection
5865         * condtion after a transtion to partly-connected
5866         *
5867         * @hide
5868         */
5869        public static final String
5870                INET_CONDITION_DEBOUNCE_DOWN_DELAY = "inet_condition_debounce_down_delay";
5871
5872        /** {@hide} */
5873        public static final String
5874                READ_EXTERNAL_STORAGE_ENFORCED_DEFAULT = "read_external_storage_enforced_default";
5875
5876        /**
5877         * Host name and port for global http proxy. Uses ':' seperator for
5878         * between host and port.
5879         */
5880        public static final String HTTP_PROXY = "http_proxy";
5881
5882        /**
5883         * Host name for global http proxy. Set via ConnectivityManager.
5884         *
5885         * @hide
5886         */
5887        public static final String GLOBAL_HTTP_PROXY_HOST = "global_http_proxy_host";
5888
5889        /**
5890         * Integer host port for global http proxy. Set via ConnectivityManager.
5891         *
5892         * @hide
5893         */
5894        public static final String GLOBAL_HTTP_PROXY_PORT = "global_http_proxy_port";
5895
5896        /**
5897         * Exclusion list for global proxy. This string contains a list of
5898         * comma-separated domains where the global proxy does not apply.
5899         * Domains should be listed in a comma- separated list. Example of
5900         * acceptable formats: ".domain1.com,my.domain2.com" Use
5901         * ConnectivityManager to set/get.
5902         *
5903         * @hide
5904         */
5905        public static final String
5906                GLOBAL_HTTP_PROXY_EXCLUSION_LIST = "global_http_proxy_exclusion_list";
5907
5908        /**
5909         * The location PAC File for the proxy.
5910         * @hide
5911         */
5912        public static final String
5913                GLOBAL_HTTP_PROXY_PAC = "global_proxy_pac_url";
5914
5915        /**
5916         * Enables the UI setting to allow the user to specify the global HTTP
5917         * proxy and associated exclusion list.
5918         *
5919         * @hide
5920         */
5921        public static final String SET_GLOBAL_HTTP_PROXY = "set_global_http_proxy";
5922
5923        /**
5924         * Setting for default DNS in case nobody suggests one
5925         *
5926         * @hide
5927         */
5928        public static final String DEFAULT_DNS_SERVER = "default_dns_server";
5929
5930        /** {@hide} */
5931        public static final String
5932                BLUETOOTH_HEADSET_PRIORITY_PREFIX = "bluetooth_headset_priority_";
5933        /** {@hide} */
5934        public static final String
5935                BLUETOOTH_A2DP_SINK_PRIORITY_PREFIX = "bluetooth_a2dp_sink_priority_";
5936        /** {@hide} */
5937        public static final String
5938                BLUETOOTH_INPUT_DEVICE_PRIORITY_PREFIX = "bluetooth_input_device_priority_";
5939        /** {@hide} */
5940        public static final String
5941                BLUETOOTH_MAP_PRIORITY_PREFIX = "bluetooth_map_priority_";
5942
5943        /**
5944         * Get the key that retrieves a bluetooth headset's priority.
5945         * @hide
5946         */
5947        public static final String getBluetoothHeadsetPriorityKey(String address) {
5948            return BLUETOOTH_HEADSET_PRIORITY_PREFIX + address.toUpperCase(Locale.ROOT);
5949        }
5950
5951        /**
5952         * Get the key that retrieves a bluetooth a2dp sink's priority.
5953         * @hide
5954         */
5955        public static final String getBluetoothA2dpSinkPriorityKey(String address) {
5956            return BLUETOOTH_A2DP_SINK_PRIORITY_PREFIX + address.toUpperCase(Locale.ROOT);
5957        }
5958
5959        /**
5960         * Get the key that retrieves a bluetooth Input Device's priority.
5961         * @hide
5962         */
5963        public static final String getBluetoothInputDevicePriorityKey(String address) {
5964            return BLUETOOTH_INPUT_DEVICE_PRIORITY_PREFIX + address.toUpperCase(Locale.ROOT);
5965        }
5966
5967        /**
5968         * Get the key that retrieves a bluetooth map priority.
5969         * @hide
5970         */
5971        public static final String getBluetoothMapPriorityKey(String address) {
5972            return BLUETOOTH_MAP_PRIORITY_PREFIX + address.toUpperCase(Locale.ROOT);
5973        }
5974        /**
5975         * Scaling factor for normal window animations. Setting to 0 will
5976         * disable window animations.
5977         */
5978        public static final String WINDOW_ANIMATION_SCALE = "window_animation_scale";
5979
5980        /**
5981         * Scaling factor for activity transition animations. Setting to 0 will
5982         * disable window animations.
5983         */
5984        public static final String TRANSITION_ANIMATION_SCALE = "transition_animation_scale";
5985
5986        /**
5987         * Scaling factor for Animator-based animations. This affects both the
5988         * start delay and duration of all such animations. Setting to 0 will
5989         * cause animations to end immediately. The default value is 1.
5990         */
5991        public static final String ANIMATOR_DURATION_SCALE = "animator_duration_scale";
5992
5993        /**
5994         * Scaling factor for normal window animations. Setting to 0 will
5995         * disable window animations.
5996         *
5997         * @hide
5998         */
5999        public static final String FANCY_IME_ANIMATIONS = "fancy_ime_animations";
6000
6001        /**
6002         * If 0, the compatibility mode is off for all applications.
6003         * If 1, older applications run under compatibility mode.
6004         * TODO: remove this settings before code freeze (bug/1907571)
6005         * @hide
6006         */
6007        public static final String COMPATIBILITY_MODE = "compatibility_mode";
6008
6009        /**
6010         * CDMA only settings
6011         * Emergency Tone  0 = Off
6012         *                 1 = Alert
6013         *                 2 = Vibrate
6014         * @hide
6015         */
6016        public static final String EMERGENCY_TONE = "emergency_tone";
6017
6018        /**
6019         * CDMA only settings
6020         * Whether the auto retry is enabled. The value is
6021         * boolean (1 or 0).
6022         * @hide
6023         */
6024        public static final String CALL_AUTO_RETRY = "call_auto_retry";
6025
6026        /**
6027         * The preferred network mode   7 = Global
6028         *                              6 = EvDo only
6029         *                              5 = CDMA w/o EvDo
6030         *                              4 = CDMA / EvDo auto
6031         *                              3 = GSM / WCDMA auto
6032         *                              2 = WCDMA only
6033         *                              1 = GSM only
6034         *                              0 = GSM / WCDMA preferred
6035         * @hide
6036         */
6037        public static final String PREFERRED_NETWORK_MODE =
6038                "preferred_network_mode";
6039
6040        /**
6041         * Name of an application package to be debugged.
6042         */
6043        public static final String DEBUG_APP = "debug_app";
6044
6045        /**
6046         * If 1, when launching DEBUG_APP it will wait for the debugger before
6047         * starting user code.  If 0, it will run normally.
6048         */
6049        public static final String WAIT_FOR_DEBUGGER = "wait_for_debugger";
6050
6051        /**
6052         * Control whether the process CPU usage meter should be shown.
6053         */
6054        public static final String SHOW_PROCESSES = "show_processes";
6055
6056        /**
6057         * If 1 low power mode is enabled.
6058         * @hide
6059         */
6060        public static final String LOW_POWER_MODE = "low_power";
6061
6062        /**
6063         * Battery level [1-99] at which low power mode automatically turns on.
6064         * If 0, it will not automatically turn on.
6065         * @hide
6066         */
6067        public static final String LOW_POWER_MODE_TRIGGER_LEVEL = "low_power_trigger_level";
6068
6069         /**
6070         * If 1, the activity manager will aggressively finish activities and
6071         * processes as soon as they are no longer needed.  If 0, the normal
6072         * extended lifetime is used.
6073         */
6074        public static final String ALWAYS_FINISH_ACTIVITIES =
6075                "always_finish_activities";
6076
6077        /**
6078         * Use Dock audio output for media:
6079         *      0 = disabled
6080         *      1 = enabled
6081         * @hide
6082         */
6083        public static final String DOCK_AUDIO_MEDIA_ENABLED = "dock_audio_media_enabled";
6084
6085        /**
6086         * Persisted safe headphone volume management state by AudioService
6087         * @hide
6088         */
6089        public static final String AUDIO_SAFE_VOLUME_STATE = "audio_safe_volume_state";
6090
6091        /**
6092         * URL for tzinfo (time zone) updates
6093         * @hide
6094         */
6095        public static final String TZINFO_UPDATE_CONTENT_URL = "tzinfo_content_url";
6096
6097        /**
6098         * URL for tzinfo (time zone) update metadata
6099         * @hide
6100         */
6101        public static final String TZINFO_UPDATE_METADATA_URL = "tzinfo_metadata_url";
6102
6103        /**
6104         * URL for selinux (mandatory access control) updates
6105         * @hide
6106         */
6107        public static final String SELINUX_UPDATE_CONTENT_URL = "selinux_content_url";
6108
6109        /**
6110         * URL for selinux (mandatory access control) update metadata
6111         * @hide
6112         */
6113        public static final String SELINUX_UPDATE_METADATA_URL = "selinux_metadata_url";
6114
6115        /**
6116         * URL for sms short code updates
6117         * @hide
6118         */
6119        public static final String SMS_SHORT_CODES_UPDATE_CONTENT_URL =
6120                "sms_short_codes_content_url";
6121
6122        /**
6123         * URL for sms short code update metadata
6124         * @hide
6125         */
6126        public static final String SMS_SHORT_CODES_UPDATE_METADATA_URL =
6127                "sms_short_codes_metadata_url";
6128
6129        /**
6130         * URL for cert pinlist updates
6131         * @hide
6132         */
6133        public static final String CERT_PIN_UPDATE_CONTENT_URL = "cert_pin_content_url";
6134
6135        /**
6136         * URL for cert pinlist updates
6137         * @hide
6138         */
6139        public static final String CERT_PIN_UPDATE_METADATA_URL = "cert_pin_metadata_url";
6140
6141        /**
6142         * URL for intent firewall updates
6143         * @hide
6144         */
6145        public static final String INTENT_FIREWALL_UPDATE_CONTENT_URL =
6146                "intent_firewall_content_url";
6147
6148        /**
6149         * URL for intent firewall update metadata
6150         * @hide
6151         */
6152        public static final String INTENT_FIREWALL_UPDATE_METADATA_URL =
6153                "intent_firewall_metadata_url";
6154
6155        /**
6156         * SELinux enforcement status. If 0, permissive; if 1, enforcing.
6157         * @hide
6158         */
6159        public static final String SELINUX_STATUS = "selinux_status";
6160
6161        /**
6162         * Developer setting to force RTL layout.
6163         * @hide
6164         */
6165        public static final String DEVELOPMENT_FORCE_RTL = "debug.force_rtl";
6166
6167        /**
6168         * Milliseconds after screen-off after which low battery sounds will be silenced.
6169         *
6170         * If zero, battery sounds will always play.
6171         * Defaults to @integer/def_low_battery_sound_timeout in SettingsProvider.
6172         *
6173         * @hide
6174         */
6175        public static final String LOW_BATTERY_SOUND_TIMEOUT = "low_battery_sound_timeout";
6176
6177        /**
6178         * Milliseconds to wait before bouncing Wi-Fi after settings is restored. Note that after
6179         * the caller is done with this, they should call {@link ContentResolver#delete(Uri)} to
6180         * clean up any value that they may have written.
6181         *
6182         * @hide
6183         */
6184        public static final String WIFI_BOUNCE_DELAY_OVERRIDE_MS = "wifi_bounce_delay_override_ms";
6185
6186        /**
6187         * Defines global runtime overrides to window policy.
6188         *
6189         * See {@link com.android.internal.policy.impl.PolicyControl} for value format.
6190         *
6191         * @hide
6192         */
6193        public static final String POLICY_CONTROL = "policy_control";
6194
6195
6196        /**
6197         * This preference enables notification display even over a securely
6198         * locked screen.
6199         * @hide
6200         */
6201        public static final String LOCK_SCREEN_SHOW_NOTIFICATIONS =
6202                "lock_screen_show_notifications";
6203
6204        /**
6205         * Defines global zen mode.  ZEN_MODE_OFF, ZEN_MODE_IMPORTANT_INTERRUPTIONS,
6206         * or ZEN_MODE_NO_INTERRUPTIONS.
6207         *
6208         * @hide
6209         */
6210        public static final String ZEN_MODE = "zen_mode";
6211
6212        /** @hide */ public static final int ZEN_MODE_OFF = 0;
6213        /** @hide */ public static final int ZEN_MODE_IMPORTANT_INTERRUPTIONS = 1;
6214        /** @hide */ public static final int ZEN_MODE_NO_INTERRUPTIONS = 2;
6215
6216        /** @hide */ public static String zenModeToString(int mode) {
6217            if (mode == ZEN_MODE_IMPORTANT_INTERRUPTIONS) return "ZEN_MODE_IMPORTANT_INTERRUPTIONS";
6218            if (mode == ZEN_MODE_NO_INTERRUPTIONS) return "ZEN_MODE_NO_INTERRUPTIONS";
6219            return "ZEN_MODE_OFF";
6220        }
6221
6222        /**
6223         * Opaque value, changes when persisted zen mode configuration changes.
6224         *
6225         * @hide
6226         */
6227        public static final String ZEN_MODE_CONFIG_ETAG = "zen_mode_config_etag";
6228
6229        /**
6230         * Defines global heads up toggle.  One of HEADS_UP_OFF, HEADS_UP_ON.
6231         *
6232         * @hide
6233         */
6234        public static final String HEADS_UP_NOTIFICATIONS_ENABLED =
6235                "heads_up_notifications_enabled";
6236
6237        /** @hide */ public static final int HEADS_UP_OFF = 0;
6238        /** @hide */ public static final int HEADS_UP_ON = 1;
6239
6240        /**
6241         * The name of the device
6242         *
6243         * @hide
6244         */
6245        public static final String DEVICE_NAME = "device_name";
6246
6247        /**
6248         * Whether it should be possible to create a guest user on the device.
6249         * <p>
6250         * Type: int (0 for disabled, 1 for enabled)
6251         * @hide
6252         */
6253        public static final String GUEST_USER_ENABLED = "guest_user_enabled";
6254
6255        /**
6256         * Settings to backup. This is here so that it's in the same place as the settings
6257         * keys and easy to update.
6258         *
6259         * These keys may be mentioned in the SETTINGS_TO_BACKUP arrays in System
6260         * and Secure as well.  This is because those tables drive both backup and
6261         * restore, and restore needs to properly whitelist keys that used to live
6262         * in those namespaces.  The keys will only actually be backed up / restored
6263         * if they are also mentioned in this table (Global.SETTINGS_TO_BACKUP).
6264         *
6265         * NOTE: Settings are backed up and restored in the order they appear
6266         *       in this array. If you have one setting depending on another,
6267         *       make sure that they are ordered appropriately.
6268         *
6269         * @hide
6270         */
6271        public static final String[] SETTINGS_TO_BACKUP = {
6272            BUGREPORT_IN_POWER_MENU,
6273            STAY_ON_WHILE_PLUGGED_IN,
6274            AUTO_TIME,
6275            AUTO_TIME_ZONE,
6276            POWER_SOUNDS_ENABLED,
6277            DOCK_SOUNDS_ENABLED,
6278            USB_MASS_STORAGE_ENABLED,
6279            ENABLE_ACCESSIBILITY_GLOBAL_GESTURE_ENABLED,
6280            WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON,
6281            WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY,
6282            WIFI_WATCHDOG_POOR_NETWORK_TEST_ENABLED,
6283            WIFI_NUM_OPEN_NETWORKS_KEPT,
6284            EMERGENCY_TONE,
6285            CALL_AUTO_RETRY,
6286            DOCK_AUDIO_MEDIA_ENABLED
6287        };
6288
6289        // Populated lazily, guarded by class object:
6290        private static NameValueCache sNameValueCache = new NameValueCache(
6291                    SYS_PROP_SETTING_VERSION,
6292                    CONTENT_URI,
6293                    CALL_METHOD_GET_GLOBAL,
6294                    CALL_METHOD_PUT_GLOBAL);
6295
6296        // Certain settings have been moved from global to the per-user secure namespace
6297        private static final HashSet<String> MOVED_TO_SECURE;
6298        static {
6299            MOVED_TO_SECURE = new HashSet<String>(1);
6300            MOVED_TO_SECURE.add(Settings.Global.INSTALL_NON_MARKET_APPS);
6301        }
6302
6303        /**
6304         * Look up a name in the database.
6305         * @param resolver to access the database with
6306         * @param name to look up in the table
6307         * @return the corresponding value, or null if not present
6308         */
6309        public static String getString(ContentResolver resolver, String name) {
6310            return getStringForUser(resolver, name, UserHandle.myUserId());
6311        }
6312
6313        /** @hide */
6314        public static String getStringForUser(ContentResolver resolver, String name,
6315                int userHandle) {
6316            if (MOVED_TO_SECURE.contains(name)) {
6317                Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.Global"
6318                        + " to android.provider.Settings.Secure, returning read-only value.");
6319                return Secure.getStringForUser(resolver, name, userHandle);
6320            }
6321            return sNameValueCache.getStringForUser(resolver, name, userHandle);
6322        }
6323
6324        /**
6325         * Store a name/value pair into the database.
6326         * @param resolver to access the database with
6327         * @param name to store
6328         * @param value to associate with the name
6329         * @return true if the value was set, false on database errors
6330         */
6331        public static boolean putString(ContentResolver resolver,
6332                String name, String value) {
6333            return putStringForUser(resolver, name, value, UserHandle.myUserId());
6334        }
6335
6336        /** @hide */
6337        public static boolean putStringForUser(ContentResolver resolver,
6338                String name, String value, int userHandle) {
6339            if (LOCAL_LOGV) {
6340                Log.v(TAG, "Global.putString(name=" + name + ", value=" + value
6341                        + " for " + userHandle);
6342            }
6343            // Global and Secure have the same access policy so we can forward writes
6344            if (MOVED_TO_SECURE.contains(name)) {
6345                Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.Global"
6346                        + " to android.provider.Settings.Secure, value is unchanged.");
6347                return Secure.putStringForUser(resolver, name, value, userHandle);
6348            }
6349            return sNameValueCache.putStringForUser(resolver, name, value, userHandle);
6350        }
6351
6352        /**
6353         * Construct the content URI for a particular name/value pair,
6354         * useful for monitoring changes with a ContentObserver.
6355         * @param name to look up in the table
6356         * @return the corresponding content URI, or null if not present
6357         */
6358        public static Uri getUriFor(String name) {
6359            return getUriFor(CONTENT_URI, name);
6360        }
6361
6362        /**
6363         * Convenience function for retrieving a single secure settings value
6364         * as an integer.  Note that internally setting values are always
6365         * stored as strings; this function converts the string to an integer
6366         * for you.  The default value will be returned if the setting is
6367         * not defined or not an integer.
6368         *
6369         * @param cr The ContentResolver to access.
6370         * @param name The name of the setting to retrieve.
6371         * @param def Value to return if the setting is not defined.
6372         *
6373         * @return The setting's current value, or 'def' if it is not defined
6374         * or not a valid integer.
6375         */
6376        public static int getInt(ContentResolver cr, String name, int def) {
6377            String v = getString(cr, name);
6378            try {
6379                return v != null ? Integer.parseInt(v) : def;
6380            } catch (NumberFormatException e) {
6381                return def;
6382            }
6383        }
6384
6385        /**
6386         * Convenience function for retrieving a single secure settings value
6387         * as an integer.  Note that internally setting values are always
6388         * stored as strings; this function converts the string to an integer
6389         * for you.
6390         * <p>
6391         * This version does not take a default value.  If the setting has not
6392         * been set, or the string value is not a number,
6393         * it throws {@link SettingNotFoundException}.
6394         *
6395         * @param cr The ContentResolver to access.
6396         * @param name The name of the setting to retrieve.
6397         *
6398         * @throws SettingNotFoundException Thrown if a setting by the given
6399         * name can't be found or the setting value is not an integer.
6400         *
6401         * @return The setting's current value.
6402         */
6403        public static int getInt(ContentResolver cr, String name)
6404                throws SettingNotFoundException {
6405            String v = getString(cr, name);
6406            try {
6407                return Integer.parseInt(v);
6408            } catch (NumberFormatException e) {
6409                throw new SettingNotFoundException(name);
6410            }
6411        }
6412
6413        /**
6414         * Convenience function for updating a single settings value as an
6415         * integer. This will either create a new entry in the table if the
6416         * given name does not exist, or modify the value of the existing row
6417         * with that name.  Note that internally setting values are always
6418         * stored as strings, so this function converts the given value to a
6419         * string before storing it.
6420         *
6421         * @param cr The ContentResolver to access.
6422         * @param name The name of the setting to modify.
6423         * @param value The new value for the setting.
6424         * @return true if the value was set, false on database errors
6425         */
6426        public static boolean putInt(ContentResolver cr, String name, int value) {
6427            return putString(cr, name, Integer.toString(value));
6428        }
6429
6430        /**
6431         * Convenience function for retrieving a single secure settings value
6432         * as a {@code long}.  Note that internally setting values are always
6433         * stored as strings; this function converts the string to a {@code long}
6434         * for you.  The default value will be returned if the setting is
6435         * not defined or not a {@code long}.
6436         *
6437         * @param cr The ContentResolver to access.
6438         * @param name The name of the setting to retrieve.
6439         * @param def Value to return if the setting is not defined.
6440         *
6441         * @return The setting's current value, or 'def' if it is not defined
6442         * or not a valid {@code long}.
6443         */
6444        public static long getLong(ContentResolver cr, String name, long def) {
6445            String valString = getString(cr, name);
6446            long value;
6447            try {
6448                value = valString != null ? Long.parseLong(valString) : def;
6449            } catch (NumberFormatException e) {
6450                value = def;
6451            }
6452            return value;
6453        }
6454
6455        /**
6456         * Convenience function for retrieving a single secure settings value
6457         * as a {@code long}.  Note that internally setting values are always
6458         * stored as strings; this function converts the string to a {@code long}
6459         * for you.
6460         * <p>
6461         * This version does not take a default value.  If the setting has not
6462         * been set, or the string value is not a number,
6463         * it throws {@link SettingNotFoundException}.
6464         *
6465         * @param cr The ContentResolver to access.
6466         * @param name The name of the setting to retrieve.
6467         *
6468         * @return The setting's current value.
6469         * @throws SettingNotFoundException Thrown if a setting by the given
6470         * name can't be found or the setting value is not an integer.
6471         */
6472        public static long getLong(ContentResolver cr, String name)
6473                throws SettingNotFoundException {
6474            String valString = getString(cr, name);
6475            try {
6476                return Long.parseLong(valString);
6477            } catch (NumberFormatException e) {
6478                throw new SettingNotFoundException(name);
6479            }
6480        }
6481
6482        /**
6483         * Convenience function for updating a secure settings value as a long
6484         * integer. This will either create a new entry in the table if the
6485         * given name does not exist, or modify the value of the existing row
6486         * with that name.  Note that internally setting values are always
6487         * stored as strings, so this function converts the given value to a
6488         * string before storing it.
6489         *
6490         * @param cr The ContentResolver to access.
6491         * @param name The name of the setting to modify.
6492         * @param value The new value for the setting.
6493         * @return true if the value was set, false on database errors
6494         */
6495        public static boolean putLong(ContentResolver cr, String name, long value) {
6496            return putString(cr, name, Long.toString(value));
6497        }
6498
6499        /**
6500         * Convenience function for retrieving a single secure settings value
6501         * as a floating point number.  Note that internally setting values are
6502         * always stored as strings; this function converts the string to an
6503         * float for you. The default value will be returned if the setting
6504         * is not defined or not a valid float.
6505         *
6506         * @param cr The ContentResolver to access.
6507         * @param name The name of the setting to retrieve.
6508         * @param def Value to return if the setting is not defined.
6509         *
6510         * @return The setting's current value, or 'def' if it is not defined
6511         * or not a valid float.
6512         */
6513        public static float getFloat(ContentResolver cr, String name, float def) {
6514            String v = getString(cr, name);
6515            try {
6516                return v != null ? Float.parseFloat(v) : def;
6517            } catch (NumberFormatException e) {
6518                return def;
6519            }
6520        }
6521
6522        /**
6523         * Convenience function for retrieving a single secure settings value
6524         * as a float.  Note that internally setting values are always
6525         * stored as strings; this function converts the string to a float
6526         * for you.
6527         * <p>
6528         * This version does not take a default value.  If the setting has not
6529         * been set, or the string value is not a number,
6530         * it throws {@link SettingNotFoundException}.
6531         *
6532         * @param cr The ContentResolver to access.
6533         * @param name The name of the setting to retrieve.
6534         *
6535         * @throws SettingNotFoundException Thrown if a setting by the given
6536         * name can't be found or the setting value is not a float.
6537         *
6538         * @return The setting's current value.
6539         */
6540        public static float getFloat(ContentResolver cr, String name)
6541                throws SettingNotFoundException {
6542            String v = getString(cr, name);
6543            if (v == null) {
6544                throw new SettingNotFoundException(name);
6545            }
6546            try {
6547                return Float.parseFloat(v);
6548            } catch (NumberFormatException e) {
6549                throw new SettingNotFoundException(name);
6550            }
6551        }
6552
6553        /**
6554         * Convenience function for updating a single settings value as a
6555         * floating point number. This will either create a new entry in the
6556         * table if the given name does not exist, or modify the value of the
6557         * existing row with that name.  Note that internally setting values
6558         * are always stored as strings, so this function converts the given
6559         * value to a string before storing it.
6560         *
6561         * @param cr The ContentResolver to access.
6562         * @param name The name of the setting to modify.
6563         * @param value The new value for the setting.
6564         * @return true if the value was set, false on database errors
6565         */
6566        public static boolean putFloat(ContentResolver cr, String name, float value) {
6567            return putString(cr, name, Float.toString(value));
6568        }
6569
6570
6571        /**
6572          * Subscription to be used for voice call on a multi sim device. The supported values
6573          * are 0 = SUB1, 1 = SUB2 and etc.
6574          * @hide
6575          */
6576        public static final String MULTI_SIM_VOICE_CALL_SUBSCRIPTION = "multi_sim_voice_call";
6577
6578        /**
6579          * Used to provide option to user to select subscription during dial.
6580          * The supported values are 0 = disable or 1 = enable prompt.
6581          * @hide
6582          */
6583        public static final String MULTI_SIM_VOICE_PROMPT = "multi_sim_voice_prompt";
6584
6585        /**
6586          * Subscription to be used for data call on a multi sim device. The supported values
6587          * are 0 = SUB1, 1 = SUB2 and etc.
6588          * @hide
6589          */
6590        public static final String MULTI_SIM_DATA_CALL_SUBSCRIPTION = "multi_sim_data_call";
6591
6592        /**
6593          * Subscription to be used for SMS on a multi sim device. The supported values
6594          * are 0 = SUB1, 1 = SUB2 and etc.
6595          * @hide
6596          */
6597        public static final String MULTI_SIM_SMS_SUBSCRIPTION = "multi_sim_sms";
6598
6599       /**
6600          * Used to provide option to user to select subscription during send SMS.
6601          * The value 1 - enable, 0 - disable
6602          * @hide
6603          */
6604        public static final String MULTI_SIM_SMS_PROMPT = "multi_sim_sms_prompt";
6605
6606
6607
6608        /** User preferred subscriptions setting.
6609          * This holds the details of the user selected subscription from the card and
6610          * the activation status. Each settings string have the coma separated values
6611          * iccId,appType,appId,activationStatus,3gppIndex,3gpp2Index
6612          * @hide
6613         */
6614        public static final String[] MULTI_SIM_USER_PREFERRED_SUBS = {"user_preferred_sub1",
6615                "user_preferred_sub2","user_preferred_sub3"};
6616    }
6617
6618    /**
6619     * User-defined bookmarks and shortcuts.  The target of each bookmark is an
6620     * Intent URL, allowing it to be either a web page or a particular
6621     * application activity.
6622     *
6623     * @hide
6624     */
6625    public static final class Bookmarks implements BaseColumns
6626    {
6627        private static final String TAG = "Bookmarks";
6628
6629        /**
6630         * The content:// style URL for this table
6631         */
6632        public static final Uri CONTENT_URI =
6633            Uri.parse("content://" + AUTHORITY + "/bookmarks");
6634
6635        /**
6636         * The row ID.
6637         * <p>Type: INTEGER</p>
6638         */
6639        public static final String ID = "_id";
6640
6641        /**
6642         * Descriptive name of the bookmark that can be displayed to the user.
6643         * If this is empty, the title should be resolved at display time (use
6644         * {@link #getTitle(Context, Cursor)} any time you want to display the
6645         * title of a bookmark.)
6646         * <P>
6647         * Type: TEXT
6648         * </P>
6649         */
6650        public static final String TITLE = "title";
6651
6652        /**
6653         * Arbitrary string (displayed to the user) that allows bookmarks to be
6654         * organized into categories.  There are some special names for
6655         * standard folders, which all start with '@'.  The label displayed for
6656         * the folder changes with the locale (via {@link #getLabelForFolder}) but
6657         * the folder name does not change so you can consistently query for
6658         * the folder regardless of the current locale.
6659         *
6660         * <P>Type: TEXT</P>
6661         *
6662         */
6663        public static final String FOLDER = "folder";
6664
6665        /**
6666         * The Intent URL of the bookmark, describing what it points to.  This
6667         * value is given to {@link android.content.Intent#getIntent} to create
6668         * an Intent that can be launched.
6669         * <P>Type: TEXT</P>
6670         */
6671        public static final String INTENT = "intent";
6672
6673        /**
6674         * Optional shortcut character associated with this bookmark.
6675         * <P>Type: INTEGER</P>
6676         */
6677        public static final String SHORTCUT = "shortcut";
6678
6679        /**
6680         * The order in which the bookmark should be displayed
6681         * <P>Type: INTEGER</P>
6682         */
6683        public static final String ORDERING = "ordering";
6684
6685        private static final String[] sIntentProjection = { INTENT };
6686        private static final String[] sShortcutProjection = { ID, SHORTCUT };
6687        private static final String sShortcutSelection = SHORTCUT + "=?";
6688
6689        /**
6690         * Convenience function to retrieve the bookmarked Intent for a
6691         * particular shortcut key.
6692         *
6693         * @param cr The ContentResolver to query.
6694         * @param shortcut The shortcut key.
6695         *
6696         * @return Intent The bookmarked URL, or null if there is no bookmark
6697         *         matching the given shortcut.
6698         */
6699        public static Intent getIntentForShortcut(ContentResolver cr, char shortcut)
6700        {
6701            Intent intent = null;
6702
6703            Cursor c = cr.query(CONTENT_URI,
6704                    sIntentProjection, sShortcutSelection,
6705                    new String[] { String.valueOf((int) shortcut) }, ORDERING);
6706            // Keep trying until we find a valid shortcut
6707            try {
6708                while (intent == null && c.moveToNext()) {
6709                    try {
6710                        String intentURI = c.getString(c.getColumnIndexOrThrow(INTENT));
6711                        intent = Intent.parseUri(intentURI, 0);
6712                    } catch (java.net.URISyntaxException e) {
6713                        // The stored URL is bad...  ignore it.
6714                    } catch (IllegalArgumentException e) {
6715                        // Column not found
6716                        Log.w(TAG, "Intent column not found", e);
6717                    }
6718                }
6719            } finally {
6720                if (c != null) c.close();
6721            }
6722
6723            return intent;
6724        }
6725
6726        /**
6727         * Add a new bookmark to the system.
6728         *
6729         * @param cr The ContentResolver to query.
6730         * @param intent The desired target of the bookmark.
6731         * @param title Bookmark title that is shown to the user; null if none
6732         *            or it should be resolved to the intent's title.
6733         * @param folder Folder in which to place the bookmark; null if none.
6734         * @param shortcut Shortcut that will invoke the bookmark; 0 if none. If
6735         *            this is non-zero and there is an existing bookmark entry
6736         *            with this same shortcut, then that existing shortcut is
6737         *            cleared (the bookmark is not removed).
6738         * @return The unique content URL for the new bookmark entry.
6739         */
6740        public static Uri add(ContentResolver cr,
6741                                           Intent intent,
6742                                           String title,
6743                                           String folder,
6744                                           char shortcut,
6745                                           int ordering)
6746        {
6747            // If a shortcut is supplied, and it is already defined for
6748            // another bookmark, then remove the old definition.
6749            if (shortcut != 0) {
6750                cr.delete(CONTENT_URI, sShortcutSelection,
6751                        new String[] { String.valueOf((int) shortcut) });
6752            }
6753
6754            ContentValues values = new ContentValues();
6755            if (title != null) values.put(TITLE, title);
6756            if (folder != null) values.put(FOLDER, folder);
6757            values.put(INTENT, intent.toUri(0));
6758            if (shortcut != 0) values.put(SHORTCUT, (int) shortcut);
6759            values.put(ORDERING, ordering);
6760            return cr.insert(CONTENT_URI, values);
6761        }
6762
6763        /**
6764         * Return the folder name as it should be displayed to the user.  This
6765         * takes care of localizing special folders.
6766         *
6767         * @param r Resources object for current locale; only need access to
6768         *          system resources.
6769         * @param folder The value found in the {@link #FOLDER} column.
6770         *
6771         * @return CharSequence The label for this folder that should be shown
6772         *         to the user.
6773         */
6774        public static CharSequence getLabelForFolder(Resources r, String folder) {
6775            return folder;
6776        }
6777
6778        /**
6779         * Return the title as it should be displayed to the user. This takes
6780         * care of localizing bookmarks that point to activities.
6781         *
6782         * @param context A context.
6783         * @param cursor A cursor pointing to the row whose title should be
6784         *        returned. The cursor must contain at least the {@link #TITLE}
6785         *        and {@link #INTENT} columns.
6786         * @return A title that is localized and can be displayed to the user,
6787         *         or the empty string if one could not be found.
6788         */
6789        public static CharSequence getTitle(Context context, Cursor cursor) {
6790            int titleColumn = cursor.getColumnIndex(TITLE);
6791            int intentColumn = cursor.getColumnIndex(INTENT);
6792            if (titleColumn == -1 || intentColumn == -1) {
6793                throw new IllegalArgumentException(
6794                        "The cursor must contain the TITLE and INTENT columns.");
6795            }
6796
6797            String title = cursor.getString(titleColumn);
6798            if (!TextUtils.isEmpty(title)) {
6799                return title;
6800            }
6801
6802            String intentUri = cursor.getString(intentColumn);
6803            if (TextUtils.isEmpty(intentUri)) {
6804                return "";
6805            }
6806
6807            Intent intent;
6808            try {
6809                intent = Intent.parseUri(intentUri, 0);
6810            } catch (URISyntaxException e) {
6811                return "";
6812            }
6813
6814            PackageManager packageManager = context.getPackageManager();
6815            ResolveInfo info = packageManager.resolveActivity(intent, 0);
6816            return info != null ? info.loadLabel(packageManager) : "";
6817        }
6818    }
6819
6820    /**
6821     * Returns the device ID that we should use when connecting to the mobile gtalk server.
6822     * This is a string like "android-0x1242", where the hex string is the Android ID obtained
6823     * from the GoogleLoginService.
6824     *
6825     * @param androidId The Android ID for this device.
6826     * @return The device ID that should be used when connecting to the mobile gtalk server.
6827     * @hide
6828     */
6829    public static String getGTalkDeviceId(long androidId) {
6830        return "android-" + Long.toHexString(androidId);
6831    }
6832}
6833