blob: a78f4687df2fdf617e88351328f3f0b521fdc338 [file] [log] [blame]
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001/*
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
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080019import android.annotation.SdkConstant;
20import android.annotation.SdkConstant.SdkConstantType;
Bryce Leecdfebd62015-02-02 08:19:11 -080021import android.annotation.SystemApi;
Jeff Sharkeya73b8fd2016-01-06 17:02:08 -070022import android.annotation.TestApi;
Adrian Roos7811d9f2015-07-27 15:10:13 -070023import android.app.ActivityThread;
Billy Lau6ad2d662015-07-18 00:26:58 +010024import android.app.AppOpsManager;
Adrian Roos7811d9f2015-07-27 15:10:13 -070025import android.app.Application;
Narayan Kamathee69ff42011-06-28 12:07:18 +010026import android.app.SearchManager;
Jeff Sharkey6e2bee72012-10-01 13:39:08 -070027import android.app.WallpaperManager;
Mike LeBeau5d34e9b2010-02-10 19:34:56 -080028import android.content.ComponentName;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080029import android.content.ContentResolver;
30import android.content.ContentValues;
31import android.content.Context;
Brad Fitzpatrick1877d012010-03-04 17:48:13 -080032import android.content.IContentProvider;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080033import android.content.Intent;
Dianne Hackbornb8b11a02010-03-10 15:53:11 -080034import android.content.pm.ActivityInfo;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080035import android.content.pm.PackageManager;
36import android.content.pm.ResolveInfo;
37import android.content.res.Configuration;
38import android.content.res.Resources;
39import android.database.Cursor;
40import android.database.SQLException;
David Christie3f7b6522013-08-06 19:19:08 -070041import android.location.LocationManager;
Jeff Sharkey625239a2012-09-26 22:03:49 -070042import android.net.ConnectivityManager;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080043import android.net.Uri;
Irfan Sheriff36f74132010-11-04 16:57:37 -070044import android.net.wifi.WifiManager;
Svetoslav Ganov585f13f8d2010-08-10 07:59:15 -070045import android.os.BatteryManager;
Billy Lau6ad2d662015-07-18 00:26:58 +010046import android.os.Binder;
Svetoslav Ganov585f13f8d2010-08-10 07:59:15 -070047import android.os.Bundle;
Jeff Sharkey625239a2012-09-26 22:03:49 -070048import android.os.DropBoxManager;
Amith Yamasani52c489c2012-03-28 11:42:42 -070049import android.os.IBinder;
Amith Yamasani7ab8c4a2012-04-06 09:27:12 -070050import android.os.Process;
Svetoslav Ganov585f13f8d2010-08-10 07:59:15 -070051import android.os.RemoteException;
Amith Yamasani52c489c2012-03-28 11:42:42 -070052import android.os.ServiceManager;
Svetoslav Ganov585f13f8d2010-08-10 07:59:15 -070053import android.os.SystemProperties;
Dianne Hackbornf02b60a2012-08-16 10:48:27 -070054import android.os.UserHandle;
Jeff Sharkey625239a2012-09-26 22:03:49 -070055import android.os.Build.VERSION_CODES;
Narayan Kamath6d632962011-08-24 11:51:37 +010056import android.speech.tts.TextToSpeech;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080057import android.text.TextUtils;
58import android.util.AndroidException;
Svetoslav683914b2015-01-15 14:22:26 -080059import android.util.ArrayMap;
60import android.util.ArraySet;
Seigo Nonakabd5cbdd2016-01-25 19:40:28 +090061import android.util.LocaleList;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080062import android.util.Log;
63
Svetoslav683914b2015-01-15 14:22:26 -080064import com.android.internal.util.ArrayUtils;
Amith Yamasani52c489c2012-03-28 11:42:42 -070065import com.android.internal.widget.ILockSettings;
66
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080067import java.net.URISyntaxException;
Svetoslav683914b2015-01-15 14:22:26 -080068import java.text.SimpleDateFormat;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080069import java.util.HashMap;
70import java.util.HashSet;
Elliott Hughescb64d432013-08-02 10:00:44 -070071import java.util.Locale;
Svetoslav683914b2015-01-15 14:22:26 -080072import java.util.Map;
73import java.util.Set;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080074
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080075/**
76 * The Settings provider contains global system-level device preferences.
77 */
78public final class Settings {
79
80 // Intent actions for Settings
81
82 /**
83 * Activity Action: Show system settings.
84 * <p>
85 * Input: Nothing.
86 * <p>
Gilles Debunnee90bed12011-08-30 14:28:27 -070087 * Output: Nothing.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080088 */
89 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
90 public static final String ACTION_SETTINGS = "android.settings.SETTINGS";
91
92 /**
93 * Activity Action: Show settings to allow configuration of APNs.
94 * <p>
95 * Input: Nothing.
96 * <p>
Gilles Debunnee90bed12011-08-30 14:28:27 -070097 * Output: Nothing.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080098 */
99 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
100 public static final String ACTION_APN_SETTINGS = "android.settings.APN_SETTINGS";
101
102 /**
103 * Activity Action: Show settings to allow configuration of current location
104 * sources.
105 * <p>
106 * In some cases, a matching Activity may not exist, so ensure you
107 * safeguard against this.
108 * <p>
109 * Input: Nothing.
110 * <p>
111 * Output: Nothing.
112 */
113 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
114 public static final String ACTION_LOCATION_SOURCE_SETTINGS =
115 "android.settings.LOCATION_SOURCE_SETTINGS";
116
117 /**
Jason Monk76c67aa2016-02-19 14:49:42 -0500118 * Activity Action: Show settings to allow configuration of users.
119 * <p>
120 * In some cases, a matching Activity may not exist, so ensure you
121 * safeguard against this.
122 * <p>
123 * Input: Nothing.
124 * <p>
125 * Output: Nothing.
126 * @hide
127 */
128 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
129 public static final String ACTION_USER_SETTINGS =
130 "android.settings.USER_SETTINGS";
131
132 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800133 * Activity Action: Show settings to allow configuration of wireless controls
134 * such as Wi-Fi, Bluetooth and Mobile networks.
135 * <p>
136 * In some cases, a matching Activity may not exist, so ensure you
137 * safeguard against this.
138 * <p>
139 * Input: Nothing.
140 * <p>
141 * Output: Nothing.
142 */
143 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
144 public static final String ACTION_WIRELESS_SETTINGS =
145 "android.settings.WIRELESS_SETTINGS";
146
147 /**
Jeremy Klein15f3d212016-01-24 17:01:09 -0800148 * Activity Action: Show tether provisioning activity.
149 *
150 * <p>
151 * In some cases, a matching Activity may not exist, so ensure you
152 * safeguard against this.
153 * <p>
154 * Input: {@link ConnectivityManager.EXTRA_TETHER_TYPE} should be included to specify which type
155 * of tethering should be checked. {@link ConnectivityManager.EXTRA_PROVISION_CALLBACK} should
156 * contain a {@link ResultReceiver} which will be called back with a tether result code.
157 * <p>
158 * Output: The result of the provisioning check.
159 * {@link ConnectivityManager.TETHER_ERROR_NO_ERROR} if successful,
160 * {@link ConnectivityManager.TETHER_ERROR_PROVISION_FAILED} for failure.
161 *
162 * @hide
163 */
164 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
165 public static final String ACTION_TETHER_PROVISIONING =
166 "android.settings.TETHER_PROVISIONING_UI";
167
168 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800169 * Activity Action: Show settings to allow entering/exiting airplane mode.
170 * <p>
171 * In some cases, a matching Activity may not exist, so ensure you
172 * safeguard against this.
173 * <p>
174 * Input: Nothing.
175 * <p>
176 * Output: Nothing.
177 */
178 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
179 public static final String ACTION_AIRPLANE_MODE_SETTINGS =
180 "android.settings.AIRPLANE_MODE_SETTINGS";
181
182 /**
Barnaby Jamesb3006d32015-04-02 17:49:54 -0700183 * Activity Action: Modify Airplane mode settings using a voice command.
Barnaby James48f35522014-07-16 14:27:39 -0700184 * <p>
185 * In some cases, a matching Activity may not exist, so ensure you safeguard against this.
186 * <p>
187 * This intent MUST be started using
188 * {@link android.service.voice.VoiceInteractionSession#startVoiceActivity
189 * startVoiceActivity}.
190 * <p>
Barnaby Jamesb3006d32015-04-02 17:49:54 -0700191 * Note: The activity implementing this intent MUST verify that
Barnaby James48f35522014-07-16 14:27:39 -0700192 * {@link android.app.Activity#isVoiceInteraction isVoiceInteraction} returns true before
193 * modifying the setting.
194 * <p>
Barnaby Jamesb3006d32015-04-02 17:49:54 -0700195 * Input: To tell which state airplane mode should be set to, add the
196 * {@link #EXTRA_AIRPLANE_MODE_ENABLED} extra to this Intent with the state specified.
197 * If the extra is not included, no changes will be made.
Barnaby James48f35522014-07-16 14:27:39 -0700198 * <p>
199 * Output: Nothing.
200 */
201 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
202 public static final String ACTION_VOICE_CONTROL_AIRPLANE_MODE =
203 "android.settings.VOICE_CONTROL_AIRPLANE_MODE";
204
205 /**
Dianne Hackborndd9b82c2009-09-03 00:18:47 -0700206 * Activity Action: Show settings for accessibility modules.
207 * <p>
208 * In some cases, a matching Activity may not exist, so ensure you
209 * safeguard against this.
210 * <p>
211 * Input: Nothing.
212 * <p>
213 * Output: Nothing.
214 */
215 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
216 public static final String ACTION_ACCESSIBILITY_SETTINGS =
217 "android.settings.ACCESSIBILITY_SETTINGS";
218
219 /**
Dianne Hackborna3fb40d2014-08-12 15:06:50 -0700220 * Activity Action: Show settings to control access to usage information.
221 * <p>
222 * In some cases, a matching Activity may not exist, so ensure you
223 * safeguard against this.
224 * <p>
225 * Input: Nothing.
226 * <p>
227 * Output: Nothing.
228 */
229 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
230 public static final String ACTION_USAGE_ACCESS_SETTINGS =
231 "android.settings.USAGE_ACCESS_SETTINGS";
232
233 /**
Jason Monk6f909782015-04-17 14:30:25 -0400234 * Activity Category: Show application settings related to usage access.
235 * <p>
236 * An activity that provides a user interface for adjusting usage access related
237 * preferences for its containing application. Optional but recommended for apps that
238 * use {@link android.Manifest.permission#PACKAGE_USAGE_STATS}.
239 * <p>
240 * The activity may define meta-data to describe what usage access is
241 * used for within their app with {@link #METADATA_USAGE_ACCESS_REASON}, which
242 * will be displayed in Settings.
243 * <p>
244 * Input: Nothing.
245 * <p>
246 * Output: Nothing.
247 */
248 @SdkConstant(SdkConstantType.INTENT_CATEGORY)
249 public static final String INTENT_CATEGORY_USAGE_ACCESS_CONFIG =
250 "android.intent.category.USAGE_ACCESS_CONFIG";
251
252 /**
253 * Metadata key: Reason for needing usage access.
254 * <p>
255 * A key for metadata attached to an activity that receives action
256 * {@link #INTENT_CATEGORY_USAGE_ACCESS_CONFIG}, shown to the
257 * user as description of how the app uses usage access.
258 * <p>
259 */
260 public static final String METADATA_USAGE_ACCESS_REASON =
261 "android.settings.metadata.USAGE_ACCESS_REASON";
262
263 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800264 * Activity Action: Show settings to allow configuration of security and
265 * location privacy.
266 * <p>
267 * In some cases, a matching Activity may not exist, so ensure you
268 * safeguard against this.
269 * <p>
270 * Input: Nothing.
271 * <p>
272 * Output: Nothing.
273 */
274 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
275 public static final String ACTION_SECURITY_SETTINGS =
276 "android.settings.SECURITY_SETTINGS";
277
278 /**
Maggie Benthall0469f412013-09-05 15:30:26 -0400279 * Activity Action: Show trusted credentials settings, opening to the user tab,
280 * to allow management of installed credentials.
281 * <p>
282 * In some cases, a matching Activity may not exist, so ensure you
283 * safeguard against this.
284 * <p>
285 * Input: Nothing.
286 * <p>
287 * Output: Nothing.
288 * @hide
289 */
290 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
291 public static final String ACTION_TRUSTED_CREDENTIALS_USER =
292 "com.android.settings.TRUSTED_CREDENTIALS_USER";
293
294 /**
295 * Activity Action: Show dialog explaining that an installed CA cert may enable
296 * monitoring of encrypted network traffic.
297 * <p>
298 * In some cases, a matching Activity may not exist, so ensure you
299 * safeguard against this.
300 * <p>
301 * Input: Nothing.
302 * <p>
303 * Output: Nothing.
304 * @hide
305 */
306 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
307 public static final String ACTION_MONITORING_CERT_INFO =
308 "com.android.settings.MONITORING_CERT_INFO";
309
310 /**
Amith Yamasanic15255a2009-09-23 15:33:19 -0700311 * Activity Action: Show settings to allow configuration of privacy options.
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_PRIVACY_SETTINGS =
322 "android.settings.PRIVACY_SETTINGS";
323
324 /**
Robin Leea249aee2016-02-03 13:42:56 +0000325 * Activity Action: Show settings to allow configuration of VPN.
326 * <p>
327 * In some cases, a matching Activity may not exist, so ensure you
328 * safeguard against this.
329 * <p>
330 * Input: Nothing.
331 * <p>
332 * Output: Nothing.
333 */
334 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
335 public static final String ACTION_VPN_SETTINGS =
336 "android.settings.VPN_SETTINGS";
337
338 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800339 * Activity Action: Show settings to allow configuration of Wi-Fi.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800340 * <p>
341 * In some cases, a matching Activity may not exist, so ensure you
342 * safeguard against this.
343 * <p>
344 * Input: Nothing.
345 * <p>
346 * Output: Nothing.
347
348 */
349 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
350 public static final String ACTION_WIFI_SETTINGS =
351 "android.settings.WIFI_SETTINGS";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -0700352
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800353 /**
354 * Activity Action: Show settings to allow configuration of a static IP
355 * address for Wi-Fi.
356 * <p>
357 * In some cases, a matching Activity may not exist, so ensure you safeguard
358 * against this.
359 * <p>
360 * Input: Nothing.
361 * <p>
362 * Output: Nothing.
363 */
364 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
365 public static final String ACTION_WIFI_IP_SETTINGS =
366 "android.settings.WIFI_IP_SETTINGS";
367
368 /**
369 * Activity Action: Show settings to allow configuration of Bluetooth.
370 * <p>
371 * In some cases, a matching Activity may not exist, so ensure you
372 * safeguard against this.
373 * <p>
374 * Input: Nothing.
375 * <p>
376 * Output: Nothing.
377 */
378 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
379 public static final String ACTION_BLUETOOTH_SETTINGS =
380 "android.settings.BLUETOOTH_SETTINGS";
381
382 /**
Jeff Brownc05c1ae2015-05-05 13:46:30 -0700383 * Activity Action: Show settings to allow configuration of cast endpoints.
Jeff Brown1a937b02014-07-01 22:13:04 -0700384 * <p>
385 * In some cases, a matching Activity may not exist, so ensure you
386 * safeguard against this.
387 * <p>
388 * Input: Nothing.
389 * <p>
390 * Output: Nothing.
391 */
392 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
393 public static final String ACTION_CAST_SETTINGS =
394 "android.settings.CAST_SETTINGS";
395
396 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800397 * Activity Action: Show settings to allow configuration of date and time.
398 * <p>
399 * In some cases, a matching Activity may not exist, so ensure you
400 * safeguard against this.
401 * <p>
402 * Input: Nothing.
403 * <p>
404 * Output: Nothing.
405 */
406 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
407 public static final String ACTION_DATE_SETTINGS =
408 "android.settings.DATE_SETTINGS";
409
410 /**
411 * Activity Action: Show settings to allow configuration of sound and volume.
412 * <p>
413 * In some cases, a matching Activity may not exist, so ensure you
414 * safeguard against this.
415 * <p>
416 * Input: Nothing.
417 * <p>
418 * Output: Nothing.
419 */
420 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
421 public static final String ACTION_SOUND_SETTINGS =
422 "android.settings.SOUND_SETTINGS";
423
424 /**
425 * Activity Action: Show settings to allow configuration of display.
426 * <p>
427 * In some cases, a matching Activity may not exist, so ensure you
428 * safeguard against this.
429 * <p>
430 * Input: Nothing.
431 * <p>
432 * Output: Nothing.
433 */
434 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
435 public static final String ACTION_DISPLAY_SETTINGS =
436 "android.settings.DISPLAY_SETTINGS";
437
438 /**
439 * Activity Action: Show settings to allow configuration of locale.
440 * <p>
441 * In some cases, a matching Activity may not exist, so ensure you
442 * safeguard against this.
443 * <p>
444 * Input: Nothing.
445 * <p>
446 * Output: Nothing.
447 */
448 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
449 public static final String ACTION_LOCALE_SETTINGS =
450 "android.settings.LOCALE_SETTINGS";
451
452 /**
453 * Activity Action: Show settings to configure input methods, in particular
454 * allowing the user to enable input methods.
455 * <p>
456 * In some cases, a matching Activity may not exist, so ensure you
457 * safeguard against this.
458 * <p>
459 * Input: Nothing.
460 * <p>
461 * Output: Nothing.
462 */
463 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
Dianne Hackborna3fb40d2014-08-12 15:06:50 -0700464 public static final String ACTION_VOICE_INPUT_SETTINGS =
465 "android.settings.VOICE_INPUT_SETTINGS";
466
467 /**
468 * Activity Action: Show settings to configure input methods, in particular
469 * allowing the user to enable input methods.
470 * <p>
471 * In some cases, a matching Activity may not exist, so ensure you
472 * safeguard against this.
473 * <p>
474 * Input: Nothing.
475 * <p>
476 * Output: Nothing.
477 */
478 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800479 public static final String ACTION_INPUT_METHOD_SETTINGS =
480 "android.settings.INPUT_METHOD_SETTINGS";
481
482 /**
Tadashi G. Takaokaf49688f2011-01-20 17:56:13 +0900483 * Activity Action: Show settings to enable/disable input method subtypes.
satok86417ea2010-10-27 14:11:03 +0900484 * <p>
485 * In some cases, a matching Activity may not exist, so ensure you
486 * safeguard against this.
487 * <p>
Tadashi G. Takaoka25480202011-01-20 23:13:02 +0900488 * To tell which input method's subtypes are displayed in the settings, add
489 * {@link #EXTRA_INPUT_METHOD_ID} extra to this Intent with the input method id.
490 * If there is no extra in this Intent, subtypes from all installed input methods
491 * will be displayed in the settings.
492 *
493 * @see android.view.inputmethod.InputMethodInfo#getId
494 * <p>
satok86417ea2010-10-27 14:11:03 +0900495 * Input: Nothing.
496 * <p>
497 * Output: Nothing.
498 */
499 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
Tadashi G. Takaokaf49688f2011-01-20 17:56:13 +0900500 public static final String ACTION_INPUT_METHOD_SUBTYPE_SETTINGS =
501 "android.settings.INPUT_METHOD_SUBTYPE_SETTINGS";
satok86417ea2010-10-27 14:11:03 +0900502
503 /**
satok7cfc0ed2011-06-20 21:29:36 +0900504 * Activity Action: Show a dialog to select input method.
505 * <p>
506 * In some cases, a matching Activity may not exist, so ensure you
507 * safeguard against this.
508 * <p>
509 * Input: Nothing.
510 * <p>
511 * Output: Nothing.
512 * @hide
513 */
514 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
515 public static final String ACTION_SHOW_INPUT_METHOD_PICKER =
516 "android.settings.SHOW_INPUT_METHOD_PICKER";
517
518 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800519 * Activity Action: Show settings to manage the user input dictionary.
520 * <p>
Chet Haasee8222dd2013-09-05 07:44:18 -0700521 * Starting with {@link android.os.Build.VERSION_CODES#KITKAT},
Satoshi Kataoka2aa2bc52013-07-30 14:25:11 +0900522 * it is guaranteed there will always be an appropriate implementation for this Intent action.
523 * In prior releases of the platform this was optional, so ensure you safeguard against it.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800524 * <p>
525 * Input: Nothing.
526 * <p>
527 * Output: Nothing.
528 */
529 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
530 public static final String ACTION_USER_DICTIONARY_SETTINGS =
531 "android.settings.USER_DICTIONARY_SETTINGS";
532
533 /**
Abodunrinwa Toki07177142016-03-22 16:25:48 +0000534 * Activity Action: Show settings to configure the hardware keyboard.
Yohei Yukawad8701bf2016-01-27 16:15:01 -0800535 * <p>
536 * In some cases, a matching Activity may not exist, so ensure you
537 * safeguard against this.
538 * <p>
Yohei Yukawad8701bf2016-01-27 16:15:01 -0800539 * Input: Nothing.
540 * <p>
541 * Output: Nothing.
542 */
543 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
Abodunrinwa Toki07177142016-03-22 16:25:48 +0000544 public static final String ACTION_HARD_KEYBOARD_SETTINGS =
545 "android.settings.HARD_KEYBOARD_SETTINGS";
Yohei Yukawad8701bf2016-01-27 16:15:01 -0800546
547 /**
Gilles Debunnee90bed12011-08-30 14:28:27 -0700548 * Activity Action: Adds a word to the user dictionary.
549 * <p>
550 * In some cases, a matching Activity may not exist, so ensure you
551 * safeguard against this.
552 * <p>
553 * Input: An extra with key <code>word</code> that contains the word
554 * that should be added to the dictionary.
555 * <p>
556 * Output: Nothing.
557 *
558 * @hide
559 */
560 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
561 public static final String ACTION_USER_DICTIONARY_INSERT =
562 "com.android.settings.USER_DICTIONARY_INSERT";
563
564 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800565 * Activity Action: Show settings to allow configuration of application-related settings.
566 * <p>
567 * In some cases, a matching Activity may not exist, so ensure you
568 * safeguard against this.
569 * <p>
570 * Input: Nothing.
571 * <p>
572 * Output: Nothing.
573 */
574 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
575 public static final String ACTION_APPLICATION_SETTINGS =
576 "android.settings.APPLICATION_SETTINGS";
577
578 /**
579 * Activity Action: Show settings to allow configuration of application
Dianne Hackborn8d866e52012-10-10 18:39:45 -0700580 * development-related settings. As of
581 * {@link android.os.Build.VERSION_CODES#JELLY_BEAN_MR1} this action is
582 * a required part of the platform.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800583 * <p>
584 * Input: Nothing.
585 * <p>
586 * Output: Nothing.
587 */
588 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
589 public static final String ACTION_APPLICATION_DEVELOPMENT_SETTINGS =
590 "android.settings.APPLICATION_DEVELOPMENT_SETTINGS";
591
592 /**
593 * Activity Action: Show settings to allow configuration of quick launch shortcuts.
594 * <p>
595 * In some cases, a matching Activity may not exist, so ensure you
596 * safeguard against this.
597 * <p>
598 * Input: Nothing.
599 * <p>
600 * Output: Nothing.
601 */
602 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
603 public static final String ACTION_QUICK_LAUNCH_SETTINGS =
604 "android.settings.QUICK_LAUNCH_SETTINGS";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -0700605
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800606 /**
607 * Activity Action: Show settings to manage installed applications.
608 * <p>
609 * In some cases, a matching Activity may not exist, so ensure you
610 * safeguard against this.
611 * <p>
612 * Input: Nothing.
613 * <p>
614 * Output: Nothing.
615 */
616 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
617 public static final String ACTION_MANAGE_APPLICATIONS_SETTINGS =
618 "android.settings.MANAGE_APPLICATIONS_SETTINGS";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -0700619
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800620 /**
Winson Chung44e8ff92010-09-27 14:36:52 -0700621 * Activity Action: Show settings to manage all applications.
622 * <p>
623 * In some cases, a matching Activity may not exist, so ensure you
624 * safeguard against this.
625 * <p>
626 * Input: Nothing.
627 * <p>
628 * Output: Nothing.
629 */
630 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
631 public static final String ACTION_MANAGE_ALL_APPLICATIONS_SETTINGS =
632 "android.settings.MANAGE_ALL_APPLICATIONS_SETTINGS";
633
634 /**
Billy Lau6ad2d662015-07-18 00:26:58 +0100635 * Activity Action: Show screen for controlling which apps can draw on top of other apps.
Billy Laucbe540f2015-06-25 01:51:44 +0100636 * <p>
637 * In some cases, a matching Activity may not exist, so ensure you
638 * safeguard against this.
639 * <p>
Billy Lau6ad2d662015-07-18 00:26:58 +0100640 * Input: Optionally, the Intent's data URI can specify the application package name to
641 * directly invoke the management GUI specific to the package name. For example
642 * "package:com.my.app".
Billy Laucbe540f2015-06-25 01:51:44 +0100643 * <p>
644 * Output: Nothing.
645 */
646 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
647 public static final String ACTION_MANAGE_OVERLAY_PERMISSION =
Billy Lau22b3f4c2015-07-08 00:31:01 +0100648 "android.settings.action.MANAGE_OVERLAY_PERMISSION";
649
650 /**
Billy Lau6ad2d662015-07-18 00:26:58 +0100651 * Activity Action: Show screen for controlling which apps are allowed to write/modify
652 * system settings.
Billy Lau22b3f4c2015-07-08 00:31:01 +0100653 * <p>
654 * In some cases, a matching Activity may not exist, so ensure you
655 * safeguard against this.
656 * <p>
Billy Lau6ad2d662015-07-18 00:26:58 +0100657 * Input: Optionally, the Intent's data URI can specify the application package name to
658 * directly invoke the management GUI specific to the package name. For example
659 * "package:com.my.app".
Billy Lau22b3f4c2015-07-08 00:31:01 +0100660 * <p>
661 * Output: Nothing.
662 */
663 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
664 public static final String ACTION_MANAGE_WRITE_SETTINGS =
665 "android.settings.action.MANAGE_WRITE_SETTINGS";
Billy Laucbe540f2015-06-25 01:51:44 +0100666
667 /**
Dianne Hackbornb7bb3b32010-06-06 22:47:50 -0700668 * Activity Action: Show screen of details about a particular application.
669 * <p>
670 * In some cases, a matching Activity may not exist, so ensure you
671 * safeguard against this.
672 * <p>
673 * Input: The Intent's data URI specifies the application package name
674 * to be shown, with the "package" scheme. That is "package:com.my.app".
675 * <p>
676 * Output: Nothing.
677 */
678 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
679 public static final String ACTION_APPLICATION_DETAILS_SETTINGS =
680 "android.settings.APPLICATION_DETAILS_SETTINGS";
681
682 /**
Jason Monk287b8892015-06-10 10:39:23 -0400683 * Activity Action: Show screen for controlling which apps can ignore battery optimizations.
684 * <p>
Dianne Hackbornc7b57b12015-08-10 14:52:52 -0700685 * Input: Nothing.
686 * <p>
687 * Output: Nothing.
688 * <p>
689 * You can use {@link android.os.PowerManager#isIgnoringBatteryOptimizations
690 * PowerManager.isIgnoringBatteryOptimizations()} to determine if an application is
691 * already ignoring optimizations. You can use
692 * {@link #ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS} to ask the user to put you
693 * on this list.
694 */
695 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
696 public static final String ACTION_IGNORE_BATTERY_OPTIMIZATION_SETTINGS =
697 "android.settings.IGNORE_BATTERY_OPTIMIZATION_SETTINGS";
698
699 /**
Felipe Leme5f5d7072016-01-27 10:41:22 -0800700 * Activity Action: Ask the user to allow an app to ignore battery optimizations (that is,
Dianne Hackbornc7b57b12015-08-10 14:52:52 -0700701 * put them on the whitelist of apps shown by
702 * {@link #ACTION_IGNORE_BATTERY_OPTIMIZATION_SETTINGS}). For an app to use this, it also
703 * must hold the {@link android.Manifest.permission#REQUEST_IGNORE_BATTERY_OPTIMIZATIONS}
704 * permission.
705 * <p><b>Note:</b> most applications should <em>not</em> use this; there are many facilities
706 * provided by the platform for applications to operate correctly in the various power
Felipe Leme5f5d7072016-01-27 10:41:22 -0800707 * saving modes. This is only for unusual applications that need to deeply control their own
Dianne Hackbornc7b57b12015-08-10 14:52:52 -0700708 * execution, at the potential expense of the user's battery life. Note that these applications
Kweku Adamseb80f7c2016-01-12 11:46:52 -0800709 * greatly run the risk of showing to the user as high power consumers on their device.</p>
Dianne Hackbornc7b57b12015-08-10 14:52:52 -0700710 * <p>
711 * Input: The Intent's data URI must specify the application package name
Jason Monk287b8892015-06-10 10:39:23 -0400712 * to be shown, with the "package" scheme. That is "package:com.my.app".
713 * <p>
714 * Output: Nothing.
Dianne Hackborn1958e5e2015-06-12 18:11:41 -0700715 * <p>
716 * You can use {@link android.os.PowerManager#isIgnoringBatteryOptimizations
717 * PowerManager.isIgnoringBatteryOptimizations()} to determine if an application is
718 * already ignoring optimizations.
Jason Monk287b8892015-06-10 10:39:23 -0400719 */
720 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
Dianne Hackbornc7b57b12015-08-10 14:52:52 -0700721 public static final String ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS =
722 "android.settings.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS";
Jason Monk287b8892015-06-10 10:39:23 -0400723
724 /**
Felipe Leme5f5d7072016-01-27 10:41:22 -0800725 * Activity Action: Show screen for controlling which apps can ignore background data
726 * restrictions.
727 * <p>
728 * Input: if the Intent's data URI is set with an application name (using the "package" schema,
729 * like "package:com.my.app"), then when the screen is displayed it will focus on such app. If
730 * the data is not set, it will just open the screen.
731 * <p>
732 * Output: Nothing.
733 * <p>
734 * Applications can also use {@link android.net.ConnectivityManager#getRestrictBackgroundStatus
735 * ConnectivityManager#getRestrictBackgroundStatus()} to determine the status of the background
736 * data restrictions for them.
737 */
738 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
739 public static final String ACTION_IGNORE_BACKGROUND_DATA_RESTRICTIONS_SETTINGS =
740 "android.settings.IGNORE_BACKGROUND_DATA_RESTRICTIONS_SETTINGS";
741
742 /**
Dianne Hackborn35654b62013-01-14 17:38:02 -0800743 * @hide
744 * Activity Action: Show the "app ops" settings screen.
745 * <p>
746 * Input: Nothing.
747 * <p>
748 * Output: Nothing.
749 */
750 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
751 public static final String ACTION_APP_OPS_SETTINGS =
752 "android.settings.APP_OPS_SETTINGS";
753
754 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800755 * Activity Action: Show settings for system update functionality.
756 * <p>
757 * In some cases, a matching Activity may not exist, so ensure you
758 * safeguard against this.
759 * <p>
760 * Input: Nothing.
761 * <p>
762 * Output: Nothing.
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -0700763 *
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800764 * @hide
765 */
766 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
767 public static final String ACTION_SYSTEM_UPDATE_SETTINGS =
768 "android.settings.SYSTEM_UPDATE_SETTINGS";
769
770 /**
771 * Activity Action: Show settings to allow configuration of sync settings.
772 * <p>
773 * In some cases, a matching Activity may not exist, so ensure you
774 * safeguard against this.
775 * <p>
Erikeebc8e22010-02-18 13:27:19 -0800776 * The account types available to add via the add account button may be restricted by adding an
777 * {@link #EXTRA_AUTHORITIES} extra to this Intent with one or more syncable content provider's
778 * authorities. Only account types which can sync with that content provider will be offered to
779 * the user.
780 * <p>
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800781 * Input: Nothing.
782 * <p>
783 * Output: Nothing.
784 */
785 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
786 public static final String ACTION_SYNC_SETTINGS =
787 "android.settings.SYNC_SETTINGS";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -0700788
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800789 /**
Erikeebc8e22010-02-18 13:27:19 -0800790 * Activity Action: Show add account screen for creating a new account.
791 * <p>
792 * In some cases, a matching Activity may not exist, so ensure you
793 * safeguard against this.
794 * <p>
795 * The account types available to add may be restricted by adding an {@link #EXTRA_AUTHORITIES}
796 * extra to the Intent with one or more syncable content provider's authorities. Only account
797 * types which can sync with that content provider will be offered to the user.
798 * <p>
Alon Albert50359c22013-02-26 14:47:48 -0800799 * Account types can also be filtered by adding an {@link #EXTRA_ACCOUNT_TYPES} extra to the
800 * Intent with one or more account types.
801 * <p>
Erikeebc8e22010-02-18 13:27:19 -0800802 * Input: Nothing.
803 * <p>
804 * Output: Nothing.
805 */
806 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
807 public static final String ACTION_ADD_ACCOUNT =
808 "android.settings.ADD_ACCOUNT_SETTINGS";
809
810 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800811 * Activity Action: Show settings for selecting the network operator.
812 * <p>
813 * In some cases, a matching Activity may not exist, so ensure you
814 * safeguard against this.
815 * <p>
816 * Input: Nothing.
817 * <p>
818 * Output: Nothing.
819 */
820 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
821 public static final String ACTION_NETWORK_OPERATOR_SETTINGS =
822 "android.settings.NETWORK_OPERATOR_SETTINGS";
823
824 /**
825 * Activity Action: Show settings for selection of 2G/3G.
826 * <p>
827 * In some cases, a matching Activity may not exist, so ensure you
828 * safeguard against this.
829 * <p>
830 * Input: Nothing.
831 * <p>
832 * Output: Nothing.
833 */
834 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
835 public static final String ACTION_DATA_ROAMING_SETTINGS =
836 "android.settings.DATA_ROAMING_SETTINGS";
837
838 /**
839 * Activity Action: Show settings for internal storage.
840 * <p>
841 * In some cases, a matching Activity may not exist, so ensure you
842 * safeguard against this.
843 * <p>
844 * Input: Nothing.
845 * <p>
846 * Output: Nothing.
847 */
848 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
849 public static final String ACTION_INTERNAL_STORAGE_SETTINGS =
850 "android.settings.INTERNAL_STORAGE_SETTINGS";
851 /**
852 * Activity Action: Show settings for memory card storage.
853 * <p>
854 * In some cases, a matching Activity may not exist, so ensure you
855 * safeguard against this.
856 * <p>
857 * Input: Nothing.
858 * <p>
859 * Output: Nothing.
860 */
861 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
862 public static final String ACTION_MEMORY_CARD_SETTINGS =
863 "android.settings.MEMORY_CARD_SETTINGS";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -0700864
Justin Mattsonef340352010-01-13 21:05:46 -0800865 /**
866 * Activity Action: Show settings for global search.
867 * <p>
868 * In some cases, a matching Activity may not exist, so ensure you
869 * safeguard against this.
870 * <p>
871 * Input: Nothing.
872 * <p>
873 * Output: Nothing
874 */
875 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
876 public static final String ACTION_SEARCH_SETTINGS =
877 "android.search.action.SEARCH_SETTINGS";
878
Daniel Sandler9d8b8762010-01-22 20:50:15 -0500879 /**
880 * Activity Action: Show general device information settings (serial
881 * number, software version, phone number, etc.).
882 * <p>
883 * In some cases, a matching Activity may not exist, so ensure you
884 * safeguard against this.
885 * <p>
886 * Input: Nothing.
887 * <p>
888 * Output: Nothing
889 */
890 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
891 public static final String ACTION_DEVICE_INFO_SETTINGS =
892 "android.settings.DEVICE_INFO_SETTINGS";
893
Martijn Coenen9b3c83f2011-07-28 11:21:39 -0500894 /**
Nick Pellycccf01d2011-10-31 14:49:40 -0700895 * Activity Action: Show NFC settings.
896 * <p>
897 * This shows UI that allows NFC to be turned on or off.
Martijn Coenen9b3c83f2011-07-28 11:21:39 -0500898 * <p>
899 * In some cases, a matching Activity may not exist, so ensure you
900 * safeguard against this.
901 * <p>
902 * Input: Nothing.
903 * <p>
904 * Output: Nothing
Nick Pellycccf01d2011-10-31 14:49:40 -0700905 * @see android.nfc.NfcAdapter#isEnabled()
906 */
907 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
908 public static final String ACTION_NFC_SETTINGS = "android.settings.NFC_SETTINGS";
909
910 /**
911 * Activity Action: Show NFC Sharing settings.
912 * <p>
913 * This shows UI that allows NDEF Push (Android Beam) to be turned on or
914 * off.
915 * <p>
916 * In some cases, a matching Activity may not exist, so ensure you
917 * safeguard against this.
918 * <p>
919 * Input: Nothing.
920 * <p>
921 * Output: Nothing
922 * @see android.nfc.NfcAdapter#isNdefPushEnabled()
Martijn Coenen9b3c83f2011-07-28 11:21:39 -0500923 */
924 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
925 public static final String ACTION_NFCSHARING_SETTINGS =
926 "android.settings.NFCSHARING_SETTINGS";
927
Daniel Sandlerc08cd022012-11-27 22:47:37 -0500928 /**
Martijn Coenen62c196a2013-08-09 13:43:34 -0700929 * Activity Action: Show NFC Tap & Pay settings
930 * <p>
931 * This shows UI that allows the user to configure Tap&Pay
932 * settings.
933 * <p>
934 * In some cases, a matching Activity may not exist, so ensure you
935 * safeguard against this.
936 * <p>
937 * Input: Nothing.
938 * <p>
939 * Output: Nothing
940 */
941 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
942 public static final String ACTION_NFC_PAYMENT_SETTINGS =
943 "android.settings.NFC_PAYMENT_SETTINGS";
944
945 /**
Daniel Sandlerc08cd022012-11-27 22:47:37 -0500946 * Activity Action: Show Daydream settings.
947 * <p>
948 * In some cases, a matching Activity may not exist, so ensure you
949 * safeguard against this.
950 * <p>
951 * Input: Nothing.
952 * <p>
953 * Output: Nothing.
954 * @see android.service.dreams.DreamService
Daniel Sandlerc08cd022012-11-27 22:47:37 -0500955 */
956 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
957 public static final String ACTION_DREAM_SETTINGS = "android.settings.DREAM_SETTINGS";
958
Daniel Sandler5feceeb2013-03-22 18:29:23 -0700959 /**
960 * Activity Action: Show Notification listener settings.
961 * <p>
962 * In some cases, a matching Activity may not exist, so ensure you
963 * safeguard against this.
964 * <p>
965 * Input: Nothing.
966 * <p>
967 * Output: Nothing.
968 * @see android.service.notification.NotificationListenerService
Daniel Sandler5feceeb2013-03-22 18:29:23 -0700969 */
970 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
971 public static final String ACTION_NOTIFICATION_LISTENER_SETTINGS
Chris Wren8326a8a2014-10-22 14:13:32 -0400972 = "android.settings.ACTION_NOTIFICATION_LISTENER_SETTINGS";
Daniel Sandler5feceeb2013-03-22 18:29:23 -0700973
Alan Viverette69ce69b2013-08-29 12:23:48 -0700974 /**
John Spurlock80774932015-05-07 17:38:50 -0400975 * Activity Action: Show Do Not Disturb access settings.
976 * <p>
John Spurlock7c74f782015-06-04 13:01:42 -0400977 * Users can grant and deny access to Do Not Disturb configuration from here.
978 * See {@link android.app.NotificationManager#isNotificationPolicyAccessGranted()} for more
979 * details.
John Spurlock80774932015-05-07 17:38:50 -0400980 * <p>
981 * Input: Nothing.
982 * <p>
983 * Output: Nothing.
984 */
985 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
John Spurlock7c74f782015-06-04 13:01:42 -0400986 public static final String ACTION_NOTIFICATION_POLICY_ACCESS_SETTINGS
987 = "android.settings.NOTIFICATION_POLICY_ACCESS_SETTINGS";
John Spurlock80774932015-05-07 17:38:50 -0400988
989 /**
John Spurlock7340fc82014-04-24 18:50:12 -0400990 * @hide
991 */
992 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
993 public static final String ACTION_CONDITION_PROVIDER_SETTINGS
994 = "android.settings.ACTION_CONDITION_PROVIDER_SETTINGS";
995
996 /**
Alan Viverette69ce69b2013-08-29 12:23:48 -0700997 * Activity Action: Show settings for video captioning.
998 * <p>
999 * In some cases, a matching Activity may not exist, so ensure you safeguard
1000 * against this.
1001 * <p>
1002 * Input: Nothing.
1003 * <p>
1004 * Output: Nothing.
1005 */
1006 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1007 public static final String ACTION_CAPTIONING_SETTINGS = "android.settings.CAPTIONING_SETTINGS";
1008
Svetoslav773f54d2013-09-03 14:01:43 -07001009 /**
1010 * Activity Action: Show the top level print settings.
1011 * <p>
1012 * In some cases, a matching Activity may not exist, so ensure you
1013 * safeguard against this.
1014 * <p>
1015 * Input: Nothing.
1016 * <p>
1017 * Output: Nothing.
1018 */
1019 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1020 public static final String ACTION_PRINT_SETTINGS =
1021 "android.settings.ACTION_PRINT_SETTINGS";
1022
John Spurlockde547002014-02-28 17:50:39 -05001023 /**
1024 * Activity Action: Show Zen Mode configuration settings.
1025 *
1026 * @hide
1027 */
1028 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1029 public static final String ACTION_ZEN_MODE_SETTINGS = "android.settings.ZEN_MODE_SETTINGS";
1030
Santos Cordona4c75242014-07-09 12:07:51 -07001031 /**
John Spurlockfc746f82015-04-03 13:47:14 -04001032 * Activity Action: Show Zen Mode priority configuration settings.
1033 *
1034 * @hide
1035 */
1036 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1037 public static final String ACTION_ZEN_MODE_PRIORITY_SETTINGS
1038 = "android.settings.ZEN_MODE_PRIORITY_SETTINGS";
1039
1040 /**
John Spurlock7af10182015-04-03 15:10:31 -04001041 * Activity Action: Show Zen Mode automation configuration settings.
1042 *
1043 * @hide
1044 */
1045 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1046 public static final String ACTION_ZEN_MODE_AUTOMATION_SETTINGS
1047 = "android.settings.ZEN_MODE_AUTOMATION_SETTINGS";
1048
1049 /**
Barnaby Jamesb3006d32015-04-02 17:49:54 -07001050 * Activity Action: Modify do not disturb mode settings.
1051 * <p>
1052 * In some cases, a matching Activity may not exist, so ensure you safeguard against this.
1053 * <p>
1054 * This intent MUST be started using
1055 * {@link android.service.voice.VoiceInteractionSession#startVoiceActivity
1056 * startVoiceActivity}.
1057 * <p>
1058 * Note: The Activity implementing this intent MUST verify that
1059 * {@link android.app.Activity#isVoiceInteraction isVoiceInteraction}.
1060 * returns true before modifying the setting.
1061 * <p>
1062 * Input: The optional {@link #EXTRA_DO_NOT_DISTURB_MODE_MINUTES} extra can be used to indicate
1063 * how long the user wishes to avoid interruptions for. The optional
1064 * {@link #EXTRA_DO_NOT_DISTURB_MODE_ENABLED} extra can be to indicate if the user is
1065 * enabling or disabling do not disturb mode. If either extra is not included, the
1066 * user maybe asked to provide the value.
1067 * <p>
1068 * Output: Nothing.
1069 */
1070 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1071 public static final String ACTION_VOICE_CONTROL_DO_NOT_DISTURB_MODE =
1072 "android.settings.VOICE_CONTROL_DO_NOT_DISTURB_MODE";
1073
1074 /**
John Spurlockb2278d62015-04-07 12:47:12 -04001075 * Activity Action: Show Zen Mode schedule rule configuration settings.
1076 *
1077 * @hide
1078 */
1079 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1080 public static final String ACTION_ZEN_MODE_SCHEDULE_RULE_SETTINGS
1081 = "android.settings.ZEN_MODE_SCHEDULE_RULE_SETTINGS";
1082
1083 /**
John Spurlockd60258f2015-04-30 09:30:52 -04001084 * Activity Action: Show Zen Mode event rule configuration settings.
1085 *
1086 * @hide
1087 */
1088 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1089 public static final String ACTION_ZEN_MODE_EVENT_RULE_SETTINGS
1090 = "android.settings.ZEN_MODE_EVENT_RULE_SETTINGS";
1091
1092 /**
John Spurlock39581cc2015-04-10 11:59:01 -04001093 * Activity Action: Show Zen Mode external rule configuration settings.
1094 *
1095 * @hide
1096 */
1097 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1098 public static final String ACTION_ZEN_MODE_EXTERNAL_RULE_SETTINGS
1099 = "android.settings.ZEN_MODE_EXTERNAL_RULE_SETTINGS";
1100
1101 /**
Santos Cordona4c75242014-07-09 12:07:51 -07001102 * Activity Action: Show the regulatory information screen for the device.
1103 * <p>
1104 * In some cases, a matching Activity may not exist, so ensure you safeguard
1105 * against this.
1106 * <p>
1107 * Input: Nothing.
1108 * <p>
1109 * Output: Nothing.
1110 */
Jeff Sharkeydd77fda2014-04-16 17:23:08 -07001111 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1112 public static final String
1113 ACTION_SHOW_REGULATORY_INFO = "android.settings.SHOW_REGULATORY_INFO";
1114
Jerome Poichet7974cb32014-05-14 12:04:43 -07001115 /**
1116 * Activity Action: Show Device Name Settings.
1117 * <p>
1118 * In some cases, a matching Activity may not exist, so ensure you safeguard
Tim Kilbourn87cd0dc2014-04-14 15:37:51 -07001119 * against this.
Jerome Poichet7974cb32014-05-14 12:04:43 -07001120 *
1121 * @hide
1122 */
1123 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1124 public static final String DEVICE_NAME_SETTINGS = "android.settings.DEVICE_NAME";
1125
Tim Kilbourn87cd0dc2014-04-14 15:37:51 -07001126 /**
1127 * Activity Action: Show pairing settings.
1128 * <p>
1129 * In some cases, a matching Activity may not exist, so ensure you safeguard
1130 * against this.
1131 *
1132 * @hide
1133 */
1134 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1135 public static final String ACTION_PAIRING_SETTINGS = "android.settings.PAIRING_SETTINGS";
1136
John Spurlockf8f524c2014-06-10 14:47:29 -04001137 /**
1138 * Activity Action: Show battery saver settings.
John Spurlock73466662014-10-30 13:42:05 -04001139 * <p>
1140 * In some cases, a matching Activity may not exist, so ensure you safeguard
1141 * against this.
John Spurlockf8f524c2014-06-10 14:47:29 -04001142 */
1143 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1144 public static final String ACTION_BATTERY_SAVER_SETTINGS
1145 = "android.settings.BATTERY_SAVER_SETTINGS";
1146
Amith Yamasanieb7b94a2014-07-14 18:02:08 -07001147 /**
Barnaby Jamesb3006d32015-04-02 17:49:54 -07001148 * Activity Action: Modify Battery Saver mode setting using a voice command.
1149 * <p>
1150 * In some cases, a matching Activity may not exist, so ensure you safeguard against this.
1151 * <p>
1152 * This intent MUST be started using
1153 * {@link android.service.voice.VoiceInteractionSession#startVoiceActivity
1154 * startVoiceActivity}.
1155 * <p>
1156 * Note: The activity implementing this intent MUST verify that
1157 * {@link android.app.Activity#isVoiceInteraction isVoiceInteraction} returns true before
1158 * modifying the setting.
1159 * <p>
1160 * Input: To tell which state batter saver mode should be set to, add the
1161 * {@link #EXTRA_BATTERY_SAVER_MODE_ENABLED} extra to this Intent with the state specified.
1162 * If the extra is not included, no changes will be made.
1163 * <p>
1164 * Output: Nothing.
1165 */
1166 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1167 public static final String ACTION_VOICE_CONTROL_BATTERY_SAVER_MODE =
1168 "android.settings.VOICE_CONTROL_BATTERY_SAVER_MODE";
1169
1170 /**
Amith Yamasanieb7b94a2014-07-14 18:02:08 -07001171 * Activity Action: Show Home selection settings. If there are multiple activities
1172 * that can satisfy the {@link Intent#CATEGORY_HOME} intent, this screen allows you
1173 * to pick your preferred activity.
1174 */
1175 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1176 public static final String ACTION_HOME_SETTINGS
1177 = "android.settings.HOME_SETTINGS";
1178
Julia Reynolds7eba5932015-12-11 16:40:39 -05001179
1180
1181 /**
1182 * Activity Action: Show Default apps settings.
1183 * <p>
1184 * In some cases, a matching Activity may not exist, so ensure you
1185 * safeguard against this.
1186 * <p>
1187 * Input: Nothing.
1188 * <p>
1189 * Output: Nothing.
1190 */
1191 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1192 public static final String ACTION_MANAGE_DEFAULT_APPS_SETTINGS
1193 = "android.settings.MANAGE_DEFAULT_APPS_SETTINGS";
1194
John Spurlock2b0e09c2014-07-27 13:27:47 -04001195 /**
1196 * Activity Action: Show notification settings.
1197 *
1198 * @hide
1199 */
1200 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1201 public static final String ACTION_NOTIFICATION_SETTINGS
1202 = "android.settings.NOTIFICATION_SETTINGS";
1203
1204 /**
1205 * Activity Action: Show notification settings for a single app.
1206 *
1207 * @hide
1208 */
1209 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1210 public static final String ACTION_APP_NOTIFICATION_SETTINGS
1211 = "android.settings.APP_NOTIFICATION_SETTINGS";
1212
Chris Wrencd8f4f72014-08-27 18:48:13 -04001213 /**
1214 * Activity Action: Show notification redaction settings.
1215 *
1216 * @hide
1217 */
1218 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1219 public static final String ACTION_APP_NOTIFICATION_REDACTION
1220 = "android.settings.ACTION_APP_NOTIFICATION_REDACTION";
1221
John Spurlock2b0e09c2014-07-27 13:27:47 -04001222 /** @hide */ public static final String EXTRA_APP_UID = "app_uid";
1223 /** @hide */ public static final String EXTRA_APP_PACKAGE = "app_package";
1224
Sudheer Shanka410e6bd2015-12-31 15:29:50 +00001225 /**
1226 * Activity Action: Show a dialog with disabled by policy message.
1227 * <p> If an user action is disabled by policy, this dialog can be triggered to let
1228 * the user know about this.
1229 * <p>
1230 * Input: Nothing.
1231 * <p>
1232 * Output: Nothing.
Sudheer Shankaaebd5dd2016-02-18 12:37:14 +00001233 *
1234 * @hide
Sudheer Shanka410e6bd2015-12-31 15:29:50 +00001235 */
1236 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1237 public static final String ACTION_SHOW_ADMIN_SUPPORT_DETAILS
1238 = "android.settings.SHOW_ADMIN_SUPPORT_DETAILS";
1239
Michal Karpinskiba244092016-02-25 17:28:24 +00001240 /**
1241 * Activity Action: Show a dialog for remote bugreport flow.
1242 * <p>
1243 * Input: Nothing.
1244 * <p>
1245 * Output: Nothing.
1246 *
1247 * @hide
1248 */
1249 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1250 public static final String ACTION_SHOW_REMOTE_BUGREPORT_DIALOG
1251 = "android.settings.SHOW_REMOTE_BUGREPORT_DIALOG";
1252
Ruben Brunke24b9a62016-02-16 21:38:24 -08001253 /**
1254 * Activity Action: Show VR listener settings.
1255 * <p>
1256 * Input: Nothing.
1257 * <p>
1258 * Output: Nothing.
1259 *
1260 * @see android.service.vr.VrListenerService
1261 */
1262 @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1263 public static final String ACTION_VR_LISTENER_SETTINGS
1264 = "android.settings.VR_LISTENER_SETTINGS";
1265
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001266 // End of Intent actions for Settings
1267
Erikeebc8e22010-02-18 13:27:19 -08001268 /**
Brad Fitzpatrick1877d012010-03-04 17:48:13 -08001269 * @hide - Private call() method on SettingsProvider to read from 'system' table.
1270 */
1271 public static final String CALL_METHOD_GET_SYSTEM = "GET_system";
1272
1273 /**
1274 * @hide - Private call() method on SettingsProvider to read from 'secure' table.
1275 */
1276 public static final String CALL_METHOD_GET_SECURE = "GET_secure";
1277
1278 /**
Christopher Tate06efb532012-08-24 15:29:27 -07001279 * @hide - Private call() method on SettingsProvider to read from 'global' table.
1280 */
1281 public static final String CALL_METHOD_GET_GLOBAL = "GET_global";
1282
1283 /**
1284 * @hide - User handle argument extra to the fast-path call()-based requests
1285 */
1286 public static final String CALL_METHOD_USER_KEY = "_user";
1287
1288 /** @hide - Private call() method to write to 'system' table */
1289 public static final String CALL_METHOD_PUT_SYSTEM = "PUT_system";
1290
1291 /** @hide - Private call() method to write to 'secure' table */
1292 public static final String CALL_METHOD_PUT_SECURE = "PUT_secure";
1293
1294 /** @hide - Private call() method to write to 'global' table */
1295 public static final String CALL_METHOD_PUT_GLOBAL= "PUT_global";
1296
1297 /**
Erikeebc8e22010-02-18 13:27:19 -08001298 * Activity Extra: Limit available options in launched activity based on the given authority.
1299 * <p>
1300 * This can be passed as an extra field in an Activity Intent with one or more syncable content
1301 * provider's authorities as a String[]. This field is used by some intents to alter the
1302 * behavior of the called activity.
1303 * <p>
1304 * Example: The {@link #ACTION_ADD_ACCOUNT} intent restricts the account types available based
1305 * on the authority given.
1306 */
Alon Albert50359c22013-02-26 14:47:48 -08001307 public static final String EXTRA_AUTHORITIES = "authorities";
1308
Alon Albertd35bf1f2013-04-18 14:26:51 -07001309 /**
1310 * Activity Extra: Limit available options in launched activity based on the given account
1311 * types.
1312 * <p>
1313 * This can be passed as an extra field in an Activity Intent with one or more account types
1314 * as a String[]. This field is used by some intents to alter the behavior of the called
1315 * activity.
1316 * <p>
1317 * Example: The {@link #ACTION_ADD_ACCOUNT} intent restricts the account types to the specified
1318 * list.
1319 */
Alon Albert50359c22013-02-26 14:47:48 -08001320 public static final String EXTRA_ACCOUNT_TYPES = "account_types";
Erikeebc8e22010-02-18 13:27:19 -08001321
Tadashi G. Takaoka25480202011-01-20 23:13:02 +09001322 public static final String EXTRA_INPUT_METHOD_ID = "input_method_id";
1323
Barnaby James48f35522014-07-16 14:27:39 -07001324 /**
Michael Wrightc93fbd12014-09-22 20:07:59 -07001325 * Activity Extra: The device identifier to act upon.
1326 * <p>
1327 * This can be passed as an extra field in an Activity Intent with a single
1328 * InputDeviceIdentifier. This field is used by some activities to jump straight into the
1329 * settings for the given device.
1330 * <p>
Dianne Hackbornad6a99b2014-11-18 10:11:10 -08001331 * Example: The {@link #ACTION_INPUT_METHOD_SETTINGS} intent opens the keyboard layout
1332 * dialog for the given device.
Michael Wrightc93fbd12014-09-22 20:07:59 -07001333 * @hide
1334 */
1335 public static final String EXTRA_INPUT_DEVICE_IDENTIFIER = "input_device_identifier";
1336
1337 /**
Barnaby James48f35522014-07-16 14:27:39 -07001338 * Activity Extra: Enable or disable Airplane Mode.
1339 * <p>
1340 * This can be passed as an extra field to the {@link #ACTION_VOICE_CONTROL_AIRPLANE_MODE}
Barnaby Jamesb3006d32015-04-02 17:49:54 -07001341 * intent as a boolean to indicate if it should be enabled.
Barnaby James48f35522014-07-16 14:27:39 -07001342 */
1343 public static final String EXTRA_AIRPLANE_MODE_ENABLED = "airplane_mode_enabled";
1344
Barnaby Jamesb3006d32015-04-02 17:49:54 -07001345 /**
1346 * Activity Extra: Enable or disable Battery saver mode.
1347 * <p>
1348 * This can be passed as an extra field to the {@link #ACTION_VOICE_CONTROL_BATTERY_SAVER_MODE}
1349 * intent as a boolean to indicate if it should be enabled.
1350 */
1351 public static final String EXTRA_BATTERY_SAVER_MODE_ENABLED =
1352 "android.settings.extra.battery_saver_mode_enabled";
1353
1354 /**
1355 * Activity Extra: Enable or disable Do Not Disturb mode.
1356 * <p>
1357 * This can be passed as an extra field to the {@link #ACTION_VOICE_CONTROL_DO_NOT_DISTURB_MODE}
1358 * intent as a boolean to indicate if it should be enabled.
1359 */
1360 public static final String EXTRA_DO_NOT_DISTURB_MODE_ENABLED =
1361 "android.settings.extra.do_not_disturb_mode_enabled";
1362
1363 /**
1364 * Activity Extra: How many minutes to enable do not disturb mode for.
1365 * <p>
1366 * This can be passed as an extra field to the {@link #ACTION_VOICE_CONTROL_DO_NOT_DISTURB_MODE}
1367 * intent to indicate how long do not disturb mode should be enabled for.
1368 */
1369 public static final String EXTRA_DO_NOT_DISTURB_MODE_MINUTES =
1370 "android.settings.extra.do_not_disturb_mode_minutes";
1371
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001372 private static final String JID_RESOURCE_PREFIX = "android";
1373
1374 public static final String AUTHORITY = "settings";
1375
1376 private static final String TAG = "Settings";
Christopher Tate06efb532012-08-24 15:29:27 -07001377 private static final boolean LOCAL_LOGV = false;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001378
David Christie3f7b6522013-08-06 19:19:08 -07001379 // Lock ensures that when enabling/disabling the master location switch, we don't end up
1380 // with a partial enable/disable state in multi-threaded situations.
1381 private static final Object mLocationSettingsLock = new Object();
1382
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001383 public static class SettingNotFoundException extends AndroidException {
1384 public SettingNotFoundException(String msg) {
1385 super(msg);
1386 }
1387 }
1388
1389 /**
1390 * Common base for tables of name/value settings.
1391 */
1392 public static class NameValueTable implements BaseColumns {
1393 public static final String NAME = "name";
1394 public static final String VALUE = "value";
1395
1396 protected static boolean putString(ContentResolver resolver, Uri uri,
1397 String name, String value) {
1398 // The database will take care of replacing duplicates.
1399 try {
1400 ContentValues values = new ContentValues();
1401 values.put(NAME, name);
1402 values.put(VALUE, value);
1403 resolver.insert(uri, values);
1404 return true;
1405 } catch (SQLException e) {
Dianne Hackborna33e3f72009-09-29 17:28:24 -07001406 Log.w(TAG, "Can't set key " + name + " in " + uri, e);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001407 return false;
1408 }
1409 }
1410
1411 public static Uri getUriFor(Uri uri, String name) {
1412 return Uri.withAppendedPath(uri, name);
1413 }
1414 }
1415
Brad Fitzpatrick1877d012010-03-04 17:48:13 -08001416 // Thread-safe.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001417 private static class NameValueCache {
1418 private final String mVersionSystemProperty;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001419 private final Uri mUri;
1420
Brad Fitzpatrick1877d012010-03-04 17:48:13 -08001421 private static final String[] SELECT_VALUE =
1422 new String[] { Settings.NameValueTable.VALUE };
1423 private static final String NAME_EQ_PLACEHOLDER = "name=?";
1424
1425 // Must synchronize on 'this' to access mValues and mValuesVersion.
Dan Egnor799f7212009-11-24 16:24:44 -08001426 private final HashMap<String, String> mValues = new HashMap<String, String>();
1427 private long mValuesVersion = 0;
1428
Brad Fitzpatrick1877d012010-03-04 17:48:13 -08001429 // Initially null; set lazily and held forever. Synchronized on 'this'.
1430 private IContentProvider mContentProvider = null;
1431
1432 // The method we'll call (or null, to not use) on the provider
1433 // for the fast path of retrieving settings.
Christopher Tate06efb532012-08-24 15:29:27 -07001434 private final String mCallGetCommand;
1435 private final String mCallSetCommand;
Brad Fitzpatrick1877d012010-03-04 17:48:13 -08001436
Christopher Tate06efb532012-08-24 15:29:27 -07001437 public NameValueCache(String versionSystemProperty, Uri uri,
1438 String getCommand, String setCommand) {
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001439 mVersionSystemProperty = versionSystemProperty;
1440 mUri = uri;
Christopher Tate06efb532012-08-24 15:29:27 -07001441 mCallGetCommand = getCommand;
1442 mCallSetCommand = setCommand;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001443 }
1444
Christopher Tate06efb532012-08-24 15:29:27 -07001445 private IContentProvider lazyGetProvider(ContentResolver cr) {
1446 IContentProvider cp = null;
1447 synchronized (this) {
1448 cp = mContentProvider;
1449 if (cp == null) {
1450 cp = mContentProvider = cr.acquireProvider(mUri.getAuthority());
1451 }
1452 }
1453 return cp;
1454 }
1455
1456 public boolean putStringForUser(ContentResolver cr, String name, String value,
1457 final int userHandle) {
1458 try {
1459 Bundle arg = new Bundle();
1460 arg.putString(Settings.NameValueTable.VALUE, value);
Christopher Tated5fe1472012-09-10 15:48:38 -07001461 arg.putInt(CALL_METHOD_USER_KEY, userHandle);
Christopher Tate06efb532012-08-24 15:29:27 -07001462 IContentProvider cp = lazyGetProvider(cr);
Dianne Hackborn35654b62013-01-14 17:38:02 -08001463 cp.call(cr.getPackageName(), mCallSetCommand, name, arg);
Christopher Tate06efb532012-08-24 15:29:27 -07001464 } catch (RemoteException e) {
1465 Log.w(TAG, "Can't set key " + name + " in " + mUri, e);
1466 return false;
1467 }
1468 return true;
1469 }
1470
Christopher Tate06efb532012-08-24 15:29:27 -07001471 public String getStringForUser(ContentResolver cr, String name, final int userHandle) {
Christopher Tate78d2a662012-09-13 16:19:44 -07001472 final boolean isSelf = (userHandle == UserHandle.myUserId());
1473 if (isSelf) {
1474 long newValuesVersion = SystemProperties.getLong(mVersionSystemProperty, 0);
Dan Egnor799f7212009-11-24 16:24:44 -08001475
Christopher Tate78d2a662012-09-13 16:19:44 -07001476 // Our own user's settings data uses a client-side cache
1477 synchronized (this) {
1478 if (mValuesVersion != newValuesVersion) {
1479 if (LOCAL_LOGV || false) {
1480 Log.v(TAG, "invalidate [" + mUri.getLastPathSegment() + "]: current "
1481 + newValuesVersion + " != cached " + mValuesVersion);
1482 }
1483
1484 mValues.clear();
1485 mValuesVersion = newValuesVersion;
Dan Egnor799f7212009-11-24 16:24:44 -08001486 }
1487
Christopher Tate78d2a662012-09-13 16:19:44 -07001488 if (mValues.containsKey(name)) {
1489 return mValues.get(name); // Could be null, that's OK -- negative caching
1490 }
Dan Egnor799f7212009-11-24 16:24:44 -08001491 }
Christopher Tate78d2a662012-09-13 16:19:44 -07001492 } else {
1493 if (LOCAL_LOGV) Log.v(TAG, "get setting for user " + userHandle
1494 + " by user " + UserHandle.myUserId() + " so skipping cache");
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001495 }
Dan Egnor799f7212009-11-24 16:24:44 -08001496
Christopher Tate06efb532012-08-24 15:29:27 -07001497 IContentProvider cp = lazyGetProvider(cr);
Brad Fitzpatrick1877d012010-03-04 17:48:13 -08001498
1499 // Try the fast path first, not using query(). If this
1500 // fails (alternate Settings provider that doesn't support
1501 // this interface?) then we fall back to the query/table
1502 // interface.
Christopher Tate06efb532012-08-24 15:29:27 -07001503 if (mCallGetCommand != null) {
Brad Fitzpatrick1877d012010-03-04 17:48:13 -08001504 try {
Christopher Tate06efb532012-08-24 15:29:27 -07001505 Bundle args = null;
Christopher Tate5e08af02012-09-21 17:17:22 -07001506 if (!isSelf) {
Christopher Tate06efb532012-08-24 15:29:27 -07001507 args = new Bundle();
1508 args.putInt(CALL_METHOD_USER_KEY, userHandle);
1509 }
Dianne Hackborn35654b62013-01-14 17:38:02 -08001510 Bundle b = cp.call(cr.getPackageName(), mCallGetCommand, name, args);
Brad Fitzpatrick1877d012010-03-04 17:48:13 -08001511 if (b != null) {
1512 String value = b.getPairValue();
Christopher Tate78d2a662012-09-13 16:19:44 -07001513 // Don't update our cache for reads of other users' data
1514 if (isSelf) {
1515 synchronized (this) {
1516 mValues.put(name, value);
1517 }
1518 } else {
1519 if (LOCAL_LOGV) Log.i(TAG, "call-query of user " + userHandle
1520 + " by " + UserHandle.myUserId()
1521 + " so not updating cache");
Brad Fitzpatrick1877d012010-03-04 17:48:13 -08001522 }
1523 return value;
1524 }
1525 // If the response Bundle is null, we fall through
1526 // to the query interface below.
1527 } catch (RemoteException e) {
1528 // Not supported by the remote side? Fall through
1529 // to query().
1530 }
1531 }
1532
Dan Egnor799f7212009-11-24 16:24:44 -08001533 Cursor c = null;
1534 try {
Dianne Hackborn35654b62013-01-14 17:38:02 -08001535 c = cp.query(cr.getPackageName(), mUri, SELECT_VALUE, NAME_EQ_PLACEHOLDER,
Jeff Brown75ea64f2012-01-25 19:37:13 -08001536 new String[]{name}, null, null);
Dan Egnor799f7212009-11-24 16:24:44 -08001537 if (c == null) {
1538 Log.w(TAG, "Can't get key " + name + " from " + mUri);
1539 return null;
1540 }
1541
1542 String value = c.moveToNext() ? c.getString(0) : null;
Brad Fitzpatrick1877d012010-03-04 17:48:13 -08001543 synchronized (this) {
Dan Egnor799f7212009-11-24 16:24:44 -08001544 mValues.put(name, value);
1545 }
1546 if (LOCAL_LOGV) {
1547 Log.v(TAG, "cache miss [" + mUri.getLastPathSegment() + "]: " +
1548 name + " = " + (value == null ? "(null)" : value));
1549 }
1550 return value;
Brad Fitzpatrick1877d012010-03-04 17:48:13 -08001551 } catch (RemoteException e) {
Dan Egnor799f7212009-11-24 16:24:44 -08001552 Log.w(TAG, "Can't get key " + name + " from " + mUri, e);
1553 return null; // Return null, but don't cache it.
1554 } finally {
1555 if (c != null) c.close();
1556 }
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001557 }
1558 }
1559
1560 /**
Billy Lau6ad2d662015-07-18 00:26:58 +01001561 * An app can use this method to check if it is currently allowed to draw on top of other
1562 * apps. In order to be allowed to do so, an app must first declare the
1563 * {@link android.Manifest.permission#SYSTEM_ALERT_WINDOW} permission in its manifest. If it
1564 * is currently disallowed, it can prompt the user to grant it this capability through a
1565 * management UI by sending an Intent with action
1566 * {@link android.provider.Settings#ACTION_MANAGE_OVERLAY_PERMISSION}.
1567 *
1568 * @param context A context
1569 * @return true if the calling app can draw on top of other apps, false otherwise.
1570 */
1571 public static boolean canDrawOverlays(Context context) {
1572 int uid = Binder.getCallingUid();
1573 return Settings.isCallingPackageAllowedToDrawOverlays(context, uid, Settings
1574 .getPackageNameForUid(context, uid), false);
1575 }
1576
1577 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001578 * System settings, containing miscellaneous system preferences. This
1579 * table holds simple name/value pairs. There are convenience
1580 * functions for accessing individual settings entries.
1581 */
1582 public static final class System extends NameValueTable {
1583 public static final String SYS_PROP_SETTING_VERSION = "sys.settings_system_version";
1584
Svetoslav683914b2015-01-15 14:22:26 -08001585 /** @hide */
1586 public static interface Validator {
1587 public boolean validate(String value);
1588 }
1589
Dianne Hackborn139748f2012-09-24 11:36:57 -07001590 /**
1591 * The content:// style URL for this table
1592 */
1593 public static final Uri CONTENT_URI =
1594 Uri.parse("content://" + AUTHORITY + "/system");
1595
1596 private static final NameValueCache sNameValueCache = new NameValueCache(
1597 SYS_PROP_SETTING_VERSION,
1598 CONTENT_URI,
1599 CALL_METHOD_GET_SYSTEM,
1600 CALL_METHOD_PUT_SYSTEM);
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07001601
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001602 private static final HashSet<String> MOVED_TO_SECURE;
1603 static {
1604 MOVED_TO_SECURE = new HashSet<String>(30);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001605 MOVED_TO_SECURE.add(Secure.ANDROID_ID);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001606 MOVED_TO_SECURE.add(Secure.HTTP_PROXY);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001607 MOVED_TO_SECURE.add(Secure.LOCATION_PROVIDERS_ALLOWED);
Danielle Millett925a7d82012-03-19 18:02:20 -04001608 MOVED_TO_SECURE.add(Secure.LOCK_BIOMETRIC_WEAK_FLAGS);
Amith Yamasani156c4352010-03-05 17:10:03 -08001609 MOVED_TO_SECURE.add(Secure.LOCK_PATTERN_ENABLED);
1610 MOVED_TO_SECURE.add(Secure.LOCK_PATTERN_VISIBLE);
1611 MOVED_TO_SECURE.add(Secure.LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001612 MOVED_TO_SECURE.add(Secure.LOGGING_ID);
1613 MOVED_TO_SECURE.add(Secure.PARENTAL_CONTROL_ENABLED);
1614 MOVED_TO_SECURE.add(Secure.PARENTAL_CONTROL_LAST_UPDATE);
1615 MOVED_TO_SECURE.add(Secure.PARENTAL_CONTROL_REDIRECT_URL);
1616 MOVED_TO_SECURE.add(Secure.SETTINGS_CLASSNAME);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001617 MOVED_TO_SECURE.add(Secure.USE_GOOGLE_MAIL);
1618 MOVED_TO_SECURE.add(Secure.WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON);
1619 MOVED_TO_SECURE.add(Secure.WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY);
1620 MOVED_TO_SECURE.add(Secure.WIFI_NUM_OPEN_NETWORKS_KEPT);
1621 MOVED_TO_SECURE.add(Secure.WIFI_ON);
1622 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE);
1623 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_AP_COUNT);
1624 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS);
1625 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED);
1626 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS);
1627 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT);
1628 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_MAX_AP_CHECKS);
1629 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_ON);
1630 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_PING_COUNT);
1631 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_PING_DELAY_MS);
1632 MOVED_TO_SECURE.add(Secure.WIFI_WATCHDOG_PING_TIMEOUT_MS);
Christopher Tateaa036a22014-05-19 16:33:27 -07001633
1634 // At one time in System, then Global, but now back in Secure
1635 MOVED_TO_SECURE.add(Secure.INSTALL_NON_MARKET_APPS);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001636 }
1637
Christopher Tate06efb532012-08-24 15:29:27 -07001638 private static final HashSet<String> MOVED_TO_GLOBAL;
Christopher Tate66488d62012-10-02 11:58:01 -07001639 private static final HashSet<String> MOVED_TO_SECURE_THEN_GLOBAL;
Christopher Tate06efb532012-08-24 15:29:27 -07001640 static {
1641 MOVED_TO_GLOBAL = new HashSet<String>();
Christopher Tate66488d62012-10-02 11:58:01 -07001642 MOVED_TO_SECURE_THEN_GLOBAL = new HashSet<String>();
1643
Christopher Tate92198742012-09-07 12:00:13 -07001644 // these were originally in system but migrated to secure in the past,
1645 // so are duplicated in the Secure.* namespace
Christopher Tate66488d62012-10-02 11:58:01 -07001646 MOVED_TO_SECURE_THEN_GLOBAL.add(Global.ADB_ENABLED);
1647 MOVED_TO_SECURE_THEN_GLOBAL.add(Global.BLUETOOTH_ON);
1648 MOVED_TO_SECURE_THEN_GLOBAL.add(Global.DATA_ROAMING);
1649 MOVED_TO_SECURE_THEN_GLOBAL.add(Global.DEVICE_PROVISIONED);
Christopher Tate66488d62012-10-02 11:58:01 -07001650 MOVED_TO_SECURE_THEN_GLOBAL.add(Global.USB_MASS_STORAGE_ENABLED);
1651 MOVED_TO_SECURE_THEN_GLOBAL.add(Global.HTTP_PROXY);
Christopher Tate06efb532012-08-24 15:29:27 -07001652
Christopher Tate92198742012-09-07 12:00:13 -07001653 // these are moving directly from system to global
Christopher Tate06efb532012-08-24 15:29:27 -07001654 MOVED_TO_GLOBAL.add(Settings.Global.AIRPLANE_MODE_ON);
1655 MOVED_TO_GLOBAL.add(Settings.Global.AIRPLANE_MODE_RADIOS);
1656 MOVED_TO_GLOBAL.add(Settings.Global.AIRPLANE_MODE_TOGGLEABLE_RADIOS);
1657 MOVED_TO_GLOBAL.add(Settings.Global.AUTO_TIME);
1658 MOVED_TO_GLOBAL.add(Settings.Global.AUTO_TIME_ZONE);
1659 MOVED_TO_GLOBAL.add(Settings.Global.CAR_DOCK_SOUND);
1660 MOVED_TO_GLOBAL.add(Settings.Global.CAR_UNDOCK_SOUND);
1661 MOVED_TO_GLOBAL.add(Settings.Global.DESK_DOCK_SOUND);
1662 MOVED_TO_GLOBAL.add(Settings.Global.DESK_UNDOCK_SOUND);
1663 MOVED_TO_GLOBAL.add(Settings.Global.DOCK_SOUNDS_ENABLED);
1664 MOVED_TO_GLOBAL.add(Settings.Global.LOCK_SOUND);
1665 MOVED_TO_GLOBAL.add(Settings.Global.UNLOCK_SOUND);
1666 MOVED_TO_GLOBAL.add(Settings.Global.LOW_BATTERY_SOUND);
1667 MOVED_TO_GLOBAL.add(Settings.Global.POWER_SOUNDS_ENABLED);
1668 MOVED_TO_GLOBAL.add(Settings.Global.STAY_ON_WHILE_PLUGGED_IN);
1669 MOVED_TO_GLOBAL.add(Settings.Global.WIFI_SLEEP_POLICY);
Eric Laurentbc0fab1f2012-09-19 11:24:41 -07001670 MOVED_TO_GLOBAL.add(Settings.Global.MODE_RINGER);
Jeff Sharkey6e2bee72012-10-01 13:39:08 -07001671 MOVED_TO_GLOBAL.add(Settings.Global.WINDOW_ANIMATION_SCALE);
1672 MOVED_TO_GLOBAL.add(Settings.Global.TRANSITION_ANIMATION_SCALE);
1673 MOVED_TO_GLOBAL.add(Settings.Global.ANIMATOR_DURATION_SCALE);
1674 MOVED_TO_GLOBAL.add(Settings.Global.FANCY_IME_ANIMATIONS);
1675 MOVED_TO_GLOBAL.add(Settings.Global.COMPATIBILITY_MODE);
1676 MOVED_TO_GLOBAL.add(Settings.Global.EMERGENCY_TONE);
1677 MOVED_TO_GLOBAL.add(Settings.Global.CALL_AUTO_RETRY);
1678 MOVED_TO_GLOBAL.add(Settings.Global.DEBUG_APP);
1679 MOVED_TO_GLOBAL.add(Settings.Global.WAIT_FOR_DEBUGGER);
1680 MOVED_TO_GLOBAL.add(Settings.Global.SHOW_PROCESSES);
1681 MOVED_TO_GLOBAL.add(Settings.Global.ALWAYS_FINISH_ACTIVITIES);
Geremy Condraa0735112013-03-26 21:49:26 -07001682 MOVED_TO_GLOBAL.add(Settings.Global.TZINFO_UPDATE_CONTENT_URL);
1683 MOVED_TO_GLOBAL.add(Settings.Global.TZINFO_UPDATE_METADATA_URL);
1684 MOVED_TO_GLOBAL.add(Settings.Global.SELINUX_UPDATE_CONTENT_URL);
1685 MOVED_TO_GLOBAL.add(Settings.Global.SELINUX_UPDATE_METADATA_URL);
1686 MOVED_TO_GLOBAL.add(Settings.Global.SMS_SHORT_CODES_UPDATE_CONTENT_URL);
1687 MOVED_TO_GLOBAL.add(Settings.Global.SMS_SHORT_CODES_UPDATE_METADATA_URL);
1688 MOVED_TO_GLOBAL.add(Settings.Global.CERT_PIN_UPDATE_CONTENT_URL);
1689 MOVED_TO_GLOBAL.add(Settings.Global.CERT_PIN_UPDATE_METADATA_URL);
Christopher Tate06efb532012-08-24 15:29:27 -07001690 }
1691
Svetoslav683914b2015-01-15 14:22:26 -08001692 private static final Validator sBooleanValidator =
1693 new DiscreteValueValidator(new String[] {"0", "1"});
1694
1695 private static final Validator sNonNegativeIntegerValidator = new Validator() {
1696 @Override
1697 public boolean validate(String value) {
1698 try {
1699 return Integer.parseInt(value) >= 0;
1700 } catch (NumberFormatException e) {
1701 return false;
1702 }
1703 }
1704 };
1705
Svetoslav683914b2015-01-15 14:22:26 -08001706 private static final Validator sUriValidator = new Validator() {
1707 @Override
1708 public boolean validate(String value) {
1709 try {
1710 Uri.decode(value);
1711 return true;
1712 } catch (IllegalArgumentException e) {
1713 return false;
1714 }
1715 }
1716 };
1717
1718 private static final Validator sLenientIpAddressValidator = new Validator() {
1719 private static final int MAX_IPV6_LENGTH = 45;
1720
1721 @Override
1722 public boolean validate(String value) {
1723 return value.length() <= MAX_IPV6_LENGTH;
1724 }
1725 };
1726
Christopher Tate66488d62012-10-02 11:58:01 -07001727 /** @hide */
Svetoslav683914b2015-01-15 14:22:26 -08001728 public static void getMovedToGlobalSettings(Set<String> outKeySet) {
Christopher Tate66488d62012-10-02 11:58:01 -07001729 outKeySet.addAll(MOVED_TO_GLOBAL);
1730 outKeySet.addAll(MOVED_TO_SECURE_THEN_GLOBAL);
1731 }
1732
1733 /** @hide */
Svetoslav683914b2015-01-15 14:22:26 -08001734 public static void getMovedToSecureSettings(Set<String> outKeySet) {
1735 outKeySet.addAll(MOVED_TO_SECURE);
1736 }
1737
1738 /** @hide */
Christopher Tate66488d62012-10-02 11:58:01 -07001739 public static void getNonLegacyMovedKeys(HashSet<String> outKeySet) {
1740 outKeySet.addAll(MOVED_TO_GLOBAL);
1741 }
1742
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001743 /**
1744 * Look up a name in the database.
1745 * @param resolver to access the database with
1746 * @param name to look up in the table
1747 * @return the corresponding value, or null if not present
1748 */
Dianne Hackborn139748f2012-09-24 11:36:57 -07001749 public static String getString(ContentResolver resolver, String name) {
Christopher Tate06efb532012-08-24 15:29:27 -07001750 return getStringForUser(resolver, name, UserHandle.myUserId());
1751 }
1752
1753 /** @hide */
Dianne Hackborn139748f2012-09-24 11:36:57 -07001754 public static String getStringForUser(ContentResolver resolver, String name,
Christopher Tate06efb532012-08-24 15:29:27 -07001755 int userHandle) {
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001756 if (MOVED_TO_SECURE.contains(name)) {
1757 Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.System"
1758 + " to android.provider.Settings.Secure, returning read-only value.");
Christopher Tate06efb532012-08-24 15:29:27 -07001759 return Secure.getStringForUser(resolver, name, userHandle);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001760 }
Christopher Tate66488d62012-10-02 11:58:01 -07001761 if (MOVED_TO_GLOBAL.contains(name) || MOVED_TO_SECURE_THEN_GLOBAL.contains(name)) {
Christopher Tate06efb532012-08-24 15:29:27 -07001762 Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.System"
1763 + " to android.provider.Settings.Global, returning read-only value.");
1764 return Global.getStringForUser(resolver, name, userHandle);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001765 }
Christopher Tate06efb532012-08-24 15:29:27 -07001766 return sNameValueCache.getStringForUser(resolver, name, userHandle);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001767 }
1768
1769 /**
1770 * Store a name/value pair into the database.
1771 * @param resolver to access the database with
1772 * @param name to store
1773 * @param value to associate with the name
1774 * @return true if the value was set, false on database errors
1775 */
1776 public static boolean putString(ContentResolver resolver, String name, String value) {
Christopher Tate06efb532012-08-24 15:29:27 -07001777 return putStringForUser(resolver, name, value, UserHandle.myUserId());
1778 }
1779
1780 /** @hide */
1781 public static boolean putStringForUser(ContentResolver resolver, String name, String value,
1782 int userHandle) {
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001783 if (MOVED_TO_SECURE.contains(name)) {
1784 Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.System"
1785 + " to android.provider.Settings.Secure, value is unchanged.");
1786 return false;
1787 }
Christopher Tate66488d62012-10-02 11:58:01 -07001788 if (MOVED_TO_GLOBAL.contains(name) || MOVED_TO_SECURE_THEN_GLOBAL.contains(name)) {
Christopher Tate06efb532012-08-24 15:29:27 -07001789 Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.System"
1790 + " to android.provider.Settings.Global, value is unchanged.");
1791 return false;
1792 }
Christopher Tate06efb532012-08-24 15:29:27 -07001793 return sNameValueCache.putStringForUser(resolver, name, value, userHandle);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001794 }
1795
1796 /**
1797 * Construct the content URI for a particular name/value pair,
1798 * useful for monitoring changes with a ContentObserver.
1799 * @param name to look up in the table
1800 * @return the corresponding content URI, or null if not present
1801 */
1802 public static Uri getUriFor(String name) {
1803 if (MOVED_TO_SECURE.contains(name)) {
1804 Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.System"
1805 + " to android.provider.Settings.Secure, returning Secure URI.");
1806 return Secure.getUriFor(Secure.CONTENT_URI, name);
1807 }
Christopher Tate66488d62012-10-02 11:58:01 -07001808 if (MOVED_TO_GLOBAL.contains(name) || MOVED_TO_SECURE_THEN_GLOBAL.contains(name)) {
Christopher Tate06efb532012-08-24 15:29:27 -07001809 Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.System"
1810 + " to android.provider.Settings.Global, returning read-only global URI.");
1811 return Global.getUriFor(Global.CONTENT_URI, name);
1812 }
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001813 return getUriFor(CONTENT_URI, name);
1814 }
1815
1816 /**
1817 * Convenience function for retrieving a single system settings value
1818 * as an integer. Note that internally setting values are always
1819 * stored as strings; this function converts the string to an integer
1820 * for you. The default value will be returned if the setting is
1821 * not defined or not an integer.
1822 *
1823 * @param cr The ContentResolver to access.
1824 * @param name The name of the setting to retrieve.
1825 * @param def Value to return if the setting is not defined.
1826 *
1827 * @return The setting's current value, or 'def' if it is not defined
1828 * or not a valid integer.
1829 */
1830 public static int getInt(ContentResolver cr, String name, int def) {
Christopher Tate06efb532012-08-24 15:29:27 -07001831 return getIntForUser(cr, name, def, UserHandle.myUserId());
1832 }
1833
1834 /** @hide */
1835 public static int getIntForUser(ContentResolver cr, String name, int def, int userHandle) {
1836 String v = getStringForUser(cr, name, userHandle);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001837 try {
1838 return v != null ? Integer.parseInt(v) : def;
1839 } catch (NumberFormatException e) {
1840 return def;
1841 }
1842 }
1843
1844 /**
1845 * Convenience function for retrieving a single system settings value
1846 * as an integer. Note that internally setting values are always
1847 * stored as strings; this function converts the string to an integer
1848 * for you.
1849 * <p>
1850 * This version does not take a default value. If the setting has not
1851 * been set, or the string value is not a number,
1852 * it throws {@link SettingNotFoundException}.
1853 *
1854 * @param cr The ContentResolver to access.
1855 * @param name The name of the setting to retrieve.
1856 *
1857 * @throws SettingNotFoundException Thrown if a setting by the given
1858 * name can't be found or the setting value is not an integer.
1859 *
1860 * @return The setting's current value.
1861 */
1862 public static int getInt(ContentResolver cr, String name)
1863 throws SettingNotFoundException {
Christopher Tate06efb532012-08-24 15:29:27 -07001864 return getIntForUser(cr, name, UserHandle.myUserId());
1865 }
1866
1867 /** @hide */
1868 public static int getIntForUser(ContentResolver cr, String name, int userHandle)
1869 throws SettingNotFoundException {
1870 String v = getStringForUser(cr, name, userHandle);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001871 try {
1872 return Integer.parseInt(v);
1873 } catch (NumberFormatException e) {
1874 throw new SettingNotFoundException(name);
1875 }
1876 }
1877
1878 /**
1879 * Convenience function for updating a single settings value as an
1880 * integer. This will either create a new entry in the table if the
1881 * given name does not exist, or modify the value of the existing row
1882 * with that name. Note that internally setting values are always
1883 * stored as strings, so this function converts the given value to a
1884 * string before storing it.
1885 *
1886 * @param cr The ContentResolver to access.
1887 * @param name The name of the setting to modify.
1888 * @param value The new value for the setting.
1889 * @return true if the value was set, false on database errors
1890 */
1891 public static boolean putInt(ContentResolver cr, String name, int value) {
Christopher Tate06efb532012-08-24 15:29:27 -07001892 return putIntForUser(cr, name, value, UserHandle.myUserId());
1893 }
1894
1895 /** @hide */
1896 public static boolean putIntForUser(ContentResolver cr, String name, int value,
1897 int userHandle) {
1898 return putStringForUser(cr, name, Integer.toString(value), userHandle);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001899 }
1900
1901 /**
1902 * Convenience function for retrieving a single system settings value
1903 * as a {@code long}. Note that internally setting values are always
1904 * stored as strings; this function converts the string to a {@code long}
1905 * for you. The default value will be returned if the setting is
1906 * not defined or not a {@code long}.
1907 *
1908 * @param cr The ContentResolver to access.
1909 * @param name The name of the setting to retrieve.
1910 * @param def Value to return if the setting is not defined.
1911 *
1912 * @return The setting's current value, or 'def' if it is not defined
1913 * or not a valid {@code long}.
1914 */
1915 public static long getLong(ContentResolver cr, String name, long def) {
Christopher Tate06efb532012-08-24 15:29:27 -07001916 return getLongForUser(cr, name, def, UserHandle.myUserId());
1917 }
1918
1919 /** @hide */
1920 public static long getLongForUser(ContentResolver cr, String name, long def,
1921 int userHandle) {
1922 String valString = getStringForUser(cr, name, userHandle);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001923 long value;
1924 try {
1925 value = valString != null ? Long.parseLong(valString) : def;
1926 } catch (NumberFormatException e) {
1927 value = def;
1928 }
1929 return value;
1930 }
1931
1932 /**
1933 * Convenience function for retrieving a single system settings value
1934 * as a {@code long}. Note that internally setting values are always
1935 * stored as strings; this function converts the string to a {@code long}
1936 * for you.
1937 * <p>
1938 * This version does not take a default value. If the setting has not
1939 * been set, or the string value is not a number,
1940 * it throws {@link SettingNotFoundException}.
1941 *
1942 * @param cr The ContentResolver to access.
1943 * @param name The name of the setting to retrieve.
1944 *
1945 * @return The setting's current value.
1946 * @throws SettingNotFoundException Thrown if a setting by the given
1947 * name can't be found or the setting value is not an integer.
1948 */
1949 public static long getLong(ContentResolver cr, String name)
1950 throws SettingNotFoundException {
Christopher Tate06efb532012-08-24 15:29:27 -07001951 return getLongForUser(cr, name, UserHandle.myUserId());
1952 }
1953
1954 /** @hide */
1955 public static long getLongForUser(ContentResolver cr, String name, int userHandle)
1956 throws SettingNotFoundException {
1957 String valString = getStringForUser(cr, name, userHandle);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001958 try {
1959 return Long.parseLong(valString);
1960 } catch (NumberFormatException e) {
1961 throw new SettingNotFoundException(name);
1962 }
1963 }
1964
1965 /**
1966 * Convenience function for updating a single settings value as a long
1967 * integer. This will either create a new entry in the table if the
1968 * given name does not exist, or modify the value of the existing row
1969 * with that name. Note that internally setting values are always
1970 * stored as strings, so this function converts the given value to a
1971 * string before storing it.
1972 *
1973 * @param cr The ContentResolver to access.
1974 * @param name The name of the setting to modify.
1975 * @param value The new value for the setting.
1976 * @return true if the value was set, false on database errors
1977 */
1978 public static boolean putLong(ContentResolver cr, String name, long value) {
Christopher Tate06efb532012-08-24 15:29:27 -07001979 return putLongForUser(cr, name, value, UserHandle.myUserId());
1980 }
1981
1982 /** @hide */
1983 public static boolean putLongForUser(ContentResolver cr, String name, long value,
1984 int userHandle) {
1985 return putStringForUser(cr, name, Long.toString(value), userHandle);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001986 }
1987
1988 /**
1989 * Convenience function for retrieving a single system settings value
1990 * as a floating point number. Note that internally setting values are
1991 * always stored as strings; this function converts the string to an
1992 * float for you. The default value will be returned if the setting
1993 * is not defined or not a valid float.
1994 *
1995 * @param cr The ContentResolver to access.
1996 * @param name The name of the setting to retrieve.
1997 * @param def Value to return if the setting is not defined.
1998 *
1999 * @return The setting's current value, or 'def' if it is not defined
2000 * or not a valid float.
2001 */
2002 public static float getFloat(ContentResolver cr, String name, float def) {
Christopher Tate06efb532012-08-24 15:29:27 -07002003 return getFloatForUser(cr, name, def, UserHandle.myUserId());
2004 }
2005
2006 /** @hide */
2007 public static float getFloatForUser(ContentResolver cr, String name, float def,
2008 int userHandle) {
2009 String v = getStringForUser(cr, name, userHandle);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002010 try {
2011 return v != null ? Float.parseFloat(v) : def;
2012 } catch (NumberFormatException e) {
2013 return def;
2014 }
2015 }
2016
2017 /**
2018 * Convenience function for retrieving a single system settings value
2019 * as a float. Note that internally setting values are always
2020 * stored as strings; this function converts the string to a float
2021 * for you.
2022 * <p>
2023 * This version does not take a default value. If the setting has not
2024 * been set, or the string value is not a number,
2025 * it throws {@link SettingNotFoundException}.
2026 *
2027 * @param cr The ContentResolver to access.
2028 * @param name The name of the setting to retrieve.
2029 *
2030 * @throws SettingNotFoundException Thrown if a setting by the given
2031 * name can't be found or the setting value is not a float.
2032 *
2033 * @return The setting's current value.
2034 */
2035 public static float getFloat(ContentResolver cr, String name)
2036 throws SettingNotFoundException {
Christopher Tate06efb532012-08-24 15:29:27 -07002037 return getFloatForUser(cr, name, UserHandle.myUserId());
2038 }
2039
2040 /** @hide */
2041 public static float getFloatForUser(ContentResolver cr, String name, int userHandle)
2042 throws SettingNotFoundException {
2043 String v = getStringForUser(cr, name, userHandle);
Brian Muramatsue1d46982010-12-06 17:34:20 -08002044 if (v == null) {
2045 throw new SettingNotFoundException(name);
2046 }
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002047 try {
2048 return Float.parseFloat(v);
2049 } catch (NumberFormatException e) {
2050 throw new SettingNotFoundException(name);
2051 }
2052 }
2053
2054 /**
2055 * Convenience function for updating a single settings value as a
2056 * floating point number. This will either create a new entry in the
2057 * table if the given name does not exist, or modify the value of the
2058 * existing row with that name. Note that internally setting values
2059 * are always stored as strings, so this function converts the given
2060 * value to a string before storing it.
2061 *
2062 * @param cr The ContentResolver to access.
2063 * @param name The name of the setting to modify.
2064 * @param value The new value for the setting.
2065 * @return true if the value was set, false on database errors
2066 */
2067 public static boolean putFloat(ContentResolver cr, String name, float value) {
Christopher Tate06efb532012-08-24 15:29:27 -07002068 return putFloatForUser(cr, name, value, UserHandle.myUserId());
2069 }
2070
2071 /** @hide */
2072 public static boolean putFloatForUser(ContentResolver cr, String name, float value,
2073 int userHandle) {
2074 return putStringForUser(cr, name, Float.toString(value), userHandle);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002075 }
2076
2077 /**
2078 * Convenience function to read all of the current
2079 * configuration-related settings into a
2080 * {@link Configuration} object.
2081 *
2082 * @param cr The ContentResolver to access.
2083 * @param outConfig Where to place the configuration settings.
2084 */
2085 public static void getConfiguration(ContentResolver cr, Configuration outConfig) {
Christopher Tate06efb532012-08-24 15:29:27 -07002086 getConfigurationForUser(cr, outConfig, UserHandle.myUserId());
2087 }
2088
2089 /** @hide */
2090 public static void getConfigurationForUser(ContentResolver cr, Configuration outConfig,
2091 int userHandle) {
2092 outConfig.fontScale = Settings.System.getFloatForUser(
2093 cr, FONT_SCALE, outConfig.fontScale, userHandle);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002094 if (outConfig.fontScale < 0) {
2095 outConfig.fontScale = 1;
2096 }
Seigo Nonakabd5cbdd2016-01-25 19:40:28 +09002097 outConfig.setLocales(LocaleList.forLanguageTags(
2098 Settings.System.getStringForUser(cr, SYSTEM_LOCALES, userHandle)));
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002099 }
2100
2101 /**
Dianne Hackborn31ca8542011-07-19 14:58:28 -07002102 * @hide Erase the fields in the Configuration that should be applied
2103 * by the settings.
2104 */
2105 public static void clearConfiguration(Configuration inoutConfig) {
2106 inoutConfig.fontScale = 0;
Seigo Nonakad4031512016-03-17 21:18:53 +09002107 if (!inoutConfig.userSetLocale && !inoutConfig.getLocales().isEmpty()) {
Seigo Nonakabd5cbdd2016-01-25 19:40:28 +09002108 inoutConfig.setLocales(LocaleList.getEmptyLocaleList());
2109 }
Dianne Hackborn31ca8542011-07-19 14:58:28 -07002110 }
Narayan Kamath6d632962011-08-24 11:51:37 +01002111
Dianne Hackborn31ca8542011-07-19 14:58:28 -07002112 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002113 * Convenience function to write a batch of configuration-related
2114 * settings from a {@link Configuration} object.
2115 *
2116 * @param cr The ContentResolver to access.
2117 * @param config The settings to write.
2118 * @return true if the values were set, false on database errors
2119 */
2120 public static boolean putConfiguration(ContentResolver cr, Configuration config) {
Christopher Tate06efb532012-08-24 15:29:27 -07002121 return putConfigurationForUser(cr, config, UserHandle.myUserId());
2122 }
2123
2124 /** @hide */
2125 public static boolean putConfigurationForUser(ContentResolver cr, Configuration config,
2126 int userHandle) {
Seigo Nonakabd5cbdd2016-01-25 19:40:28 +09002127 return Settings.System.putFloatForUser(cr, FONT_SCALE, config.fontScale, userHandle) &&
2128 Settings.System.putStringForUser(
2129 cr, SYSTEM_LOCALES, config.getLocales().toLanguageTags(), userHandle);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002130 }
2131
Dianne Hackbornb8b11a02010-03-10 15:53:11 -08002132 /** @hide */
2133 public static boolean hasInterestingConfigurationChanges(int changes) {
Seigo Nonakabd5cbdd2016-01-25 19:40:28 +09002134 return (changes & ActivityInfo.CONFIG_FONT_SCALE) != 0 ||
2135 (changes & ActivityInfo.CONFIG_LOCALE) != 0;
Dianne Hackbornb8b11a02010-03-10 15:53:11 -08002136 }
Jaikumar Ganesh545e6702010-06-04 10:23:03 -07002137
Christopher Tate06efb532012-08-24 15:29:27 -07002138 /** @deprecated - Do not use */
2139 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002140 public static boolean getShowGTalkServiceStatus(ContentResolver cr) {
Christopher Tate06efb532012-08-24 15:29:27 -07002141 return getShowGTalkServiceStatusForUser(cr, UserHandle.myUserId());
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002142 }
2143
Christopher Tate06efb532012-08-24 15:29:27 -07002144 /**
2145 * @hide
2146 * @deprecated - Do not use
2147 */
2148 public static boolean getShowGTalkServiceStatusForUser(ContentResolver cr,
2149 int userHandle) {
2150 return getIntForUser(cr, SHOW_GTALK_SERVICE_STATUS, 0, userHandle) != 0;
2151 }
2152
2153 /** @deprecated - Do not use */
2154 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002155 public static void setShowGTalkServiceStatus(ContentResolver cr, boolean flag) {
Christopher Tatec8c08382012-09-19 17:18:18 -07002156 setShowGTalkServiceStatusForUser(cr, flag, UserHandle.myUserId());
Christopher Tate06efb532012-08-24 15:29:27 -07002157 }
2158
2159 /**
2160 * @hide
2161 * @deprecated - Do not use
2162 */
2163 @Deprecated
2164 public static void setShowGTalkServiceStatusForUser(ContentResolver cr, boolean flag,
2165 int userHandle) {
2166 putIntForUser(cr, SHOW_GTALK_SERVICE_STATUS, flag ? 1 : 0, userHandle);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002167 }
2168
Svetoslav683914b2015-01-15 14:22:26 -08002169 private static final class DiscreteValueValidator implements Validator {
2170 private final String[] mValues;
2171
2172 public DiscreteValueValidator(String[] values) {
2173 mValues = values;
2174 }
2175
Svetoslav1b71ea92015-02-17 18:20:29 -08002176 @Override
Svetoslav683914b2015-01-15 14:22:26 -08002177 public boolean validate(String value) {
2178 return ArrayUtils.contains(mValues, value);
2179 }
2180 }
2181
2182 private static final class InclusiveIntegerRangeValidator implements Validator {
2183 private final int mMin;
2184 private final int mMax;
2185
2186 public InclusiveIntegerRangeValidator(int min, int max) {
2187 mMin = min;
2188 mMax = max;
2189 }
2190
Svetoslav1b71ea92015-02-17 18:20:29 -08002191 @Override
Svetoslav683914b2015-01-15 14:22:26 -08002192 public boolean validate(String value) {
2193 try {
2194 final int intValue = Integer.parseInt(value);
2195 return intValue >= mMin && intValue <= mMax;
2196 } catch (NumberFormatException e) {
2197 return false;
2198 }
2199 }
2200 }
2201
2202 private static final class InclusiveFloatRangeValidator implements Validator {
2203 private final float mMin;
2204 private final float mMax;
2205
2206 public InclusiveFloatRangeValidator(float min, float max) {
2207 mMin = min;
2208 mMax = max;
2209 }
2210
Svetoslav1b71ea92015-02-17 18:20:29 -08002211 @Override
Svetoslav683914b2015-01-15 14:22:26 -08002212 public boolean validate(String value) {
2213 try {
2214 final float floatValue = Float.parseFloat(value);
2215 return floatValue >= mMin && floatValue <= mMax;
2216 } catch (NumberFormatException e) {
2217 return false;
2218 }
2219 }
2220 }
2221
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002222 /**
Christopher Tate06efb532012-08-24 15:29:27 -07002223 * @deprecated Use {@link android.provider.Settings.Global#STAY_ON_WHILE_PLUGGED_IN} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002224 */
Christopher Tate06efb532012-08-24 15:29:27 -07002225 @Deprecated
2226 public static final String STAY_ON_WHILE_PLUGGED_IN = Global.STAY_ON_WHILE_PLUGGED_IN;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002227
2228 /**
2229 * What happens when the user presses the end call button if they're not
2230 * on a call.<br/>
2231 * <b>Values:</b><br/>
2232 * 0 - The end button does nothing.<br/>
2233 * 1 - The end button goes to the home screen.<br/>
2234 * 2 - The end button puts the device to sleep and locks the keyguard.<br/>
2235 * 3 - The end button goes to the home screen. If the user is already on the
2236 * home screen, it puts the device to sleep.
2237 */
2238 public static final String END_BUTTON_BEHAVIOR = "end_button_behavior";
2239
Svetoslav683914b2015-01-15 14:22:26 -08002240 private static final Validator END_BUTTON_BEHAVIOR_VALIDATOR =
2241 new InclusiveIntegerRangeValidator(0, 3);
2242
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002243 /**
David Brown458e8062010-03-08 21:52:11 -08002244 * END_BUTTON_BEHAVIOR value for "go home".
2245 * @hide
2246 */
2247 public static final int END_BUTTON_BEHAVIOR_HOME = 0x1;
2248
2249 /**
2250 * END_BUTTON_BEHAVIOR value for "go to sleep".
2251 * @hide
2252 */
2253 public static final int END_BUTTON_BEHAVIOR_SLEEP = 0x2;
2254
2255 /**
2256 * END_BUTTON_BEHAVIOR default value.
2257 * @hide
2258 */
2259 public static final int END_BUTTON_BEHAVIOR_DEFAULT = END_BUTTON_BEHAVIOR_SLEEP;
2260
2261 /**
Joe Onorato9cdffa12011-04-06 18:27:27 -07002262 * Is advanced settings mode turned on. 0 == no, 1 == yes
2263 * @hide
2264 */
2265 public static final String ADVANCED_SETTINGS = "advanced_settings";
2266
Svetoslav683914b2015-01-15 14:22:26 -08002267 private static final Validator ADVANCED_SETTINGS_VALIDATOR = sBooleanValidator;
2268
Joe Onorato9cdffa12011-04-06 18:27:27 -07002269 /**
2270 * ADVANCED_SETTINGS default value.
2271 * @hide
2272 */
2273 public static final int ADVANCED_SETTINGS_DEFAULT = 0;
2274
2275 /**
Christopher Tate06efb532012-08-24 15:29:27 -07002276 * @deprecated Use {@link android.provider.Settings.Global#AIRPLANE_MODE_ON} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002277 */
Christopher Tate06efb532012-08-24 15:29:27 -07002278 @Deprecated
2279 public static final String AIRPLANE_MODE_ON = Global.AIRPLANE_MODE_ON;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002280
2281 /**
Christopher Tate06efb532012-08-24 15:29:27 -07002282 * @deprecated Use {@link android.provider.Settings.Global#RADIO_BLUETOOTH} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002283 */
Christopher Tate06efb532012-08-24 15:29:27 -07002284 @Deprecated
2285 public static final String RADIO_BLUETOOTH = Global.RADIO_BLUETOOTH;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002286
2287 /**
Christopher Tate06efb532012-08-24 15:29:27 -07002288 * @deprecated Use {@link android.provider.Settings.Global#RADIO_WIFI} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002289 */
Christopher Tate06efb532012-08-24 15:29:27 -07002290 @Deprecated
2291 public static final String RADIO_WIFI = Global.RADIO_WIFI;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002292
Robert Greenwalt8588e472011-11-08 10:12:25 -08002293 /**
Christopher Tate06efb532012-08-24 15:29:27 -07002294 * @deprecated Use {@link android.provider.Settings.Global#RADIO_WIMAX} instead
Robert Greenwalt8588e472011-11-08 10:12:25 -08002295 * {@hide}
2296 */
Christopher Tate06efb532012-08-24 15:29:27 -07002297 @Deprecated
2298 public static final String RADIO_WIMAX = Global.RADIO_WIMAX;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002299
2300 /**
Christopher Tate06efb532012-08-24 15:29:27 -07002301 * @deprecated Use {@link android.provider.Settings.Global#RADIO_CELL} instead
Nick Pelly8d32a012011-08-09 07:03:49 -07002302 */
Christopher Tate06efb532012-08-24 15:29:27 -07002303 @Deprecated
2304 public static final String RADIO_CELL = Global.RADIO_CELL;
Nick Pelly8d32a012011-08-09 07:03:49 -07002305
2306 /**
Christopher Tate06efb532012-08-24 15:29:27 -07002307 * @deprecated Use {@link android.provider.Settings.Global#RADIO_NFC} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002308 */
Christopher Tate06efb532012-08-24 15:29:27 -07002309 @Deprecated
2310 public static final String RADIO_NFC = Global.RADIO_NFC;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002311
2312 /**
Christopher Tate06efb532012-08-24 15:29:27 -07002313 * @deprecated Use {@link android.provider.Settings.Global#AIRPLANE_MODE_RADIOS} instead
2314 */
2315 @Deprecated
2316 public static final String AIRPLANE_MODE_RADIOS = Global.AIRPLANE_MODE_RADIOS;
2317
2318 /**
2319 * @deprecated Use {@link android.provider.Settings.Global#AIRPLANE_MODE_TOGGLEABLE_RADIOS} instead
Mike Lockwoodbd5ddf02009-07-29 21:37:14 -07002320 *
2321 * {@hide}
2322 */
Christopher Tate06efb532012-08-24 15:29:27 -07002323 @Deprecated
2324 public static final String AIRPLANE_MODE_TOGGLEABLE_RADIOS =
2325 Global.AIRPLANE_MODE_TOGGLEABLE_RADIOS;
Mike Lockwoodbd5ddf02009-07-29 21:37:14 -07002326
2327 /**
Christopher Tate06efb532012-08-24 15:29:27 -07002328 * @deprecated Use {@link android.provider.Settings.Global#WIFI_SLEEP_POLICY} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002329 */
Christopher Tate06efb532012-08-24 15:29:27 -07002330 @Deprecated
2331 public static final String WIFI_SLEEP_POLICY = Global.WIFI_SLEEP_POLICY;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002332
2333 /**
Christopher Tate06efb532012-08-24 15:29:27 -07002334 * @deprecated Use {@link android.provider.Settings.Global#WIFI_SLEEP_POLICY_DEFAULT} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002335 */
Christopher Tate06efb532012-08-24 15:29:27 -07002336 @Deprecated
2337 public static final int WIFI_SLEEP_POLICY_DEFAULT = Global.WIFI_SLEEP_POLICY_DEFAULT;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002338
2339 /**
Christopher Tate06efb532012-08-24 15:29:27 -07002340 * @deprecated Use {@link android.provider.Settings.Global#WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002341 */
Christopher Tate06efb532012-08-24 15:29:27 -07002342 @Deprecated
2343 public static final int WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED =
2344 Global.WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002345
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002346 /**
Christopher Tate06efb532012-08-24 15:29:27 -07002347 * @deprecated Use {@link android.provider.Settings.Global#WIFI_SLEEP_POLICY_NEVER} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002348 */
Christopher Tate06efb532012-08-24 15:29:27 -07002349 @Deprecated
2350 public static final int WIFI_SLEEP_POLICY_NEVER = Global.WIFI_SLEEP_POLICY_NEVER;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002351
Eric Laurentbc0fab1f2012-09-19 11:24:41 -07002352 /**
2353 * @deprecated Use {@link android.provider.Settings.Global#MODE_RINGER} instead
2354 */
2355 @Deprecated
2356 public static final String MODE_RINGER = Global.MODE_RINGER;
2357
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002358 /**
2359 * Whether to use static IP and other static network attributes.
2360 * <p>
2361 * Set to 1 for true and 0 for false.
Jeff Sharkey625239a2012-09-26 22:03:49 -07002362 *
2363 * @deprecated Use {@link WifiManager} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002364 */
Jeff Sharkey625239a2012-09-26 22:03:49 -07002365 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002366 public static final String WIFI_USE_STATIC_IP = "wifi_use_static_ip";
2367
Svetoslav683914b2015-01-15 14:22:26 -08002368 private static final Validator WIFI_USE_STATIC_IP_VALIDATOR = sBooleanValidator;
2369
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002370 /**
2371 * The static IP address.
2372 * <p>
2373 * Example: "192.168.1.51"
Jeff Sharkey625239a2012-09-26 22:03:49 -07002374 *
2375 * @deprecated Use {@link WifiManager} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002376 */
Jeff Sharkey625239a2012-09-26 22:03:49 -07002377 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002378 public static final String WIFI_STATIC_IP = "wifi_static_ip";
2379
Svetoslav683914b2015-01-15 14:22:26 -08002380 private static final Validator WIFI_STATIC_IP_VALIDATOR = sLenientIpAddressValidator;
2381
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002382 /**
2383 * If using static IP, the gateway's IP address.
2384 * <p>
2385 * Example: "192.168.1.1"
Jeff Sharkey625239a2012-09-26 22:03:49 -07002386 *
2387 * @deprecated Use {@link WifiManager} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002388 */
Jeff Sharkey625239a2012-09-26 22:03:49 -07002389 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002390 public static final String WIFI_STATIC_GATEWAY = "wifi_static_gateway";
2391
Svetoslav683914b2015-01-15 14:22:26 -08002392 private static final Validator WIFI_STATIC_GATEWAY_VALIDATOR = sLenientIpAddressValidator;
2393
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002394 /**
2395 * If using static IP, the net mask.
2396 * <p>
2397 * Example: "255.255.255.0"
Jeff Sharkey625239a2012-09-26 22:03:49 -07002398 *
2399 * @deprecated Use {@link WifiManager} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002400 */
Jeff Sharkey625239a2012-09-26 22:03:49 -07002401 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002402 public static final String WIFI_STATIC_NETMASK = "wifi_static_netmask";
2403
Svetoslav683914b2015-01-15 14:22:26 -08002404 private static final Validator WIFI_STATIC_NETMASK_VALIDATOR = sLenientIpAddressValidator;
2405
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002406 /**
2407 * If using static IP, the primary DNS's IP address.
2408 * <p>
2409 * Example: "192.168.1.1"
Jeff Sharkey625239a2012-09-26 22:03:49 -07002410 *
2411 * @deprecated Use {@link WifiManager} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002412 */
Jeff Sharkey625239a2012-09-26 22:03:49 -07002413 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002414 public static final String WIFI_STATIC_DNS1 = "wifi_static_dns1";
2415
Svetoslav683914b2015-01-15 14:22:26 -08002416 private static final Validator WIFI_STATIC_DNS1_VALIDATOR = sLenientIpAddressValidator;
2417
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002418 /**
2419 * If using static IP, the secondary DNS's IP address.
2420 * <p>
2421 * Example: "192.168.1.2"
Jeff Sharkey625239a2012-09-26 22:03:49 -07002422 *
2423 * @deprecated Use {@link WifiManager} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002424 */
Jeff Sharkey625239a2012-09-26 22:03:49 -07002425 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002426 public static final String WIFI_STATIC_DNS2 = "wifi_static_dns2";
2427
Svetoslav683914b2015-01-15 14:22:26 -08002428 private static final Validator WIFI_STATIC_DNS2_VALIDATOR = sLenientIpAddressValidator;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002429
2430 /**
2431 * Determines whether remote devices may discover and/or connect to
2432 * this device.
2433 * <P>Type: INT</P>
2434 * 2 -- discoverable and connectable
2435 * 1 -- connectable but not discoverable
2436 * 0 -- neither connectable nor discoverable
2437 */
2438 public static final String BLUETOOTH_DISCOVERABILITY =
2439 "bluetooth_discoverability";
2440
Svetoslav683914b2015-01-15 14:22:26 -08002441 private static final Validator BLUETOOTH_DISCOVERABILITY_VALIDATOR =
2442 new InclusiveIntegerRangeValidator(0, 2);
2443
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002444 /**
2445 * Bluetooth discoverability timeout. If this value is nonzero, then
2446 * Bluetooth becomes discoverable for a certain number of seconds,
2447 * after which is becomes simply connectable. The value is in seconds.
2448 */
2449 public static final String BLUETOOTH_DISCOVERABILITY_TIMEOUT =
2450 "bluetooth_discoverability_timeout";
2451
Svetoslav683914b2015-01-15 14:22:26 -08002452 private static final Validator BLUETOOTH_DISCOVERABILITY_TIMEOUT_VALIDATOR =
2453 sNonNegativeIntegerValidator;
2454
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002455 /**
Amith Yamasani156c4352010-03-05 17:10:03 -08002456 * @deprecated Use {@link android.provider.Settings.Secure#LOCK_PATTERN_ENABLED}
2457 * instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002458 */
Amith Yamasani156c4352010-03-05 17:10:03 -08002459 @Deprecated
2460 public static final String LOCK_PATTERN_ENABLED = Secure.LOCK_PATTERN_ENABLED;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002461
2462 /**
Amith Yamasani156c4352010-03-05 17:10:03 -08002463 * @deprecated Use {@link android.provider.Settings.Secure#LOCK_PATTERN_VISIBLE}
2464 * instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002465 */
Amith Yamasani156c4352010-03-05 17:10:03 -08002466 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002467 public static final String LOCK_PATTERN_VISIBLE = "lock_pattern_visible_pattern";
2468
2469 /**
Jaikumar Ganesh545e6702010-06-04 10:23:03 -07002470 * @deprecated Use
Amith Yamasani156c4352010-03-05 17:10:03 -08002471 * {@link android.provider.Settings.Secure#LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED}
2472 * instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002473 */
Amith Yamasani156c4352010-03-05 17:10:03 -08002474 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002475 public static final String LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED =
2476 "lock_pattern_tactile_feedback_enabled";
2477
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002478 /**
2479 * A formatted string of the next alarm that is set, or the empty string
2480 * if there is no alarm set.
Adrian Roosc42a1e12014-07-07 23:35:53 +02002481 *
2482 * @deprecated Use {@link android.app.AlarmManager#getNextAlarmClock()}.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002483 */
Adrian Roosc42a1e12014-07-07 23:35:53 +02002484 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002485 public static final String NEXT_ALARM_FORMATTED = "next_alarm_formatted";
2486
Svetoslav683914b2015-01-15 14:22:26 -08002487 private static final Validator NEXT_ALARM_FORMATTED_VALIDATOR = new Validator() {
2488 private static final int MAX_LENGTH = 1000;
Svetoslav1b71ea92015-02-17 18:20:29 -08002489
Svetoslav683914b2015-01-15 14:22:26 -08002490 @Override
2491 public boolean validate(String value) {
2492 // TODO: No idea what the correct format is.
Svetoslav64d6e9c2015-02-12 11:30:36 -08002493 return value == null || value.length() < MAX_LENGTH;
Svetoslav683914b2015-01-15 14:22:26 -08002494 }
2495 };
2496
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002497 /**
2498 * Scaling factor for fonts, float.
2499 */
2500 public static final String FONT_SCALE = "font_scale";
2501
Svetoslav683914b2015-01-15 14:22:26 -08002502 private static final Validator FONT_SCALE_VALIDATOR = new Validator() {
2503 @Override
2504 public boolean validate(String value) {
2505 try {
2506 return Float.parseFloat(value) >= 0;
2507 } catch (NumberFormatException e) {
2508 return false;
2509 }
2510 }
2511 };
2512
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002513 /**
Seigo Nonakabd5cbdd2016-01-25 19:40:28 +09002514 * The serialized system locale value.
2515 *
2516 * Do not use this value directory.
2517 * To get system locale, use {@link android.util.LocaleList#getDefault} instead.
2518 * To update system locale, use {@link com.android.internal.app.LocalePicker#updateLocales}
2519 * instead.
2520 * @hide
2521 */
2522 public static final String SYSTEM_LOCALES = "system_locales";
2523
2524
2525 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002526 * Name of an application package to be debugged.
Jeff Sharkey6e2bee72012-10-01 13:39:08 -07002527 *
2528 * @deprecated Use {@link Global#DEBUG_APP} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002529 */
Jeff Sharkey6e2bee72012-10-01 13:39:08 -07002530 @Deprecated
2531 public static final String DEBUG_APP = Global.DEBUG_APP;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002532
2533 /**
2534 * If 1, when launching DEBUG_APP it will wait for the debugger before
2535 * starting user code. If 0, it will run normally.
Jeff Sharkey6e2bee72012-10-01 13:39:08 -07002536 *
2537 * @deprecated Use {@link Global#WAIT_FOR_DEBUGGER} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002538 */
Jeff Sharkey6e2bee72012-10-01 13:39:08 -07002539 @Deprecated
2540 public static final String WAIT_FOR_DEBUGGER = Global.WAIT_FOR_DEBUGGER;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002541
2542 /**
2543 * Whether or not to dim the screen. 0=no 1=yes
Jeff Brown96307042012-07-27 15:51:34 -07002544 * @deprecated This setting is no longer used.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002545 */
Jeff Brown96307042012-07-27 15:51:34 -07002546 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002547 public static final String DIM_SCREEN = "dim_screen";
2548
Svetoslav683914b2015-01-15 14:22:26 -08002549 private static final Validator DIM_SCREEN_VALIDATOR = sBooleanValidator;
2550
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002551 /**
Jeff Brown05af6ad2014-09-30 20:54:30 -07002552 * The amount of time in milliseconds before the device goes to sleep or begins
2553 * to dream after a period of inactivity. This value is also known as the
2554 * user activity timeout period since the screen isn't necessarily turned off
2555 * when it expires.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002556 */
2557 public static final String SCREEN_OFF_TIMEOUT = "screen_off_timeout";
2558
Svetoslav683914b2015-01-15 14:22:26 -08002559 private static final Validator SCREEN_OFF_TIMEOUT_VALIDATOR = sNonNegativeIntegerValidator;
2560
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002561 /**
2562 * The screen backlight brightness between 0 and 255.
2563 */
2564 public static final String SCREEN_BRIGHTNESS = "screen_brightness";
2565
Svetoslav683914b2015-01-15 14:22:26 -08002566 private static final Validator SCREEN_BRIGHTNESS_VALIDATOR =
2567 new InclusiveIntegerRangeValidator(0, 255);
2568
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002569 /**
Dan Murphy951764b2009-08-27 14:59:03 -05002570 * Control whether to enable automatic brightness mode.
Dan Murphy951764b2009-08-27 14:59:03 -05002571 */
2572 public static final String SCREEN_BRIGHTNESS_MODE = "screen_brightness_mode";
2573
Svetoslav683914b2015-01-15 14:22:26 -08002574 private static final Validator SCREEN_BRIGHTNESS_MODE_VALIDATOR = sBooleanValidator;
2575
Dan Murphy951764b2009-08-27 14:59:03 -05002576 /**
Dianne Hackbornd9ea4682012-01-20 18:36:40 -08002577 * Adjustment to auto-brightness to make it generally more (>0.0 <1.0)
2578 * or less (<0.0 >-1.0) bright.
Dianne Hackborn518a3d82012-05-09 16:30:49 -07002579 * @hide
Dianne Hackbornd9ea4682012-01-20 18:36:40 -08002580 */
2581 public static final String SCREEN_AUTO_BRIGHTNESS_ADJ = "screen_auto_brightness_adj";
2582
Svetoslav683914b2015-01-15 14:22:26 -08002583 private static final Validator SCREEN_AUTO_BRIGHTNESS_ADJ_VALIDATOR =
2584 new InclusiveFloatRangeValidator(-1, 1);
2585
Dianne Hackbornd9ea4682012-01-20 18:36:40 -08002586 /**
Mike Lockwooddc3494e2009-10-14 21:17:09 -07002587 * SCREEN_BRIGHTNESS_MODE value for manual mode.
Mike Lockwooddc3494e2009-10-14 21:17:09 -07002588 */
2589 public static final int SCREEN_BRIGHTNESS_MODE_MANUAL = 0;
2590
2591 /**
Scott Main52bfc242012-02-09 10:09:14 -08002592 * SCREEN_BRIGHTNESS_MODE value for automatic mode.
Mike Lockwooddc3494e2009-10-14 21:17:09 -07002593 */
2594 public static final int SCREEN_BRIGHTNESS_MODE_AUTOMATIC = 1;
2595
2596 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002597 * Control whether the process CPU usage meter should be shown.
Jeff Sharkey6e2bee72012-10-01 13:39:08 -07002598 *
2599 * @deprecated Use {@link Global#SHOW_PROCESSES} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002600 */
Jeff Sharkey6e2bee72012-10-01 13:39:08 -07002601 @Deprecated
2602 public static final String SHOW_PROCESSES = Global.SHOW_PROCESSES;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002603
2604 /**
2605 * If 1, the activity manager will aggressively finish activities and
2606 * processes as soon as they are no longer needed. If 0, the normal
2607 * extended lifetime is used.
Jeff Sharkey6e2bee72012-10-01 13:39:08 -07002608 *
2609 * @deprecated Use {@link Global#ALWAYS_FINISH_ACTIVITIES} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002610 */
Jeff Sharkey6e2bee72012-10-01 13:39:08 -07002611 @Deprecated
2612 public static final String ALWAYS_FINISH_ACTIVITIES = Global.ALWAYS_FINISH_ACTIVITIES;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002613
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002614 /**
2615 * Determines which streams are affected by ringer mode changes. The
2616 * stream type's bit should be set to 1 if it should be muted when going
2617 * into an inaudible ringer mode.
2618 */
2619 public static final String MODE_RINGER_STREAMS_AFFECTED = "mode_ringer_streams_affected";
2620
Svetoslav683914b2015-01-15 14:22:26 -08002621 private static final Validator MODE_RINGER_STREAMS_AFFECTED_VALIDATOR =
2622 sNonNegativeIntegerValidator;
2623
2624 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002625 * Determines which streams are affected by mute. The
2626 * stream type's bit should be set to 1 if it should be muted when a mute request
2627 * is received.
2628 */
Svetoslav683914b2015-01-15 14:22:26 -08002629 public static final String MUTE_STREAMS_AFFECTED = "mute_streams_affected";
2630
2631 private static final Validator MUTE_STREAMS_AFFECTED_VALIDATOR =
2632 sNonNegativeIntegerValidator;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002633
2634 /**
2635 * Whether vibrate is on for different events. This is used internally,
2636 * changing this value will not change the vibrate. See AudioManager.
2637 */
2638 public static final String VIBRATE_ON = "vibrate_on";
2639
Svetoslav683914b2015-01-15 14:22:26 -08002640 private static final Validator VIBRATE_ON_VALIDATOR = sBooleanValidator;
2641
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002642 /**
Jeff Brown7f6c2312012-04-13 20:38:38 -07002643 * If 1, redirects the system vibrator to all currently attached input devices
2644 * that support vibration. If there are no such input devices, then the system
2645 * vibrator is used instead.
2646 * If 0, does not register the system vibrator.
2647 *
2648 * This setting is mainly intended to provide a compatibility mechanism for
2649 * applications that only know about the system vibrator and do not use the
2650 * input device vibrator API.
2651 *
2652 * @hide
2653 */
2654 public static final String VIBRATE_INPUT_DEVICES = "vibrate_input_devices";
2655
Svetoslav683914b2015-01-15 14:22:26 -08002656 private static final Validator VIBRATE_INPUT_DEVICES_VALIDATOR = sBooleanValidator;
2657
Jeff Brown7f6c2312012-04-13 20:38:38 -07002658 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002659 * Ringer volume. This is used internally, changing this value will not
2660 * change the volume. See AudioManager.
Svetoslavdbbeeb32015-02-18 19:16:25 -08002661 *
2662 * @removed Not used by anything since API 2.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002663 */
2664 public static final String VOLUME_RING = "volume_ring";
2665
2666 /**
2667 * System/notifications volume. This is used internally, changing this
2668 * value will not change the volume. See AudioManager.
Svetoslavdbbeeb32015-02-18 19:16:25 -08002669 *
2670 * @removed Not used by anything since API 2.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002671 */
2672 public static final String VOLUME_SYSTEM = "volume_system";
2673
2674 /**
2675 * Voice call volume. This is used internally, changing this value will
2676 * not change the volume. See AudioManager.
Svetoslavdbbeeb32015-02-18 19:16:25 -08002677 *
2678 * @removed Not used by anything since API 2.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002679 */
2680 public static final String VOLUME_VOICE = "volume_voice";
2681
2682 /**
2683 * Music/media/gaming volume. This is used internally, changing this
2684 * value will not change the volume. See AudioManager.
Svetoslavdbbeeb32015-02-18 19:16:25 -08002685 *
2686 * @removed Not used by anything since API 2.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002687 */
2688 public static final String VOLUME_MUSIC = "volume_music";
2689
2690 /**
2691 * Alarm volume. This is used internally, changing this
2692 * value will not change the volume. See AudioManager.
Svetoslavdbbeeb32015-02-18 19:16:25 -08002693 *
2694 * @removed Not used by anything since API 2.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002695 */
2696 public static final String VOLUME_ALARM = "volume_alarm";
2697
2698 /**
2699 * Notification volume. This is used internally, changing this
2700 * value will not change the volume. See AudioManager.
Svetoslavdbbeeb32015-02-18 19:16:25 -08002701 *
2702 * @removed Not used by anything since API 2.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002703 */
2704 public static final String VOLUME_NOTIFICATION = "volume_notification";
2705
2706 /**
Eric Laurent484d2882009-12-08 09:05:45 -08002707 * Bluetooth Headset volume. This is used internally, changing this value will
2708 * not change the volume. See AudioManager.
Svetoslavdbbeeb32015-02-18 19:16:25 -08002709 *
2710 * @removed Not used by anything since API 2.
Eric Laurent484d2882009-12-08 09:05:45 -08002711 */
2712 public static final String VOLUME_BLUETOOTH_SCO = "volume_bluetooth_sco";
2713
2714 /**
Mike Lockwood8517e462011-10-25 14:47:19 -04002715 * Master volume (float in the range 0.0f to 1.0f).
Svetoslavdbbeeb32015-02-18 19:16:25 -08002716 *
Mike Lockwood8517e462011-10-25 14:47:19 -04002717 * @hide
2718 */
2719 public static final String VOLUME_MASTER = "volume_master";
2720
2721 /**
Andy Hungf04b84d2015-12-18 17:33:27 -08002722 * Master mono (int 1 = mono, 0 = normal).
2723 *
2724 * @hide
2725 */
2726 public static final String MASTER_MONO = "master_mono";
2727
2728 private static final Validator MASTER_MONO_VALIDATOR = sBooleanValidator;
2729
2730 /**
Justin Koh57978ed2012-04-03 17:37:58 -07002731 * Whether the notifications should use the ring volume (value of 1) or
2732 * a separate notification volume (value of 0). In most cases, users
2733 * will have this enabled so the notification and ringer volumes will be
2734 * the same. However, power users can disable this and use the separate
2735 * notification volume control.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002736 * <p>
Justin Koh57978ed2012-04-03 17:37:58 -07002737 * Note: This is a one-off setting that will be removed in the future
2738 * when there is profile support. For this reason, it is kept hidden
2739 * from the public APIs.
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002740 *
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002741 * @hide
Amith Yamasani42722bf2011-07-22 10:34:27 -07002742 * @deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002743 */
Gilles Debunnee90bed12011-08-30 14:28:27 -07002744 @Deprecated
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002745 public static final String NOTIFICATIONS_USE_RING_VOLUME =
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002746 "notifications_use_ring_volume";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002747
Svetoslav683914b2015-01-15 14:22:26 -08002748 private static final Validator NOTIFICATIONS_USE_RING_VOLUME_VALIDATOR = sBooleanValidator;
2749
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002750 /**
Daniel Sandler6329bf72010-02-26 15:17:44 -05002751 * Whether silent mode should allow vibration feedback. This is used
2752 * internally in AudioService and the Sound settings activity to
2753 * coordinate decoupling of vibrate and silent modes. This setting
2754 * will likely be removed in a future release with support for
2755 * audio/vibe feedback profiles.
2756 *
Eric Laurentbffc3d12012-05-07 17:43:49 -07002757 * Not used anymore. On devices with vibrator, the user explicitly selects
2758 * silent or vibrate mode.
2759 * Kept for use by legacy database upgrade code in DatabaseHelper.
Daniel Sandler6329bf72010-02-26 15:17:44 -05002760 * @hide
2761 */
2762 public static final String VIBRATE_IN_SILENT = "vibrate_in_silent";
2763
Svetoslav683914b2015-01-15 14:22:26 -08002764 private static final Validator VIBRATE_IN_SILENT_VALIDATOR = sBooleanValidator;
2765
Daniel Sandler6329bf72010-02-26 15:17:44 -05002766 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002767 * The mapping of stream type (integer) to its setting.
Svetoslavdbbeeb32015-02-18 19:16:25 -08002768 *
2769 * @removed Not used by anything since API 2.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002770 */
2771 public static final String[] VOLUME_SETTINGS = {
2772 VOLUME_VOICE, VOLUME_SYSTEM, VOLUME_RING, VOLUME_MUSIC,
Eric Laurent484d2882009-12-08 09:05:45 -08002773 VOLUME_ALARM, VOLUME_NOTIFICATION, VOLUME_BLUETOOTH_SCO
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002774 };
2775
2776 /**
2777 * Appended to various volume related settings to record the previous
2778 * values before they the settings were affected by a silent/vibrate
2779 * ringer mode change.
Svetoslavdbbeeb32015-02-18 19:16:25 -08002780 *
2781 * @removed Not used by anything since API 2.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002782 */
2783 public static final String APPEND_FOR_LAST_AUDIBLE = "_last_audible";
2784
2785 /**
2786 * Persistent store for the system-wide default ringtone URI.
2787 * <p>
2788 * If you need to play the default ringtone at any given time, it is recommended
2789 * you give {@link #DEFAULT_RINGTONE_URI} to the media player. It will resolve
2790 * to the set default ringtone at the time of playing.
2791 *
2792 * @see #DEFAULT_RINGTONE_URI
2793 */
2794 public static final String RINGTONE = "ringtone";
2795
Svetoslav683914b2015-01-15 14:22:26 -08002796 private static final Validator RINGTONE_VALIDATOR = sUriValidator;
2797
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002798 /**
2799 * A {@link Uri} that will point to the current default ringtone at any
2800 * given time.
2801 * <p>
2802 * If the current default ringtone is in the DRM provider and the caller
2803 * does not have permission, the exception will be a
2804 * FileNotFoundException.
2805 */
2806 public static final Uri DEFAULT_RINGTONE_URI = getUriFor(RINGTONE);
2807
Jeff Sharkey413573a2016-02-22 17:52:45 -07002808 /** {@hide} */
2809 public static final String RINGTONE_CACHE = "ringtone_cache";
2810 /** {@hide} */
2811 public static final Uri RINGTONE_CACHE_URI = getUriFor(RINGTONE_CACHE);
2812
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002813 /**
2814 * Persistent store for the system-wide default notification sound.
2815 *
2816 * @see #RINGTONE
2817 * @see #DEFAULT_NOTIFICATION_URI
2818 */
2819 public static final String NOTIFICATION_SOUND = "notification_sound";
2820
Svetoslav683914b2015-01-15 14:22:26 -08002821 private static final Validator NOTIFICATION_SOUND_VALIDATOR = sUriValidator;
2822
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002823 /**
2824 * A {@link Uri} that will point to the current default notification
2825 * sound at any given time.
2826 *
2827 * @see #DEFAULT_RINGTONE_URI
2828 */
2829 public static final Uri DEFAULT_NOTIFICATION_URI = getUriFor(NOTIFICATION_SOUND);
2830
Jeff Sharkey413573a2016-02-22 17:52:45 -07002831 /** {@hide} */
2832 public static final String NOTIFICATION_SOUND_CACHE = "notification_sound_cache";
2833 /** {@hide} */
2834 public static final Uri NOTIFICATION_SOUND_CACHE_URI = getUriFor(NOTIFICATION_SOUND_CACHE);
2835
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002836 /**
Patrick Scott3156bb002009-04-13 09:57:38 -07002837 * Persistent store for the system-wide default alarm alert.
2838 *
2839 * @see #RINGTONE
2840 * @see #DEFAULT_ALARM_ALERT_URI
2841 */
2842 public static final String ALARM_ALERT = "alarm_alert";
2843
Svetoslav683914b2015-01-15 14:22:26 -08002844 private static final Validator ALARM_ALERT_VALIDATOR = sUriValidator;
2845
Patrick Scott3156bb002009-04-13 09:57:38 -07002846 /**
2847 * A {@link Uri} that will point to the current default alarm alert at
2848 * any given time.
2849 *
2850 * @see #DEFAULT_ALARM_ALERT_URI
2851 */
2852 public static final Uri DEFAULT_ALARM_ALERT_URI = getUriFor(ALARM_ALERT);
2853
Jeff Sharkey413573a2016-02-22 17:52:45 -07002854 /** {@hide} */
2855 public static final String ALARM_ALERT_CACHE = "alarm_alert_cache";
2856 /** {@hide} */
2857 public static final Uri ALARM_ALERT_CACHE_URI = getUriFor(ALARM_ALERT_CACHE);
2858
Patrick Scott3156bb002009-04-13 09:57:38 -07002859 /**
Jean-Michel Trivid589fea2011-04-15 11:28:10 -07002860 * Persistent store for the system default media button event receiver.
2861 *
2862 * @hide
2863 */
2864 public static final String MEDIA_BUTTON_RECEIVER = "media_button_receiver";
2865
Svetoslav683914b2015-01-15 14:22:26 -08002866 private static final Validator MEDIA_BUTTON_RECEIVER_VALIDATOR = new Validator() {
2867 @Override
2868 public boolean validate(String value) {
2869 try {
2870 ComponentName.unflattenFromString(value);
2871 return true;
2872 } catch (NullPointerException e) {
2873 return false;
2874 }
2875 }
2876 };
2877
Jean-Michel Trivid589fea2011-04-15 11:28:10 -07002878 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002879 * Setting to enable Auto Replace (AutoText) in text editors. 1 = On, 0 = Off
2880 */
2881 public static final String TEXT_AUTO_REPLACE = "auto_replace";
2882
Svetoslav683914b2015-01-15 14:22:26 -08002883 private static final Validator TEXT_AUTO_REPLACE_VALIDATOR = sBooleanValidator;
2884
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002885 /**
2886 * Setting to enable Auto Caps in text editors. 1 = On, 0 = Off
2887 */
2888 public static final String TEXT_AUTO_CAPS = "auto_caps";
2889
Svetoslav683914b2015-01-15 14:22:26 -08002890 private static final Validator TEXT_AUTO_CAPS_VALIDATOR = sBooleanValidator;
2891
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002892 /**
2893 * Setting to enable Auto Punctuate in text editors. 1 = On, 0 = Off. This
2894 * feature converts two spaces to a "." and space.
2895 */
2896 public static final String TEXT_AUTO_PUNCTUATE = "auto_punctuate";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07002897
Svetoslav683914b2015-01-15 14:22:26 -08002898 private static final Validator TEXT_AUTO_PUNCTUATE_VALIDATOR = sBooleanValidator;
2899
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002900 /**
2901 * Setting to showing password characters in text editors. 1 = On, 0 = Off
2902 */
2903 public static final String TEXT_SHOW_PASSWORD = "show_password";
2904
Svetoslav683914b2015-01-15 14:22:26 -08002905 private static final Validator TEXT_SHOW_PASSWORD_VALIDATOR = sBooleanValidator;
2906
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002907 public static final String SHOW_GTALK_SERVICE_STATUS =
2908 "SHOW_GTALK_SERVICE_STATUS";
2909
Svetoslav683914b2015-01-15 14:22:26 -08002910 private static final Validator SHOW_GTALK_SERVICE_STATUS_VALIDATOR = sBooleanValidator;
2911
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002912 /**
2913 * Name of activity to use for wallpaper on the home screen.
Jeff Sharkey6e2bee72012-10-01 13:39:08 -07002914 *
2915 * @deprecated Use {@link WallpaperManager} instead.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002916 */
Jeff Sharkey6e2bee72012-10-01 13:39:08 -07002917 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002918 public static final String WALLPAPER_ACTIVITY = "wallpaper_activity";
2919
Svetoslav683914b2015-01-15 14:22:26 -08002920 private static final Validator WALLPAPER_ACTIVITY_VALIDATOR = new Validator() {
2921 private static final int MAX_LENGTH = 1000;
2922
2923 @Override
2924 public boolean validate(String value) {
2925 if (value != null && value.length() > MAX_LENGTH) {
2926 return false;
2927 }
2928 return ComponentName.unflattenFromString(value) != null;
2929 }
2930 };
2931
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002932 /**
Christopher Tate06efb532012-08-24 15:29:27 -07002933 * @deprecated Use {@link android.provider.Settings.Global#AUTO_TIME}
2934 * instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002935 */
Christopher Tate06efb532012-08-24 15:29:27 -07002936 @Deprecated
2937 public static final String AUTO_TIME = Global.AUTO_TIME;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002938
2939 /**
Christopher Tate06efb532012-08-24 15:29:27 -07002940 * @deprecated Use {@link android.provider.Settings.Global#AUTO_TIME_ZONE}
2941 * instead
Amith Yamasaniad450be2010-09-16 16:47:00 -07002942 */
Christopher Tate06efb532012-08-24 15:29:27 -07002943 @Deprecated
2944 public static final String AUTO_TIME_ZONE = Global.AUTO_TIME_ZONE;
Amith Yamasaniad450be2010-09-16 16:47:00 -07002945
2946 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002947 * Display times as 12 or 24 hours
2948 * 12
2949 * 24
2950 */
2951 public static final String TIME_12_24 = "time_12_24";
2952
Svetoslav683914b2015-01-15 14:22:26 -08002953 /** @hide */
2954 public static final Validator TIME_12_24_VALIDATOR =
2955 new DiscreteValueValidator(new String[] {"12", "24"});
2956
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002957 /**
2958 * Date format string
2959 * mm/dd/yyyy
2960 * dd/mm/yyyy
2961 * yyyy/mm/dd
2962 */
2963 public static final String DATE_FORMAT = "date_format";
2964
Svetoslav683914b2015-01-15 14:22:26 -08002965 /** @hide */
2966 public static final Validator DATE_FORMAT_VALIDATOR = new Validator() {
2967 @Override
2968 public boolean validate(String value) {
2969 try {
2970 new SimpleDateFormat(value);
2971 return true;
2972 } catch (IllegalArgumentException e) {
2973 return false;
2974 }
2975 }
2976 };
2977
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002978 /**
2979 * Whether the setup wizard has been run before (on first boot), or if
2980 * it still needs to be run.
2981 *
2982 * nonzero = it has been run in the past
2983 * 0 = it has not been run in the past
2984 */
2985 public static final String SETUP_WIZARD_HAS_RUN = "setup_wizard_has_run";
2986
Svetoslav683914b2015-01-15 14:22:26 -08002987 /** @hide */
2988 public static final Validator SETUP_WIZARD_HAS_RUN_VALIDATOR = sBooleanValidator;
2989
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002990 /**
2991 * Scaling factor for normal window animations. Setting to 0 will disable window
2992 * animations.
Jeff Sharkey6e2bee72012-10-01 13:39:08 -07002993 *
2994 * @deprecated Use {@link Global#WINDOW_ANIMATION_SCALE} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002995 */
Jeff Sharkey6e2bee72012-10-01 13:39:08 -07002996 @Deprecated
2997 public static final String WINDOW_ANIMATION_SCALE = Global.WINDOW_ANIMATION_SCALE;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002998
2999 /**
3000 * Scaling factor for activity transition animations. Setting to 0 will disable window
3001 * animations.
Jeff Sharkey6e2bee72012-10-01 13:39:08 -07003002 *
3003 * @deprecated Use {@link Global#TRANSITION_ANIMATION_SCALE} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003004 */
Jeff Sharkey6e2bee72012-10-01 13:39:08 -07003005 @Deprecated
3006 public static final String TRANSITION_ANIMATION_SCALE = Global.TRANSITION_ANIMATION_SCALE;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003007
3008 /**
Chet Haasec38fa1f2012-02-01 16:37:46 -08003009 * Scaling factor for Animator-based animations. This affects both the start delay and
3010 * duration of all such animations. Setting to 0 will cause animations to end immediately.
3011 * The default value is 1.
Jeff Sharkey6e2bee72012-10-01 13:39:08 -07003012 *
3013 * @deprecated Use {@link Global#ANIMATOR_DURATION_SCALE} instead
Chet Haasec38fa1f2012-02-01 16:37:46 -08003014 */
Jeff Sharkey6e2bee72012-10-01 13:39:08 -07003015 @Deprecated
3016 public static final String ANIMATOR_DURATION_SCALE = Global.ANIMATOR_DURATION_SCALE;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003017
3018 /**
3019 * Control whether the accelerometer will be used to change screen
3020 * orientation. If 0, it will not be used unless explicitly requested
3021 * by the application; if 1, it will be used by default unless explicitly
3022 * disabled by the application.
3023 */
3024 public static final String ACCELEROMETER_ROTATION = "accelerometer_rotation";
3025
Svetoslav683914b2015-01-15 14:22:26 -08003026 /** @hide */
3027 public static final Validator ACCELEROMETER_ROTATION_VALIDATOR = sBooleanValidator;
3028
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003029 /**
Daniel Sandlerb73617d2010-08-17 00:41:00 -04003030 * Default screen rotation when no other policy applies.
3031 * When {@link #ACCELEROMETER_ROTATION} is zero and no on-screen Activity expresses a
3032 * preference, this rotation value will be used. Must be one of the
Brian Muramatsue1d46982010-12-06 17:34:20 -08003033 * {@link android.view.Surface#ROTATION_0 Surface rotation constants}.
Daniel Sandlerb73617d2010-08-17 00:41:00 -04003034 *
Dianne Hackborn16ec0802014-08-15 18:32:33 -07003035 * @see android.view.Display#getRotation
Daniel Sandlerb73617d2010-08-17 00:41:00 -04003036 */
3037 public static final String USER_ROTATION = "user_rotation";
3038
Svetoslav683914b2015-01-15 14:22:26 -08003039 /** @hide */
3040 public static final Validator USER_ROTATION_VALIDATOR =
3041 new InclusiveIntegerRangeValidator(0, 3);
3042
Daniel Sandlerb73617d2010-08-17 00:41:00 -04003043 /**
Jeff Brown207673cd2012-06-05 17:47:11 -07003044 * Control whether the rotation lock toggle in the System UI should be hidden.
3045 * Typically this is done for accessibility purposes to make it harder for
3046 * the user to accidentally toggle the rotation lock while the display rotation
3047 * has been locked for accessibility.
3048 *
3049 * If 0, then rotation lock toggle is not hidden for accessibility (although it may be
3050 * unavailable for other reasons). If 1, then the rotation lock toggle is hidden.
3051 *
3052 * @hide
3053 */
3054 public static final String HIDE_ROTATION_LOCK_TOGGLE_FOR_ACCESSIBILITY =
3055 "hide_rotation_lock_toggle_for_accessibility";
3056
Svetoslav683914b2015-01-15 14:22:26 -08003057 /** @hide */
3058 public static final Validator HIDE_ROTATION_LOCK_TOGGLE_FOR_ACCESSIBILITY_VALIDATOR =
3059 sBooleanValidator;
3060
Jeff Brown207673cd2012-06-05 17:47:11 -07003061 /**
Daisuke Miyakawa3c60eeb2012-05-08 12:08:25 -07003062 * Whether the phone vibrates when it is ringing due to an incoming call. This will
3063 * be used by Phone and Setting apps; it shouldn't affect other apps.
3064 * The value is boolean (1 or 0).
3065 *
3066 * Note: this is not same as "vibrate on ring", which had been available until ICS.
3067 * It was about AudioManager's setting and thus affected all the applications which
3068 * relied on the setting, while this is purely about the vibration setting for incoming
3069 * calls.
Daisuke Miyakawa3c60eeb2012-05-08 12:08:25 -07003070 */
3071 public static final String VIBRATE_WHEN_RINGING = "vibrate_when_ringing";
3072
Svetoslav683914b2015-01-15 14:22:26 -08003073 /** @hide */
3074 public static final Validator VIBRATE_WHEN_RINGING_VALIDATOR = sBooleanValidator;
3075
Daisuke Miyakawa3c60eeb2012-05-08 12:08:25 -07003076 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003077 * Whether the audible DTMF tones are played by the dialer when dialing. The value is
3078 * boolean (1 or 0).
3079 */
3080 public static final String DTMF_TONE_WHEN_DIALING = "dtmf_tone";
3081
Svetoslav683914b2015-01-15 14:22:26 -08003082 /** @hide */
3083 public static final Validator DTMF_TONE_WHEN_DIALING_VALIDATOR = sBooleanValidator;
3084
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003085 /**
David Kraused0f67152009-06-13 18:01:13 -05003086 * CDMA only settings
3087 * DTMF tone type played by the dialer when dialing.
3088 * 0 = Normal
3089 * 1 = Long
David Kraused0f67152009-06-13 18:01:13 -05003090 */
3091 public static final String DTMF_TONE_TYPE_WHEN_DIALING = "dtmf_tone_type";
3092
Svetoslav683914b2015-01-15 14:22:26 -08003093 /** @hide */
3094 public static final Validator DTMF_TONE_TYPE_WHEN_DIALING_VALIDATOR = sBooleanValidator;
3095
David Kraused0f67152009-06-13 18:01:13 -05003096 /**
David Kraused0f67152009-06-13 18:01:13 -05003097 * Whether the hearing aid is enabled. The value is
3098 * boolean (1 or 0).
3099 * @hide
3100 */
3101 public static final String HEARING_AID = "hearing_aid";
3102
Svetoslav683914b2015-01-15 14:22:26 -08003103 /** @hide */
3104 public static final Validator HEARING_AID_VALIDATOR = sBooleanValidator;
3105
David Kraused0f67152009-06-13 18:01:13 -05003106 /**
3107 * CDMA only settings
3108 * TTY Mode
3109 * 0 = OFF
3110 * 1 = FULL
3111 * 2 = VCO
3112 * 3 = HCO
3113 * @hide
3114 */
3115 public static final String TTY_MODE = "tty_mode";
3116
Svetoslav683914b2015-01-15 14:22:26 -08003117 /** @hide */
3118 public static final Validator TTY_MODE_VALIDATOR = new InclusiveIntegerRangeValidator(0, 3);
3119
David Kraused0f67152009-06-13 18:01:13 -05003120 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003121 * Whether the sounds effects (key clicks, lid open ...) are enabled. The value is
3122 * boolean (1 or 0).
3123 */
3124 public static final String SOUND_EFFECTS_ENABLED = "sound_effects_enabled";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07003125
Svetoslav683914b2015-01-15 14:22:26 -08003126 /** @hide */
3127 public static final Validator SOUND_EFFECTS_ENABLED_VALIDATOR = sBooleanValidator;
3128
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003129 /**
3130 * Whether the haptic feedback (long presses, ...) are enabled. The value is
3131 * boolean (1 or 0).
3132 */
3133 public static final String HAPTIC_FEEDBACK_ENABLED = "haptic_feedback_enabled";
Sanjay Jeyakumar21bf2412009-07-09 13:31:48 -07003134
Svetoslav683914b2015-01-15 14:22:26 -08003135 /** @hide */
3136 public static final Validator HAPTIC_FEEDBACK_ENABLED_VALIDATOR = sBooleanValidator;
3137
Mike LeBeau48603e72009-06-05 00:27:00 +01003138 /**
Bjorn Bringert24abb662010-09-21 12:21:18 +01003139 * @deprecated Each application that shows web suggestions should have its own
3140 * setting for this.
Mike LeBeau48603e72009-06-05 00:27:00 +01003141 */
Bjorn Bringert24abb662010-09-21 12:21:18 +01003142 @Deprecated
Mike LeBeau48603e72009-06-05 00:27:00 +01003143 public static final String SHOW_WEB_SUGGESTIONS = "show_web_suggestions";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07003144
Svetoslav683914b2015-01-15 14:22:26 -08003145 /** @hide */
3146 public static final Validator SHOW_WEB_SUGGESTIONS_VALIDATOR = sBooleanValidator;
3147
-b master501eec92009-07-06 13:53:11 -07003148 /**
Amith Yamasaniae3ed702009-12-01 19:02:05 -08003149 * Whether the notification LED should repeatedly flash when a notification is
3150 * pending. The value is boolean (1 or 0).
3151 * @hide
3152 */
3153 public static final String NOTIFICATION_LIGHT_PULSE = "notification_light_pulse";
3154
Svetoslav683914b2015-01-15 14:22:26 -08003155 /** @hide */
3156 public static final Validator NOTIFICATION_LIGHT_PULSE_VALIDATOR = sBooleanValidator;
3157
Amith Yamasaniae3ed702009-12-01 19:02:05 -08003158 /**
Dianne Hackborn90d2db32010-02-11 22:19:06 -08003159 * Show pointer location on screen?
3160 * 0 = no
3161 * 1 = yes
3162 * @hide
3163 */
3164 public static final String POINTER_LOCATION = "pointer_location";
3165
Svetoslav683914b2015-01-15 14:22:26 -08003166 /** @hide */
3167 public static final Validator POINTER_LOCATION_VALIDATOR = sBooleanValidator;
3168
Dianne Hackborn90d2db32010-02-11 22:19:06 -08003169 /**
Jeff Browndaf4a122011-08-26 17:14:14 -07003170 * Show touch positions on screen?
3171 * 0 = no
3172 * 1 = yes
3173 * @hide
3174 */
3175 public static final String SHOW_TOUCHES = "show_touches";
3176
Svetoslav683914b2015-01-15 14:22:26 -08003177 /** @hide */
3178 public static final Validator SHOW_TOUCHES_VALIDATOR = sBooleanValidator;
3179
Jeff Browndaf4a122011-08-26 17:14:14 -07003180 /**
Dianne Hackborn16ec0802014-08-15 18:32:33 -07003181 * Log raw orientation data from
Jorim Jaggib10e33f2015-02-04 21:57:40 +01003182 * {@link com.android.server.policy.WindowOrientationListener} for use with the
Jeff Brown4519f072011-01-23 13:16:01 -08003183 * orientationplot.py tool.
3184 * 0 = no
3185 * 1 = yes
3186 * @hide
3187 */
3188 public static final String WINDOW_ORIENTATION_LISTENER_LOG =
3189 "window_orientation_listener_log";
3190
Svetoslav683914b2015-01-15 14:22:26 -08003191 /** @hide */
3192 public static final Validator WINDOW_ORIENTATION_LISTENER_LOG_VALIDATOR = sBooleanValidator;
3193
Jeff Brown4519f072011-01-23 13:16:01 -08003194 /**
Christopher Tate06efb532012-08-24 15:29:27 -07003195 * @deprecated Use {@link android.provider.Settings.Global#POWER_SOUNDS_ENABLED}
3196 * instead
Daniel Sandler0e9d2af2010-01-25 11:33:03 -05003197 * @hide
3198 */
Christopher Tate06efb532012-08-24 15:29:27 -07003199 @Deprecated
3200 public static final String POWER_SOUNDS_ENABLED = Global.POWER_SOUNDS_ENABLED;
Daniel Sandler0e9d2af2010-01-25 11:33:03 -05003201
3202 /**
Christopher Tate06efb532012-08-24 15:29:27 -07003203 * @deprecated Use {@link android.provider.Settings.Global#DOCK_SOUNDS_ENABLED}
3204 * instead
Daniel Sandler0e9d2af2010-01-25 11:33:03 -05003205 * @hide
3206 */
Christopher Tate06efb532012-08-24 15:29:27 -07003207 @Deprecated
3208 public static final String DOCK_SOUNDS_ENABLED = Global.DOCK_SOUNDS_ENABLED;
Daniel Sandler0e9d2af2010-01-25 11:33:03 -05003209
3210 /**
3211 * Whether to play sounds when the keyguard is shown and dismissed.
3212 * @hide
3213 */
3214 public static final String LOCKSCREEN_SOUNDS_ENABLED = "lockscreen_sounds_enabled";
3215
Svetoslav683914b2015-01-15 14:22:26 -08003216 /** @hide */
3217 public static final Validator LOCKSCREEN_SOUNDS_ENABLED_VALIDATOR = sBooleanValidator;
3218
Daniel Sandler0e9d2af2010-01-25 11:33:03 -05003219 /**
Mike Lockwood7bef7392011-10-20 16:51:53 -04003220 * Whether the lockscreen should be completely disabled.
3221 * @hide
3222 */
3223 public static final String LOCKSCREEN_DISABLED = "lockscreen.disabled";
3224
Svetoslav683914b2015-01-15 14:22:26 -08003225 /** @hide */
3226 public static final Validator LOCKSCREEN_DISABLED_VALIDATOR = sBooleanValidator;
3227
Mike Lockwood7bef7392011-10-20 16:51:53 -04003228 /**
Christopher Tate06efb532012-08-24 15:29:27 -07003229 * @deprecated Use {@link android.provider.Settings.Global#LOW_BATTERY_SOUND}
3230 * instead
Daniel Sandler0e9d2af2010-01-25 11:33:03 -05003231 * @hide
3232 */
Christopher Tate06efb532012-08-24 15:29:27 -07003233 @Deprecated
3234 public static final String LOW_BATTERY_SOUND = Global.LOW_BATTERY_SOUND;
Daniel Sandler0e9d2af2010-01-25 11:33:03 -05003235
3236 /**
Christopher Tate06efb532012-08-24 15:29:27 -07003237 * @deprecated Use {@link android.provider.Settings.Global#DESK_DOCK_SOUND}
3238 * instead
Daniel Sandler0e9d2af2010-01-25 11:33:03 -05003239 * @hide
3240 */
Christopher Tate06efb532012-08-24 15:29:27 -07003241 @Deprecated
3242 public static final String DESK_DOCK_SOUND = Global.DESK_DOCK_SOUND;
Daniel Sandler0e9d2af2010-01-25 11:33:03 -05003243
3244 /**
Christopher Tate06efb532012-08-24 15:29:27 -07003245 * @deprecated Use {@link android.provider.Settings.Global#DESK_UNDOCK_SOUND}
3246 * instead
Daniel Sandler0e9d2af2010-01-25 11:33:03 -05003247 * @hide
3248 */
Christopher Tate06efb532012-08-24 15:29:27 -07003249 @Deprecated
3250 public static final String DESK_UNDOCK_SOUND = Global.DESK_UNDOCK_SOUND;
Daniel Sandler0e9d2af2010-01-25 11:33:03 -05003251
3252 /**
Christopher Tate06efb532012-08-24 15:29:27 -07003253 * @deprecated Use {@link android.provider.Settings.Global#CAR_DOCK_SOUND}
3254 * instead
Daniel Sandler0e9d2af2010-01-25 11:33:03 -05003255 * @hide
3256 */
Christopher Tate06efb532012-08-24 15:29:27 -07003257 @Deprecated
3258 public static final String CAR_DOCK_SOUND = Global.CAR_DOCK_SOUND;
Daniel Sandler0e9d2af2010-01-25 11:33:03 -05003259
3260 /**
Christopher Tate06efb532012-08-24 15:29:27 -07003261 * @deprecated Use {@link android.provider.Settings.Global#CAR_UNDOCK_SOUND}
3262 * instead
Daniel Sandler0e9d2af2010-01-25 11:33:03 -05003263 * @hide
3264 */
Christopher Tate06efb532012-08-24 15:29:27 -07003265 @Deprecated
3266 public static final String CAR_UNDOCK_SOUND = Global.CAR_UNDOCK_SOUND;
Daniel Sandler0e9d2af2010-01-25 11:33:03 -05003267
3268 /**
Christopher Tate06efb532012-08-24 15:29:27 -07003269 * @deprecated Use {@link android.provider.Settings.Global#LOCK_SOUND}
3270 * instead
Daniel Sandler0e9d2af2010-01-25 11:33:03 -05003271 * @hide
3272 */
Christopher Tate06efb532012-08-24 15:29:27 -07003273 @Deprecated
3274 public static final String LOCK_SOUND = Global.LOCK_SOUND;
Daniel Sandler0e9d2af2010-01-25 11:33:03 -05003275
3276 /**
Christopher Tate06efb532012-08-24 15:29:27 -07003277 * @deprecated Use {@link android.provider.Settings.Global#UNLOCK_SOUND}
3278 * instead
Daniel Sandler0e9d2af2010-01-25 11:33:03 -05003279 * @hide
3280 */
Christopher Tate06efb532012-08-24 15:29:27 -07003281 @Deprecated
3282 public static final String UNLOCK_SOUND = Global.UNLOCK_SOUND;
Daniel Sandler0e9d2af2010-01-25 11:33:03 -05003283
3284 /**
Chung-yih Wang042e9bd2010-08-31 17:43:39 +08003285 * Receive incoming SIP calls?
3286 * 0 = no
3287 * 1 = yes
3288 * @hide
3289 */
3290 public static final String SIP_RECEIVE_CALLS = "sip_receive_calls";
3291
Svetoslav683914b2015-01-15 14:22:26 -08003292 /** @hide */
3293 public static final Validator SIP_RECEIVE_CALLS_VALIDATOR = sBooleanValidator;
3294
Chung-yih Wang042e9bd2010-08-31 17:43:39 +08003295 /**
3296 * Call Preference String.
3297 * "SIP_ALWAYS" : Always use SIP with network access
3298 * "SIP_ADDRESS_ONLY" : Only if destination is a SIP address
Chung-yih Wang042e9bd2010-08-31 17:43:39 +08003299 * @hide
3300 */
3301 public static final String SIP_CALL_OPTIONS = "sip_call_options";
3302
Svetoslav683914b2015-01-15 14:22:26 -08003303 /** @hide */
3304 public static final Validator SIP_CALL_OPTIONS_VALIDATOR = new DiscreteValueValidator(
3305 new String[] {"SIP_ALWAYS", "SIP_ADDRESS_ONLY"});
3306
Chung-yih Wang042e9bd2010-08-31 17:43:39 +08003307 /**
3308 * One of the sip call options: Always use SIP with network access.
3309 * @hide
3310 */
3311 public static final String SIP_ALWAYS = "SIP_ALWAYS";
3312
Svetoslav683914b2015-01-15 14:22:26 -08003313 /** @hide */
3314 public static final Validator SIP_ALWAYS_VALIDATOR = sBooleanValidator;
3315
Chung-yih Wang042e9bd2010-08-31 17:43:39 +08003316 /**
3317 * One of the sip call options: Only if destination is a SIP address.
3318 * @hide
3319 */
3320 public static final String SIP_ADDRESS_ONLY = "SIP_ADDRESS_ONLY";
3321
Svetoslav683914b2015-01-15 14:22:26 -08003322 /** @hide */
3323 public static final Validator SIP_ADDRESS_ONLY_VALIDATOR = sBooleanValidator;
3324
Chung-yih Wang042e9bd2010-08-31 17:43:39 +08003325 /**
Tyler Gunn2c830a22014-09-02 08:39:35 -07003326 * @deprecated Use SIP_ALWAYS or SIP_ADDRESS_ONLY instead. Formerly used to indicate that
3327 * the user should be prompted each time a call is made whether it should be placed using
3328 * SIP. The {@link com.android.providers.settings.DatabaseHelper} replaces this with
3329 * SIP_ADDRESS_ONLY.
Chung-yih Wang042e9bd2010-08-31 17:43:39 +08003330 * @hide
3331 */
Tyler Gunn2c830a22014-09-02 08:39:35 -07003332 @Deprecated
Chung-yih Wang042e9bd2010-08-31 17:43:39 +08003333 public static final String SIP_ASK_ME_EACH_TIME = "SIP_ASK_ME_EACH_TIME";
3334
Svetoslav683914b2015-01-15 14:22:26 -08003335 /** @hide */
3336 public static final Validator SIP_ASK_ME_EACH_TIME_VALIDATOR = sBooleanValidator;
3337
Chung-yih Wang042e9bd2010-08-31 17:43:39 +08003338 /**
Jeff Brown1a84fd12011-06-02 01:26:32 -07003339 * Pointer speed setting.
3340 * This is an integer value in a range between -7 and +7, so there are 15 possible values.
3341 * -7 = slowest
3342 * 0 = default speed
3343 * +7 = fastest
3344 * @hide
3345 */
3346 public static final String POINTER_SPEED = "pointer_speed";
3347
Svetoslav683914b2015-01-15 14:22:26 -08003348 /** @hide */
3349 public static final Validator POINTER_SPEED_VALIDATOR =
3350 new InclusiveFloatRangeValidator(-7, 7);
3351
Jeff Brown1a84fd12011-06-02 01:26:32 -07003352 /**
Jason Monk56e09b42014-07-18 10:29:14 -04003353 * Whether lock-to-app will be triggered by long-press on recents.
3354 * @hide
3355 */
3356 public static final String LOCK_TO_APP_ENABLED = "lock_to_app_enabled";
3357
Svetoslav683914b2015-01-15 14:22:26 -08003358 /** @hide */
3359 public static final Validator LOCK_TO_APP_ENABLED_VALIDATOR = sBooleanValidator;
3360
Jason Monk56e09b42014-07-18 10:29:14 -04003361 /**
Daniel Sandler2fdb68b2013-10-03 00:12:11 -04003362 * I am the lolrus.
3363 * <p>
3364 * Nonzero values indicate that the user has a bukkit.
3365 * Backward-compatible with <code>PrefGetPreference(prefAllowEasterEggs)</code>.
3366 * @hide
3367 */
3368 public static final String EGG_MODE = "egg_mode";
3369
Svetoslav683914b2015-01-15 14:22:26 -08003370 /** @hide */
Svet Ganovb1918a02015-05-15 09:32:55 -07003371 public static final Validator EGG_MODE_VALIDATOR = new Validator() {
3372 @Override
3373 public boolean validate(String value) {
3374 try {
3375 return Long.parseLong(value) >= 0;
3376 } catch (NumberFormatException e) {
3377 return false;
3378 }
3379 }
3380 };
Svetoslav683914b2015-01-15 14:22:26 -08003381
3382 /**
3383 * IMPORTANT: If you add a new public settings you also have to add it to
3384 * PUBLIC_SETTINGS below. If the new setting is hidden you have to add
3385 * it to PRIVATE_SETTINGS below. Also add a validator that can validate
3386 * the setting value. See an example above.
3387 */
3388
Daniel Sandler2fdb68b2013-10-03 00:12:11 -04003389 /**
-b master501eec92009-07-06 13:53:11 -07003390 * Settings to backup. This is here so that it's in the same place as the settings
3391 * keys and easy to update.
Svetoslav Ganova571a582011-09-20 18:32:20 -07003392 *
3393 * NOTE: Settings are backed up and restored in the order they appear
3394 * in this array. If you have one setting depending on another,
3395 * make sure that they are ordered appropriately.
3396 *
-b master501eec92009-07-06 13:53:11 -07003397 * @hide
3398 */
3399 public static final String[] SETTINGS_TO_BACKUP = {
Christopher Tate66488d62012-10-02 11:58:01 -07003400 STAY_ON_WHILE_PLUGGED_IN, // moved to global
-b master501eec92009-07-06 13:53:11 -07003401 WIFI_USE_STATIC_IP,
3402 WIFI_STATIC_IP,
3403 WIFI_STATIC_GATEWAY,
3404 WIFI_STATIC_NETMASK,
3405 WIFI_STATIC_DNS1,
3406 WIFI_STATIC_DNS2,
3407 BLUETOOTH_DISCOVERABILITY,
3408 BLUETOOTH_DISCOVERABILITY_TIMEOUT,
Casey Burkhardt86b867f2015-12-29 18:03:36 -08003409 FONT_SCALE,
-b master501eec92009-07-06 13:53:11 -07003410 DIM_SCREEN,
3411 SCREEN_OFF_TIMEOUT,
3412 SCREEN_BRIGHTNESS,
Christopher Tate362aca62009-09-25 15:58:03 -07003413 SCREEN_BRIGHTNESS_MODE,
Dianne Hackbornd9ea4682012-01-20 18:36:40 -08003414 SCREEN_AUTO_BRIGHTNESS_ADJ,
Jeff Brown7f6c2312012-04-13 20:38:38 -07003415 VIBRATE_INPUT_DEVICES,
Amith Yamasani8823c0a82009-07-07 14:30:17 -07003416 MODE_RINGER_STREAMS_AFFECTED,
-b master501eec92009-07-06 13:53:11 -07003417 TEXT_AUTO_REPLACE,
3418 TEXT_AUTO_CAPS,
3419 TEXT_AUTO_PUNCTUATE,
3420 TEXT_SHOW_PASSWORD,
Christopher Tate66488d62012-10-02 11:58:01 -07003421 AUTO_TIME, // moved to global
3422 AUTO_TIME_ZONE, // moved to global
-b master501eec92009-07-06 13:53:11 -07003423 TIME_12_24,
3424 DATE_FORMAT,
-b master501eec92009-07-06 13:53:11 -07003425 DTMF_TONE_WHEN_DIALING,
3426 DTMF_TONE_TYPE_WHEN_DIALING,
-b master501eec92009-07-06 13:53:11 -07003427 HEARING_AID,
3428 TTY_MODE,
3429 SOUND_EFFECTS_ENABLED,
3430 HAPTIC_FEEDBACK_ENABLED,
Christopher Tate66488d62012-10-02 11:58:01 -07003431 POWER_SOUNDS_ENABLED, // moved to global
3432 DOCK_SOUNDS_ENABLED, // moved to global
Christopher Tate14c2d792010-02-25 16:49:44 -08003433 LOCKSCREEN_SOUNDS_ENABLED,
Amith Yamasaniae3ed702009-12-01 19:02:05 -08003434 SHOW_WEB_SUGGESTIONS,
Chung-yih Wang042e9bd2010-08-31 17:43:39 +08003435 SIP_CALL_OPTIONS,
Nick Pelly038cabe2010-09-23 16:12:11 -07003436 SIP_RECEIVE_CALLS,
Jeff Brown1a84fd12011-06-02 01:26:32 -07003437 POINTER_SPEED,
Amith Yamasani622bf2222013-09-06 13:54:28 -07003438 VIBRATE_WHEN_RINGING,
3439 RINGTONE,
Jason Monk94cfd9d2014-10-31 13:18:21 -04003440 LOCK_TO_APP_ENABLED,
Anna Galuszafa7786c2015-12-22 10:53:44 -08003441 NOTIFICATION_SOUND,
3442 ACCELEROMETER_ROTATION
-b master501eec92009-07-06 13:53:11 -07003443 };
3444
Sailesh Nepal1bd78762014-02-11 22:32:21 -08003445 /**
Amith Yamasanib0ff3222015-03-04 09:56:14 -08003446 * These are all public system settings
Svetoslav683914b2015-01-15 14:22:26 -08003447 *
Amith Yamasani4f7e2e32014-08-14 18:49:48 -07003448 * @hide
3449 */
Svetoslav683914b2015-01-15 14:22:26 -08003450 public static final Set<String> PUBLIC_SETTINGS = new ArraySet<>();
3451 static {
3452 PUBLIC_SETTINGS.add(END_BUTTON_BEHAVIOR);
3453 PUBLIC_SETTINGS.add(WIFI_USE_STATIC_IP);
3454 PUBLIC_SETTINGS.add(WIFI_STATIC_IP);
3455 PUBLIC_SETTINGS.add(WIFI_STATIC_GATEWAY);
3456 PUBLIC_SETTINGS.add(WIFI_STATIC_NETMASK);
3457 PUBLIC_SETTINGS.add(WIFI_STATIC_DNS1);
3458 PUBLIC_SETTINGS.add(WIFI_STATIC_DNS2);
3459 PUBLIC_SETTINGS.add(BLUETOOTH_DISCOVERABILITY);
3460 PUBLIC_SETTINGS.add(BLUETOOTH_DISCOVERABILITY_TIMEOUT);
3461 PUBLIC_SETTINGS.add(NEXT_ALARM_FORMATTED);
3462 PUBLIC_SETTINGS.add(FONT_SCALE);
3463 PUBLIC_SETTINGS.add(DIM_SCREEN);
3464 PUBLIC_SETTINGS.add(SCREEN_OFF_TIMEOUT);
3465 PUBLIC_SETTINGS.add(SCREEN_BRIGHTNESS);
3466 PUBLIC_SETTINGS.add(SCREEN_BRIGHTNESS_MODE);
3467 PUBLIC_SETTINGS.add(MODE_RINGER_STREAMS_AFFECTED);
3468 PUBLIC_SETTINGS.add(MUTE_STREAMS_AFFECTED);
3469 PUBLIC_SETTINGS.add(VIBRATE_ON);
3470 PUBLIC_SETTINGS.add(VOLUME_RING);
3471 PUBLIC_SETTINGS.add(VOLUME_SYSTEM);
3472 PUBLIC_SETTINGS.add(VOLUME_VOICE);
3473 PUBLIC_SETTINGS.add(VOLUME_MUSIC);
3474 PUBLIC_SETTINGS.add(VOLUME_ALARM);
3475 PUBLIC_SETTINGS.add(VOLUME_NOTIFICATION);
3476 PUBLIC_SETTINGS.add(VOLUME_BLUETOOTH_SCO);
3477 PUBLIC_SETTINGS.add(RINGTONE);
3478 PUBLIC_SETTINGS.add(NOTIFICATION_SOUND);
3479 PUBLIC_SETTINGS.add(ALARM_ALERT);
3480 PUBLIC_SETTINGS.add(TEXT_AUTO_REPLACE);
3481 PUBLIC_SETTINGS.add(TEXT_AUTO_CAPS);
3482 PUBLIC_SETTINGS.add(TEXT_AUTO_PUNCTUATE);
3483 PUBLIC_SETTINGS.add(TEXT_SHOW_PASSWORD);
3484 PUBLIC_SETTINGS.add(SHOW_GTALK_SERVICE_STATUS);
3485 PUBLIC_SETTINGS.add(WALLPAPER_ACTIVITY);
3486 PUBLIC_SETTINGS.add(TIME_12_24);
3487 PUBLIC_SETTINGS.add(DATE_FORMAT);
3488 PUBLIC_SETTINGS.add(SETUP_WIZARD_HAS_RUN);
3489 PUBLIC_SETTINGS.add(ACCELEROMETER_ROTATION);
3490 PUBLIC_SETTINGS.add(USER_ROTATION);
3491 PUBLIC_SETTINGS.add(DTMF_TONE_WHEN_DIALING);
3492 PUBLIC_SETTINGS.add(SOUND_EFFECTS_ENABLED);
3493 PUBLIC_SETTINGS.add(HAPTIC_FEEDBACK_ENABLED);
3494 PUBLIC_SETTINGS.add(SHOW_WEB_SUGGESTIONS);
Svetoslav Ganovd2631632015-12-09 16:29:22 -08003495 PUBLIC_SETTINGS.add(VIBRATE_WHEN_RINGING);
Svetoslav683914b2015-01-15 14:22:26 -08003496 }
3497
3498 /**
3499 * These are all hidden system settings.
3500 *
3501 * @hide
3502 */
3503 public static final Set<String> PRIVATE_SETTINGS = new ArraySet<>();
3504 static {
3505 PRIVATE_SETTINGS.add(WIFI_USE_STATIC_IP);
3506 PRIVATE_SETTINGS.add(END_BUTTON_BEHAVIOR);
3507 PRIVATE_SETTINGS.add(ADVANCED_SETTINGS);
3508 PRIVATE_SETTINGS.add(SCREEN_AUTO_BRIGHTNESS_ADJ);
3509 PRIVATE_SETTINGS.add(VIBRATE_INPUT_DEVICES);
3510 PRIVATE_SETTINGS.add(VOLUME_MASTER);
Andy Hungf04b84d2015-12-18 17:33:27 -08003511 PRIVATE_SETTINGS.add(MASTER_MONO);
Svetoslav683914b2015-01-15 14:22:26 -08003512 PRIVATE_SETTINGS.add(NOTIFICATIONS_USE_RING_VOLUME);
3513 PRIVATE_SETTINGS.add(VIBRATE_IN_SILENT);
3514 PRIVATE_SETTINGS.add(MEDIA_BUTTON_RECEIVER);
3515 PRIVATE_SETTINGS.add(HIDE_ROTATION_LOCK_TOGGLE_FOR_ACCESSIBILITY);
Svetoslav683914b2015-01-15 14:22:26 -08003516 PRIVATE_SETTINGS.add(DTMF_TONE_TYPE_WHEN_DIALING);
3517 PRIVATE_SETTINGS.add(HEARING_AID);
3518 PRIVATE_SETTINGS.add(TTY_MODE);
3519 PRIVATE_SETTINGS.add(NOTIFICATION_LIGHT_PULSE);
3520 PRIVATE_SETTINGS.add(POINTER_LOCATION);
3521 PRIVATE_SETTINGS.add(SHOW_TOUCHES);
3522 PRIVATE_SETTINGS.add(WINDOW_ORIENTATION_LISTENER_LOG);
3523 PRIVATE_SETTINGS.add(POWER_SOUNDS_ENABLED);
3524 PRIVATE_SETTINGS.add(DOCK_SOUNDS_ENABLED);
3525 PRIVATE_SETTINGS.add(LOCKSCREEN_SOUNDS_ENABLED);
3526 PRIVATE_SETTINGS.add(LOCKSCREEN_DISABLED);
3527 PRIVATE_SETTINGS.add(LOW_BATTERY_SOUND);
3528 PRIVATE_SETTINGS.add(DESK_DOCK_SOUND);
3529 PRIVATE_SETTINGS.add(DESK_UNDOCK_SOUND);
3530 PRIVATE_SETTINGS.add(CAR_DOCK_SOUND);
3531 PRIVATE_SETTINGS.add(CAR_UNDOCK_SOUND);
3532 PRIVATE_SETTINGS.add(LOCK_SOUND);
3533 PRIVATE_SETTINGS.add(UNLOCK_SOUND);
3534 PRIVATE_SETTINGS.add(SIP_RECEIVE_CALLS);
3535 PRIVATE_SETTINGS.add(SIP_CALL_OPTIONS);
3536 PRIVATE_SETTINGS.add(SIP_ALWAYS);
3537 PRIVATE_SETTINGS.add(SIP_ADDRESS_ONLY);
3538 PRIVATE_SETTINGS.add(SIP_ASK_ME_EACH_TIME);
3539 PRIVATE_SETTINGS.add(POINTER_SPEED);
3540 PRIVATE_SETTINGS.add(LOCK_TO_APP_ENABLED);
3541 PRIVATE_SETTINGS.add(EGG_MODE);
3542 }
3543
3544 /**
Amith Yamasanib0ff3222015-03-04 09:56:14 -08003545 * These are all public system settings
Svetoslav683914b2015-01-15 14:22:26 -08003546 *
3547 * @hide
3548 */
3549 public static final Map<String, Validator> VALIDATORS = new ArrayMap<>();
3550 static {
3551 VALIDATORS.put(END_BUTTON_BEHAVIOR,END_BUTTON_BEHAVIOR_VALIDATOR);
3552 VALIDATORS.put(WIFI_USE_STATIC_IP, WIFI_USE_STATIC_IP_VALIDATOR);
3553 VALIDATORS.put(BLUETOOTH_DISCOVERABILITY, BLUETOOTH_DISCOVERABILITY_VALIDATOR);
3554 VALIDATORS.put(BLUETOOTH_DISCOVERABILITY_TIMEOUT,
3555 BLUETOOTH_DISCOVERABILITY_TIMEOUT_VALIDATOR);
3556 VALIDATORS.put(NEXT_ALARM_FORMATTED, NEXT_ALARM_FORMATTED_VALIDATOR);
3557 VALIDATORS.put(FONT_SCALE, FONT_SCALE_VALIDATOR);
3558 VALIDATORS.put(DIM_SCREEN, DIM_SCREEN_VALIDATOR);
3559 VALIDATORS.put(SCREEN_OFF_TIMEOUT, SCREEN_OFF_TIMEOUT_VALIDATOR);
3560 VALIDATORS.put(SCREEN_BRIGHTNESS, SCREEN_BRIGHTNESS_VALIDATOR);
3561 VALIDATORS.put(SCREEN_BRIGHTNESS_MODE, SCREEN_BRIGHTNESS_MODE_VALIDATOR);
3562 VALIDATORS.put(MODE_RINGER_STREAMS_AFFECTED, MODE_RINGER_STREAMS_AFFECTED_VALIDATOR);
3563 VALIDATORS.put(MUTE_STREAMS_AFFECTED, MUTE_STREAMS_AFFECTED_VALIDATOR);
3564 VALIDATORS.put(VIBRATE_ON, VIBRATE_ON_VALIDATOR);
Svetoslav683914b2015-01-15 14:22:26 -08003565 VALIDATORS.put(RINGTONE, RINGTONE_VALIDATOR);
3566 VALIDATORS.put(NOTIFICATION_SOUND, NOTIFICATION_SOUND_VALIDATOR);
3567 VALIDATORS.put(ALARM_ALERT, ALARM_ALERT_VALIDATOR);
3568 VALIDATORS.put(TEXT_AUTO_REPLACE, TEXT_AUTO_REPLACE_VALIDATOR);
3569 VALIDATORS.put(TEXT_AUTO_CAPS, TEXT_AUTO_CAPS_VALIDATOR);
3570 VALIDATORS.put(TEXT_AUTO_PUNCTUATE, TEXT_AUTO_PUNCTUATE_VALIDATOR);
3571 VALIDATORS.put(TEXT_SHOW_PASSWORD, TEXT_SHOW_PASSWORD_VALIDATOR);
3572 VALIDATORS.put(SHOW_GTALK_SERVICE_STATUS, SHOW_GTALK_SERVICE_STATUS_VALIDATOR);
3573 VALIDATORS.put(WALLPAPER_ACTIVITY, WALLPAPER_ACTIVITY_VALIDATOR);
3574 VALIDATORS.put(TIME_12_24, TIME_12_24_VALIDATOR);
3575 VALIDATORS.put(DATE_FORMAT, DATE_FORMAT_VALIDATOR);
3576 VALIDATORS.put(SETUP_WIZARD_HAS_RUN, SETUP_WIZARD_HAS_RUN_VALIDATOR);
3577 VALIDATORS.put(ACCELEROMETER_ROTATION, ACCELEROMETER_ROTATION_VALIDATOR);
3578 VALIDATORS.put(USER_ROTATION, USER_ROTATION_VALIDATOR);
3579 VALIDATORS.put(DTMF_TONE_WHEN_DIALING, DTMF_TONE_WHEN_DIALING_VALIDATOR);
3580 VALIDATORS.put(SOUND_EFFECTS_ENABLED, SOUND_EFFECTS_ENABLED_VALIDATOR);
3581 VALIDATORS.put(HAPTIC_FEEDBACK_ENABLED, HAPTIC_FEEDBACK_ENABLED_VALIDATOR);
3582 VALIDATORS.put(SHOW_WEB_SUGGESTIONS, SHOW_WEB_SUGGESTIONS_VALIDATOR);
3583 VALIDATORS.put(WIFI_USE_STATIC_IP, WIFI_USE_STATIC_IP_VALIDATOR);
3584 VALIDATORS.put(END_BUTTON_BEHAVIOR, END_BUTTON_BEHAVIOR_VALIDATOR);
3585 VALIDATORS.put(ADVANCED_SETTINGS, ADVANCED_SETTINGS_VALIDATOR);
3586 VALIDATORS.put(SCREEN_AUTO_BRIGHTNESS_ADJ, SCREEN_AUTO_BRIGHTNESS_ADJ_VALIDATOR);
3587 VALIDATORS.put(VIBRATE_INPUT_DEVICES, VIBRATE_INPUT_DEVICES_VALIDATOR);
Andy Hungf04b84d2015-12-18 17:33:27 -08003588 VALIDATORS.put(MASTER_MONO, MASTER_MONO_VALIDATOR);
Svetoslav683914b2015-01-15 14:22:26 -08003589 VALIDATORS.put(NOTIFICATIONS_USE_RING_VOLUME, NOTIFICATIONS_USE_RING_VOLUME_VALIDATOR);
3590 VALIDATORS.put(VIBRATE_IN_SILENT, VIBRATE_IN_SILENT_VALIDATOR);
3591 VALIDATORS.put(MEDIA_BUTTON_RECEIVER, MEDIA_BUTTON_RECEIVER_VALIDATOR);
3592 VALIDATORS.put(HIDE_ROTATION_LOCK_TOGGLE_FOR_ACCESSIBILITY,
3593 HIDE_ROTATION_LOCK_TOGGLE_FOR_ACCESSIBILITY_VALIDATOR);
3594 VALIDATORS.put(VIBRATE_WHEN_RINGING, VIBRATE_WHEN_RINGING_VALIDATOR);
3595 VALIDATORS.put(DTMF_TONE_TYPE_WHEN_DIALING, DTMF_TONE_TYPE_WHEN_DIALING_VALIDATOR);
3596 VALIDATORS.put(HEARING_AID, HEARING_AID_VALIDATOR);
3597 VALIDATORS.put(TTY_MODE, TTY_MODE_VALIDATOR);
3598 VALIDATORS.put(NOTIFICATION_LIGHT_PULSE, NOTIFICATION_LIGHT_PULSE_VALIDATOR);
3599 VALIDATORS.put(POINTER_LOCATION, POINTER_LOCATION_VALIDATOR);
3600 VALIDATORS.put(SHOW_TOUCHES, SHOW_TOUCHES_VALIDATOR);
3601 VALIDATORS.put(WINDOW_ORIENTATION_LISTENER_LOG,
3602 WINDOW_ORIENTATION_LISTENER_LOG_VALIDATOR);
3603 VALIDATORS.put(LOCKSCREEN_SOUNDS_ENABLED, LOCKSCREEN_SOUNDS_ENABLED_VALIDATOR);
3604 VALIDATORS.put(LOCKSCREEN_DISABLED, LOCKSCREEN_DISABLED_VALIDATOR);
3605 VALIDATORS.put(SIP_RECEIVE_CALLS, SIP_RECEIVE_CALLS_VALIDATOR);
3606 VALIDATORS.put(SIP_CALL_OPTIONS, SIP_CALL_OPTIONS_VALIDATOR);
3607 VALIDATORS.put(SIP_ALWAYS, SIP_ALWAYS_VALIDATOR);
3608 VALIDATORS.put(SIP_ADDRESS_ONLY, SIP_ADDRESS_ONLY_VALIDATOR);
3609 VALIDATORS.put(SIP_ASK_ME_EACH_TIME, SIP_ASK_ME_EACH_TIME_VALIDATOR);
3610 VALIDATORS.put(POINTER_SPEED, POINTER_SPEED_VALIDATOR);
3611 VALIDATORS.put(LOCK_TO_APP_ENABLED, LOCK_TO_APP_ENABLED_VALIDATOR);
3612 VALIDATORS.put(EGG_MODE, EGG_MODE_VALIDATOR);
3613 VALIDATORS.put(WIFI_STATIC_IP, WIFI_STATIC_IP_VALIDATOR);
3614 VALIDATORS.put(WIFI_STATIC_GATEWAY, WIFI_STATIC_GATEWAY_VALIDATOR);
3615 VALIDATORS.put(WIFI_STATIC_NETMASK, WIFI_STATIC_NETMASK_VALIDATOR);
3616 VALIDATORS.put(WIFI_STATIC_DNS1, WIFI_STATIC_DNS1_VALIDATOR);
3617 VALIDATORS.put(WIFI_STATIC_DNS2, WIFI_STATIC_DNS2_VALIDATOR);
3618 }
3619
3620 /**
3621 * These entries are considered common between the personal and the managed profile,
3622 * since the managed profile doesn't get to change them.
3623 */
3624 private static final Set<String> CLONE_TO_MANAGED_PROFILE = new ArraySet<>();
3625 static {
3626 CLONE_TO_MANAGED_PROFILE.add(DATE_FORMAT);
3627 CLONE_TO_MANAGED_PROFILE.add(HAPTIC_FEEDBACK_ENABLED);
3628 CLONE_TO_MANAGED_PROFILE.add(SOUND_EFFECTS_ENABLED);
3629 CLONE_TO_MANAGED_PROFILE.add(TEXT_SHOW_PASSWORD);
3630 CLONE_TO_MANAGED_PROFILE.add(TIME_12_24);
3631 }
3632
3633 /** @hide */
3634 public static void getCloneToManagedProfileSettings(Set<String> outKeySet) {
3635 outKeySet.addAll(CLONE_TO_MANAGED_PROFILE);
3636 }
Amith Yamasani4f7e2e32014-08-14 18:49:48 -07003637
3638 /**
Sailesh Nepal1bd78762014-02-11 22:32:21 -08003639 * When to use Wi-Fi calling
3640 *
3641 * @see android.telephony.TelephonyManager.WifiCallingChoices
3642 * @hide
3643 */
3644 public static final String WHEN_TO_MAKE_WIFI_CALLS = "when_to_make_wifi_calls";
3645
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003646 // Settings moved to Settings.Secure
3647
3648 /**
Christopher Tate06efb532012-08-24 15:29:27 -07003649 * @deprecated Use {@link android.provider.Settings.Global#ADB_ENABLED}
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003650 * instead
3651 */
3652 @Deprecated
Christopher Tate06efb532012-08-24 15:29:27 -07003653 public static final String ADB_ENABLED = Global.ADB_ENABLED;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003654
3655 /**
3656 * @deprecated Use {@link android.provider.Settings.Secure#ANDROID_ID} instead
3657 */
3658 @Deprecated
3659 public static final String ANDROID_ID = Secure.ANDROID_ID;
3660
3661 /**
Christopher Tate06efb532012-08-24 15:29:27 -07003662 * @deprecated Use {@link android.provider.Settings.Global#BLUETOOTH_ON} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003663 */
3664 @Deprecated
Christopher Tate06efb532012-08-24 15:29:27 -07003665 public static final String BLUETOOTH_ON = Global.BLUETOOTH_ON;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003666
3667 /**
Christopher Tate06efb532012-08-24 15:29:27 -07003668 * @deprecated Use {@link android.provider.Settings.Global#DATA_ROAMING} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003669 */
3670 @Deprecated
Christopher Tate06efb532012-08-24 15:29:27 -07003671 public static final String DATA_ROAMING = Global.DATA_ROAMING;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003672
3673 /**
Christopher Tate06efb532012-08-24 15:29:27 -07003674 * @deprecated Use {@link android.provider.Settings.Global#DEVICE_PROVISIONED} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003675 */
3676 @Deprecated
Christopher Tate06efb532012-08-24 15:29:27 -07003677 public static final String DEVICE_PROVISIONED = Global.DEVICE_PROVISIONED;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003678
3679 /**
Jeff Sharkey625239a2012-09-26 22:03:49 -07003680 * @deprecated Use {@link android.provider.Settings.Global#HTTP_PROXY} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003681 */
3682 @Deprecated
Jeff Sharkey625239a2012-09-26 22:03:49 -07003683 public static final String HTTP_PROXY = Global.HTTP_PROXY;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003684
3685 /**
Christopher Tateaa036a22014-05-19 16:33:27 -07003686 * @deprecated Use {@link android.provider.Settings.Secure#INSTALL_NON_MARKET_APPS} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003687 */
3688 @Deprecated
Christopher Tateaa036a22014-05-19 16:33:27 -07003689 public static final String INSTALL_NON_MARKET_APPS = Secure.INSTALL_NON_MARKET_APPS;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07003690
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003691 /**
3692 * @deprecated Use {@link android.provider.Settings.Secure#LOCATION_PROVIDERS_ALLOWED}
3693 * instead
3694 */
3695 @Deprecated
3696 public static final String LOCATION_PROVIDERS_ALLOWED = Secure.LOCATION_PROVIDERS_ALLOWED;
3697
3698 /**
3699 * @deprecated Use {@link android.provider.Settings.Secure#LOGGING_ID} instead
3700 */
3701 @Deprecated
3702 public static final String LOGGING_ID = Secure.LOGGING_ID;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07003703
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003704 /**
Christopher Tate06efb532012-08-24 15:29:27 -07003705 * @deprecated Use {@link android.provider.Settings.Global#NETWORK_PREFERENCE} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003706 */
3707 @Deprecated
Christopher Tate06efb532012-08-24 15:29:27 -07003708 public static final String NETWORK_PREFERENCE = Global.NETWORK_PREFERENCE;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003709
3710 /**
3711 * @deprecated Use {@link android.provider.Settings.Secure#PARENTAL_CONTROL_ENABLED}
3712 * instead
3713 */
3714 @Deprecated
3715 public static final String PARENTAL_CONTROL_ENABLED = Secure.PARENTAL_CONTROL_ENABLED;
3716
3717 /**
3718 * @deprecated Use {@link android.provider.Settings.Secure#PARENTAL_CONTROL_LAST_UPDATE}
3719 * instead
3720 */
3721 @Deprecated
3722 public static final String PARENTAL_CONTROL_LAST_UPDATE = Secure.PARENTAL_CONTROL_LAST_UPDATE;
3723
3724 /**
3725 * @deprecated Use {@link android.provider.Settings.Secure#PARENTAL_CONTROL_REDIRECT_URL}
3726 * instead
3727 */
3728 @Deprecated
3729 public static final String PARENTAL_CONTROL_REDIRECT_URL =
3730 Secure.PARENTAL_CONTROL_REDIRECT_URL;
3731
3732 /**
3733 * @deprecated Use {@link android.provider.Settings.Secure#SETTINGS_CLASSNAME} instead
3734 */
3735 @Deprecated
3736 public static final String SETTINGS_CLASSNAME = Secure.SETTINGS_CLASSNAME;
3737
3738 /**
Christopher Tate06efb532012-08-24 15:29:27 -07003739 * @deprecated Use {@link android.provider.Settings.Global#USB_MASS_STORAGE_ENABLED} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003740 */
3741 @Deprecated
Christopher Tate06efb532012-08-24 15:29:27 -07003742 public static final String USB_MASS_STORAGE_ENABLED = Global.USB_MASS_STORAGE_ENABLED;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07003743
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003744 /**
Christopher Tate06efb532012-08-24 15:29:27 -07003745 * @deprecated Use {@link android.provider.Settings.Global#USE_GOOGLE_MAIL} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003746 */
3747 @Deprecated
Christopher Tate06efb532012-08-24 15:29:27 -07003748 public static final String USE_GOOGLE_MAIL = Global.USE_GOOGLE_MAIL;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003749
Dianne Hackborn4a51c202009-08-21 15:14:02 -07003750 /**
3751 * @deprecated Use
Christopher Tate06efb532012-08-24 15:29:27 -07003752 * {@link android.provider.Settings.Global#WIFI_MAX_DHCP_RETRY_COUNT} instead
Dianne Hackborn4a51c202009-08-21 15:14:02 -07003753 */
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003754 @Deprecated
Christopher Tate06efb532012-08-24 15:29:27 -07003755 public static final String WIFI_MAX_DHCP_RETRY_COUNT = Global.WIFI_MAX_DHCP_RETRY_COUNT;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003756
Dianne Hackborn4a51c202009-08-21 15:14:02 -07003757 /**
3758 * @deprecated Use
Christopher Tate06efb532012-08-24 15:29:27 -07003759 * {@link android.provider.Settings.Global#WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS} instead
Dianne Hackborn4a51c202009-08-21 15:14:02 -07003760 */
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003761 @Deprecated
3762 public static final String WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS =
Christopher Tate06efb532012-08-24 15:29:27 -07003763 Global.WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003764
3765 /**
3766 * @deprecated Use
Christopher Tate06efb532012-08-24 15:29:27 -07003767 * {@link android.provider.Settings.Global#WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003768 */
3769 @Deprecated
3770 public static final String WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON =
Christopher Tate06efb532012-08-24 15:29:27 -07003771 Global.WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003772
3773 /**
3774 * @deprecated Use
Christopher Tate06efb532012-08-24 15:29:27 -07003775 * {@link android.provider.Settings.Global#WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003776 */
3777 @Deprecated
3778 public static final String WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY =
Christopher Tate06efb532012-08-24 15:29:27 -07003779 Global.WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07003780
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003781 /**
Christopher Tate06efb532012-08-24 15:29:27 -07003782 * @deprecated Use {@link android.provider.Settings.Global#WIFI_NUM_OPEN_NETWORKS_KEPT}
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003783 * instead
3784 */
3785 @Deprecated
Christopher Tate06efb532012-08-24 15:29:27 -07003786 public static final String WIFI_NUM_OPEN_NETWORKS_KEPT = Global.WIFI_NUM_OPEN_NETWORKS_KEPT;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003787
3788 /**
Christopher Tate06efb532012-08-24 15:29:27 -07003789 * @deprecated Use {@link android.provider.Settings.Global#WIFI_ON} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003790 */
3791 @Deprecated
Christopher Tate06efb532012-08-24 15:29:27 -07003792 public static final String WIFI_ON = Global.WIFI_ON;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003793
3794 /**
3795 * @deprecated Use
3796 * {@link android.provider.Settings.Secure#WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE}
3797 * instead
3798 */
3799 @Deprecated
3800 public static final String WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE =
3801 Secure.WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE;
3802
3803 /**
3804 * @deprecated Use {@link android.provider.Settings.Secure#WIFI_WATCHDOG_AP_COUNT} instead
3805 */
3806 @Deprecated
3807 public static final String WIFI_WATCHDOG_AP_COUNT = Secure.WIFI_WATCHDOG_AP_COUNT;
3808
3809 /**
3810 * @deprecated Use
3811 * {@link android.provider.Settings.Secure#WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS} instead
3812 */
3813 @Deprecated
3814 public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS =
3815 Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07003816
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003817 /**
3818 * @deprecated Use
3819 * {@link android.provider.Settings.Secure#WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED} instead
3820 */
3821 @Deprecated
3822 public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED =
3823 Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED;
3824
3825 /**
3826 * @deprecated Use
3827 * {@link android.provider.Settings.Secure#WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS}
3828 * instead
3829 */
3830 @Deprecated
3831 public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS =
3832 Secure.WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS;
3833
3834 /**
3835 * @deprecated Use
3836 * {@link android.provider.Settings.Secure#WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT} instead
3837 */
3838 @Deprecated
3839 public static final String WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT =
3840 Secure.WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT;
3841
3842 /**
3843 * @deprecated Use {@link android.provider.Settings.Secure#WIFI_WATCHDOG_MAX_AP_CHECKS}
3844 * instead
3845 */
3846 @Deprecated
3847 public static final String WIFI_WATCHDOG_MAX_AP_CHECKS = Secure.WIFI_WATCHDOG_MAX_AP_CHECKS;
3848
3849 /**
Christopher Tate06efb532012-08-24 15:29:27 -07003850 * @deprecated Use {@link android.provider.Settings.Global#WIFI_WATCHDOG_ON} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003851 */
3852 @Deprecated
Christopher Tate06efb532012-08-24 15:29:27 -07003853 public static final String WIFI_WATCHDOG_ON = Global.WIFI_WATCHDOG_ON;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003854
3855 /**
3856 * @deprecated Use {@link android.provider.Settings.Secure#WIFI_WATCHDOG_PING_COUNT} instead
3857 */
3858 @Deprecated
3859 public static final String WIFI_WATCHDOG_PING_COUNT = Secure.WIFI_WATCHDOG_PING_COUNT;
3860
3861 /**
3862 * @deprecated Use {@link android.provider.Settings.Secure#WIFI_WATCHDOG_PING_DELAY_MS}
3863 * instead
3864 */
3865 @Deprecated
3866 public static final String WIFI_WATCHDOG_PING_DELAY_MS = Secure.WIFI_WATCHDOG_PING_DELAY_MS;
3867
3868 /**
3869 * @deprecated Use {@link android.provider.Settings.Secure#WIFI_WATCHDOG_PING_TIMEOUT_MS}
3870 * instead
3871 */
3872 @Deprecated
3873 public static final String WIFI_WATCHDOG_PING_TIMEOUT_MS =
3874 Secure.WIFI_WATCHDOG_PING_TIMEOUT_MS;
Billy Lau6ad2d662015-07-18 00:26:58 +01003875
3876 /**
3877 * An app can use this method to check if it is currently allowed to write or modify system
3878 * settings. In order to gain write access to the system settings, an app must declare the
3879 * {@link android.Manifest.permission#WRITE_SETTINGS} permission in its manifest. If it is
3880 * currently disallowed, it can prompt the user to grant it this capability through a
3881 * management UI by sending an Intent with action
3882 * {@link android.provider.Settings#ACTION_MANAGE_WRITE_SETTINGS}.
3883 *
3884 * @param context A context
3885 * @return true if the calling app can write to system settings, false otherwise
3886 */
3887 public static boolean canWrite(Context context) {
3888 int uid = Binder.getCallingUid();
3889 return isCallingPackageAllowedToWriteSettings(context, uid, getPackageNameForUid(
3890 context, uid), false);
3891 }
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003892 }
3893
3894 /**
3895 * Secure system settings, containing system preferences that applications
3896 * can read but are not allowed to write. These are for preferences that
3897 * the user must explicitly modify through the system UI or specialized
3898 * APIs for those values, not modified directly by applications.
3899 */
3900 public static final class Secure extends NameValueTable {
3901 public static final String SYS_PROP_SETTING_VERSION = "sys.settings_secure_version";
3902
Dianne Hackborn139748f2012-09-24 11:36:57 -07003903 /**
3904 * The content:// style URL for this table
3905 */
3906 public static final Uri CONTENT_URI =
3907 Uri.parse("content://" + AUTHORITY + "/secure");
3908
Brad Fitzpatrick1877d012010-03-04 17:48:13 -08003909 // Populated lazily, guarded by class object:
Dianne Hackborn139748f2012-09-24 11:36:57 -07003910 private static final NameValueCache sNameValueCache = new NameValueCache(
3911 SYS_PROP_SETTING_VERSION,
3912 CONTENT_URI,
3913 CALL_METHOD_GET_SECURE,
3914 CALL_METHOD_PUT_SECURE);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08003915
Amith Yamasani52c489c2012-03-28 11:42:42 -07003916 private static ILockSettings sLockSettings = null;
3917
Amith Yamasani7ab8c4a2012-04-06 09:27:12 -07003918 private static boolean sIsSystemProcess;
Amith Yamasani52c489c2012-03-28 11:42:42 -07003919 private static final HashSet<String> MOVED_TO_LOCK_SETTINGS;
Christopher Tate06efb532012-08-24 15:29:27 -07003920 private static final HashSet<String> MOVED_TO_GLOBAL;
Amith Yamasani52c489c2012-03-28 11:42:42 -07003921 static {
3922 MOVED_TO_LOCK_SETTINGS = new HashSet<String>(3);
3923 MOVED_TO_LOCK_SETTINGS.add(Secure.LOCK_PATTERN_ENABLED);
3924 MOVED_TO_LOCK_SETTINGS.add(Secure.LOCK_PATTERN_VISIBLE);
3925 MOVED_TO_LOCK_SETTINGS.add(Secure.LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED);
Christopher Tate06efb532012-08-24 15:29:27 -07003926
3927 MOVED_TO_GLOBAL = new HashSet<String>();
3928 MOVED_TO_GLOBAL.add(Settings.Global.ADB_ENABLED);
3929 MOVED_TO_GLOBAL.add(Settings.Global.ASSISTED_GPS_ENABLED);
3930 MOVED_TO_GLOBAL.add(Settings.Global.BLUETOOTH_ON);
Christopher Tate58f41ec2013-01-11 15:40:36 -08003931 MOVED_TO_GLOBAL.add(Settings.Global.BUGREPORT_IN_POWER_MENU);
Christopher Tate06efb532012-08-24 15:29:27 -07003932 MOVED_TO_GLOBAL.add(Settings.Global.CDMA_CELL_BROADCAST_SMS);
3933 MOVED_TO_GLOBAL.add(Settings.Global.CDMA_ROAMING_MODE);
3934 MOVED_TO_GLOBAL.add(Settings.Global.CDMA_SUBSCRIPTION_MODE);
3935 MOVED_TO_GLOBAL.add(Settings.Global.DATA_ACTIVITY_TIMEOUT_MOBILE);
3936 MOVED_TO_GLOBAL.add(Settings.Global.DATA_ACTIVITY_TIMEOUT_WIFI);
3937 MOVED_TO_GLOBAL.add(Settings.Global.DATA_ROAMING);
3938 MOVED_TO_GLOBAL.add(Settings.Global.DEVELOPMENT_SETTINGS_ENABLED);
3939 MOVED_TO_GLOBAL.add(Settings.Global.DEVICE_PROVISIONED);
Christopher Tate06efb532012-08-24 15:29:27 -07003940 MOVED_TO_GLOBAL.add(Settings.Global.DISPLAY_SIZE_FORCED);
3941 MOVED_TO_GLOBAL.add(Settings.Global.DOWNLOAD_MAX_BYTES_OVER_MOBILE);
3942 MOVED_TO_GLOBAL.add(Settings.Global.DOWNLOAD_RECOMMENDED_MAX_BYTES_OVER_MOBILE);
Christopher Tate06efb532012-08-24 15:29:27 -07003943 MOVED_TO_GLOBAL.add(Settings.Global.MOBILE_DATA);
3944 MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_DEV_BUCKET_DURATION);
3945 MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_DEV_DELETE_AGE);
3946 MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_DEV_PERSIST_BYTES);
3947 MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_DEV_ROTATE_AGE);
3948 MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_ENABLED);
3949 MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_GLOBAL_ALERT_BYTES);
3950 MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_POLL_INTERVAL);
Christopher Tate06efb532012-08-24 15:29:27 -07003951 MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_SAMPLE_ENABLED);
3952 MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_TIME_CACHE_MAX_AGE);
3953 MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_UID_BUCKET_DURATION);
3954 MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_UID_DELETE_AGE);
3955 MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_UID_PERSIST_BYTES);
3956 MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_UID_ROTATE_AGE);
3957 MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_UID_TAG_BUCKET_DURATION);
3958 MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_UID_TAG_DELETE_AGE);
3959 MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_UID_TAG_PERSIST_BYTES);
3960 MOVED_TO_GLOBAL.add(Settings.Global.NETSTATS_UID_TAG_ROTATE_AGE);
3961 MOVED_TO_GLOBAL.add(Settings.Global.NETWORK_PREFERENCE);
3962 MOVED_TO_GLOBAL.add(Settings.Global.NITZ_UPDATE_DIFF);
3963 MOVED_TO_GLOBAL.add(Settings.Global.NITZ_UPDATE_SPACING);
3964 MOVED_TO_GLOBAL.add(Settings.Global.NTP_SERVER);
3965 MOVED_TO_GLOBAL.add(Settings.Global.NTP_TIMEOUT);
3966 MOVED_TO_GLOBAL.add(Settings.Global.PDP_WATCHDOG_ERROR_POLL_COUNT);
3967 MOVED_TO_GLOBAL.add(Settings.Global.PDP_WATCHDOG_LONG_POLL_INTERVAL_MS);
3968 MOVED_TO_GLOBAL.add(Settings.Global.PDP_WATCHDOG_MAX_PDP_RESET_FAIL_COUNT);
3969 MOVED_TO_GLOBAL.add(Settings.Global.PDP_WATCHDOG_POLL_INTERVAL_MS);
3970 MOVED_TO_GLOBAL.add(Settings.Global.PDP_WATCHDOG_TRIGGER_PACKET_COUNT);
3971 MOVED_TO_GLOBAL.add(Settings.Global.SAMPLING_PROFILER_MS);
3972 MOVED_TO_GLOBAL.add(Settings.Global.SETUP_PREPAID_DATA_SERVICE_URL);
3973 MOVED_TO_GLOBAL.add(Settings.Global.SETUP_PREPAID_DETECTION_REDIR_HOST);
3974 MOVED_TO_GLOBAL.add(Settings.Global.SETUP_PREPAID_DETECTION_TARGET_URL);
3975 MOVED_TO_GLOBAL.add(Settings.Global.TETHER_DUN_APN);
3976 MOVED_TO_GLOBAL.add(Settings.Global.TETHER_DUN_REQUIRED);
3977 MOVED_TO_GLOBAL.add(Settings.Global.TETHER_SUPPORTED);
Christopher Tate06efb532012-08-24 15:29:27 -07003978 MOVED_TO_GLOBAL.add(Settings.Global.USB_MASS_STORAGE_ENABLED);
3979 MOVED_TO_GLOBAL.add(Settings.Global.USE_GOOGLE_MAIL);
Robert Greenwalt3ea0c992013-10-03 21:13:49 +00003980 MOVED_TO_GLOBAL.add(Settings.Global.WIFI_COUNTRY_CODE);
Christopher Tate06efb532012-08-24 15:29:27 -07003981 MOVED_TO_GLOBAL.add(Settings.Global.WIFI_FRAMEWORK_SCAN_INTERVAL_MS);
3982 MOVED_TO_GLOBAL.add(Settings.Global.WIFI_FREQUENCY_BAND);
3983 MOVED_TO_GLOBAL.add(Settings.Global.WIFI_IDLE_MS);
3984 MOVED_TO_GLOBAL.add(Settings.Global.WIFI_MAX_DHCP_RETRY_COUNT);
3985 MOVED_TO_GLOBAL.add(Settings.Global.WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS);
3986 MOVED_TO_GLOBAL.add(Settings.Global.WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON);
3987 MOVED_TO_GLOBAL.add(Settings.Global.WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY);
3988 MOVED_TO_GLOBAL.add(Settings.Global.WIFI_NUM_OPEN_NETWORKS_KEPT);
3989 MOVED_TO_GLOBAL.add(Settings.Global.WIFI_ON);
3990 MOVED_TO_GLOBAL.add(Settings.Global.WIFI_P2P_DEVICE_NAME);
3991 MOVED_TO_GLOBAL.add(Settings.Global.WIFI_SAVED_STATE);
3992 MOVED_TO_GLOBAL.add(Settings.Global.WIFI_SUPPLICANT_SCAN_INTERVAL_MS);
3993 MOVED_TO_GLOBAL.add(Settings.Global.WIFI_SUSPEND_OPTIMIZATIONS_ENABLED);
vandwalle7c3606c2014-03-31 19:12:07 -07003994 MOVED_TO_GLOBAL.add(Settings.Global.WIFI_ENHANCED_AUTO_JOIN);
3995 MOVED_TO_GLOBAL.add(Settings.Global.WIFI_NETWORK_SHOW_RSSI);
Christopher Tate06efb532012-08-24 15:29:27 -07003996 MOVED_TO_GLOBAL.add(Settings.Global.WIFI_WATCHDOG_ON);
3997 MOVED_TO_GLOBAL.add(Settings.Global.WIFI_WATCHDOG_POOR_NETWORK_TEST_ENABLED);
Christopher Tate06efb532012-08-24 15:29:27 -07003998 MOVED_TO_GLOBAL.add(Settings.Global.WIMAX_NETWORKS_AVAILABLE_NOTIFICATION_ON);
Christopher Tatec868b642012-09-12 17:41:04 -07003999 MOVED_TO_GLOBAL.add(Settings.Global.PACKAGE_VERIFIER_ENABLE);
4000 MOVED_TO_GLOBAL.add(Settings.Global.PACKAGE_VERIFIER_TIMEOUT);
4001 MOVED_TO_GLOBAL.add(Settings.Global.PACKAGE_VERIFIER_DEFAULT_RESPONSE);
4002 MOVED_TO_GLOBAL.add(Settings.Global.DATA_STALL_ALARM_NON_AGGRESSIVE_DELAY_IN_MS);
4003 MOVED_TO_GLOBAL.add(Settings.Global.DATA_STALL_ALARM_AGGRESSIVE_DELAY_IN_MS);
4004 MOVED_TO_GLOBAL.add(Settings.Global.GPRS_REGISTER_CHECK_PERIOD_MS);
Christopher Tate06efb532012-08-24 15:29:27 -07004005 MOVED_TO_GLOBAL.add(Settings.Global.WTF_IS_FATAL);
Jeff Sharkey625239a2012-09-26 22:03:49 -07004006 MOVED_TO_GLOBAL.add(Settings.Global.BATTERY_DISCHARGE_DURATION_THRESHOLD);
4007 MOVED_TO_GLOBAL.add(Settings.Global.BATTERY_DISCHARGE_THRESHOLD);
4008 MOVED_TO_GLOBAL.add(Settings.Global.SEND_ACTION_APP_ERROR);
4009 MOVED_TO_GLOBAL.add(Settings.Global.DROPBOX_AGE_SECONDS);
4010 MOVED_TO_GLOBAL.add(Settings.Global.DROPBOX_MAX_FILES);
4011 MOVED_TO_GLOBAL.add(Settings.Global.DROPBOX_QUOTA_KB);
4012 MOVED_TO_GLOBAL.add(Settings.Global.DROPBOX_QUOTA_PERCENT);
4013 MOVED_TO_GLOBAL.add(Settings.Global.DROPBOX_RESERVE_PERCENT);
4014 MOVED_TO_GLOBAL.add(Settings.Global.DROPBOX_TAG_PREFIX);
4015 MOVED_TO_GLOBAL.add(Settings.Global.ERROR_LOGCAT_PREFIX);
4016 MOVED_TO_GLOBAL.add(Settings.Global.SYS_FREE_STORAGE_LOG_INTERVAL);
4017 MOVED_TO_GLOBAL.add(Settings.Global.DISK_FREE_CHANGE_REPORTING_THRESHOLD);
4018 MOVED_TO_GLOBAL.add(Settings.Global.SYS_STORAGE_THRESHOLD_PERCENTAGE);
4019 MOVED_TO_GLOBAL.add(Settings.Global.SYS_STORAGE_THRESHOLD_MAX_BYTES);
4020 MOVED_TO_GLOBAL.add(Settings.Global.SYS_STORAGE_FULL_THRESHOLD_BYTES);
4021 MOVED_TO_GLOBAL.add(Settings.Global.SYNC_MAX_RETRY_DELAY_IN_SECONDS);
4022 MOVED_TO_GLOBAL.add(Settings.Global.CONNECTIVITY_CHANGE_DELAY);
4023 MOVED_TO_GLOBAL.add(Settings.Global.CAPTIVE_PORTAL_DETECTION_ENABLED);
4024 MOVED_TO_GLOBAL.add(Settings.Global.CAPTIVE_PORTAL_SERVER);
4025 MOVED_TO_GLOBAL.add(Settings.Global.NSD_ON);
4026 MOVED_TO_GLOBAL.add(Settings.Global.SET_INSTALL_LOCATION);
4027 MOVED_TO_GLOBAL.add(Settings.Global.DEFAULT_INSTALL_LOCATION);
4028 MOVED_TO_GLOBAL.add(Settings.Global.INET_CONDITION_DEBOUNCE_UP_DELAY);
4029 MOVED_TO_GLOBAL.add(Settings.Global.INET_CONDITION_DEBOUNCE_DOWN_DELAY);
4030 MOVED_TO_GLOBAL.add(Settings.Global.READ_EXTERNAL_STORAGE_ENFORCED_DEFAULT);
4031 MOVED_TO_GLOBAL.add(Settings.Global.HTTP_PROXY);
4032 MOVED_TO_GLOBAL.add(Settings.Global.GLOBAL_HTTP_PROXY_HOST);
4033 MOVED_TO_GLOBAL.add(Settings.Global.GLOBAL_HTTP_PROXY_PORT);
4034 MOVED_TO_GLOBAL.add(Settings.Global.GLOBAL_HTTP_PROXY_EXCLUSION_LIST);
4035 MOVED_TO_GLOBAL.add(Settings.Global.SET_GLOBAL_HTTP_PROXY);
4036 MOVED_TO_GLOBAL.add(Settings.Global.DEFAULT_DNS_SERVER);
Jeff Sharkey6e2bee72012-10-01 13:39:08 -07004037 MOVED_TO_GLOBAL.add(Settings.Global.PREFERRED_NETWORK_MODE);
Hui Shu22671772014-10-01 21:41:07 +00004038 MOVED_TO_GLOBAL.add(Settings.Global.WEBVIEW_DATA_REDUCTION_PROXY_KEY);
Christopher Tate06efb532012-08-24 15:29:27 -07004039 }
4040
Christopher Tate66488d62012-10-02 11:58:01 -07004041 /** @hide */
Svetoslav683914b2015-01-15 14:22:26 -08004042 public static void getMovedToGlobalSettings(Set<String> outKeySet) {
Christopher Tate66488d62012-10-02 11:58:01 -07004043 outKeySet.addAll(MOVED_TO_GLOBAL);
4044 }
4045
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004046 /**
4047 * Look up a name in the database.
4048 * @param resolver to access the database with
4049 * @param name to look up in the table
4050 * @return the corresponding value, or null if not present
4051 */
Dianne Hackborn139748f2012-09-24 11:36:57 -07004052 public static String getString(ContentResolver resolver, String name) {
Christopher Tate06efb532012-08-24 15:29:27 -07004053 return getStringForUser(resolver, name, UserHandle.myUserId());
4054 }
4055
4056 /** @hide */
Dianne Hackborn139748f2012-09-24 11:36:57 -07004057 public static String getStringForUser(ContentResolver resolver, String name,
Christopher Tate06efb532012-08-24 15:29:27 -07004058 int userHandle) {
4059 if (MOVED_TO_GLOBAL.contains(name)) {
4060 Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.Secure"
4061 + " to android.provider.Settings.Global.");
4062 return Global.getStringForUser(resolver, name, userHandle);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004063 }
Amith Yamasani52c489c2012-03-28 11:42:42 -07004064
Dianne Hackborn139748f2012-09-24 11:36:57 -07004065 if (MOVED_TO_LOCK_SETTINGS.contains(name)) {
4066 synchronized (Secure.class) {
4067 if (sLockSettings == null) {
4068 sLockSettings = ILockSettings.Stub.asInterface(
4069 (IBinder) ServiceManager.getService("lock_settings"));
4070 sIsSystemProcess = Process.myUid() == Process.SYSTEM_UID;
4071 }
4072 }
4073 if (sLockSettings != null && !sIsSystemProcess) {
Adrian Roos7811d9f2015-07-27 15:10:13 -07004074 // No context; use the ActivityThread's context as an approximation for
4075 // determining the target API level.
4076 Application application = ActivityThread.currentApplication();
4077
4078 boolean isPreMnc = application != null
4079 && application.getApplicationInfo() != null
4080 && application.getApplicationInfo().targetSdkVersion
4081 <= VERSION_CODES.LOLLIPOP_MR1;
4082 if (isPreMnc) {
4083 try {
4084 return sLockSettings.getString(name, "0", userHandle);
4085 } catch (RemoteException re) {
4086 // Fall through
4087 }
4088 } else {
4089 throw new SecurityException("Settings.Secure." + name
4090 + " is deprecated and no longer accessible."
4091 + " See API documentation for potential replacements.");
Dianne Hackborn139748f2012-09-24 11:36:57 -07004092 }
Amith Yamasani52c489c2012-03-28 11:42:42 -07004093 }
4094 }
4095
Christopher Tate06efb532012-08-24 15:29:27 -07004096 return sNameValueCache.getStringForUser(resolver, name, userHandle);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004097 }
4098
4099 /**
4100 * Store a name/value pair into the database.
4101 * @param resolver to access the database with
4102 * @param name to store
4103 * @param value to associate with the name
4104 * @return true if the value was set, false on database errors
4105 */
Christopher Tate06efb532012-08-24 15:29:27 -07004106 public static boolean putString(ContentResolver resolver, String name, String value) {
4107 return putStringForUser(resolver, name, value, UserHandle.myUserId());
4108 }
4109
4110 /** @hide */
4111 public static boolean putStringForUser(ContentResolver resolver, String name, String value,
4112 int userHandle) {
Julia Reynolds82735bc2014-09-04 16:43:30 -04004113 if (LOCATION_MODE.equals(name)) {
4114 // HACK ALERT: temporary hack to work around b/10491283.
4115 // TODO: once b/10491283 fixed, remove this hack
4116 return setLocationModeForUser(resolver, Integer.parseInt(value), userHandle);
4117 }
Christopher Tate06efb532012-08-24 15:29:27 -07004118 if (MOVED_TO_GLOBAL.contains(name)) {
4119 Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.System"
4120 + " to android.provider.Settings.Global");
4121 return Global.putStringForUser(resolver, name, value, userHandle);
4122 }
Christopher Tate06efb532012-08-24 15:29:27 -07004123 return sNameValueCache.putStringForUser(resolver, name, value, userHandle);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004124 }
4125
4126 /**
4127 * Construct the content URI for a particular name/value pair,
4128 * useful for monitoring changes with a ContentObserver.
4129 * @param name to look up in the table
4130 * @return the corresponding content URI, or null if not present
4131 */
4132 public static Uri getUriFor(String name) {
Christopher Tate06efb532012-08-24 15:29:27 -07004133 if (MOVED_TO_GLOBAL.contains(name)) {
4134 Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.Secure"
4135 + " to android.provider.Settings.Global, returning global URI.");
4136 return Global.getUriFor(Global.CONTENT_URI, name);
4137 }
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004138 return getUriFor(CONTENT_URI, name);
4139 }
4140
4141 /**
4142 * Convenience function for retrieving a single secure settings value
4143 * as an integer. Note that internally setting values are always
4144 * stored as strings; this function converts the string to an integer
4145 * for you. The default value will be returned if the setting is
4146 * not defined or not an integer.
4147 *
4148 * @param cr The ContentResolver to access.
4149 * @param name The name of the setting to retrieve.
4150 * @param def Value to return if the setting is not defined.
4151 *
4152 * @return The setting's current value, or 'def' if it is not defined
4153 * or not a valid integer.
4154 */
4155 public static int getInt(ContentResolver cr, String name, int def) {
Christopher Tate06efb532012-08-24 15:29:27 -07004156 return getIntForUser(cr, name, def, UserHandle.myUserId());
4157 }
4158
4159 /** @hide */
4160 public static int getIntForUser(ContentResolver cr, String name, int def, int userHandle) {
Tom O'Neill7f6f4572013-08-27 10:53:15 -07004161 if (LOCATION_MODE.equals(name)) {
4162 // HACK ALERT: temporary hack to work around b/10491283.
4163 // TODO: once b/10491283 fixed, remove this hack
4164 return getLocationModeForUser(cr, userHandle);
4165 }
Christopher Tate06efb532012-08-24 15:29:27 -07004166 String v = getStringForUser(cr, name, userHandle);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004167 try {
4168 return v != null ? Integer.parseInt(v) : def;
4169 } catch (NumberFormatException e) {
4170 return def;
4171 }
4172 }
4173
4174 /**
4175 * Convenience function for retrieving a single secure settings value
4176 * as an integer. Note that internally setting values are always
4177 * stored as strings; this function converts the string to an integer
4178 * for you.
4179 * <p>
4180 * This version does not take a default value. If the setting has not
4181 * been set, or the string value is not a number,
4182 * it throws {@link SettingNotFoundException}.
4183 *
4184 * @param cr The ContentResolver to access.
4185 * @param name The name of the setting to retrieve.
4186 *
4187 * @throws SettingNotFoundException Thrown if a setting by the given
4188 * name can't be found or the setting value is not an integer.
4189 *
4190 * @return The setting's current value.
4191 */
4192 public static int getInt(ContentResolver cr, String name)
4193 throws SettingNotFoundException {
Christopher Tate06efb532012-08-24 15:29:27 -07004194 return getIntForUser(cr, name, UserHandle.myUserId());
4195 }
4196
4197 /** @hide */
4198 public static int getIntForUser(ContentResolver cr, String name, int userHandle)
4199 throws SettingNotFoundException {
Tom O'Neill7f6f4572013-08-27 10:53:15 -07004200 if (LOCATION_MODE.equals(name)) {
4201 // HACK ALERT: temporary hack to work around b/10491283.
4202 // TODO: once b/10491283 fixed, remove this hack
4203 return getLocationModeForUser(cr, userHandle);
4204 }
Christopher Tate06efb532012-08-24 15:29:27 -07004205 String v = getStringForUser(cr, name, userHandle);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004206 try {
4207 return Integer.parseInt(v);
4208 } catch (NumberFormatException e) {
4209 throw new SettingNotFoundException(name);
4210 }
4211 }
4212
4213 /**
4214 * Convenience function for updating a single settings value as an
4215 * integer. This will either create a new entry in the table if the
4216 * given name does not exist, or modify the value of the existing row
4217 * with that name. Note that internally setting values are always
4218 * stored as strings, so this function converts the given value to a
4219 * string before storing it.
4220 *
4221 * @param cr The ContentResolver to access.
4222 * @param name The name of the setting to modify.
4223 * @param value The new value for the setting.
4224 * @return true if the value was set, false on database errors
4225 */
4226 public static boolean putInt(ContentResolver cr, String name, int value) {
Christopher Tate06efb532012-08-24 15:29:27 -07004227 return putIntForUser(cr, name, value, UserHandle.myUserId());
4228 }
4229
4230 /** @hide */
4231 public static boolean putIntForUser(ContentResolver cr, String name, int value,
4232 int userHandle) {
4233 return putStringForUser(cr, name, Integer.toString(value), userHandle);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004234 }
4235
4236 /**
4237 * Convenience function for retrieving a single secure settings value
4238 * as a {@code long}. Note that internally setting values are always
4239 * stored as strings; this function converts the string to a {@code long}
4240 * for you. The default value will be returned if the setting is
4241 * not defined or not a {@code long}.
4242 *
4243 * @param cr The ContentResolver to access.
4244 * @param name The name of the setting to retrieve.
4245 * @param def Value to return if the setting is not defined.
4246 *
4247 * @return The setting's current value, or 'def' if it is not defined
4248 * or not a valid {@code long}.
4249 */
4250 public static long getLong(ContentResolver cr, String name, long def) {
Christopher Tate06efb532012-08-24 15:29:27 -07004251 return getLongForUser(cr, name, def, UserHandle.myUserId());
4252 }
4253
4254 /** @hide */
4255 public static long getLongForUser(ContentResolver cr, String name, long def,
4256 int userHandle) {
4257 String valString = getStringForUser(cr, name, userHandle);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004258 long value;
4259 try {
4260 value = valString != null ? Long.parseLong(valString) : def;
4261 } catch (NumberFormatException e) {
4262 value = def;
4263 }
4264 return value;
4265 }
4266
4267 /**
4268 * Convenience function for retrieving a single secure settings value
4269 * as a {@code long}. Note that internally setting values are always
4270 * stored as strings; this function converts the string to a {@code long}
4271 * for you.
4272 * <p>
4273 * This version does not take a default value. If the setting has not
4274 * been set, or the string value is not a number,
4275 * it throws {@link SettingNotFoundException}.
4276 *
4277 * @param cr The ContentResolver to access.
4278 * @param name The name of the setting to retrieve.
4279 *
4280 * @return The setting's current value.
4281 * @throws SettingNotFoundException Thrown if a setting by the given
4282 * name can't be found or the setting value is not an integer.
4283 */
4284 public static long getLong(ContentResolver cr, String name)
4285 throws SettingNotFoundException {
Christopher Tate06efb532012-08-24 15:29:27 -07004286 return getLongForUser(cr, name, UserHandle.myUserId());
4287 }
4288
4289 /** @hide */
4290 public static long getLongForUser(ContentResolver cr, String name, int userHandle)
4291 throws SettingNotFoundException {
4292 String valString = getStringForUser(cr, name, userHandle);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004293 try {
4294 return Long.parseLong(valString);
4295 } catch (NumberFormatException e) {
4296 throw new SettingNotFoundException(name);
4297 }
4298 }
4299
4300 /**
4301 * Convenience function for updating a secure settings value as a long
4302 * integer. This will either create a new entry in the table if the
4303 * given name does not exist, or modify the value of the existing row
4304 * with that name. Note that internally setting values are always
4305 * stored as strings, so this function converts the given value to a
4306 * string before storing it.
4307 *
4308 * @param cr The ContentResolver to access.
4309 * @param name The name of the setting to modify.
4310 * @param value The new value for the setting.
4311 * @return true if the value was set, false on database errors
4312 */
4313 public static boolean putLong(ContentResolver cr, String name, long value) {
Christopher Tate06efb532012-08-24 15:29:27 -07004314 return putLongForUser(cr, name, value, UserHandle.myUserId());
4315 }
4316
4317 /** @hide */
4318 public static boolean putLongForUser(ContentResolver cr, String name, long value,
4319 int userHandle) {
4320 return putStringForUser(cr, name, Long.toString(value), userHandle);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004321 }
4322
4323 /**
4324 * Convenience function for retrieving a single secure settings value
4325 * as a floating point number. Note that internally setting values are
4326 * always stored as strings; this function converts the string to an
4327 * float for you. The default value will be returned if the setting
4328 * is not defined or not a valid float.
4329 *
4330 * @param cr The ContentResolver to access.
4331 * @param name The name of the setting to retrieve.
4332 * @param def Value to return if the setting is not defined.
4333 *
4334 * @return The setting's current value, or 'def' if it is not defined
4335 * or not a valid float.
4336 */
4337 public static float getFloat(ContentResolver cr, String name, float def) {
Christopher Tate06efb532012-08-24 15:29:27 -07004338 return getFloatForUser(cr, name, def, UserHandle.myUserId());
4339 }
4340
4341 /** @hide */
4342 public static float getFloatForUser(ContentResolver cr, String name, float def,
4343 int userHandle) {
4344 String v = getStringForUser(cr, name, userHandle);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004345 try {
4346 return v != null ? Float.parseFloat(v) : def;
4347 } catch (NumberFormatException e) {
4348 return def;
4349 }
4350 }
4351
4352 /**
4353 * Convenience function for retrieving a single secure settings value
4354 * as a float. Note that internally setting values are always
4355 * stored as strings; this function converts the string to a float
4356 * for you.
4357 * <p>
4358 * This version does not take a default value. If the setting has not
4359 * been set, or the string value is not a number,
4360 * it throws {@link SettingNotFoundException}.
4361 *
4362 * @param cr The ContentResolver to access.
4363 * @param name The name of the setting to retrieve.
4364 *
4365 * @throws SettingNotFoundException Thrown if a setting by the given
4366 * name can't be found or the setting value is not a float.
4367 *
4368 * @return The setting's current value.
4369 */
4370 public static float getFloat(ContentResolver cr, String name)
4371 throws SettingNotFoundException {
Christopher Tate06efb532012-08-24 15:29:27 -07004372 return getFloatForUser(cr, name, UserHandle.myUserId());
4373 }
4374
4375 /** @hide */
4376 public static float getFloatForUser(ContentResolver cr, String name, int userHandle)
4377 throws SettingNotFoundException {
4378 String v = getStringForUser(cr, name, userHandle);
Brian Muramatsue1d46982010-12-06 17:34:20 -08004379 if (v == null) {
4380 throw new SettingNotFoundException(name);
4381 }
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004382 try {
4383 return Float.parseFloat(v);
4384 } catch (NumberFormatException e) {
4385 throw new SettingNotFoundException(name);
4386 }
4387 }
4388
4389 /**
4390 * Convenience function for updating a single settings value as a
4391 * floating point number. This will either create a new entry in the
4392 * table if the given name does not exist, or modify the value of the
4393 * existing row with that name. Note that internally setting values
4394 * are always stored as strings, so this function converts the given
4395 * value to a string before storing it.
4396 *
4397 * @param cr The ContentResolver to access.
4398 * @param name The name of the setting to modify.
4399 * @param value The new value for the setting.
4400 * @return true if the value was set, false on database errors
4401 */
4402 public static boolean putFloat(ContentResolver cr, String name, float value) {
Christopher Tate06efb532012-08-24 15:29:27 -07004403 return putFloatForUser(cr, name, value, UserHandle.myUserId());
4404 }
4405
4406 /** @hide */
4407 public static boolean putFloatForUser(ContentResolver cr, String name, float value,
4408 int userHandle) {
4409 return putStringForUser(cr, name, Float.toString(value), userHandle);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004410 }
4411
4412 /**
Christopher Tate06efb532012-08-24 15:29:27 -07004413 * @deprecated Use {@link android.provider.Settings.Global#DEVELOPMENT_SETTINGS_ENABLED}
4414 * instead
Dianne Hackborn895f99e2012-02-02 11:49:12 -08004415 */
Christopher Tate06efb532012-08-24 15:29:27 -07004416 @Deprecated
4417 public static final String DEVELOPMENT_SETTINGS_ENABLED =
4418 Global.DEVELOPMENT_SETTINGS_ENABLED;
Dianne Hackborn895f99e2012-02-02 11:49:12 -08004419
4420 /**
Dianne Hackborn5773bfdb2012-07-13 13:24:15 -07004421 * When the user has enable the option to have a "bug report" command
4422 * in the power menu.
Christopher Tate58f41ec2013-01-11 15:40:36 -08004423 * @deprecated Use {@link android.provider.Settings.Global#BUGREPORT_IN_POWER_MENU} instead
Dianne Hackborn5773bfdb2012-07-13 13:24:15 -07004424 * @hide
4425 */
Christopher Tate58f41ec2013-01-11 15:40:36 -08004426 @Deprecated
Dianne Hackborn5773bfdb2012-07-13 13:24:15 -07004427 public static final String BUGREPORT_IN_POWER_MENU = "bugreport_in_power_menu";
4428
4429 /**
Christopher Tate06efb532012-08-24 15:29:27 -07004430 * @deprecated Use {@link android.provider.Settings.Global#ADB_ENABLED} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004431 */
Christopher Tate06efb532012-08-24 15:29:27 -07004432 @Deprecated
4433 public static final String ADB_ENABLED = Global.ADB_ENABLED;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004434
4435 /**
4436 * Setting to allow mock locations and location provider status to be injected into the
4437 * LocationManager service for testing purposes during application development. These
4438 * locations and status values override actual location and status information generated
4439 * by network, gps, or other location providers.
Svet Ganovf7e9cf42015-05-13 10:40:31 -07004440 *
4441 * @deprecated This settings is not used anymore.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004442 */
Svet Ganovf7e9cf42015-05-13 10:40:31 -07004443 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004444 public static final String ALLOW_MOCK_LOCATION = "mock_location";
4445
4446 /**
Doug Zongkerd8893db2010-01-26 12:29:44 -08004447 * A 64-bit number (as a hex string) that is randomly
Scott Main44895332013-11-12 09:23:13 -08004448 * generated when the user first sets up the device and should remain
4449 * constant for the lifetime of the user's device. The value may
4450 * change if a factory reset is performed on the device.
4451 * <p class="note"><strong>Note:</strong> When a device has <a
4452 * href="{@docRoot}about/versions/android-4.2.html#MultipleUsers">multiple users</a>
4453 * (available on certain devices running Android 4.2 or higher), each user appears as a
4454 * completely separate device, so the {@code ANDROID_ID} value is unique to each
4455 * user.</p>
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004456 */
4457 public static final String ANDROID_ID = "android_id";
4458
4459 /**
Christopher Tate06efb532012-08-24 15:29:27 -07004460 * @deprecated Use {@link android.provider.Settings.Global#BLUETOOTH_ON} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004461 */
Christopher Tate06efb532012-08-24 15:29:27 -07004462 @Deprecated
4463 public static final String BLUETOOTH_ON = Global.BLUETOOTH_ON;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004464
4465 /**
Christopher Tate06efb532012-08-24 15:29:27 -07004466 * @deprecated Use {@link android.provider.Settings.Global#DATA_ROAMING} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004467 */
Jeff Sharkeybdfce2e2012-09-26 15:54:06 -07004468 @Deprecated
Christopher Tate06efb532012-08-24 15:29:27 -07004469 public static final String DATA_ROAMING = Global.DATA_ROAMING;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004470
4471 /**
4472 * Setting to record the input method used by default, holding the ID
4473 * of the desired method.
4474 */
4475 public static final String DEFAULT_INPUT_METHOD = "default_input_method";
4476
4477 /**
satokab751aa2010-09-14 19:17:36 +09004478 * Setting to record the input method subtype used by default, holding the ID
4479 * of the desired method.
4480 */
4481 public static final String SELECTED_INPUT_METHOD_SUBTYPE =
4482 "selected_input_method_subtype";
4483
4484 /**
satok723a27e2010-11-11 14:58:11 +09004485 * Setting to record the history of input method subtype, holding the pair of ID of IME
4486 * and its last used subtype.
4487 * @hide
4488 */
4489 public static final String INPUT_METHODS_SUBTYPE_HISTORY =
4490 "input_methods_subtype_history";
4491
4492 /**
satok5c58dfc2010-12-14 21:54:47 +09004493 * Setting to record the visibility of input method selector
4494 */
4495 public static final String INPUT_METHOD_SELECTOR_VISIBILITY =
4496 "input_method_selector_visibility";
4497
4498 /**
Dianne Hackborn91097de2014-04-04 18:02:06 -07004499 * The currently selected voice interaction service flattened ComponentName.
4500 * @hide
4501 */
Jeff Sharkeya73b8fd2016-01-06 17:02:08 -07004502 @TestApi
Dianne Hackborn91097de2014-04-04 18:02:06 -07004503 public static final String VOICE_INTERACTION_SERVICE = "voice_interaction_service";
4504
4505 /**
Zhihai Xuaf5971e2013-06-10 20:28:31 -07004506 * bluetooth HCI snoop log configuration
4507 * @hide
4508 */
4509 public static final String BLUETOOTH_HCI_LOG =
4510 "bluetooth_hci_log";
4511
4512 /**
Christopher Tate06efb532012-08-24 15:29:27 -07004513 * @deprecated Use {@link android.provider.Settings.Global#DEVICE_PROVISIONED} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004514 */
Christopher Tate06efb532012-08-24 15:29:27 -07004515 @Deprecated
4516 public static final String DEVICE_PROVISIONED = Global.DEVICE_PROVISIONED;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07004517
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004518 /**
Russell Brennerde6ae442012-09-26 20:53:10 -07004519 * Whether the current user has been set up via setup wizard (0 = false, 1 = true)
4520 * @hide
4521 */
4522 public static final String USER_SETUP_COMPLETE = "user_setup_complete";
4523
4524 /**
Ido Ofird193c672016-03-01 13:27:54 -08004525 * Prefix for category name that marks whether a suggested action from that category was
4526 * completed.
4527 * @hide
4528 */
4529 public static final String COMPLETED_CATEGORY_PREFIX = "suggested.completed_category.";
4530
4531 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004532 * List of input methods that are currently enabled. This is a string
4533 * containing the IDs of all enabled input methods, each ID separated
4534 * by ':'.
4535 */
4536 public static final String ENABLED_INPUT_METHODS = "enabled_input_methods";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07004537
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004538 /**
Amith Yamasanie861ec12010-03-24 21:39:27 -07004539 * List of system input methods that are currently disabled. This is a string
4540 * containing the IDs of all disabled input methods, each ID separated
4541 * by ':'.
4542 * @hide
4543 */
4544 public static final String DISABLED_SYSTEM_INPUT_METHODS = "disabled_system_input_methods";
4545
4546 /**
Michael Wright7b5a96b2014-08-09 19:28:42 -07004547 * Whether to show the IME when a hard keyboard is connected. This is a boolean that
4548 * determines if the IME should be shown when a hard keyboard is attached.
4549 * @hide
4550 */
4551 public static final String SHOW_IME_WITH_HARD_KEYBOARD = "show_ime_with_hard_keyboard";
4552
4553 /**
Jeff Sharkey625239a2012-09-26 22:03:49 -07004554 * Host name and port for global http proxy. Uses ':' seperator for
4555 * between host and port.
4556 *
4557 * @deprecated Use {@link Global#HTTP_PROXY}
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004558 */
Jeff Sharkey625239a2012-09-26 22:03:49 -07004559 @Deprecated
4560 public static final String HTTP_PROXY = Global.HTTP_PROXY;
Robert Greenwalte90aa5e2010-09-01 11:34:05 -07004561
4562 /**
Robin Lee244ce8e2016-01-05 18:03:46 +00004563 * Package designated as always-on VPN provider.
4564 *
4565 * @hide
4566 */
4567 public static final String ALWAYS_ON_VPN_APP = "always_on_vpn_app";
4568
4569 /**
Christopher Tateaa036a22014-05-19 16:33:27 -07004570 * Whether applications can be installed for this user via the system's
4571 * {@link Intent#ACTION_INSTALL_PACKAGE} mechanism.
4572 *
4573 * <p>1 = permit app installation via the system package installer intent
4574 * <p>0 = do not allow use of the package installer
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004575 */
Christopher Tateaa036a22014-05-19 16:33:27 -07004576 public static final String INSTALL_NON_MARKET_APPS = "install_non_market_apps";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07004577
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004578 /**
Tom O'Neill923c0dc2014-03-03 11:07:55 -08004579 * Comma-separated list of location providers that activities may access. Do not rely on
4580 * this value being present in settings.db or on ContentObserver notifications on the
4581 * corresponding Uri.
Tom O'Neilla324ac72013-08-26 14:40:23 -07004582 *
Tom O'Neill923c0dc2014-03-03 11:07:55 -08004583 * @deprecated use {@link #LOCATION_MODE} and
4584 * {@link LocationManager#MODE_CHANGED_ACTION} (or
4585 * {@link LocationManager#PROVIDERS_CHANGED_ACTION})
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004586 */
Tom O'Neilla324ac72013-08-26 14:40:23 -07004587 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004588 public static final String LOCATION_PROVIDERS_ALLOWED = "location_providers_allowed";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07004589
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004590 /**
Tom O'Neill7f6f4572013-08-27 10:53:15 -07004591 * The degree of location access enabled by the user.
Tom O'Neill923c0dc2014-03-03 11:07:55 -08004592 * <p>
Tom O'Neill7f6f4572013-08-27 10:53:15 -07004593 * When used with {@link #putInt(ContentResolver, String, int)}, must be one of {@link
4594 * #LOCATION_MODE_HIGH_ACCURACY}, {@link #LOCATION_MODE_SENSORS_ONLY}, {@link
4595 * #LOCATION_MODE_BATTERY_SAVING}, or {@link #LOCATION_MODE_OFF}. When used with {@link
4596 * #getInt(ContentResolver, String)}, the caller must gracefully handle additional location
4597 * modes that might be added in the future.
Tom O'Neill923c0dc2014-03-03 11:07:55 -08004598 * <p>
4599 * Note: do not rely on this value being present in settings.db or on ContentObserver
4600 * notifications for the corresponding Uri. Use {@link LocationManager#MODE_CHANGED_ACTION}
4601 * to receive changes in this value.
Tom O'Neilla324ac72013-08-26 14:40:23 -07004602 */
4603 public static final String LOCATION_MODE = "location_mode";
Lifu Tangd1fa1d62015-11-25 21:42:44 -08004604 /**
4605 * Stores the previous location mode when {@link #LOCATION_MODE} is set to
4606 * {@link #LOCATION_MODE_OFF}
4607 * @hide
4608 */
4609 public static final String LOCATION_PREVIOUS_MODE = "location_previous_mode";
Tom O'Neilla324ac72013-08-26 14:40:23 -07004610
4611 /**
Lifu Tangd1fa1d62015-11-25 21:42:44 -08004612 * Sets all location providers to the previous states before location was turned off.
4613 * @hide
4614 */
4615 public static final int LOCATION_MODE_PREVIOUS = -1;
4616 /**
Tom O'Neill7f6f4572013-08-27 10:53:15 -07004617 * Location access disabled.
Tom O'Neill1f48b782013-08-19 18:14:56 -07004618 */
4619 public static final int LOCATION_MODE_OFF = 0;
4620 /**
4621 * Network Location Provider disabled, but GPS and other sensors enabled.
4622 */
4623 public static final int LOCATION_MODE_SENSORS_ONLY = 1;
4624 /**
Tom O'Neilld5759432013-09-11 11:03:03 -07004625 * Reduced power usage, such as limiting the number of GPS updates per hour. Requests
4626 * with {@link android.location.Criteria#POWER_HIGH} may be downgraded to
4627 * {@link android.location.Criteria#POWER_MEDIUM}.
Tom O'Neill1f48b782013-08-19 18:14:56 -07004628 */
4629 public static final int LOCATION_MODE_BATTERY_SAVING = 2;
4630 /**
4631 * Best-effort location computation allowed.
4632 */
4633 public static final int LOCATION_MODE_HIGH_ACCURACY = 3;
4634
4635 /**
Danielle Millett925a7d82012-03-19 18:02:20 -04004636 * A flag containing settings used for biometric weak
4637 * @hide
4638 */
Adrian Roos230635e2015-01-07 20:50:29 +01004639 @Deprecated
Danielle Millett925a7d82012-03-19 18:02:20 -04004640 public static final String LOCK_BIOMETRIC_WEAK_FLAGS =
4641 "lock_biometric_weak_flags";
4642
4643 /**
Jason Monk94cfd9d2014-10-31 13:18:21 -04004644 * Whether lock-to-app will lock the keyguard when exiting.
4645 * @hide
4646 */
4647 public static final String LOCK_TO_APP_EXIT_LOCKED = "lock_to_app_exit_locked";
4648
4649 /**
Amith Yamasani156c4352010-03-05 17:10:03 -08004650 * Whether autolock is enabled (0 = false, 1 = true)
Adrian Roos9dd16eb2015-01-08 16:20:49 +01004651 *
4652 * @deprecated Use {@link android.app.KeyguardManager} to determine the state and security
Adrian Roos7811d9f2015-07-27 15:10:13 -07004653 * level of the keyguard. Accessing this setting from an app that is targeting
Deepanshu Guptae836a222015-07-31 12:11:07 -07004654 * {@link VERSION_CODES#M} or later throws a {@code SecurityException}.
Amith Yamasani156c4352010-03-05 17:10:03 -08004655 */
Adrian Roos9dd16eb2015-01-08 16:20:49 +01004656 @Deprecated
Amith Yamasani156c4352010-03-05 17:10:03 -08004657 public static final String LOCK_PATTERN_ENABLED = "lock_pattern_autolock";
4658
4659 /**
4660 * Whether lock pattern is visible as user enters (0 = false, 1 = true)
Adrian Roos7811d9f2015-07-27 15:10:13 -07004661 *
4662 * @deprecated Accessing this setting from an app that is targeting
Deepanshu Guptae836a222015-07-31 12:11:07 -07004663 * {@link VERSION_CODES#M} or later throws a {@code SecurityException}.
Amith Yamasani156c4352010-03-05 17:10:03 -08004664 */
Adrian Roos7811d9f2015-07-27 15:10:13 -07004665 @Deprecated
Amith Yamasani156c4352010-03-05 17:10:03 -08004666 public static final String LOCK_PATTERN_VISIBLE = "lock_pattern_visible_pattern";
4667
4668 /**
Jeff Sharkey5ed9d682012-10-10 14:28:27 -07004669 * Whether lock pattern will vibrate as user enters (0 = false, 1 =
4670 * true)
4671 *
4672 * @deprecated Starting in {@link VERSION_CODES#JELLY_BEAN_MR1} the
4673 * lockscreen uses
4674 * {@link Settings.System#HAPTIC_FEEDBACK_ENABLED}.
Adrian Roos7811d9f2015-07-27 15:10:13 -07004675 * Accessing this setting from an app that is targeting
Deepanshu Guptae836a222015-07-31 12:11:07 -07004676 * {@link VERSION_CODES#M} or later throws a {@code SecurityException}.
Amith Yamasani156c4352010-03-05 17:10:03 -08004677 */
Jeff Sharkey5ed9d682012-10-10 14:28:27 -07004678 @Deprecated
4679 public static final String
4680 LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED = "lock_pattern_tactile_feedback_enabled";
Amith Yamasani156c4352010-03-05 17:10:03 -08004681
4682 /**
Jim Millerbc4603b2010-08-30 21:21:34 -07004683 * This preference allows the device to be locked given time after screen goes off,
4684 * subject to current DeviceAdmin policy limits.
4685 * @hide
4686 */
4687 public static final String LOCK_SCREEN_LOCK_AFTER_TIMEOUT = "lock_screen_lock_after_timeout";
4688
4689
4690 /**
John Spurlock5f050e52012-10-27 10:44:19 -04004691 * This preference contains the string that shows for owner info on LockScreen.
Jim Miller253a5ef2010-10-13 20:57:29 -07004692 * @hide
Jim Miller187ec582013-04-15 18:27:54 -07004693 * @deprecated
Jim Miller253a5ef2010-10-13 20:57:29 -07004694 */
4695 public static final String LOCK_SCREEN_OWNER_INFO = "lock_screen_owner_info";
4696
4697 /**
John Spurlock5f050e52012-10-27 10:44:19 -04004698 * Ids of the user-selected appwidgets on the lockscreen (comma-delimited).
Jim Millerf229e4d2012-09-12 20:32:50 -07004699 * @hide
4700 */
Adrian Roos230635e2015-01-07 20:50:29 +01004701 @Deprecated
Michael Jurkaaa2859a2012-10-24 12:46:49 -07004702 public static final String LOCK_SCREEN_APPWIDGET_IDS =
4703 "lock_screen_appwidget_ids";
Jim Millerf229e4d2012-09-12 20:32:50 -07004704
4705 /**
Jim Miller51117262012-11-04 17:58:09 -08004706 * Id of the appwidget shown on the lock screen when appwidgets are disabled.
4707 * @hide
4708 */
Adrian Roos230635e2015-01-07 20:50:29 +01004709 @Deprecated
Jim Miller51117262012-11-04 17:58:09 -08004710 public static final String LOCK_SCREEN_FALLBACK_APPWIDGET_ID =
4711 "lock_screen_fallback_appwidget_id";
4712
4713 /**
John Spurlock5f050e52012-10-27 10:44:19 -04004714 * Index of the lockscreen appwidget to restore, -1 if none.
4715 * @hide
4716 */
Adrian Roos230635e2015-01-07 20:50:29 +01004717 @Deprecated
John Spurlock5f050e52012-10-27 10:44:19 -04004718 public static final String LOCK_SCREEN_STICKY_APPWIDGET =
4719 "lock_screen_sticky_appwidget";
4720
4721 /**
4722 * This preference enables showing the owner info on LockScreen.
Jim Miller253a5ef2010-10-13 20:57:29 -07004723 * @hide
Jim Miller187ec582013-04-15 18:27:54 -07004724 * @deprecated
Jim Miller253a5ef2010-10-13 20:57:29 -07004725 */
4726 public static final String LOCK_SCREEN_OWNER_INFO_ENABLED =
4727 "lock_screen_owner_info_enabled";
4728
4729 /**
Dan Sandler5d7c3cc2014-02-18 17:35:15 -05004730 * When set by a user, allows notifications to be shown atop a securely locked screen
4731 * in their full "private" form (same as when the device is unlocked).
Dan Sandlerfd16d562014-02-13 18:43:31 -08004732 * @hide
4733 */
4734 public static final String LOCK_SCREEN_ALLOW_PRIVATE_NOTIFICATIONS =
4735 "lock_screen_allow_private_notifications";
4736
4737 /**
Adrian Roos3aec6382016-02-05 14:19:01 -08004738 * When set by a user, allows notification remote input atop a securely locked screen
4739 * without having to unlock
4740 * @hide
4741 */
4742 public static final String LOCK_SCREEN_ALLOW_REMOTE_INPUT =
4743 "lock_screen_allow_remote_input";
4744
4745 /**
Chris Wrencd8f4f72014-08-27 18:48:13 -04004746 * Set by the system to track if the user needs to see the call to action for
4747 * the lockscreen notification policy.
4748 * @hide
4749 */
4750 public static final String SHOW_NOTE_ABOUT_NOTIFICATION_HIDING =
4751 "show_note_about_notification_hiding";
4752
4753 /**
Adrian Roos3870d452014-09-05 18:22:28 +02004754 * Set to 1 by the system after trust agents have been initialized.
4755 * @hide
4756 */
4757 public static final String TRUST_AGENTS_INITIALIZED =
4758 "trust_agents_initialized";
4759
4760 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004761 * The Logging ID (a unique 64-bit value) as a hex string.
4762 * Used as a pseudonymous identifier for logging.
4763 * @deprecated This identifier is poorly initialized and has
4764 * many collisions. It should not be used.
4765 */
4766 @Deprecated
4767 public static final String LOGGING_ID = "logging_id";
4768
4769 /**
Christopher Tate06efb532012-08-24 15:29:27 -07004770 * @deprecated Use {@link android.provider.Settings.Global#NETWORK_PREFERENCE} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004771 */
Christopher Tate06efb532012-08-24 15:29:27 -07004772 @Deprecated
4773 public static final String NETWORK_PREFERENCE = Global.NETWORK_PREFERENCE;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07004774
4775 /**
Dan Egnor1c9131c2010-02-13 10:38:55 -08004776 * No longer supported.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004777 */
4778 public static final String PARENTAL_CONTROL_ENABLED = "parental_control_enabled";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07004779
4780 /**
Dan Egnor1c9131c2010-02-13 10:38:55 -08004781 * No longer supported.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004782 */
4783 public static final String PARENTAL_CONTROL_LAST_UPDATE = "parental_control_last_update";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07004784
4785 /**
Dan Egnor1c9131c2010-02-13 10:38:55 -08004786 * No longer supported.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004787 */
4788 public static final String PARENTAL_CONTROL_REDIRECT_URL = "parental_control_redirect_url";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07004789
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004790 /**
4791 * Settings classname to launch when Settings is clicked from All
4792 * Applications. Needed because of user testing between the old
4793 * and new Settings apps.
4794 */
4795 // TODO: 881807
4796 public static final String SETTINGS_CLASSNAME = "settings_classname";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07004797
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004798 /**
Christopher Tate06efb532012-08-24 15:29:27 -07004799 * @deprecated Use {@link android.provider.Settings.Global#USB_MASS_STORAGE_ENABLED} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004800 */
Christopher Tate06efb532012-08-24 15:29:27 -07004801 @Deprecated
4802 public static final String USB_MASS_STORAGE_ENABLED = Global.USB_MASS_STORAGE_ENABLED;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07004803
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004804 /**
Christopher Tate06efb532012-08-24 15:29:27 -07004805 * @deprecated Use {@link android.provider.Settings.Global#USE_GOOGLE_MAIL} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004806 */
Christopher Tate06efb532012-08-24 15:29:27 -07004807 @Deprecated
4808 public static final String USE_GOOGLE_MAIL = Global.USE_GOOGLE_MAIL;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07004809
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08004810 /**
svetoslavganov75986cf2009-05-14 22:28:01 -07004811 * If accessibility is enabled.
4812 */
4813 public static final String ACCESSIBILITY_ENABLED = "accessibility_enabled";
4814
4815 /**
Svetoslav Ganov00aabf72011-07-21 11:35:03 -07004816 * If touch exploration is enabled.
Svetoslav Ganov35bfede2011-07-14 17:57:06 -07004817 */
Svetoslav Ganov00aabf72011-07-21 11:35:03 -07004818 public static final String TOUCH_EXPLORATION_ENABLED = "touch_exploration_enabled";
Svetoslav Ganov35bfede2011-07-14 17:57:06 -07004819
4820 /**
svetoslavganov75986cf2009-05-14 22:28:01 -07004821 * List of the enabled accessibility providers.
4822 */
4823 public static final String ENABLED_ACCESSIBILITY_SERVICES =
4824 "enabled_accessibility_services";
4825
4826 /**
Svetoslav Ganov7befb7d2012-09-27 16:49:23 -07004827 * List of the accessibility services to which the user has granted
Svetoslav Ganov9a4c5cd2012-05-30 14:06:32 -07004828 * permission to put the device into touch exploration mode.
4829 *
4830 * @hide
4831 */
4832 public static final String TOUCH_EXPLORATION_GRANTED_ACCESSIBILITY_SERVICES =
4833 "touch_exploration_granted_accessibility_services";
4834
4835 /**
Svetoslav Ganov55f937a2011-12-05 11:42:07 -08004836 * Whether to speak passwords while in accessibility mode.
4837 */
4838 public static final String ACCESSIBILITY_SPEAK_PASSWORD = "speak_password";
4839
4840 /**
Chris Craikcce47eb2014-07-16 15:12:15 -07004841 * Whether to draw text with high contrast while in accessibility mode.
4842 *
4843 * @hide
4844 */
4845 public static final String ACCESSIBILITY_HIGH_TEXT_CONTRAST_ENABLED =
4846 "high_text_contrast_enabled";
4847
4848 /**
Svetoslav Ganov3ca5a742011-12-06 15:24:37 -08004849 * If injection of accessibility enhancing JavaScript screen-reader
Svetoslav Ganov585f13f8d2010-08-10 07:59:15 -07004850 * is enabled.
4851 * <p>
Svetoslav Ganov3ca5a742011-12-06 15:24:37 -08004852 * Note: The JavaScript based screen-reader is served by the
Svetoslav Ganov585f13f8d2010-08-10 07:59:15 -07004853 * Google infrastructure and enable users with disabilities to
Svetoslav Ganov7befb7d2012-09-27 16:49:23 -07004854 * efficiently navigate in and explore web content.
Svetoslav Ganov585f13f8d2010-08-10 07:59:15 -07004855 * </p>
4856 * <p>
4857 * This property represents a boolean value.
4858 * </p>
4859 * @hide
4860 */
4861 public static final String ACCESSIBILITY_SCRIPT_INJECTION =
4862 "accessibility_script_injection";
4863
4864 /**
Svetoslav Ganov3ca5a742011-12-06 15:24:37 -08004865 * The URL for the injected JavaScript based screen-reader used
Svetoslav Ganov7befb7d2012-09-27 16:49:23 -07004866 * for providing accessibility of content in WebView.
Svetoslav Ganov3ca5a742011-12-06 15:24:37 -08004867 * <p>
4868 * Note: The JavaScript based screen-reader is served by the
4869 * Google infrastructure and enable users with disabilities to
4870 * efficiently navigate in and explore web content.
4871 * </p>
4872 * <p>
4873 * This property represents a string value.
4874 * </p>
4875 * @hide
4876 */
4877 public static final String ACCESSIBILITY_SCREEN_READER_URL =
4878 "accessibility_script_injection_url";
4879
4880 /**
Svetoslav Ganov585f13f8d2010-08-10 07:59:15 -07004881 * Key bindings for navigation in built-in accessibility support for web content.
4882 * <p>
4883 * Note: These key bindings are for the built-in accessibility navigation for
4884 * web content which is used as a fall back solution if JavaScript in a WebView
4885 * is not enabled or the user has not opted-in script injection from Google.
4886 * </p>
4887 * <p>
4888 * The bindings are separated by semi-colon. A binding is a mapping from
4889 * a key to a sequence of actions (for more details look at
4890 * android.webkit.AccessibilityInjector). A key is represented as the hexademical
4891 * string representation of an integer obtained from a meta state (optional) shifted
4892 * sixteen times left and bitwise ored with a key code. An action is represented
4893 * as a hexademical string representation of an integer where the first two digits
4894 * are navigation action index, the second, the third, and the fourth digit pairs
4895 * represent the action arguments. The separate actions in a binding are colon
4896 * separated. The key and the action sequence it maps to are separated by equals.
4897 * </p>
4898 * <p>
4899 * For example, the binding below maps the DPAD right button to traverse the
4900 * current navigation axis once without firing an accessibility event and to
4901 * perform the same traversal again but to fire an event:
4902 * <code>
4903 * 0x16=0x01000100:0x01000101;
4904 * </code>
4905 * </p>
4906 * <p>
4907 * The goal of this binding is to enable dynamic rebinding of keys to
4908 * navigation actions for web content without requiring a framework change.
4909 * </p>
4910 * <p>
4911 * This property represents a string value.
4912 * </p>
4913 * @hide
4914 */
4915 public static final String ACCESSIBILITY_WEB_CONTENT_KEY_BINDINGS =
4916 "accessibility_web_content_key_bindings";
4917
4918 /**
Svetoslav Ganov1cf70bb2012-08-06 10:53:34 -07004919 * Setting that specifies whether the display magnification is enabled.
4920 * Display magnifications allows the user to zoom in the display content
4921 * and is targeted to low vision users. The current magnification scale
4922 * is controlled by {@link #ACCESSIBILITY_DISPLAY_MAGNIFICATION_SCALE}.
4923 *
4924 * @hide
4925 */
4926 public static final String ACCESSIBILITY_DISPLAY_MAGNIFICATION_ENABLED =
4927 "accessibility_display_magnification_enabled";
4928
4929 /**
4930 * Setting that specifies what the display magnification scale is.
4931 * Display magnifications allows the user to zoom in the display
4932 * content and is targeted to low vision users. Whether a display
4933 * magnification is performed is controlled by
4934 * {@link #ACCESSIBILITY_DISPLAY_MAGNIFICATION_ENABLED}
4935 *
4936 * @hide
4937 */
4938 public static final String ACCESSIBILITY_DISPLAY_MAGNIFICATION_SCALE =
4939 "accessibility_display_magnification_scale";
4940
4941 /**
4942 * Setting that specifies whether the display magnification should be
4943 * automatically updated. If this fearture is enabled the system will
4944 * exit magnification mode or pan the viewport when a context change
4945 * occurs. For example, on staring a new activity or rotating the screen,
4946 * the system may zoom out so the user can see the new context he is in.
4947 * Another example is on showing a window that is not visible in the
4948 * magnified viewport the system may pan the viewport to make the window
4949 * the has popped up so the user knows that the context has changed.
4950 * Whether a screen magnification is performed is controlled by
4951 * {@link #ACCESSIBILITY_DISPLAY_MAGNIFICATION_ENABLED}
4952 *
4953 * @hide
4954 */
4955 public static final String ACCESSIBILITY_DISPLAY_MAGNIFICATION_AUTO_UPDATE =
4956 "accessibility_display_magnification_auto_update";
4957
4958 /**
Anna Galusza9b278112016-01-04 11:37:37 -08004959 * Setting that specifies what mode the soft keyboard is in (default or hidden). Can be
4960 * modified from an AccessibilityService using the SoftKeyboardController.
4961 *
4962 * @hide
4963 */
4964 public static final String ACCESSIBILITY_SOFT_KEYBOARD_MODE =
4965 "accessibility_soft_keyboard_mode";
4966
4967 /**
4968 * Default soft keyboard behavior.
4969 *
4970 * @hide
4971 */
4972 public static final int SHOW_MODE_AUTO = 0;
4973
4974 /**
4975 * Soft keyboard is never shown.
4976 *
4977 * @hide
4978 */
4979 public static final int SHOW_MODE_HIDDEN = 1;
4980
4981 /**
Alan Viveretteef793802013-07-23 14:15:28 -07004982 * Setting that specifies whether timed text (captions) should be
4983 * displayed in video content. Text display properties are controlled by
4984 * the following settings:
4985 * <ul>
4986 * <li>{@link #ACCESSIBILITY_CAPTIONING_LOCALE}
4987 * <li>{@link #ACCESSIBILITY_CAPTIONING_BACKGROUND_COLOR}
4988 * <li>{@link #ACCESSIBILITY_CAPTIONING_FOREGROUND_COLOR}
4989 * <li>{@link #ACCESSIBILITY_CAPTIONING_EDGE_COLOR}
4990 * <li>{@link #ACCESSIBILITY_CAPTIONING_EDGE_TYPE}
4991 * <li>{@link #ACCESSIBILITY_CAPTIONING_TYPEFACE}
Alan Viverette69ce69b2013-08-29 12:23:48 -07004992 * <li>{@link #ACCESSIBILITY_CAPTIONING_FONT_SCALE}
Alan Viveretteef793802013-07-23 14:15:28 -07004993 * </ul>
4994 *
4995 * @hide
4996 */
4997 public static final String ACCESSIBILITY_CAPTIONING_ENABLED =
4998 "accessibility_captioning_enabled";
4999
5000 /**
5001 * Setting that specifies the language for captions as a locale string,
5002 * e.g. en_US.
5003 *
5004 * @see java.util.Locale#toString
5005 * @hide
5006 */
5007 public static final String ACCESSIBILITY_CAPTIONING_LOCALE =
5008 "accessibility_captioning_locale";
5009
5010 /**
Alan Viverette43a1e3d2013-08-02 16:45:03 -07005011 * Integer property that specifies the preset style for captions, one
5012 * of:
5013 * <ul>
Alan Viverette69ce69b2013-08-29 12:23:48 -07005014 * <li>{@link android.view.accessibility.CaptioningManager.CaptionStyle#PRESET_CUSTOM}
5015 * <li>a valid index of {@link android.view.accessibility.CaptioningManager.CaptionStyle#PRESETS}
Alan Viverette43a1e3d2013-08-02 16:45:03 -07005016 * </ul>
5017 *
5018 * @see java.util.Locale#toString
5019 * @hide
5020 */
5021 public static final String ACCESSIBILITY_CAPTIONING_PRESET =
5022 "accessibility_captioning_preset";
5023
5024 /**
Alan Viveretteef793802013-07-23 14:15:28 -07005025 * Integer property that specifes the background color for captions as a
5026 * packed 32-bit color.
5027 *
5028 * @see android.graphics.Color#argb
5029 * @hide
5030 */
5031 public static final String ACCESSIBILITY_CAPTIONING_BACKGROUND_COLOR =
5032 "accessibility_captioning_background_color";
5033
5034 /**
5035 * Integer property that specifes the foreground color for captions as a
5036 * packed 32-bit color.
5037 *
5038 * @see android.graphics.Color#argb
5039 * @hide
5040 */
5041 public static final String ACCESSIBILITY_CAPTIONING_FOREGROUND_COLOR =
5042 "accessibility_captioning_foreground_color";
5043
5044 /**
5045 * Integer property that specifes the edge type for captions, one of:
5046 * <ul>
Alan Viverette69ce69b2013-08-29 12:23:48 -07005047 * <li>{@link android.view.accessibility.CaptioningManager.CaptionStyle#EDGE_TYPE_NONE}
5048 * <li>{@link android.view.accessibility.CaptioningManager.CaptionStyle#EDGE_TYPE_OUTLINE}
5049 * <li>{@link android.view.accessibility.CaptioningManager.CaptionStyle#EDGE_TYPE_DROP_SHADOW}
Alan Viveretteef793802013-07-23 14:15:28 -07005050 * </ul>
5051 *
5052 * @see #ACCESSIBILITY_CAPTIONING_EDGE_COLOR
5053 * @hide
5054 */
5055 public static final String ACCESSIBILITY_CAPTIONING_EDGE_TYPE =
5056 "accessibility_captioning_edge_type";
5057
5058 /**
5059 * Integer property that specifes the edge color for captions as a
5060 * packed 32-bit color.
5061 *
5062 * @see #ACCESSIBILITY_CAPTIONING_EDGE_TYPE
5063 * @see android.graphics.Color#argb
5064 * @hide
5065 */
5066 public static final String ACCESSIBILITY_CAPTIONING_EDGE_COLOR =
5067 "accessibility_captioning_edge_color";
5068
5069 /**
Alan Viverette55d70622013-12-11 15:22:14 -08005070 * Integer property that specifes the window color for captions as a
5071 * packed 32-bit color.
5072 *
5073 * @see android.graphics.Color#argb
5074 * @hide
5075 */
5076 public static final String ACCESSIBILITY_CAPTIONING_WINDOW_COLOR =
5077 "accessibility_captioning_window_color";
5078
5079 /**
Alan Viveretteef793802013-07-23 14:15:28 -07005080 * String property that specifies the typeface for captions, one of:
5081 * <ul>
5082 * <li>DEFAULT
5083 * <li>MONOSPACE
5084 * <li>SANS_SERIF
5085 * <li>SERIF
5086 * </ul>
5087 *
5088 * @see android.graphics.Typeface
5089 * @hide
5090 */
5091 public static final String ACCESSIBILITY_CAPTIONING_TYPEFACE =
5092 "accessibility_captioning_typeface";
5093
5094 /**
Alan Viverette69ce69b2013-08-29 12:23:48 -07005095 * Floating point property that specifies font scaling for captions.
Alan Viveretteef793802013-07-23 14:15:28 -07005096 *
5097 * @hide
5098 */
Alan Viverette69ce69b2013-08-29 12:23:48 -07005099 public static final String ACCESSIBILITY_CAPTIONING_FONT_SCALE =
5100 "accessibility_captioning_font_scale";
Alan Viveretteef793802013-07-23 14:15:28 -07005101
5102 /**
Alan Viverette410d4e32013-09-30 15:37:38 -07005103 * Setting that specifies whether display color inversion is enabled.
Alan Viverette410d4e32013-09-30 15:37:38 -07005104 */
5105 public static final String ACCESSIBILITY_DISPLAY_INVERSION_ENABLED =
5106 "accessibility_display_inversion_enabled";
5107
5108 /**
Alan Viverette410d4e32013-09-30 15:37:38 -07005109 * Setting that specifies whether display color space adjustment is
5110 * enabled.
5111 *
5112 * @hide
5113 */
5114 public static final String ACCESSIBILITY_DISPLAY_DALTONIZER_ENABLED =
5115 "accessibility_display_daltonizer_enabled";
5116
5117 /**
5118 * Integer property that specifies the type of color space adjustment to
5119 * perform. Valid values are defined in AccessibilityManager.
5120 *
5121 * @hide
5122 */
5123 public static final String ACCESSIBILITY_DISPLAY_DALTONIZER =
5124 "accessibility_display_daltonizer";
5125
5126 /**
Jason Monk08e7fa92015-12-07 20:05:08 -05005127 * Float list that specifies the color matrix to apply to
5128 * the display. Valid values are defined in AccessibilityManager.
5129 *
5130 * @hide
5131 */
5132 public static final String ACCESSIBILITY_DISPLAY_COLOR_MATRIX =
5133 "accessibility_display_color_matrix";
5134
5135 /**
Toni Barzic386f8342015-09-09 12:30:41 -07005136 * Setting that specifies whether automatic click when the mouse pointer stops moving is
5137 * enabled.
5138 *
5139 * @hide
5140 */
5141 public static final String ACCESSIBILITY_AUTOCLICK_ENABLED =
5142 "accessibility_autoclick_enabled";
5143
5144 /**
5145 * Integer setting specifying amount of time in ms the mouse pointer has to stay still
5146 * before performing click when {@link #ACCESSIBILITY_AUTOCLICK_ENABLED} is set.
5147 *
5148 * @see #ACCESSIBILITY_AUTOCLICK_ENABLED
5149 * @hide
5150 */
5151 public static final String ACCESSIBILITY_AUTOCLICK_DELAY =
5152 "accessibility_autoclick_delay";
5153
5154 /**
Jun Mukai19a56012015-11-24 11:25:52 -08005155 * Whether or not larger size icons are used for the pointer of mouse/trackpad for
5156 * accessibility.
5157 * (0 = false, 1 = true)
5158 * @hide
5159 */
5160 public static final String ACCESSIBILITY_LARGE_POINTER_ICON =
5161 "accessibility_large_pointer_icon";
5162
5163 /**
Toni Barzic386f8342015-09-09 12:30:41 -07005164 * The timeout for considering a press to be a long press in milliseconds.
Svetoslav Ganov54d068e2011-03-02 12:58:40 -08005165 * @hide
5166 */
5167 public static final String LONG_PRESS_TIMEOUT = "long_press_timeout";
5168
5169 /**
Svetoslav Ganov6bd20bc2013-09-02 15:24:45 -07005170 * List of the enabled print services.
Philip P. Moltmann8141bdf2015-12-21 17:03:05 -08005171 *
5172 * N and beyond uses {@link #DISABLED_PRINT_SERVICES}. But this might be used in an upgrade
5173 * from pre-N.
5174 *
Svetoslav Ganov4b9a4d12013-06-11 15:20:06 -07005175 * @hide
5176 */
5177 public static final String ENABLED_PRINT_SERVICES =
5178 "enabled_print_services";
5179
5180 /**
Philip P. Moltmann8141bdf2015-12-21 17:03:05 -08005181 * List of the disabled print services.
5182 *
Svetoslav Ganov6bd20bc2013-09-02 15:24:45 -07005183 * @hide
5184 */
Philip P. Moltmann8141bdf2015-12-21 17:03:05 -08005185 public static final String DISABLED_PRINT_SERVICES =
5186 "disabled_print_services";
Svetoslav Ganov6bd20bc2013-09-02 15:24:45 -07005187
5188 /**
Alan Viverette5e8d8372016-02-03 15:38:59 -05005189 * The saved value for WindowManagerService.setForcedDisplayDensity()
5190 * formatted as a single integer representing DPI. If unset, then use
5191 * the real display density.
5192 *
5193 * @hide
5194 */
5195 public static final String DISPLAY_DENSITY_FORCED = "display_density_forced";
5196
5197 /**
Jean-Michel Trivif62ba452009-06-04 14:55:24 -07005198 * Setting to always use the default text-to-speech settings regardless
5199 * of the application settings.
5200 * 1 = override application settings,
5201 * 0 = use application settings (if specified).
Narayan Kamath6d632962011-08-24 11:51:37 +01005202 *
5203 * @deprecated The value of this setting is no longer respected by
5204 * the framework text to speech APIs as of the Ice Cream Sandwich release.
Jean-Michel Trivif62ba452009-06-04 14:55:24 -07005205 */
Narayan Kamath6d632962011-08-24 11:51:37 +01005206 @Deprecated
Jean-Michel Trivif62ba452009-06-04 14:55:24 -07005207 public static final String TTS_USE_DEFAULTS = "tts_use_defaults";
5208
5209 /**
5210 * Default text-to-speech engine speech rate. 100 = 1x
5211 */
5212 public static final String TTS_DEFAULT_RATE = "tts_default_rate";
5213
5214 /**
5215 * Default text-to-speech engine pitch. 100 = 1x
5216 */
5217 public static final String TTS_DEFAULT_PITCH = "tts_default_pitch";
5218
5219 /**
5220 * Default text-to-speech engine.
5221 */
5222 public static final String TTS_DEFAULT_SYNTH = "tts_default_synth";
5223
5224 /**
Jean-Michel Trivif4782672009-06-09 16:22:48 -07005225 * Default text-to-speech language.
Narayan Kamath6d632962011-08-24 11:51:37 +01005226 *
5227 * @deprecated this setting is no longer in use, as of the Ice Cream
5228 * Sandwich release. Apps should never need to read this setting directly,
5229 * instead can query the TextToSpeech framework classes for the default
5230 * locale. {@link TextToSpeech#getLanguage()}.
Jean-Michel Trivif4782672009-06-09 16:22:48 -07005231 */
Narayan Kamath6d632962011-08-24 11:51:37 +01005232 @Deprecated
Jean-Michel Trivif4782672009-06-09 16:22:48 -07005233 public static final String TTS_DEFAULT_LANG = "tts_default_lang";
5234
5235 /**
Jean-Michel Trivia6fcc952009-06-19 14:06:01 -07005236 * Default text-to-speech country.
Narayan Kamath6d632962011-08-24 11:51:37 +01005237 *
5238 * @deprecated this setting is no longer in use, as of the Ice Cream
5239 * Sandwich release. Apps should never need to read this setting directly,
5240 * instead can query the TextToSpeech framework classes for the default
5241 * locale. {@link TextToSpeech#getLanguage()}.
Jean-Michel Trivia6fcc952009-06-19 14:06:01 -07005242 */
Narayan Kamath6d632962011-08-24 11:51:37 +01005243 @Deprecated
Jean-Michel Trivia6fcc952009-06-19 14:06:01 -07005244 public static final String TTS_DEFAULT_COUNTRY = "tts_default_country";
5245
5246 /**
5247 * Default text-to-speech locale variant.
Narayan Kamath6d632962011-08-24 11:51:37 +01005248 *
5249 * @deprecated this setting is no longer in use, as of the Ice Cream
5250 * Sandwich release. Apps should never need to read this setting directly,
5251 * instead can query the TextToSpeech framework classes for the
5252 * locale that is in use {@link TextToSpeech#getLanguage()}.
Jean-Michel Trivia6fcc952009-06-19 14:06:01 -07005253 */
Narayan Kamath6d632962011-08-24 11:51:37 +01005254 @Deprecated
Jean-Michel Trivia6fcc952009-06-19 14:06:01 -07005255 public static final String TTS_DEFAULT_VARIANT = "tts_default_variant";
5256
5257 /**
Narayan Kamathe5b8c4d2011-08-22 15:37:47 +01005258 * Stores the default tts locales on a per engine basis. Stored as
5259 * a comma seperated list of values, each value being of the form
5260 * {@code engine_name:locale} for example,
Narayan Kamath6d632962011-08-24 11:51:37 +01005261 * {@code com.foo.ttsengine:eng-USA,com.bar.ttsengine:esp-ESP}. This
5262 * supersedes {@link #TTS_DEFAULT_LANG}, {@link #TTS_DEFAULT_COUNTRY} and
5263 * {@link #TTS_DEFAULT_VARIANT}. Apps should never need to read this
5264 * setting directly, and can query the TextToSpeech framework classes
5265 * for the locale that is in use.
Narayan Kamathe5b8c4d2011-08-22 15:37:47 +01005266 *
5267 * @hide
5268 */
5269 public static final String TTS_DEFAULT_LOCALE = "tts_default_locale";
5270
5271 /**
Charles Chenceffa152010-03-16 21:18:10 -07005272 * Space delimited list of plugin packages that are enabled.
5273 */
5274 public static final String TTS_ENABLED_PLUGINS = "tts_enabled_plugins";
5275
5276 /**
Christopher Tate6f5a9a92012-09-14 17:24:28 -07005277 * @deprecated Use {@link android.provider.Settings.Global#WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON}
5278 * instead.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005279 */
Christopher Tate6f5a9a92012-09-14 17:24:28 -07005280 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005281 public static final String WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON =
Christopher Tate6f5a9a92012-09-14 17:24:28 -07005282 Global.WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07005283
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005284 /**
Christopher Tate6f5a9a92012-09-14 17:24:28 -07005285 * @deprecated Use {@link android.provider.Settings.Global#WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY}
5286 * instead.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005287 */
Christopher Tate6f5a9a92012-09-14 17:24:28 -07005288 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005289 public static final String WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY =
Christopher Tate6f5a9a92012-09-14 17:24:28 -07005290 Global.WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07005291
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005292 /**
Christopher Tate6f5a9a92012-09-14 17:24:28 -07005293 * @deprecated Use {@link android.provider.Settings.Global#WIFI_NUM_OPEN_NETWORKS_KEPT}
5294 * instead.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005295 */
Christopher Tate6f5a9a92012-09-14 17:24:28 -07005296 @Deprecated
5297 public static final String WIFI_NUM_OPEN_NETWORKS_KEPT =
5298 Global.WIFI_NUM_OPEN_NETWORKS_KEPT;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07005299
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005300 /**
Christopher Tate6f5a9a92012-09-14 17:24:28 -07005301 * @deprecated Use {@link android.provider.Settings.Global#WIFI_ON}
5302 * instead.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005303 */
Christopher Tate6f5a9a92012-09-14 17:24:28 -07005304 @Deprecated
5305 public static final String WIFI_ON = Global.WIFI_ON;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07005306
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005307 /**
5308 * The acceptable packet loss percentage (range 0 - 100) before trying
5309 * another AP on the same network.
Jeff Brownbf6f6f92012-09-25 15:03:20 -07005310 * @deprecated This setting is not used.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005311 */
Isaac Levyd7b3e6a2011-07-20 18:15:30 -07005312 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005313 public static final String WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE =
5314 "wifi_watchdog_acceptable_packet_loss_percentage";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07005315
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005316 /**
5317 * The number of access points required for a network in order for the
5318 * watchdog to monitor it.
Jeff Brownbf6f6f92012-09-25 15:03:20 -07005319 * @deprecated This setting is not used.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005320 */
Isaac Levyd7b3e6a2011-07-20 18:15:30 -07005321 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005322 public static final String WIFI_WATCHDOG_AP_COUNT = "wifi_watchdog_ap_count";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07005323
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005324 /**
5325 * The delay between background checks.
Jeff Brownbf6f6f92012-09-25 15:03:20 -07005326 * @deprecated This setting is not used.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005327 */
Isaac Levyd7b3e6a2011-07-20 18:15:30 -07005328 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005329 public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS =
5330 "wifi_watchdog_background_check_delay_ms";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07005331
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005332 /**
5333 * Whether the Wi-Fi watchdog is enabled for background checking even
5334 * after it thinks the user has connected to a good access point.
Jeff Brownbf6f6f92012-09-25 15:03:20 -07005335 * @deprecated This setting is not used.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005336 */
Isaac Levyd7b3e6a2011-07-20 18:15:30 -07005337 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005338 public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED =
5339 "wifi_watchdog_background_check_enabled";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07005340
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005341 /**
5342 * The timeout for a background ping
Jeff Brownbf6f6f92012-09-25 15:03:20 -07005343 * @deprecated This setting is not used.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005344 */
Isaac Levyd7b3e6a2011-07-20 18:15:30 -07005345 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005346 public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS =
5347 "wifi_watchdog_background_check_timeout_ms";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07005348
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005349 /**
5350 * The number of initial pings to perform that *may* be ignored if they
5351 * fail. Again, if these fail, they will *not* be used in packet loss
5352 * calculation. For example, one network always seemed to time out for
5353 * the first couple pings, so this is set to 3 by default.
Jeff Brownbf6f6f92012-09-25 15:03:20 -07005354 * @deprecated This setting is not used.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005355 */
Isaac Levyd7b3e6a2011-07-20 18:15:30 -07005356 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005357 public static final String WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT =
5358 "wifi_watchdog_initial_ignored_ping_count";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07005359
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005360 /**
5361 * The maximum number of access points (per network) to attempt to test.
5362 * If this number is reached, the watchdog will no longer monitor the
5363 * initial connection state for the network. This is a safeguard for
5364 * networks containing multiple APs whose DNS does not respond to pings.
Jeff Brownbf6f6f92012-09-25 15:03:20 -07005365 * @deprecated This setting is not used.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005366 */
Isaac Levyd7b3e6a2011-07-20 18:15:30 -07005367 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005368 public static final String WIFI_WATCHDOG_MAX_AP_CHECKS = "wifi_watchdog_max_ap_checks";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07005369
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005370 /**
Jeff Sharkeybdfce2e2012-09-26 15:54:06 -07005371 * @deprecated Use {@link android.provider.Settings.Global#WIFI_WATCHDOG_ON} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005372 */
Jeff Sharkeybdfce2e2012-09-26 15:54:06 -07005373 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005374 public static final String WIFI_WATCHDOG_ON = "wifi_watchdog_on";
5375
5376 /**
5377 * A comma-separated list of SSIDs for which the Wi-Fi watchdog should be enabled.
Jeff Brownbf6f6f92012-09-25 15:03:20 -07005378 * @deprecated This setting is not used.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005379 */
Isaac Levyd7b3e6a2011-07-20 18:15:30 -07005380 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005381 public static final String WIFI_WATCHDOG_WATCH_LIST = "wifi_watchdog_watch_list";
5382
5383 /**
5384 * The number of pings to test if an access point is a good connection.
Jeff Brownbf6f6f92012-09-25 15:03:20 -07005385 * @deprecated This setting is not used.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005386 */
Isaac Levyd7b3e6a2011-07-20 18:15:30 -07005387 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005388 public static final String WIFI_WATCHDOG_PING_COUNT = "wifi_watchdog_ping_count";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07005389
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005390 /**
5391 * The delay between pings.
Jeff Brownbf6f6f92012-09-25 15:03:20 -07005392 * @deprecated This setting is not used.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005393 */
Isaac Levyd7b3e6a2011-07-20 18:15:30 -07005394 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005395 public static final String WIFI_WATCHDOG_PING_DELAY_MS = "wifi_watchdog_ping_delay_ms";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07005396
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005397 /**
5398 * The timeout per ping.
Jeff Brownbf6f6f92012-09-25 15:03:20 -07005399 * @deprecated This setting is not used.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005400 */
Isaac Levyd7b3e6a2011-07-20 18:15:30 -07005401 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005402 public static final String WIFI_WATCHDOG_PING_TIMEOUT_MS = "wifi_watchdog_ping_timeout_ms";
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07005403
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005404 /**
Christopher Tate06efb532012-08-24 15:29:27 -07005405 * @deprecated Use
5406 * {@link android.provider.Settings.Global#WIFI_MAX_DHCP_RETRY_COUNT} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005407 */
Christopher Tate06efb532012-08-24 15:29:27 -07005408 @Deprecated
5409 public static final String WIFI_MAX_DHCP_RETRY_COUNT = Global.WIFI_MAX_DHCP_RETRY_COUNT;
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07005410
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005411 /**
Jeff Brownbf6f6f92012-09-25 15:03:20 -07005412 * @deprecated Use
5413 * {@link android.provider.Settings.Global#WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS} instead
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005414 */
Jeff Sharkeybdfce2e2012-09-26 15:54:06 -07005415 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005416 public static final String WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS =
Jeff Brownbf6f6f92012-09-25 15:03:20 -07005417 Global.WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005418
5419 /**
Jeremy Joslin79294842014-12-03 17:15:28 -08005420 * The number of milliseconds to hold on to a PendingIntent based request. This delay gives
5421 * the receivers of the PendingIntent an opportunity to make a new network request before
5422 * the Network satisfying the request is potentially removed.
5423 *
5424 * @hide
5425 */
5426 public static final String CONNECTIVITY_RELEASE_PENDING_INTENT_DELAY_MS =
5427 "connectivity_release_pending_intent_delay_ms";
5428
5429 /**
Jeff Sharkey625239a2012-09-26 22:03:49 -07005430 * Whether background data usage is allowed.
5431 *
5432 * @deprecated As of {@link VERSION_CODES#ICE_CREAM_SANDWICH},
5433 * availability of background data depends on several
5434 * combined factors. When background data is unavailable,
5435 * {@link ConnectivityManager#getActiveNetworkInfo()} will
5436 * now appear disconnected.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005437 */
Jeff Sharkey3a844fc2011-08-16 14:37:57 -07005438 @Deprecated
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08005439 public static final String BACKGROUND_DATA = "background_data";
Wink Saville04e71b32009-04-02 11:00:54 -07005440
5441 /**
Bjorn Bringert98bfa392010-03-24 10:59:48 +00005442 * Origins for which browsers should allow geolocation by default.
5443 * The value is a space-separated list of origins.
5444 */
5445 public static final String ALLOWED_GEOLOCATION_ORIGINS
5446 = "allowed_geolocation_origins";
5447
5448 /**
Wink Savillee9b06d72009-05-18 21:47:50 -07005449 * The preferred TTY mode 0 = TTy Off, CDMA default
5450 * 1 = TTY Full
5451 * 2 = TTY HCO
5452 * 3 = TTY VCO
5453 * @hide
5454 */
5455 public static final String PREFERRED_TTY_MODE =
5456 "preferred_tty_mode";
5457
Wink Saville04e71b32009-04-02 11:00:54 -07005458 /**
Wink Saville04e71b32009-04-02 11:00:54 -07005459 * Whether the enhanced voice privacy mode is enabled.
5460 * 0 = normal voice privacy
5461 * 1 = enhanced voice privacy
5462 * @hide
5463 */
5464 public static final String ENHANCED_VOICE_PRIVACY_ENABLED = "enhanced_voice_privacy_enabled";
5465
5466 /**
5467 * Whether the TTY mode mode is enabled.
5468 * 0 = disabled
5469 * 1 = enabled
5470 * @hide
5471 */
5472 public static final String TTY_MODE_ENABLED = "tty_mode_enabled";
Mike Lockwoodbd2a7122009-04-02 23:41:33 -07005473
5474 /**
Christopher Tate8031a3d2009-07-06 16:36:05 -07005475 * Controls whether settings backup is enabled.
Dianne Hackborncf098292009-07-01 19:55:20 -07005476 * Type: int ( 0 = disabled, 1 = enabled )
5477 * @hide
5478 */
5479 public static final String BACKUP_ENABLED = "backup_enabled";
5480
5481 /**
Christopher Tatecce9da52010-02-03 15:11:15 -08005482 * Controls whether application data is automatically restored from backup
5483 * at install time.
5484 * Type: int ( 0 = disabled, 1 = enabled )
5485 * @hide
5486 */
5487 public static final String BACKUP_AUTO_RESTORE = "backup_auto_restore";
5488
5489 /**
Christopher Tate8031a3d2009-07-06 16:36:05 -07005490 * Indicates whether settings backup has been fully provisioned.
5491 * Type: int ( 0 = unprovisioned, 1 = fully provisioned )
5492 * @hide
5493 */
5494 public static final String BACKUP_PROVISIONED = "backup_provisioned";
5495
5496 /**
Dianne Hackborncf098292009-07-01 19:55:20 -07005497 * Component of the transport to use for backup/restore.
5498 * @hide
5499 */
5500 public static final String BACKUP_TRANSPORT = "backup_transport";
Sanjay Jeyakumar21bf2412009-07-09 13:31:48 -07005501
Dianne Hackbornd7cd29d2009-07-01 11:22:45 -07005502 /**
5503 * Version for which the setup wizard was last shown. Bumped for
5504 * each release when there is new setup information to show.
5505 * @hide
5506 */
5507 public static final String LAST_SETUP_SHOWN = "last_setup_shown";
Dianne Hackborncf098292009-07-01 19:55:20 -07005508
5509 /**
Doug Zongker43866e02010-01-07 12:09:54 -08005510 * The interval in milliseconds after which Wi-Fi is considered idle.
5511 * When idle, it is possible for the device to be switched from Wi-Fi to
5512 * the mobile data network.
5513 * @hide
Jeff Brownbf6f6f92012-09-25 15:03:20 -07005514 * @deprecated Use {@link android.provider.Settings.Global#WIFI_IDLE_MS}
5515 * instead.
Doug Zongker43866e02010-01-07 12:09:54 -08005516 */
Christopher Tate6f5a9a92012-09-14 17:24:28 -07005517 @Deprecated
5518 public static final String WIFI_IDLE_MS = Global.WIFI_IDLE_MS;
Doug Zongker43866e02010-01-07 12:09:54 -08005519
5520 /**
Narayan Kamathee69ff42011-06-28 12:07:18 +01005521 * The global search provider chosen by the user (if multiple global
5522 * search providers are installed). This will be the provider returned
5523 * by {@link SearchManager#getGlobalSearchActivity()} if it's still
5524 * installed. This setting is stored as a flattened component name as
5525 * per {@link ComponentName#flattenToString()}.
5526 *
5527 * @hide
5528 */
5529 public static final String SEARCH_GLOBAL_SEARCH_ACTIVITY =
5530 "search_global_search_activity";
5531
5532 /**
Doug Zongkeraed8f8e2010-01-07 18:07:50 -08005533 * The number of promoted sources in GlobalSearch.
5534 * @hide
5535 */
5536 public static final String SEARCH_NUM_PROMOTED_SOURCES = "search_num_promoted_sources";
5537 /**
5538 * The maximum number of suggestions returned by GlobalSearch.
5539 * @hide
5540 */
5541 public static final String SEARCH_MAX_RESULTS_TO_DISPLAY = "search_max_results_to_display";
5542 /**
5543 * The number of suggestions GlobalSearch will ask each non-web search source for.
5544 * @hide
5545 */
5546 public static final String SEARCH_MAX_RESULTS_PER_SOURCE = "search_max_results_per_source";
5547 /**
5548 * The number of suggestions the GlobalSearch will ask the web search source for.
5549 * @hide
5550 */
5551 public static final String SEARCH_WEB_RESULTS_OVERRIDE_LIMIT =
5552 "search_web_results_override_limit";
5553 /**
5554 * The number of milliseconds that GlobalSearch will wait for suggestions from
5555 * promoted sources before continuing with all other sources.
5556 * @hide
5557 */
5558 public static final String SEARCH_PROMOTED_SOURCE_DEADLINE_MILLIS =
5559 "search_promoted_source_deadline_millis";
5560 /**
5561 * The number of milliseconds before GlobalSearch aborts search suggesiton queries.
5562 * @hide
5563 */
5564 public static final String SEARCH_SOURCE_TIMEOUT_MILLIS = "search_source_timeout_millis";
5565 /**
5566 * The maximum number of milliseconds that GlobalSearch shows the previous results
5567 * after receiving a new query.
5568 * @hide
5569 */
5570 public static final String SEARCH_PREFILL_MILLIS = "search_prefill_millis";
5571 /**
5572 * The maximum age of log data used for shortcuts in GlobalSearch.
5573 * @hide
5574 */
5575 public static final String SEARCH_MAX_STAT_AGE_MILLIS = "search_max_stat_age_millis";
5576 /**
5577 * The maximum age of log data used for source ranking in GlobalSearch.
5578 * @hide
5579 */
5580 public static final String SEARCH_MAX_SOURCE_EVENT_AGE_MILLIS =
5581 "search_max_source_event_age_millis";
5582 /**
5583 * The minimum number of impressions needed to rank a source in GlobalSearch.
5584 * @hide
5585 */
5586 public static final String SEARCH_MIN_IMPRESSIONS_FOR_SOURCE_RANKING =
5587 "search_min_impressions_for_source_ranking";
5588 /**
5589 * The minimum number of clicks needed to rank a source in GlobalSearch.
5590 * @hide
5591 */
5592 public static final String SEARCH_MIN_CLICKS_FOR_SOURCE_RANKING =
5593 "search_min_clicks_for_source_ranking";
5594 /**
5595 * The maximum number of shortcuts shown by GlobalSearch.
5596 * @hide
5597 */
5598 public static final String SEARCH_MAX_SHORTCUTS_RETURNED = "search_max_shortcuts_returned";
5599 /**
5600 * The size of the core thread pool for suggestion queries in GlobalSearch.
5601 * @hide
5602 */
5603 public static final String SEARCH_QUERY_THREAD_CORE_POOL_SIZE =
5604 "search_query_thread_core_pool_size";
5605 /**
5606 * The maximum size of the thread pool for suggestion queries in GlobalSearch.
5607 * @hide
5608 */
5609 public static final String SEARCH_QUERY_THREAD_MAX_POOL_SIZE =
5610 "search_query_thread_max_pool_size";
5611 /**
5612 * The size of the core thread pool for shortcut refreshing in GlobalSearch.
5613 * @hide
5614 */
5615 public static final String SEARCH_SHORTCUT_REFRESH_CORE_POOL_SIZE =
5616 "search_shortcut_refresh_core_pool_size";
5617 /**
5618 * The maximum size of the thread pool for shortcut refreshing in GlobalSearch.
5619 * @hide
5620 */
5621 public static final String SEARCH_SHORTCUT_REFRESH_MAX_POOL_SIZE =
5622 "search_shortcut_refresh_max_pool_size";
5623 /**
5624 * The maximun time that excess threads in the GlobalSeach thread pools will
5625 * wait before terminating.
5626 * @hide
5627 */
5628 public static final String SEARCH_THREAD_KEEPALIVE_SECONDS =
5629 "search_thread_keepalive_seconds";
5630 /**
5631 * The maximum number of concurrent suggestion queries to each source.
5632 * @hide
5633 */
5634 public static final String SEARCH_PER_SOURCE_CONCURRENT_QUERY_LIMIT =
5635 "search_per_source_concurrent_query_limit";
5636
San Mehat87734d32010-01-08 12:53:06 -08005637 /**
5638 * Whether or not alert sounds are played on MountService events. (0 = false, 1 = true)
5639 * @hide
5640 */
5641 public static final String MOUNT_PLAY_NOTIFICATION_SND = "mount_play_not_snd";
5642
5643 /**
5644 * Whether or not UMS auto-starts on UMS host detection. (0 = false, 1 = true)
5645 * @hide
5646 */
5647 public static final String MOUNT_UMS_AUTOSTART = "mount_ums_autostart";
5648
5649 /**
5650 * Whether or not a notification is displayed on UMS host detection. (0 = false, 1 = true)
5651 * @hide
5652 */
5653 public static final String MOUNT_UMS_PROMPT = "mount_ums_prompt";
5654
5655 /**
5656 * Whether or not a notification is displayed while UMS is enabled. (0 = false, 1 = true)
5657 * @hide
5658 */
5659 public static final String MOUNT_UMS_NOTIFY_ENABLED = "mount_ums_notify_enabled";
Doug Zongkeraed8f8e2010-01-07 18:07:50 -08005660
Dan Egnor42471dd2010-01-07 17:25:22 -08005661 /**
5662 * If nonzero, ANRs in invisible background processes bring up a dialog.
5663 * Otherwise, the process will be silently killed.
5664 * @hide
5665 */
5666 public static final String ANR_SHOW_BACKGROUND = "anr_show_background";
Erikeebc8e22010-02-18 13:27:19 -08005667
Mike LeBeau5d34e9b2010-02-10 19:34:56 -08005668 /**
5669 * The {@link ComponentName} string of the service to be used as the voice recognition
5670 * service.
Erikeebc8e22010-02-18 13:27:19 -08005671 *
Mike LeBeau5d34e9b2010-02-10 19:34:56 -08005672 * @hide
5673 */
5674 public static final String VOICE_RECOGNITION_SERVICE = "voice_recognition_service";
Dan Egnor42471dd2010-01-07 17:25:22 -08005675
William Luh623a4282013-06-24 12:14:18 -07005676 /**
5677 * Stores whether an user has consented to have apps verified through PAM.
5678 * The value is boolean (1 or 0).
5679 *
5680 * @hide
5681 */
5682 public static final String PACKAGE_VERIFIER_USER_CONSENT =
5683 "package_verifier_user_consent";
satok988323c2011-06-22 16:38:13 +09005684
5685 /**
satokada8c4e2011-08-23 14:56:56 +09005686 * The {@link ComponentName} string of the selected spell checker service which is
5687 * one of the services managed by the text service manager.
5688 *
5689 * @hide
5690 */
5691 public static final String SELECTED_SPELL_CHECKER = "selected_spell_checker";
5692
5693 /**
5694 * The {@link ComponentName} string of the selected subtype of the selected spell checker
satok988323c2011-06-22 16:38:13 +09005695 * service which is one of the services managed by the text service manager.
5696 *
5697 * @hide
5698 */
satokada8c4e2011-08-23 14:56:56 +09005699 public static final String SELECTED_SPELL_CHECKER_SUBTYPE =
5700 "selected_spell_checker_subtype";
satok988323c2011-06-22 16:38:13 +09005701
Doug Zongkeraed8f8e2010-01-07 18:07:50 -08005702 /**
satoka33c4fc2011-08-25 16:50:11 +09005703 * The {@link ComponentName} string whether spell checker is enabled or not.
5704 *
5705 * @hide
5706 */
5707 public static final String SPELL_CHECKER_ENABLED = "spell_checker_enabled";
5708
5709 /**
David Brown458e8062010-03-08 21:52:11 -08005710 * What happens when the user presses the Power button while in-call
5711 * and the screen is on.<br/>
5712 * <b>Values:</b><br/>
5713 * 1 - The Power button turns off the screen and locks the device. (Default behavior)<br/>
5714 * 2 - The Power button hangs up the current call.<br/>
5715 *
5716 * @hide
5717 */
5718 public static final String INCALL_POWER_BUTTON_BEHAVIOR = "incall_power_button_behavior";
5719
5720 /**
5721 * INCALL_POWER_BUTTON_BEHAVIOR value for "turn off screen".
5722 * @hide
5723 */
5724 public static final int INCALL_POWER_BUTTON_BEHAVIOR_SCREEN_OFF = 0x1;
5725
5726 /**
5727 * INCALL_POWER_BUTTON_BEHAVIOR value for "hang up".
5728 * @hide
5729 */
5730 public static final int INCALL_POWER_BUTTON_BEHAVIOR_HANGUP = 0x2;
5731
5732 /**
5733 * INCALL_POWER_BUTTON_BEHAVIOR default value.
5734 * @hide
5735 */
5736 public static final int INCALL_POWER_BUTTON_BEHAVIOR_DEFAULT =
5737 INCALL_POWER_BUTTON_BEHAVIOR_SCREEN_OFF;
5738
5739 /**
Jeff Browna20dda42014-05-27 20:57:24 -07005740 * Whether the device should wake when the wake gesture sensor detects motion.
5741 * @hide
5742 */
5743 public static final String WAKE_GESTURE_ENABLED = "wake_gesture_enabled";
5744
5745 /**
John Spurlocka4215ce2014-08-04 14:50:38 -04005746 * Whether the device should doze if configured.
5747 * @hide
5748 */
5749 public static final String DOZE_ENABLED = "doze_enabled";
5750
5751 /**
Dianne Hackborn2ccda4d2010-03-22 21:49:15 -07005752 * The current night mode that has been selected by the user. Owned
5753 * and controlled by UiModeManagerService. Constants are as per
5754 * UiModeManager.
5755 * @hide
5756 */
5757 public static final String UI_NIGHT_MODE = "ui_night_mode";
Suchi Amalapurapu40e47252010-04-07 16:15:50 -07005758
5759 /**
John Spurlock1a868b72012-08-22 09:56:51 -04005760 * Whether screensavers are enabled.
Daniel Sandler0601eb72011-04-13 01:01:32 -04005761 * @hide
5762 */
Daniel Sandler2d545362011-11-17 10:38:37 -08005763 public static final String SCREENSAVER_ENABLED = "screensaver_enabled";
Daniel Sandler0601eb72011-04-13 01:01:32 -04005764
5765 /**
John Spurlock1a868b72012-08-22 09:56:51 -04005766 * The user's chosen screensaver components.
Daniel Sandler2d545362011-11-17 10:38:37 -08005767 *
John Spurlock1a868b72012-08-22 09:56:51 -04005768 * These will be launched by the PhoneWindowManager after a timeout when not on
Daniel Sandler2d545362011-11-17 10:38:37 -08005769 * battery, or upon dock insertion (if SCREENSAVER_ACTIVATE_ON_DOCK is set to 1).
Daniel Sandler0601eb72011-04-13 01:01:32 -04005770 * @hide
5771 */
John Spurlock1a868b72012-08-22 09:56:51 -04005772 public static final String SCREENSAVER_COMPONENTS = "screensaver_components";
Daniel Sandler2d545362011-11-17 10:38:37 -08005773
5774 /**
John Spurlock1a868b72012-08-22 09:56:51 -04005775 * If screensavers are enabled, whether the screensaver should be automatically launched
5776 * when the device is inserted into a (desk) dock.
Daniel Sandler2d545362011-11-17 10:38:37 -08005777 * @hide
5778 */
5779 public static final String SCREENSAVER_ACTIVATE_ON_DOCK = "screensaver_activate_on_dock";
Daniel Sandler0601eb72011-04-13 01:01:32 -04005780
John Spurlock1a868b72012-08-22 09:56:51 -04005781 /**
5782 * If screensavers are enabled, whether the screensaver should be automatically launched
5783 * when the screen times out when not on battery.
5784 * @hide
5785 */
5786 public static final String SCREENSAVER_ACTIVATE_ON_SLEEP = "screensaver_activate_on_sleep";
5787
5788 /**
5789 * If screensavers are enabled, the default screensaver component.
5790 * @hide
5791 */
5792 public static final String SCREENSAVER_DEFAULT_COMPONENT = "screensaver_default_component";
5793
Daniel Sandler0601eb72011-04-13 01:01:32 -04005794 /**
Martijn Coenena7397882013-07-30 20:07:47 -07005795 * The default NFC payment component
5796 * @hide
5797 */
5798 public static final String NFC_PAYMENT_DEFAULT_COMPONENT = "nfc_payment_default_component";
5799
5800 /**
Martijn Coenen2f6f3a012014-04-25 17:00:21 -07005801 * Whether NFC payment is handled by the foreground application or a default.
5802 * @hide
5803 */
5804 public static final String NFC_PAYMENT_FOREGROUND = "nfc_payment_foreground";
5805
5806 /**
David Braunf5d83192013-09-16 13:43:51 -07005807 * Specifies the package name currently configured to be the primary sms application
5808 * @hide
5809 */
5810 public static final String SMS_DEFAULT_APPLICATION = "sms_default_application";
5811
5812 /**
Yorke Lee014de022015-04-21 17:15:47 -07005813 * Specifies the package name currently configured to be the default dialer application
5814 * @hide
5815 */
5816 public static final String DIALER_DEFAULT_APPLICATION = "dialer_default_application";
5817
5818 /**
Adrian Roos943eb862015-03-26 12:31:16 -07005819 * Specifies the package name currently configured to be the emergency assistance application
5820 *
5821 * @see android.telephony.TelephonyManager#ACTION_EMERGENCY_ASSISTANCE
5822 *
5823 * @hide
5824 */
5825 public static final String EMERGENCY_ASSISTANCE_APPLICATION = "emergency_assistance_application";
5826
5827 /**
Jorim Jaggi9d910832015-05-18 17:35:26 -07005828 * Specifies whether the current app context on scren (assist data) will be sent to the
5829 * assist application (active voice interaction service).
5830 *
5831 * @hide
5832 */
5833 public static final String ASSIST_STRUCTURE_ENABLED = "assist_structure_enabled";
5834
5835 /**
Jorim Jaggia133f0b2015-06-26 16:40:00 -07005836 * Specifies whether a screenshot of the screen contents will be sent to the assist
5837 * application (active voice interaction service).
5838 *
5839 * @hide
5840 */
5841 public static final String ASSIST_SCREENSHOT_ENABLED = "assist_screenshot_enabled";
5842
5843 /**
John Spurlock7c74f782015-06-04 13:01:42 -04005844 * Names of the service components that the current user has explicitly allowed to
Chris Wren8326a8a2014-10-22 14:13:32 -04005845 * see all of the user's notifications, separated by ':'.
Daniel Sandler4b749ef2013-03-18 21:53:04 -04005846 *
5847 * @hide
5848 */
5849 public static final String ENABLED_NOTIFICATION_LISTENERS = "enabled_notification_listeners";
5850
John Spurlock7340fc82014-04-24 18:50:12 -04005851 /**
John Spurlock7c74f782015-06-04 13:01:42 -04005852 * Names of the packages that the current user has explicitly allowed to
5853 * manage notification policy configuration, separated by ':'.
John Spurlock7c74f782015-06-04 13:01:42 -04005854 */
5855 public static final String ENABLED_NOTIFICATION_POLICY_ACCESS_PACKAGES =
5856 "enabled_notification_policy_access_packages";
5857
John Spurlock5c454122013-06-17 07:35:46 -04005858 /** @hide */
5859 public static final String BAR_SERVICE_COMPONENT = "bar_service_component";
5860
John Spurlockd67ec252013-09-05 11:31:54 -04005861 /** @hide */
John Spurlockcdb57ae2015-02-11 19:04:11 -05005862 public static final String VOLUME_CONTROLLER_SERVICE_COMPONENT
5863 = "volume_controller_service_component";
5864
5865 /** @hide */
John Spurlockf1a36642013-10-12 17:50:42 -04005866 public static final String IMMERSIVE_MODE_CONFIRMATIONS = "immersive_mode_confirmations";
John Spurlockd67ec252013-09-05 11:31:54 -04005867
Yorke Lee647f8f32013-05-07 10:49:44 -07005868 /**
Svetoslavf43e8512013-09-30 17:33:05 -07005869 * This is the query URI for finding a print service to install.
5870 *
5871 * @hide
5872 */
5873 public static final String PRINT_SERVICE_SEARCH_URI = "print_service_search_uri";
5874
5875 /**
5876 * This is the query URI for finding a NFC payment service to install.
5877 *
5878 * @hide
5879 */
5880 public static final String PAYMENT_SERVICE_SEARCH_URI = "payment_service_search_uri";
5881
5882 /**
Amith Yamasani1e9c2182014-06-11 17:25:51 -07005883 * If enabled, apps should try to skip any introductory hints on first launch. This might
Amith Yamasani0c416392014-06-13 15:54:39 -07005884 * apply to users that are already familiar with the environment or temporary users.
Amith Yamasani1e9c2182014-06-11 17:25:51 -07005885 * <p>
5886 * Type : int (0 to show hints, 1 to skip showing hints)
Amith Yamasani1e9c2182014-06-11 17:25:51 -07005887 */
5888 public static final String SKIP_FIRST_USE_HINTS = "skip_first_use_hints";
5889
5890 /**
John Spurlockaa5ee4d2014-07-25 13:05:12 -04005891 * Persisted playback time after a user confirmation of an unsafe volume level.
5892 *
5893 * @hide
5894 */
5895 public static final String UNSAFE_VOLUME_MUSIC_ACTIVE_MS = "unsafe_volume_music_active_ms";
5896
5897 /**
Dan Sandler52e5701e2014-07-22 23:14:54 -04005898 * This preference enables notification display on the lockscreen.
5899 * @hide
5900 */
5901 public static final String LOCK_SCREEN_SHOW_NOTIFICATIONS =
5902 "lock_screen_show_notifications";
5903
5904 /**
Dongwon Kang4d933a02014-08-07 22:51:47 -07005905 * List of TV inputs that are currently hidden. This is a string
Jaewan Kimf0e530e2014-08-22 00:43:31 +09005906 * containing the IDs of all hidden TV inputs. Each ID is encoded by
5907 * {@link android.net.Uri#encode(String)} and separated by ':'.
Dongwon Kang4d933a02014-08-07 22:51:47 -07005908 * @hide
5909 */
5910 public static final String TV_INPUT_HIDDEN_INPUTS = "tv_input_hidden_inputs";
5911
5912 /**
5913 * List of custom TV input labels. This is a string containing <TV input id, custom name>
Jaewan Kimf0e530e2014-08-22 00:43:31 +09005914 * pairs. TV input id and custom name are encoded by {@link android.net.Uri#encode(String)}
5915 * and separated by ','. Each pair is separated by ':'.
Dongwon Kang4d933a02014-08-07 22:51:47 -07005916 * @hide
5917 */
5918 public static final String TV_INPUT_CUSTOM_LABELS = "tv_input_custom_labels";
5919
5920 /**
Glenn Kasten34cc4db2014-08-13 10:56:38 -07005921 * Whether automatic routing of system audio to USB audio peripheral is disabled.
5922 * The value is boolean (1 or 0), where 1 means automatic routing is disabled,
5923 * and 0 means automatic routing is enabled.
5924 *
5925 * @hide
5926 */
5927 public static final String USB_AUDIO_AUTOMATIC_ROUTING_DISABLED =
5928 "usb_audio_automatic_routing_disabled";
5929
5930 /**
Jeff Brown05af6ad2014-09-30 20:54:30 -07005931 * The timeout in milliseconds before the device fully goes to sleep after
5932 * a period of inactivity. This value sets an upper bound on how long the device
5933 * will stay awake or dreaming without user activity. It should generally
Dianne Hackbornad6a99b2014-11-18 10:11:10 -08005934 * be longer than {@link Settings.System#SCREEN_OFF_TIMEOUT} as otherwise the device
Jeff Brown05af6ad2014-09-30 20:54:30 -07005935 * will sleep before it ever has a chance to dream.
5936 * <p>
5937 * Use -1 to disable this timeout.
5938 * </p>
5939 *
5940 * @hide
5941 */
5942 public static final String SLEEP_TIMEOUT = "sleep_timeout";
5943
5944 /**
Jason Monk27bbb2d2015-03-31 16:46:39 -04005945 * Controls whether double tap to wake is enabled.
5946 * @hide
5947 */
5948 public static final String DOUBLE_TAP_TO_WAKE = "double_tap_to_wake";
5949
5950 /**
Xiyuan Xiae6de8b92015-06-06 22:18:05 -07005951 * The current assistant component. It could be a voice interaction service,
5952 * or an activity that handles ACTION_ASSIST, or empty which means using the default
5953 * handling.
5954 *
5955 * @hide
5956 */
5957 public static final String ASSISTANT = "assistant";
5958
5959 /**
Jason Monk5a5e7d62015-08-04 11:20:25 -04005960 * Whether the camera launch gesture should be disabled.
5961 *
5962 * @hide
5963 */
5964 public static final String CAMERA_GESTURE_DISABLED = "camera_gesture_disabled";
5965
5966 /**
Adrian Roos5941c982015-09-03 15:59:49 -07005967 * Whether the camera launch gesture to double tap the power button when the screen is off
5968 * should be disabled.
5969 *
5970 * @hide
5971 */
5972 public static final String CAMERA_DOUBLE_TAP_POWER_GESTURE_DISABLED =
5973 "camera_double_tap_power_gesture_disabled";
5974
5975 /**
Jason Monk5dbd4aa2016-02-07 13:13:39 -05005976
5977 /**
5978 * Behavior of twilight on the device.
5979 * One of {@link #TWILIGHT_MODE_LOCKED_OFF}, {@link #TWILIGHT_MODE_LOCKED_ON}
5980 * or {@link #TWILIGHT_MODE_AUTO}.
5981 * @hide
5982 */
5983 public static final String TWILIGHT_MODE = "twilight_mode";
5984
5985 /**
5986 * Twilight mode always off.
5987 * @hide
5988 */
5989 public static final int TWILIGHT_MODE_LOCKED_OFF = 0;
5990
5991 /**
5992 * Twilight mode always on.
5993 * @hide
5994 */
5995 public static final int TWILIGHT_MODE_LOCKED_ON = 1;
5996
5997 /**
5998 * Twilight mode auto.
5999 * @hide
6000 */
6001 public static final int TWILIGHT_MODE_AUTO = 2;
6002
6003 /**
6004 * Twilight mode auto, temporarily overriden to on.
6005 * @hide
6006 */
6007 public static final int TWILIGHT_MODE_AUTO_OVERRIDE_OFF = 3;
6008
6009 /**
6010 * Twilight mode auto, temporarily overriden to off.
6011 * @hide
6012 */
6013 public static final int TWILIGHT_MODE_AUTO_OVERRIDE_ON = 4;
6014
6015 /**
6016 * Whether brightness should automatically adjust based on twilight state.
6017 * @hide
6018 */
6019 public static final String BRIGHTNESS_USE_TWILIGHT = "brightness_use_twilight";
6020
6021 /**
Ruben Brunke24b9a62016-02-16 21:38:24 -08006022 * Names of the service components that the current user has explicitly allowed to
6023 * be a VR mode listener, separated by ':'.
6024 *
6025 * @hide
6026 */
6027 public static final String ENABLED_VR_LISTENERS = "enabled_vr_listeners";
6028
6029 /**
Svetoslav Ganova571a582011-09-20 18:32:20 -07006030 * This are the settings to be backed up.
6031 *
6032 * NOTE: Settings are backed up and restored in the order they appear
6033 * in this array. If you have one setting depending on another,
6034 * make sure that they are ordered appropriately.
6035 *
-b master501eec92009-07-06 13:53:11 -07006036 * @hide
6037 */
6038 public static final String[] SETTINGS_TO_BACKUP = {
Christopher Tate58f41ec2013-01-11 15:40:36 -08006039 BUGREPORT_IN_POWER_MENU, // moved to global
Amith Yamasani8823c0a82009-07-07 14:30:17 -07006040 ALLOW_MOCK_LOCATION,
-b master501eec92009-07-06 13:53:11 -07006041 PARENTAL_CONTROL_ENABLED,
6042 PARENTAL_CONTROL_REDIRECT_URL,
Christopher Tate66488d62012-10-02 11:58:01 -07006043 USB_MASS_STORAGE_ENABLED, // moved to global
Anna Galuszafa7786c2015-12-22 10:53:44 -08006044 ACCESSIBILITY_DISPLAY_INVERSION_ENABLED,
6045 ACCESSIBILITY_DISPLAY_DALTONIZER,
6046 ACCESSIBILITY_DISPLAY_COLOR_MATRIX,
6047 ACCESSIBILITY_DISPLAY_DALTONIZER_ENABLED,
Svetoslav Ganov1cf70bb2012-08-06 10:53:34 -07006048 ACCESSIBILITY_DISPLAY_MAGNIFICATION_ENABLED,
6049 ACCESSIBILITY_DISPLAY_MAGNIFICATION_SCALE,
6050 ACCESSIBILITY_DISPLAY_MAGNIFICATION_AUTO_UPDATE,
Svetoslav Ganov585f13f8d2010-08-10 07:59:15 -07006051 ACCESSIBILITY_SCRIPT_INJECTION,
Anna Galuszafa7786c2015-12-22 10:53:44 -08006052 ACCESSIBILITY_WEB_CONTENT_KEY_BINDINGS,
Christopher Tate14c2d792010-02-25 16:49:44 -08006053 BACKUP_AUTO_RESTORE,
-b master501eec92009-07-06 13:53:11 -07006054 ENABLED_ACCESSIBILITY_SERVICES,
Christopher Tate6597e342015-02-17 12:15:25 -08006055 ENABLED_NOTIFICATION_LISTENERS,
Ruben Brunke24b9a62016-02-16 21:38:24 -08006056 ENABLED_VR_LISTENERS,
Christopher Tate7b9a28c2015-03-18 13:06:16 -07006057 ENABLED_INPUT_METHODS,
Svetoslav Ganov9a4c5cd2012-05-30 14:06:32 -07006058 TOUCH_EXPLORATION_GRANTED_ACCESSIBILITY_SERVICES,
Svetoslav Ganova28a16d2011-07-28 11:24:21 -07006059 TOUCH_EXPLORATION_ENABLED,
Svetoslav Ganova571a582011-09-20 18:32:20 -07006060 ACCESSIBILITY_ENABLED,
Svetoslav Ganov55f937a2011-12-05 11:42:07 -08006061 ACCESSIBILITY_SPEAK_PASSWORD,
Chris Craikcce47eb2014-07-16 15:12:15 -07006062 ACCESSIBILITY_HIGH_TEXT_CONTRAST_ENABLED,
Anna Galuszafa7786c2015-12-22 10:53:44 -08006063 ACCESSIBILITY_CAPTIONING_PRESET,
Alan Viveretteef793802013-07-23 14:15:28 -07006064 ACCESSIBILITY_CAPTIONING_ENABLED,
6065 ACCESSIBILITY_CAPTIONING_LOCALE,
6066 ACCESSIBILITY_CAPTIONING_BACKGROUND_COLOR,
6067 ACCESSIBILITY_CAPTIONING_FOREGROUND_COLOR,
6068 ACCESSIBILITY_CAPTIONING_EDGE_TYPE,
6069 ACCESSIBILITY_CAPTIONING_EDGE_COLOR,
6070 ACCESSIBILITY_CAPTIONING_TYPEFACE,
Alan Viverette69ce69b2013-08-29 12:23:48 -07006071 ACCESSIBILITY_CAPTIONING_FONT_SCALE,
Anna Galuszafa7786c2015-12-22 10:53:44 -08006072 ACCESSIBILITY_CAPTIONING_WINDOW_COLOR,
-b master501eec92009-07-06 13:53:11 -07006073 TTS_USE_DEFAULTS,
6074 TTS_DEFAULT_RATE,
6075 TTS_DEFAULT_PITCH,
6076 TTS_DEFAULT_SYNTH,
6077 TTS_DEFAULT_LANG,
6078 TTS_DEFAULT_COUNTRY,
Charles Chenceffa152010-03-16 21:18:10 -07006079 TTS_ENABLED_PLUGINS,
Narayan Kamath6d632962011-08-24 11:51:37 +01006080 TTS_DEFAULT_LOCALE,
Anna Galuszafa7786c2015-12-22 10:53:44 -08006081 SHOW_IME_WITH_HARD_KEYBOARD,
Christopher Tate66488d62012-10-02 11:58:01 -07006082 WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON, // moved to global
6083 WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY, // moved to global
6084 WIFI_NUM_OPEN_NETWORKS_KEPT, // moved to global
Christopher Tate06cbadd2015-03-16 18:29:42 -07006085 SELECTED_SPELL_CHECKER,
6086 SELECTED_SPELL_CHECKER_SUBTYPE,
6087 SPELL_CHECKER_ENABLED,
San Mehat87734d32010-01-08 12:53:06 -08006088 MOUNT_PLAY_NOTIFICATION_SND,
6089 MOUNT_UMS_AUTOSTART,
6090 MOUNT_UMS_PROMPT,
Dianne Hackborn2ccda4d2010-03-22 21:49:15 -07006091 MOUNT_UMS_NOTIFY_ENABLED,
Jason Monk27bbb2d2015-03-31 16:46:39 -04006092 SLEEP_TIMEOUT,
6093 DOUBLE_TAP_TO_WAKE,
Anna Galuszafa7786c2015-12-22 10:53:44 -08006094 WAKE_GESTURE_ENABLED,
6095 LONG_PRESS_TIMEOUT,
Jason Monk5a5e7d62015-08-04 11:20:25 -04006096 CAMERA_GESTURE_DISABLED,
Toni Barzic386f8342015-09-09 12:30:41 -07006097 ACCESSIBILITY_AUTOCLICK_ENABLED,
Anna Galuszafa7786c2015-12-22 10:53:44 -08006098 ACCESSIBILITY_AUTOCLICK_DELAY,
6099 ACCESSIBILITY_LARGE_POINTER_ICON,
6100 PREFERRED_TTY_MODE,
6101 ENHANCED_VOICE_PRIVACY_ENABLED,
6102 TTY_MODE_ENABLED,
6103 INCALL_POWER_BUTTON_BEHAVIOR
-b master501eec92009-07-06 13:53:11 -07006104 };
6105
6106 /**
Amith Yamasani4f7e2e32014-08-14 18:49:48 -07006107 * These entries are considered common between the personal and the managed profile,
6108 * since the managed profile doesn't get to change them.
Amith Yamasani4f7e2e32014-08-14 18:49:48 -07006109 */
Svetoslav683914b2015-01-15 14:22:26 -08006110 private static final Set<String> CLONE_TO_MANAGED_PROFILE = new ArraySet<>();
Amith Yamasanib0ff3222015-03-04 09:56:14 -08006111
Svetoslav683914b2015-01-15 14:22:26 -08006112 static {
6113 CLONE_TO_MANAGED_PROFILE.add(ACCESSIBILITY_ENABLED);
6114 CLONE_TO_MANAGED_PROFILE.add(ALLOW_MOCK_LOCATION);
6115 CLONE_TO_MANAGED_PROFILE.add(ALLOWED_GEOLOCATION_ORIGINS);
6116 CLONE_TO_MANAGED_PROFILE.add(DEFAULT_INPUT_METHOD);
6117 CLONE_TO_MANAGED_PROFILE.add(ENABLED_ACCESSIBILITY_SERVICES);
6118 CLONE_TO_MANAGED_PROFILE.add(ENABLED_INPUT_METHODS);
6119 CLONE_TO_MANAGED_PROFILE.add(LOCATION_MODE);
Lifu Tangd1fa1d62015-11-25 21:42:44 -08006120 CLONE_TO_MANAGED_PROFILE.add(LOCATION_PREVIOUS_MODE);
Svetoslav683914b2015-01-15 14:22:26 -08006121 CLONE_TO_MANAGED_PROFILE.add(LOCATION_PROVIDERS_ALLOWED);
Svetoslav683914b2015-01-15 14:22:26 -08006122 CLONE_TO_MANAGED_PROFILE.add(SELECTED_INPUT_METHOD_SUBTYPE);
6123 CLONE_TO_MANAGED_PROFILE.add(SELECTED_SPELL_CHECKER);
6124 CLONE_TO_MANAGED_PROFILE.add(SELECTED_SPELL_CHECKER_SUBTYPE);
6125 }
6126
6127 /** @hide */
6128 public static void getCloneToManagedProfileSettings(Set<String> outKeySet) {
6129 outKeySet.addAll(CLONE_TO_MANAGED_PROFILE);
6130 }
Amith Yamasani4f7e2e32014-08-14 18:49:48 -07006131
6132 /**
Mike Lockwoodbd2a7122009-04-02 23:41:33 -07006133 * Helper method for determining if a location provider is enabled.
Tom O'Neilld5759432013-09-11 11:03:03 -07006134 *
Mike Lockwoodbd2a7122009-04-02 23:41:33 -07006135 * @param cr the content resolver to use
6136 * @param provider the location provider to query
6137 * @return true if the provider is enabled
Tom O'Neilld5759432013-09-11 11:03:03 -07006138 *
6139 * @deprecated use {@link #LOCATION_MODE} or
6140 * {@link LocationManager#isProviderEnabled(String)}
Mike Lockwoodbd2a7122009-04-02 23:41:33 -07006141 */
Tom O'Neill1f48b782013-08-19 18:14:56 -07006142 @Deprecated
Mike Lockwoodbd2a7122009-04-02 23:41:33 -07006143 public static final boolean isLocationProviderEnabled(ContentResolver cr, String provider) {
Victoria Leaseb711d572012-10-02 13:14:11 -07006144 return isLocationProviderEnabledForUser(cr, provider, UserHandle.myUserId());
6145 }
6146
6147 /**
6148 * Helper method for determining if a location provider is enabled.
6149 * @param cr the content resolver to use
6150 * @param provider the location provider to query
6151 * @param userId the userId to query
6152 * @return true if the provider is enabled
Tom O'Neilld5759432013-09-11 11:03:03 -07006153 * @deprecated use {@link #LOCATION_MODE} or
6154 * {@link LocationManager#isProviderEnabled(String)}
Victoria Leaseb711d572012-10-02 13:14:11 -07006155 * @hide
6156 */
Tom O'Neill1f48b782013-08-19 18:14:56 -07006157 @Deprecated
Victoria Leaseb711d572012-10-02 13:14:11 -07006158 public static final boolean isLocationProviderEnabledForUser(ContentResolver cr, String provider, int userId) {
6159 String allowedProviders = Settings.Secure.getStringForUser(cr,
6160 LOCATION_PROVIDERS_ALLOWED, userId);
Brad Fitzpatrick11fe1812010-09-10 16:07:52 -07006161 return TextUtils.delimitedStringContains(allowedProviders, ',', provider);
Mike Lockwoodbd2a7122009-04-02 23:41:33 -07006162 }
6163
6164 /**
6165 * Thread-safe method for enabling or disabling a single location provider.
6166 * @param cr the content resolver to use
6167 * @param provider the location provider to enable or disable
6168 * @param enabled true if the provider should be enabled
Tom O'Neilla324ac72013-08-26 14:40:23 -07006169 * @deprecated use {@link #putInt(ContentResolver, String, int)} and {@link #LOCATION_MODE}
Mike Lockwoodbd2a7122009-04-02 23:41:33 -07006170 */
Tom O'Neill1f48b782013-08-19 18:14:56 -07006171 @Deprecated
Mike Lockwoodbd2a7122009-04-02 23:41:33 -07006172 public static final void setLocationProviderEnabled(ContentResolver cr,
6173 String provider, boolean enabled) {
Victoria Leaseb711d572012-10-02 13:14:11 -07006174 setLocationProviderEnabledForUser(cr, provider, enabled, UserHandle.myUserId());
6175 }
6176
6177 /**
6178 * Thread-safe method for enabling or disabling a single location provider.
Tom O'Neilla324ac72013-08-26 14:40:23 -07006179 *
Victoria Leaseb711d572012-10-02 13:14:11 -07006180 * @param cr the content resolver to use
6181 * @param provider the location provider to enable or disable
6182 * @param enabled true if the provider should be enabled
6183 * @param userId the userId for which to enable/disable providers
Tom O'Neilla324ac72013-08-26 14:40:23 -07006184 * @return true if the value was set, false on database errors
6185 * @deprecated use {@link #putIntForUser(ContentResolver, String, int, int)} and
6186 * {@link #LOCATION_MODE}
Victoria Leaseb711d572012-10-02 13:14:11 -07006187 * @hide
6188 */
Tom O'Neill1f48b782013-08-19 18:14:56 -07006189 @Deprecated
Tom O'Neilla324ac72013-08-26 14:40:23 -07006190 public static final boolean setLocationProviderEnabledForUser(ContentResolver cr,
Victoria Leaseb711d572012-10-02 13:14:11 -07006191 String provider, boolean enabled, int userId) {
David Christie3f7b6522013-08-06 19:19:08 -07006192 synchronized (mLocationSettingsLock) {
6193 // to ensure thread safety, we write the provider name with a '+' or '-'
6194 // and let the SettingsProvider handle it rather than reading and modifying
6195 // the list of enabled providers.
6196 if (enabled) {
6197 provider = "+" + provider;
6198 } else {
6199 provider = "-" + provider;
6200 }
Tom O'Neilla324ac72013-08-26 14:40:23 -07006201 return putStringForUser(cr, Settings.Secure.LOCATION_PROVIDERS_ALLOWED, provider,
David Christie3f7b6522013-08-06 19:19:08 -07006202 userId);
Mike Lockwoodbd2a7122009-04-02 23:41:33 -07006203 }
Mike Lockwoodbd2a7122009-04-02 23:41:33 -07006204 }
Tom O'Neill1f48b782013-08-19 18:14:56 -07006205
6206 /**
Lifu Tangd1fa1d62015-11-25 21:42:44 -08006207 * Saves the current location mode into {@link #LOCATION_PREVIOUS_MODE}.
6208 */
6209 private static final boolean saveLocationModeForUser(ContentResolver cr, int userId) {
6210 final int mode = getLocationModeForUser(cr, userId);
6211 return putIntForUser(cr, Settings.Secure.LOCATION_PREVIOUS_MODE, mode, userId);
6212 }
6213
6214 /**
6215 * Restores the current location mode from {@link #LOCATION_PREVIOUS_MODE}.
6216 */
6217 private static final boolean restoreLocationModeForUser(ContentResolver cr, int userId) {
6218 int mode = getIntForUser(cr, Settings.Secure.LOCATION_PREVIOUS_MODE,
6219 LOCATION_MODE_HIGH_ACCURACY, userId);
6220 // Make sure that the previous mode is never "off". Otherwise the user won't be able to
6221 // turn on location any longer.
6222 if (mode == LOCATION_MODE_OFF) {
6223 mode = LOCATION_MODE_HIGH_ACCURACY;
6224 }
6225 return setLocationModeForUser(cr, mode, userId);
6226 }
6227
6228 /**
Tom O'Neill1f48b782013-08-19 18:14:56 -07006229 * Thread-safe method for setting the location mode to one of
6230 * {@link #LOCATION_MODE_HIGH_ACCURACY}, {@link #LOCATION_MODE_SENSORS_ONLY},
6231 * {@link #LOCATION_MODE_BATTERY_SAVING}, or {@link #LOCATION_MODE_OFF}.
6232 *
Tom O'Neill1f48b782013-08-19 18:14:56 -07006233 * @param cr the content resolver to use
6234 * @param mode such as {@link #LOCATION_MODE_HIGH_ACCURACY}
6235 * @param userId the userId for which to change mode
Tom O'Neilla324ac72013-08-26 14:40:23 -07006236 * @return true if the value was set, false on database errors
Tom O'Neill1f48b782013-08-19 18:14:56 -07006237 *
6238 * @throws IllegalArgumentException if mode is not one of the supported values
6239 */
Tom O'Neill7f6f4572013-08-27 10:53:15 -07006240 private static final boolean setLocationModeForUser(ContentResolver cr, int mode,
6241 int userId) {
Tom O'Neill1f48b782013-08-19 18:14:56 -07006242 synchronized (mLocationSettingsLock) {
6243 boolean gps = false;
6244 boolean network = false;
6245 switch (mode) {
Lifu Tangd1fa1d62015-11-25 21:42:44 -08006246 case LOCATION_MODE_PREVIOUS:
6247 // Retrieve the actual mode and set to that mode.
6248 return restoreLocationModeForUser(cr, userId);
Tom O'Neill1f48b782013-08-19 18:14:56 -07006249 case LOCATION_MODE_OFF:
Lifu Tangd1fa1d62015-11-25 21:42:44 -08006250 saveLocationModeForUser(cr, userId);
Tom O'Neill1f48b782013-08-19 18:14:56 -07006251 break;
6252 case LOCATION_MODE_SENSORS_ONLY:
6253 gps = true;
6254 break;
6255 case LOCATION_MODE_BATTERY_SAVING:
6256 network = true;
6257 break;
6258 case LOCATION_MODE_HIGH_ACCURACY:
6259 gps = true;
6260 network = true;
6261 break;
6262 default:
6263 throw new IllegalArgumentException("Invalid location mode: " + mode);
6264 }
Tom O'Neill7731a992014-10-09 11:30:49 -07006265 // Note it's important that we set the NLP mode first. The Google implementation
6266 // of NLP clears its NLP consent setting any time it receives a
6267 // LocationManager.PROVIDERS_CHANGED_ACTION broadcast and NLP is disabled. Also,
6268 // it shows an NLP consent dialog any time it receives the broadcast, NLP is
6269 // enabled, and the NLP consent is not set. If 1) we were to enable GPS first,
6270 // 2) a setup wizard has its own NLP consent UI that sets the NLP consent setting,
6271 // and 3) the receiver happened to complete before we enabled NLP, then the Google
6272 // NLP would detect the attempt to enable NLP and show a redundant NLP consent
6273 // dialog. Then the people who wrote the setup wizard would be sad.
Tom O'Neilla324ac72013-08-26 14:40:23 -07006274 boolean nlpSuccess = Settings.Secure.setLocationProviderEnabledForUser(
Tom O'Neill1f48b782013-08-19 18:14:56 -07006275 cr, LocationManager.NETWORK_PROVIDER, network, userId);
Tom O'Neill7731a992014-10-09 11:30:49 -07006276 boolean gpsSuccess = Settings.Secure.setLocationProviderEnabledForUser(
6277 cr, LocationManager.GPS_PROVIDER, gps, userId);
Tom O'Neilla324ac72013-08-26 14:40:23 -07006278 return gpsSuccess && nlpSuccess;
Tom O'Neill1f48b782013-08-19 18:14:56 -07006279 }
6280 }
6281
6282 /**
Tom O'Neill1f48b782013-08-19 18:14:56 -07006283 * Thread-safe method for reading the location mode, returns one of
6284 * {@link #LOCATION_MODE_HIGH_ACCURACY}, {@link #LOCATION_MODE_SENSORS_ONLY},
6285 * {@link #LOCATION_MODE_BATTERY_SAVING}, or {@link #LOCATION_MODE_OFF}.
6286 *
6287 * @param cr the content resolver to use
6288 * @param userId the userId for which to read the mode
6289 * @return the location mode
6290 */
Tom O'Neill7f6f4572013-08-27 10:53:15 -07006291 private static final int getLocationModeForUser(ContentResolver cr, int userId) {
Tom O'Neill1f48b782013-08-19 18:14:56 -07006292 synchronized (mLocationSettingsLock) {
6293 boolean gpsEnabled = Settings.Secure.isLocationProviderEnabledForUser(
6294 cr, LocationManager.GPS_PROVIDER, userId);
6295 boolean networkEnabled = Settings.Secure.isLocationProviderEnabledForUser(
6296 cr, LocationManager.NETWORK_PROVIDER, userId);
6297 if (gpsEnabled && networkEnabled) {
6298 return LOCATION_MODE_HIGH_ACCURACY;
6299 } else if (gpsEnabled) {
6300 return LOCATION_MODE_SENSORS_ONLY;
6301 } else if (networkEnabled) {
6302 return LOCATION_MODE_BATTERY_SAVING;
6303 } else {
6304 return LOCATION_MODE_OFF;
6305 }
6306 }
6307 }
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08006308 }
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07006309
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08006310 /**
Christopher Tate06efb532012-08-24 15:29:27 -07006311 * Global system settings, containing preferences that always apply identically
6312 * to all defined users. Applications can read these but are not allowed to write;
6313 * like the "Secure" settings, these are for preferences that the user must
6314 * explicitly modify through the system UI or specialized APIs for those values.
6315 */
6316 public static final class Global extends NameValueTable {
6317 public static final String SYS_PROP_SETTING_VERSION = "sys.settings_global_version";
6318
6319 /**
6320 * The content:// style URL for global secure settings items. Not public.
6321 */
6322 public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/global");
6323
6324 /**
Amith Yamasani23a0f052014-07-25 12:26:53 -07006325 * Whether users are allowed to add more users or guest from lockscreen.
6326 * <p>
6327 * Type: int
6328 * @hide
6329 */
6330 public static final String ADD_USERS_WHEN_LOCKED = "add_users_when_locked";
6331
6332 /**
Svetoslav Ganov7befb7d2012-09-27 16:49:23 -07006333 * Setting whether the global gesture for enabling accessibility is enabled.
6334 * If this gesture is enabled the user will be able to perfrom it to enable
6335 * the accessibility state without visiting the settings app.
6336 * @hide
6337 */
6338 public static final String ENABLE_ACCESSIBILITY_GLOBAL_GESTURE_ENABLED =
6339 "enable_accessibility_global_gesture_enabled";
6340
6341 /**
Christopher Tate06efb532012-08-24 15:29:27 -07006342 * Whether Airplane Mode is on.
6343 */
6344 public static final String AIRPLANE_MODE_ON = "airplane_mode_on";
6345
6346 /**
Bryce Lee584a4452014-10-21 15:55:55 -07006347 * Whether Theater Mode is on.
6348 * {@hide}
6349 */
Bryce Leecdfebd62015-02-02 08:19:11 -08006350 @SystemApi
Bryce Lee584a4452014-10-21 15:55:55 -07006351 public static final String THEATER_MODE_ON = "theater_mode_on";
6352
6353 /**
Christopher Tate06efb532012-08-24 15:29:27 -07006354 * Constant for use in AIRPLANE_MODE_RADIOS to specify Bluetooth radio.
6355 */
6356 public static final String RADIO_BLUETOOTH = "bluetooth";
6357
6358 /**
6359 * Constant for use in AIRPLANE_MODE_RADIOS to specify Wi-Fi radio.
6360 */
6361 public static final String RADIO_WIFI = "wifi";
6362
6363 /**
6364 * {@hide}
6365 */
6366 public static final String RADIO_WIMAX = "wimax";
6367 /**
6368 * Constant for use in AIRPLANE_MODE_RADIOS to specify Cellular radio.
6369 */
6370 public static final String RADIO_CELL = "cell";
6371
6372 /**
6373 * Constant for use in AIRPLANE_MODE_RADIOS to specify NFC radio.
6374 */
6375 public static final String RADIO_NFC = "nfc";
6376
6377 /**
6378 * A comma separated list of radios that need to be disabled when airplane mode
6379 * is on. This overrides WIFI_ON and BLUETOOTH_ON, if Wi-Fi and bluetooth are
6380 * included in the comma separated list.
6381 */
6382 public static final String AIRPLANE_MODE_RADIOS = "airplane_mode_radios";
6383
6384 /**
6385 * A comma separated list of radios that should to be disabled when airplane mode
6386 * is on, but can be manually reenabled by the user. For example, if RADIO_WIFI is
6387 * added to both AIRPLANE_MODE_RADIOS and AIRPLANE_MODE_TOGGLEABLE_RADIOS, then Wifi
6388 * will be turned off when entering airplane mode, but the user will be able to reenable
6389 * Wifi in the Settings app.
6390 *
6391 * {@hide}
6392 */
6393 public static final String AIRPLANE_MODE_TOGGLEABLE_RADIOS = "airplane_mode_toggleable_radios";
6394
6395 /**
Bryce Leeec85f342015-12-16 13:32:28 -08006396 * A Long representing a bitmap of profiles that should be disabled when bluetooth starts.
6397 * See {@link android.bluetooth.BluetoothProfile}.
6398 * {@hide}
6399 */
6400 public static final String BLUETOOTH_DISABLED_PROFILES = "bluetooth_disabled_profiles";
6401
6402 /**
Andre Eisenbach82a94d92016-01-14 14:20:34 -08006403 * A semi-colon separated list of Bluetooth interoperability workarounds.
6404 * Each entry is a partial Bluetooth device address string and an integer representing
6405 * the feature to be disabled, separated by a comma. The integer must correspond
6406 * to a interoperability feature as defined in "interop.h" in /system/bt.
6407 * <p>
6408 * Example: <br/>
6409 * "00:11:22,0;01:02:03:04,2"
6410 * @hide
6411 */
6412 public static final String BLUETOOTH_INTEROPERABILITY_LIST = "bluetooth_interoperability_list";
6413
6414 /**
Christopher Tate06efb532012-08-24 15:29:27 -07006415 * The policy for deciding when Wi-Fi should go to sleep (which will in
6416 * turn switch to using the mobile data as an Internet connection).
6417 * <p>
6418 * Set to one of {@link #WIFI_SLEEP_POLICY_DEFAULT},
6419 * {@link #WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED}, or
6420 * {@link #WIFI_SLEEP_POLICY_NEVER}.
6421 */
6422 public static final String WIFI_SLEEP_POLICY = "wifi_sleep_policy";
6423
6424 /**
6425 * Value for {@link #WIFI_SLEEP_POLICY} to use the default Wi-Fi sleep
6426 * policy, which is to sleep shortly after the turning off
6427 * according to the {@link #STAY_ON_WHILE_PLUGGED_IN} setting.
6428 */
6429 public static final int WIFI_SLEEP_POLICY_DEFAULT = 0;
6430
6431 /**
6432 * Value for {@link #WIFI_SLEEP_POLICY} to use the default policy when
6433 * the device is on battery, and never go to sleep when the device is
6434 * plugged in.
6435 */
6436 public static final int WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED = 1;
6437
6438 /**
6439 * Value for {@link #WIFI_SLEEP_POLICY} to never go to sleep.
6440 */
6441 public static final int WIFI_SLEEP_POLICY_NEVER = 2;
6442
6443 /**
6444 * Value to specify if the user prefers the date, time and time zone
6445 * to be automatically fetched from the network (NITZ). 1=yes, 0=no
6446 */
6447 public static final String AUTO_TIME = "auto_time";
6448
6449 /**
6450 * Value to specify if the user prefers the time zone
6451 * to be automatically fetched from the network (NITZ). 1=yes, 0=no
6452 */
6453 public static final String AUTO_TIME_ZONE = "auto_time_zone";
6454
6455 /**
6456 * URI for the car dock "in" event sound.
6457 * @hide
6458 */
6459 public static final String CAR_DOCK_SOUND = "car_dock_sound";
6460
6461 /**
6462 * URI for the car dock "out" event sound.
6463 * @hide
6464 */
6465 public static final String CAR_UNDOCK_SOUND = "car_undock_sound";
6466
6467 /**
6468 * URI for the desk dock "in" event sound.
6469 * @hide
6470 */
6471 public static final String DESK_DOCK_SOUND = "desk_dock_sound";
6472
6473 /**
6474 * URI for the desk dock "out" event sound.
6475 * @hide
6476 */
6477 public static final String DESK_UNDOCK_SOUND = "desk_undock_sound";
6478
6479 /**
6480 * Whether to play a sound for dock events.
6481 * @hide
6482 */
6483 public static final String DOCK_SOUNDS_ENABLED = "dock_sounds_enabled";
6484
6485 /**
6486 * URI for the "device locked" (keyguard shown) sound.
6487 * @hide
6488 */
6489 public static final String LOCK_SOUND = "lock_sound";
6490
6491 /**
6492 * URI for the "device unlocked" sound.
6493 * @hide
6494 */
6495 public static final String UNLOCK_SOUND = "unlock_sound";
6496
6497 /**
Adrian Roos49e057d2014-08-13 17:14:51 +02006498 * URI for the "device is trusted" sound, which is played when the device enters the trusted
6499 * state without unlocking.
6500 * @hide
6501 */
6502 public static final String TRUSTED_SOUND = "trusted_sound";
6503
6504 /**
Christopher Tate06efb532012-08-24 15:29:27 -07006505 * URI for the low battery sound file.
6506 * @hide
6507 */
6508 public static final String LOW_BATTERY_SOUND = "low_battery_sound";
6509
6510 /**
6511 * Whether to play a sound for low-battery alerts.
6512 * @hide
6513 */
6514 public static final String POWER_SOUNDS_ENABLED = "power_sounds_enabled";
6515
6516 /**
Jeff Brown84e27562012-12-07 13:56:34 -08006517 * URI for the "wireless charging started" sound.
6518 * @hide
6519 */
6520 public static final String WIRELESS_CHARGING_STARTED_SOUND =
6521 "wireless_charging_started_sound";
6522
6523 /**
John Spurlock51a871d2015-05-06 17:41:30 -04006524 * Whether to play a sound for charging events.
6525 * @hide
6526 */
6527 public static final String CHARGING_SOUNDS_ENABLED = "charging_sounds_enabled";
6528
6529 /**
Christopher Tate06efb532012-08-24 15:29:27 -07006530 * Whether we keep the device on while the device is plugged in.
6531 * Supported values are:
6532 * <ul>
6533 * <li>{@code 0} to never stay on while plugged in</li>
6534 * <li>{@link BatteryManager#BATTERY_PLUGGED_AC} to stay on for AC charger</li>
6535 * <li>{@link BatteryManager#BATTERY_PLUGGED_USB} to stay on for USB charger</li>
6536 * <li>{@link BatteryManager#BATTERY_PLUGGED_WIRELESS} to stay on for wireless charger</li>
6537 * </ul>
6538 * These values can be OR-ed together.
6539 */
6540 public static final String STAY_ON_WHILE_PLUGGED_IN = "stay_on_while_plugged_in";
6541
6542 /**
Christopher Tate58f41ec2013-01-11 15:40:36 -08006543 * When the user has enable the option to have a "bug report" command
6544 * in the power menu.
6545 * @hide
6546 */
6547 public static final String BUGREPORT_IN_POWER_MENU = "bugreport_in_power_menu";
6548
6549 /**
Christopher Tate06efb532012-08-24 15:29:27 -07006550 * Whether ADB is enabled.
6551 */
6552 public static final String ADB_ENABLED = "adb_enabled";
6553
6554 /**
Jon Miranda836c0a82014-08-11 12:32:26 -07006555 * Whether Views are allowed to save their attribute data.
6556 * @hide
6557 */
6558 public static final String DEBUG_VIEW_ATTRIBUTES = "debug_view_attributes";
6559
6560 /**
Christopher Tate06efb532012-08-24 15:29:27 -07006561 * Whether assisted GPS should be enabled or not.
6562 * @hide
6563 */
6564 public static final String ASSISTED_GPS_ENABLED = "assisted_gps_enabled";
6565
6566 /**
6567 * Whether bluetooth is enabled/disabled
6568 * 0=disabled. 1=enabled.
6569 */
6570 public static final String BLUETOOTH_ON = "bluetooth_on";
6571
6572 /**
6573 * CDMA Cell Broadcast SMS
6574 * 0 = CDMA Cell Broadcast SMS disabled
6575 * 1 = CDMA Cell Broadcast SMS enabled
6576 * @hide
6577 */
6578 public static final String CDMA_CELL_BROADCAST_SMS =
6579 "cdma_cell_broadcast_sms";
6580
6581 /**
6582 * The CDMA roaming mode 0 = Home Networks, CDMA default
6583 * 1 = Roaming on Affiliated networks
6584 * 2 = Roaming on any networks
6585 * @hide
6586 */
6587 public static final String CDMA_ROAMING_MODE = "roaming_settings";
6588
6589 /**
6590 * The CDMA subscription mode 0 = RUIM/SIM (default)
6591 * 1 = NV
6592 * @hide
6593 */
6594 public static final String CDMA_SUBSCRIPTION_MODE = "subscription_mode";
6595
6596 /** Inactivity timeout to track mobile data activity.
6597 *
6598 * If set to a positive integer, it indicates the inactivity timeout value in seconds to
6599 * infer the data activity of mobile network. After a period of no activity on mobile
6600 * networks with length specified by the timeout, an {@code ACTION_DATA_ACTIVITY_CHANGE}
6601 * intent is fired to indicate a transition of network status from "active" to "idle". Any
6602 * subsequent activity on mobile networks triggers the firing of {@code
6603 * ACTION_DATA_ACTIVITY_CHANGE} intent indicating transition from "idle" to "active".
6604 *
6605 * Network activity refers to transmitting or receiving data on the network interfaces.
6606 *
6607 * Tracking is disabled if set to zero or negative value.
6608 *
6609 * @hide
6610 */
6611 public static final String DATA_ACTIVITY_TIMEOUT_MOBILE = "data_activity_timeout_mobile";
6612
6613 /** Timeout to tracking Wifi data activity. Same as {@code DATA_ACTIVITY_TIMEOUT_MOBILE}
6614 * but for Wifi network.
6615 * @hide
6616 */
6617 public static final String DATA_ACTIVITY_TIMEOUT_WIFI = "data_activity_timeout_wifi";
6618
6619 /**
6620 * Whether or not data roaming is enabled. (0 = false, 1 = true)
6621 */
6622 public static final String DATA_ROAMING = "data_roaming";
6623
6624 /**
Wink Saville75c1e692013-03-20 17:06:50 -07006625 * The value passed to a Mobile DataConnection via bringUp which defines the
6626 * number of retries to preform when setting up the initial connection. The default
6627 * value defined in DataConnectionTrackerBase#DEFAULT_MDC_INITIAL_RETRY is currently 1.
6628 * @hide
6629 */
6630 public static final String MDC_INITIAL_MAX_RETRY = "mdc_initial_max_retry";
6631
6632 /**
Todd Kennedyf39ca8f2015-08-07 14:15:07 -07006633 * Whether any package can be on external storage. When this is true, any
6634 * package, regardless of manifest values, is a candidate for installing
6635 * or moving onto external storage. (0 = false, 1 = true)
6636 * @hide
6637 */
6638 public static final String FORCE_ALLOW_ON_EXTERNAL = "force_allow_on_external";
6639
Jorim Jaggi8ccdf3a2015-10-22 12:50:31 +02006640 /**
6641 * Whether any activity can be resized. When this is true, any
6642 * activity, regardless of manifest values, can be resized for multi-window.
6643 * (0 = false, 1 = true)
6644 * @hide
6645 */
6646 public static final String DEVELOPMENT_FORCE_RESIZABLE_ACTIVITIES
6647 = "force_resizable_activities";
6648
Jorim Jaggi6f2efd32015-12-23 12:04:39 +01006649 /**
6650 * Whether to enable experimental freeform support for windows.
6651 * @hide
6652 */
6653 public static final String DEVELOPMENT_ENABLE_FREEFORM_WINDOWS_SUPPORT
6654 = "enable_freeform_support";
6655
Todd Kennedyf39ca8f2015-08-07 14:15:07 -07006656 /**
Christopher Tate06efb532012-08-24 15:29:27 -07006657 * Whether user has enabled development settings.
6658 */
6659 public static final String DEVELOPMENT_SETTINGS_ENABLED = "development_settings_enabled";
6660
6661 /**
Amith Yamasanicb15d662015-11-10 11:11:15 -08006662 * Whether the device has been provisioned (0 = false, 1 = true).
6663 * <p>On a multiuser device with a separate system user, the screen may be locked
6664 * as soon as this is set to true and further activities cannot be launched on the
6665 * system user unless they are marked to show over keyguard.
Christopher Tate06efb532012-08-24 15:29:27 -07006666 */
6667 public static final String DEVICE_PROVISIONED = "device_provisioned";
6668
6669 /**
Christopher Tate06efb532012-08-24 15:29:27 -07006670 * The saved value for WindowManagerService.setForcedDisplaySize().
6671 * Two integers separated by a comma. If unset, then use the real display size.
6672 * @hide
6673 */
6674 public static final String DISPLAY_SIZE_FORCED = "display_size_forced";
6675
6676 /**
Jeff Brownd46747a2015-04-15 19:02:36 -07006677 * The saved value for WindowManagerService.setForcedDisplayScalingMode().
6678 * 0 or unset if scaling is automatic, 1 if scaling is disabled.
6679 * @hide
6680 */
6681 public static final String DISPLAY_SCALING_FORCE = "display_scaling_force";
6682
6683 /**
Christopher Tate06efb532012-08-24 15:29:27 -07006684 * The maximum size, in bytes, of a download that the download manager will transfer over
6685 * a non-wifi connection.
6686 * @hide
6687 */
6688 public static final String DOWNLOAD_MAX_BYTES_OVER_MOBILE =
6689 "download_manager_max_bytes_over_mobile";
6690
6691 /**
6692 * The recommended maximum size, in bytes, of a download that the download manager should
6693 * transfer over a non-wifi connection. Over this size, the use will be warned, but will
6694 * have the option to start the download over the mobile connection anyway.
6695 * @hide
6696 */
6697 public static final String DOWNLOAD_RECOMMENDED_MAX_BYTES_OVER_MOBILE =
6698 "download_manager_recommended_max_bytes_over_mobile";
6699
6700 /**
Christopher Tateaa036a22014-05-19 16:33:27 -07006701 * @deprecated Use {@link android.provider.Settings.Secure#INSTALL_NON_MARKET_APPS} instead
Christopher Tate06efb532012-08-24 15:29:27 -07006702 */
Christopher Tateaa036a22014-05-19 16:33:27 -07006703 @Deprecated
6704 public static final String INSTALL_NON_MARKET_APPS = Secure.INSTALL_NON_MARKET_APPS;
Christopher Tate06efb532012-08-24 15:29:27 -07006705
6706 /**
Jinsuk Kimb3d91772014-07-10 12:48:54 +09006707 * Whether HDMI control shall be enabled. If disabled, no CEC/MHL command will be
6708 * sent or processed. (0 = false, 1 = true)
6709 * @hide
6710 */
6711 public static final String HDMI_CONTROL_ENABLED = "hdmi_control_enabled";
6712
6713 /**
6714 * Whether HDMI system audio is enabled. If enabled, TV internal speaker is muted,
6715 * and the output is redirected to AV Receiver connected via
6716 * {@Global#HDMI_SYSTEM_AUDIO_OUTPUT}.
6717 * @hide
6718 */
6719 public static final String HDMI_SYSTEM_AUDIO_ENABLED = "hdmi_system_audio_enabled";
6720
6721 /**
Jinsuk Kimb3d91772014-07-10 12:48:54 +09006722 * Whether TV will automatically turn on upon reception of the CEC command
6723 * &lt;Text View On&gt; or &lt;Image View On&gt;. (0 = false, 1 = true)
6724 * @hide
6725 */
6726 public static final String HDMI_CONTROL_AUTO_WAKEUP_ENABLED =
6727 "hdmi_control_auto_wakeup_enabled";
6728
6729 /**
6730 * Whether TV will also turn off other CEC devices when it goes to standby mode.
6731 * (0 = false, 1 = true)
6732 * @hide
6733 */
6734 public static final String HDMI_CONTROL_AUTO_DEVICE_OFF_ENABLED =
6735 "hdmi_control_auto_device_off_enabled";
6736
6737 /**
Lorenzo Colitti06d7e532015-03-16 23:46:24 +09006738 * Whether to use the DHCP client from Lollipop and earlier instead of the newer Android DHCP
6739 * client.
6740 * (0 = false, 1 = true)
6741 * @hide
6742 */
6743 public static final String LEGACY_DHCP_CLIENT = "legacy_dhcp_client";
6744
6745 /**
Jinsuk Kimb3d91772014-07-10 12:48:54 +09006746 * Whether TV will switch to MHL port when a mobile device is plugged in.
6747 * (0 = false, 1 = true)
6748 * @hide
6749 */
6750 public static final String MHL_INPUT_SWITCHING_ENABLED = "mhl_input_switching_enabled";
6751
6752 /**
6753 * Whether TV will charge the mobile device connected at MHL port. (0 = false, 1 = true)
6754 * @hide
6755 */
6756 public static final String MHL_POWER_CHARGE_ENABLED = "mhl_power_charge_enabled";
6757
6758 /**
Christopher Tate06efb532012-08-24 15:29:27 -07006759 * Whether mobile data connections are allowed by the user. See
6760 * ConnectivityManager for more info.
6761 * @hide
6762 */
6763 public static final String MOBILE_DATA = "mobile_data";
6764
Erik Klineda4bfa82015-04-30 12:58:40 +09006765 /**
6766 * Whether the mobile data connection should remain active even when higher
6767 * priority networks like WiFi are active, to help make network switching faster.
6768 *
6769 * See ConnectivityService for more info.
6770 *
6771 * (0 = disabled, 1 = enabled)
6772 * @hide
6773 */
6774 public static final String MOBILE_DATA_ALWAYS_ON = "mobile_data_always_on";
6775
Christopher Tate06efb532012-08-24 15:29:27 -07006776 /** {@hide} */
6777 public static final String NETSTATS_ENABLED = "netstats_enabled";
6778 /** {@hide} */
6779 public static final String NETSTATS_POLL_INTERVAL = "netstats_poll_interval";
6780 /** {@hide} */
6781 public static final String NETSTATS_TIME_CACHE_MAX_AGE = "netstats_time_cache_max_age";
6782 /** {@hide} */
6783 public static final String NETSTATS_GLOBAL_ALERT_BYTES = "netstats_global_alert_bytes";
6784 /** {@hide} */
6785 public static final String NETSTATS_SAMPLE_ENABLED = "netstats_sample_enabled";
Christopher Tate06efb532012-08-24 15:29:27 -07006786
6787 /** {@hide} */
6788 public static final String NETSTATS_DEV_BUCKET_DURATION = "netstats_dev_bucket_duration";
6789 /** {@hide} */
6790 public static final String NETSTATS_DEV_PERSIST_BYTES = "netstats_dev_persist_bytes";
6791 /** {@hide} */
6792 public static final String NETSTATS_DEV_ROTATE_AGE = "netstats_dev_rotate_age";
6793 /** {@hide} */
6794 public static final String NETSTATS_DEV_DELETE_AGE = "netstats_dev_delete_age";
6795
6796 /** {@hide} */
6797 public static final String NETSTATS_UID_BUCKET_DURATION = "netstats_uid_bucket_duration";
6798 /** {@hide} */
6799 public static final String NETSTATS_UID_PERSIST_BYTES = "netstats_uid_persist_bytes";
6800 /** {@hide} */
6801 public static final String NETSTATS_UID_ROTATE_AGE = "netstats_uid_rotate_age";
6802 /** {@hide} */
6803 public static final String NETSTATS_UID_DELETE_AGE = "netstats_uid_delete_age";
6804
6805 /** {@hide} */
6806 public static final String NETSTATS_UID_TAG_BUCKET_DURATION = "netstats_uid_tag_bucket_duration";
6807 /** {@hide} */
6808 public static final String NETSTATS_UID_TAG_PERSIST_BYTES = "netstats_uid_tag_persist_bytes";
6809 /** {@hide} */
6810 public static final String NETSTATS_UID_TAG_ROTATE_AGE = "netstats_uid_tag_rotate_age";
6811 /** {@hide} */
6812 public static final String NETSTATS_UID_TAG_DELETE_AGE = "netstats_uid_tag_delete_age";
6813
6814 /**
6815 * User preference for which network(s) should be used. Only the
6816 * connectivity service should touch this.
6817 */
6818 public static final String NETWORK_PREFERENCE = "network_preference";
6819
6820 /**
Jeff Davidsondd6fd1e2014-04-14 15:14:30 -07006821 * Which package name to use for network scoring. If null, or if the package is not a valid
6822 * scorer app, external network scores will neither be requested nor accepted.
6823 * @hide
6824 */
6825 public static final String NETWORK_SCORER_APP = "network_scorer_app";
6826
6827 /**
Christopher Tate06efb532012-08-24 15:29:27 -07006828 * If the NITZ_UPDATE_DIFF time is exceeded then an automatic adjustment
6829 * to SystemClock will be allowed even if NITZ_UPDATE_SPACING has not been
6830 * exceeded.
6831 * @hide
6832 */
6833 public static final String NITZ_UPDATE_DIFF = "nitz_update_diff";
6834
6835 /**
6836 * The length of time in milli-seconds that automatic small adjustments to
6837 * SystemClock are ignored if NITZ_UPDATE_DIFF is not exceeded.
6838 * @hide
6839 */
6840 public static final String NITZ_UPDATE_SPACING = "nitz_update_spacing";
6841
6842 /** Preferred NTP server. {@hide} */
6843 public static final String NTP_SERVER = "ntp_server";
6844 /** Timeout in milliseconds to wait for NTP server. {@hide} */
6845 public static final String NTP_TIMEOUT = "ntp_timeout";
6846
Jeff Sharkeye8a4b662015-06-27 15:43:45 -07006847 /** {@hide} */
6848 public static final String STORAGE_BENCHMARK_INTERVAL = "storage_benchmark_interval";
6849
Christopher Tate06efb532012-08-24 15:29:27 -07006850 /**
Tao Baofdf7c5d2016-02-15 20:59:15 -08006851 * Whether to disable the automatic scheduling of system updates.
6852 * 1 = system updates won't be automatically scheduled (will always
6853 * present notification instead).
6854 * 0 = system updates will be automatically scheduled. (default)
6855 * @hide
6856 */
6857 @SystemApi
6858 public static final String OTA_DISABLE_AUTOMATIC_UPDATE = "ota_disable_automatic_update";
6859
6860 /**
rich cannings4d8fc792012-09-07 14:43:43 -07006861 * Whether the package manager should send package verification broadcasts for verifiers to
6862 * review apps prior to installation.
6863 * 1 = request apps to be verified prior to installation, if a verifier exists.
6864 * 0 = do not verify apps before installation
rich cannings4e5753f2012-09-19 16:03:56 -07006865 * @hide
rich cannings4d8fc792012-09-07 14:43:43 -07006866 */
6867 public static final String PACKAGE_VERIFIER_ENABLE = "package_verifier_enable";
6868
6869 /** Timeout for package verification.
rich cannings4e5753f2012-09-19 16:03:56 -07006870 * @hide */
rich cannings4d8fc792012-09-07 14:43:43 -07006871 public static final String PACKAGE_VERIFIER_TIMEOUT = "verifier_timeout";
6872
6873 /** Default response code for package verification.
rich cannings4e5753f2012-09-19 16:03:56 -07006874 * @hide */
rich cannings4d8fc792012-09-07 14:43:43 -07006875 public static final String PACKAGE_VERIFIER_DEFAULT_RESPONSE = "verifier_default_response";
6876
rich cannings4e5753f2012-09-19 16:03:56 -07006877 /**
6878 * Show package verification setting in the Settings app.
rich canningse6686b32012-09-16 14:02:20 -07006879 * 1 = show (default)
6880 * 0 = hide
rich cannings4e5753f2012-09-19 16:03:56 -07006881 * @hide
rich canningse6686b32012-09-16 14:02:20 -07006882 */
6883 public static final String PACKAGE_VERIFIER_SETTING_VISIBLE = "verifier_setting_visible";
6884
rich cannings4d8fc792012-09-07 14:43:43 -07006885 /**
Fabrice Di Meglio1c1b4712014-11-19 17:12:32 -08006886 * Run package verification on apps installed through ADB/ADT/USB
rich cannings4e5753f2012-09-19 16:03:56 -07006887 * 1 = perform package verification on ADB installs (default)
6888 * 0 = bypass package verification on ADB installs
6889 * @hide
6890 */
6891 public static final String PACKAGE_VERIFIER_INCLUDE_ADB = "verifier_verify_adb_installs";
6892
6893 /**
Christopher Tate7265abe2014-11-21 13:54:45 -08006894 * Time since last fstrim (milliseconds) after which we force one to happen
6895 * during device startup. If unset, the default is 3 days.
6896 * @hide
6897 */
6898 public static final String FSTRIM_MANDATORY_INTERVAL = "fstrim_mandatory_interval";
6899
6900 /**
Christopher Tate06efb532012-08-24 15:29:27 -07006901 * The interval in milliseconds at which to check packet counts on the
6902 * mobile data interface when screen is on, to detect possible data
6903 * connection problems.
6904 * @hide
6905 */
6906 public static final String PDP_WATCHDOG_POLL_INTERVAL_MS =
6907 "pdp_watchdog_poll_interval_ms";
6908
6909 /**
6910 * The interval in milliseconds at which to check packet counts on the
6911 * mobile data interface when screen is off, to detect possible data
6912 * connection problems.
6913 * @hide
6914 */
6915 public static final String PDP_WATCHDOG_LONG_POLL_INTERVAL_MS =
6916 "pdp_watchdog_long_poll_interval_ms";
6917
6918 /**
6919 * The interval in milliseconds at which to check packet counts on the
6920 * mobile data interface after {@link #PDP_WATCHDOG_TRIGGER_PACKET_COUNT}
6921 * outgoing packets has been reached without incoming packets.
6922 * @hide
6923 */
6924 public static final String PDP_WATCHDOG_ERROR_POLL_INTERVAL_MS =
6925 "pdp_watchdog_error_poll_interval_ms";
6926
6927 /**
6928 * The number of outgoing packets sent without seeing an incoming packet
6929 * that triggers a countdown (of {@link #PDP_WATCHDOG_ERROR_POLL_COUNT}
6930 * device is logged to the event log
6931 * @hide
6932 */
6933 public static final String PDP_WATCHDOG_TRIGGER_PACKET_COUNT =
6934 "pdp_watchdog_trigger_packet_count";
6935
6936 /**
6937 * The number of polls to perform (at {@link #PDP_WATCHDOG_ERROR_POLL_INTERVAL_MS})
6938 * after hitting {@link #PDP_WATCHDOG_TRIGGER_PACKET_COUNT} before
6939 * attempting data connection recovery.
6940 * @hide
6941 */
6942 public static final String PDP_WATCHDOG_ERROR_POLL_COUNT =
6943 "pdp_watchdog_error_poll_count";
6944
6945 /**
6946 * The number of failed PDP reset attempts before moving to something more
6947 * drastic: re-registering to the network.
6948 * @hide
6949 */
6950 public static final String PDP_WATCHDOG_MAX_PDP_RESET_FAIL_COUNT =
6951 "pdp_watchdog_max_pdp_reset_fail_count";
6952
6953 /**
6954 * A positive value indicates how often the SamplingProfiler
6955 * should take snapshots. Zero value means SamplingProfiler
6956 * is disabled.
6957 *
6958 * @hide
6959 */
6960 public static final String SAMPLING_PROFILER_MS = "sampling_profiler_ms";
6961
6962 /**
6963 * URL to open browser on to allow user to manage a prepay account
6964 * @hide
6965 */
6966 public static final String SETUP_PREPAID_DATA_SERVICE_URL =
6967 "setup_prepaid_data_service_url";
6968
6969 /**
6970 * URL to attempt a GET on to see if this is a prepay device
6971 * @hide
6972 */
6973 public static final String SETUP_PREPAID_DETECTION_TARGET_URL =
6974 "setup_prepaid_detection_target_url";
6975
6976 /**
6977 * Host to check for a redirect to after an attempt to GET
6978 * SETUP_PREPAID_DETECTION_TARGET_URL. (If we redirected there,
6979 * this is a prepaid device with zero balance.)
6980 * @hide
6981 */
6982 public static final String SETUP_PREPAID_DETECTION_REDIR_HOST =
6983 "setup_prepaid_detection_redir_host";
6984
6985 /**
Jake Hamby76a61422012-09-06 17:40:21 -07006986 * The interval in milliseconds at which to check the number of SMS sent out without asking
6987 * for use permit, to limit the un-authorized SMS usage.
6988 *
6989 * @hide
6990 */
6991 public static final String SMS_OUTGOING_CHECK_INTERVAL_MS =
6992 "sms_outgoing_check_interval_ms";
6993
6994 /**
6995 * The number of outgoing SMS sent without asking for user permit (of {@link
6996 * #SMS_OUTGOING_CHECK_INTERVAL_MS}
6997 *
6998 * @hide
6999 */
7000 public static final String SMS_OUTGOING_CHECK_MAX_COUNT =
7001 "sms_outgoing_check_max_count";
7002
7003 /**
7004 * Used to disable SMS short code confirmation - defaults to true.
Robert Greenwalt026efcc2012-09-24 10:03:21 -07007005 * True indcates we will do the check, etc. Set to false to disable.
Jake Hamby76a61422012-09-06 17:40:21 -07007006 * @see com.android.internal.telephony.SmsUsageMonitor
7007 * @hide
7008 */
7009 public static final String SMS_SHORT_CODE_CONFIRMATION = "sms_short_code_confirmation";
7010
Robert Greenwalt026efcc2012-09-24 10:03:21 -07007011 /**
7012 * Used to select which country we use to determine premium sms codes.
7013 * One of com.android.internal.telephony.SMSDispatcher.PREMIUM_RULE_USE_SIM,
7014 * com.android.internal.telephony.SMSDispatcher.PREMIUM_RULE_USE_NETWORK,
7015 * or com.android.internal.telephony.SMSDispatcher.PREMIUM_RULE_USE_BOTH.
7016 * @hide
7017 */
7018 public static final String SMS_SHORT_CODE_RULE = "sms_short_code_rule";
7019
Jake Hamby76a61422012-09-06 17:40:21 -07007020 /**
JP Abgrall32d1ac4d2014-02-21 12:05:20 -08007021 * Used to select TCP's default initial receiver window size in segments - defaults to a build config value
7022 * @hide
7023 */
7024 public static final String TCP_DEFAULT_INIT_RWND = "tcp_default_init_rwnd";
7025
7026 /**
Christopher Tate06efb532012-08-24 15:29:27 -07007027 * Used to disable Tethering on a device - defaults to true
7028 * @hide
7029 */
7030 public static final String TETHER_SUPPORTED = "tether_supported";
7031
7032 /**
7033 * Used to require DUN APN on the device or not - defaults to a build config value
7034 * which defaults to false
7035 * @hide
7036 */
7037 public static final String TETHER_DUN_REQUIRED = "tether_dun_required";
7038
7039 /**
7040 * Used to hold a gservices-provisioned apn value for DUN. If set, or the
7041 * corresponding build config values are set it will override the APN DB
7042 * values.
7043 * Consists of a comma seperated list of strings:
7044 * "name,apn,proxy,port,username,password,server,mmsc,mmsproxy,mmsport,mcc,mnc,auth,type"
7045 * note that empty fields can be ommitted: "name,apn,,,,,,,,,310,260,,DUN"
7046 * @hide
7047 */
7048 public static final String TETHER_DUN_APN = "tether_dun_apn";
7049
7050 /**
Junda Liu0c35fbc2016-01-19 23:20:15 -08007051 * List of carrier apps which are whitelisted to prompt the user for install when
7052 * a sim card with matching uicc carrier privilege rules is inserted.
7053 *
7054 * The value is "package1;package2;..."
7055 * @hide
7056 */
7057 public static final String CARRIER_APP_WHITELIST = "carrier_app_whitelist";
7058
7059 /**
Christopher Tate06efb532012-08-24 15:29:27 -07007060 * USB Mass Storage Enabled
7061 */
7062 public static final String USB_MASS_STORAGE_ENABLED = "usb_mass_storage_enabled";
7063
7064 /**
7065 * If this setting is set (to anything), then all references
7066 * to Gmail on the device must change to Google Mail.
7067 */
7068 public static final String USE_GOOGLE_MAIL = "use_google_mail";
7069
Hui Shu22671772014-10-01 21:41:07 +00007070 /**
7071 * Webview Data reduction proxy key.
7072 * @hide
7073 */
7074 public static final String WEBVIEW_DATA_REDUCTION_PROXY_KEY =
7075 "webview_data_reduction_proxy_key";
7076
Gustav Sennton14c033c2016-02-11 12:51:27 +00007077 /**
Gustav Senntonc83e3fa2016-02-18 12:19:13 +00007078 * Whether or not the WebView fallback mechanism should be enabled.
7079 * 0=disabled, 1=enabled.
7080 * @hide
7081 */
7082 public static final String WEBVIEW_FALLBACK_LOGIC_ENABLED =
7083 "webview_fallback_logic_enabled";
7084
7085 /**
Gustav Sennton14c033c2016-02-11 12:51:27 +00007086 * Name of the package used as WebView provider (if unset the provider is instead determined
7087 * by the system).
7088 * @hide
7089 */
7090 public static final String WEBVIEW_PROVIDER = "webview_provider";
7091
Tobias Sargeantda857102016-02-11 14:52:28 +00007092 /**
7093 * Developer setting to enable WebView multiprocess rendering.
7094 * @hide
7095 */
Tobias Sargeantadfded12016-02-22 13:45:34 +00007096 @SystemApi
Tobias Sargeantda857102016-02-11 14:52:28 +00007097 public static final String WEBVIEW_MULTIPROCESS = "webview_multiprocess";
7098
Christopher Tate06efb532012-08-24 15:29:27 -07007099 /**
Jeff Brown89d55462012-09-19 11:33:42 -07007100 * Whether Wifi display is enabled/disabled
7101 * 0=disabled. 1=enabled.
7102 * @hide
7103 */
7104 public static final String WIFI_DISPLAY_ON = "wifi_display_on";
7105
7106 /**
Chong Zhang1f3ecaa2013-05-03 15:55:36 -07007107 * Whether Wifi display certification mode is enabled/disabled
7108 * 0=disabled. 1=enabled.
7109 * @hide
7110 */
7111 public static final String WIFI_DISPLAY_CERTIFICATION_ON =
7112 "wifi_display_certification_on";
7113
7114 /**
Chong Zhange38af812013-08-29 17:25:17 -07007115 * WPS Configuration method used by Wifi display, this setting only
7116 * takes effect when WIFI_DISPLAY_CERTIFICATION_ON is 1 (enabled).
7117 *
7118 * Possible values are:
7119 *
7120 * WpsInfo.INVALID: use default WPS method chosen by framework
7121 * WpsInfo.PBC : use Push button
7122 * WpsInfo.KEYPAD : use Keypad
7123 * WpsInfo.DISPLAY: use Display
7124 * @hide
7125 */
7126 public static final String WIFI_DISPLAY_WPS_CONFIG =
7127 "wifi_display_wps_config";
7128
7129 /**
Christopher Tate06efb532012-08-24 15:29:27 -07007130 * Whether to notify the user of open networks.
7131 * <p>
7132 * If not connected and the scan results have an open network, we will
7133 * put this notification up. If we attempt to connect to a network or
7134 * the open network(s) disappear, we remove the notification. When we
7135 * show the notification, we will not show it again for
7136 * {@link android.provider.Settings.Secure#WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY} time.
7137 */
7138 public static final String WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON =
7139 "wifi_networks_available_notification_on";
7140 /**
7141 * {@hide}
7142 */
7143 public static final String WIMAX_NETWORKS_AVAILABLE_NOTIFICATION_ON =
7144 "wimax_networks_available_notification_on";
7145
7146 /**
7147 * Delay (in seconds) before repeating the Wi-Fi networks available notification.
7148 * Connecting to a network will reset the timer.
7149 */
7150 public static final String WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY =
7151 "wifi_networks_available_repeat_delay";
7152
7153 /**
Robert Greenwalt3ea0c992013-10-03 21:13:49 +00007154 * 802.11 country code in ISO 3166 format
7155 * @hide
7156 */
7157 public static final String WIFI_COUNTRY_CODE = "wifi_country_code";
7158
7159 /**
Christopher Tate06efb532012-08-24 15:29:27 -07007160 * The interval in milliseconds to issue wake up scans when wifi needs
7161 * to connect. This is necessary to connect to an access point when
7162 * device is on the move and the screen is off.
7163 * @hide
7164 */
7165 public static final String WIFI_FRAMEWORK_SCAN_INTERVAL_MS =
7166 "wifi_framework_scan_interval_ms";
7167
7168 /**
7169 * The interval in milliseconds after which Wi-Fi is considered idle.
7170 * When idle, it is possible for the device to be switched from Wi-Fi to
7171 * the mobile data network.
7172 * @hide
7173 */
7174 public static final String WIFI_IDLE_MS = "wifi_idle_ms";
7175
7176 /**
7177 * When the number of open networks exceeds this number, the
7178 * least-recently-used excess networks will be removed.
7179 */
7180 public static final String WIFI_NUM_OPEN_NETWORKS_KEPT = "wifi_num_open_networks_kept";
7181
7182 /**
7183 * Whether the Wi-Fi should be on. Only the Wi-Fi service should touch this.
7184 */
7185 public static final String WIFI_ON = "wifi_on";
7186
7187 /**
Irfan Sheriff11aefad2013-03-06 07:57:41 -08007188 * Setting to allow scans to be enabled even wifi is turned off for connectivity.
7189 * @hide
7190 */
7191 public static final String WIFI_SCAN_ALWAYS_AVAILABLE =
7192 "wifi_scan_always_enabled";
7193
7194 /**
Wei Wangd91f1932015-03-19 15:09:56 -07007195 * Settings to allow BLE scans to be enabled even when Bluetooth is turned off for
7196 * connectivity.
7197 * @hide
7198 */
7199 public static final String BLE_SCAN_ALWAYS_AVAILABLE =
7200 "ble_scan_always_enabled";
7201
7202 /**
Christopher Tate06efb532012-08-24 15:29:27 -07007203 * Used to save the Wifi_ON state prior to tethering.
7204 * This state will be checked to restore Wifi after
7205 * the user turns off tethering.
7206 *
7207 * @hide
7208 */
7209 public static final String WIFI_SAVED_STATE = "wifi_saved_state";
7210
7211 /**
7212 * The interval in milliseconds to scan as used by the wifi supplicant
7213 * @hide
7214 */
7215 public static final String WIFI_SUPPLICANT_SCAN_INTERVAL_MS =
7216 "wifi_supplicant_scan_interval_ms";
7217
vandwalle7c3606c2014-03-31 19:12:07 -07007218 /**
7219 * whether frameworks handles wifi auto-join
7220 * @hide
7221 */
7222 public static final String WIFI_ENHANCED_AUTO_JOIN =
7223 "wifi_enhanced_auto_join";
7224
7225 /**
7226 * whether settings show RSSI
7227 * @hide
7228 */
7229 public static final String WIFI_NETWORK_SHOW_RSSI =
7230 "wifi_network_show_rssi";
7231
7232 /**
Irfan Sheriff3809f502012-09-17 16:04:57 -07007233 * The interval in milliseconds to scan at supplicant when p2p is connected
7234 * @hide
7235 */
7236 public static final String WIFI_SCAN_INTERVAL_WHEN_P2P_CONNECTED_MS =
7237 "wifi_scan_interval_p2p_connected_ms";
7238
7239 /**
Christopher Tate06efb532012-08-24 15:29:27 -07007240 * Whether the Wi-Fi watchdog is enabled.
7241 */
7242 public static final String WIFI_WATCHDOG_ON = "wifi_watchdog_on";
7243
7244 /**
Christopher Tate06efb532012-08-24 15:29:27 -07007245 * Setting to turn off poor network avoidance on Wi-Fi. Feature is enabled by default and
7246 * the setting needs to be set to 0 to disable it.
7247 * @hide
7248 */
7249 public static final String WIFI_WATCHDOG_POOR_NETWORK_TEST_ENABLED =
7250 "wifi_watchdog_poor_network_test_enabled";
7251
7252 /**
7253 * Setting to turn on suspend optimizations at screen off on Wi-Fi. Enabled by default and
7254 * needs to be set to 0 to disable it.
7255 * @hide
7256 */
7257 public static final String WIFI_SUSPEND_OPTIMIZATIONS_ENABLED =
7258 "wifi_suspend_optimizations_enabled";
7259
7260 /**
7261 * The maximum number of times we will retry a connection to an access
7262 * point for which we have failed in acquiring an IP address from DHCP.
7263 * A value of N means that we will make N+1 connection attempts in all.
7264 */
7265 public static final String WIFI_MAX_DHCP_RETRY_COUNT = "wifi_max_dhcp_retry_count";
7266
7267 /**
7268 * Maximum amount of time in milliseconds to hold a wakelock while waiting for mobile
7269 * data connectivity to be established after a disconnect from Wi-Fi.
7270 */
7271 public static final String WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS =
7272 "wifi_mobile_data_transition_wakelock_timeout_ms";
7273
7274 /**
Zoltan Szatmary-Ban4045d242015-05-27 12:42:39 +01007275 * This setting controls whether WiFi configurations created by a Device Owner app
7276 * should be locked down (that is, be editable or removable only by the Device Owner App,
7277 * not even by Settings app).
7278 * This setting takes integer values. Non-zero values mean DO created configurations
7279 * are locked down. Value of zero means they are not. Default value in the absence of
7280 * actual value to this setting is 0.
7281 */
7282 public static final String WIFI_DEVICE_OWNER_CONFIGS_LOCKDOWN =
7283 "wifi_device_owner_configs_lockdown";
7284
7285 /**
Christopher Tate06efb532012-08-24 15:29:27 -07007286 * The operational wifi frequency band
7287 * Set to one of {@link WifiManager#WIFI_FREQUENCY_BAND_AUTO},
7288 * {@link WifiManager#WIFI_FREQUENCY_BAND_5GHZ} or
7289 * {@link WifiManager#WIFI_FREQUENCY_BAND_2GHZ}
7290 *
7291 * @hide
7292 */
7293 public static final String WIFI_FREQUENCY_BAND = "wifi_frequency_band";
7294
7295 /**
7296 * The Wi-Fi peer-to-peer device name
7297 * @hide
7298 */
7299 public static final String WIFI_P2P_DEVICE_NAME = "wifi_p2p_device_name";
7300
7301 /**
Robert Greenwaltc12783a2013-05-16 12:48:20 -07007302 * The min time between wifi disable and wifi enable
7303 * @hide
7304 */
7305 public static final String WIFI_REENABLE_DELAY_MS = "wifi_reenable_delay";
7306
7307 /**
Jeff Davidsona20ca67d2014-12-16 11:48:54 -08007308 * Timeout for ephemeral networks when all known BSSIDs go out of range. We will disconnect
7309 * from an ephemeral network if there is no BSSID for that network with a non-null score that
7310 * has been seen in this time period.
7311 *
7312 * If this is less than or equal to zero, we use a more conservative behavior and only check
7313 * for a non-null score from the currently connected or target BSSID.
7314 * @hide
7315 */
7316 public static final String WIFI_EPHEMERAL_OUT_OF_RANGE_TIMEOUT_MS =
7317 "wifi_ephemeral_out_of_range_timeout_ms";
7318
7319 /**
Christopher Tatec868b642012-09-12 17:41:04 -07007320 * The number of milliseconds to delay when checking for data stalls during
7321 * non-aggressive detection. (screen is turned off.)
7322 * @hide
7323 */
7324 public static final String DATA_STALL_ALARM_NON_AGGRESSIVE_DELAY_IN_MS =
7325 "data_stall_alarm_non_aggressive_delay_in_ms";
7326
7327 /**
7328 * The number of milliseconds to delay when checking for data stalls during
7329 * aggressive detection. (screen on or suspected data stall)
7330 * @hide
7331 */
7332 public static final String DATA_STALL_ALARM_AGGRESSIVE_DELAY_IN_MS =
7333 "data_stall_alarm_aggressive_delay_in_ms";
7334
7335 /**
Wink Savillece1e3792013-09-03 16:41:44 -07007336 * The number of milliseconds to allow the provisioning apn to remain active
7337 * @hide
7338 */
7339 public static final String PROVISIONING_APN_ALARM_DELAY_IN_MS =
7340 "provisioning_apn_alarm_delay_in_ms";
7341
7342 /**
Christopher Tatec868b642012-09-12 17:41:04 -07007343 * The interval in milliseconds at which to check gprs registration
7344 * after the first registration mismatch of gprs and voice service,
7345 * to detect possible data network registration problems.
7346 *
7347 * @hide
7348 */
7349 public static final String GPRS_REGISTER_CHECK_PERIOD_MS =
7350 "gprs_register_check_period_ms";
7351
7352 /**
Christopher Tate06efb532012-08-24 15:29:27 -07007353 * Nonzero causes Log.wtf() to crash.
7354 * @hide
7355 */
7356 public static final String WTF_IS_FATAL = "wtf_is_fatal";
7357
Eric Laurentbc0fab1f2012-09-19 11:24:41 -07007358 /**
7359 * Ringer mode. This is used internally, changing this value will not
7360 * change the ringer mode. See AudioManager.
7361 */
7362 public static final String MODE_RINGER = "mode_ringer";
Christopher Tate06efb532012-08-24 15:29:27 -07007363
Jeff Brownd4935962012-09-25 13:27:20 -07007364 /**
7365 * Overlay display devices setting.
7366 * The associated value is a specially formatted string that describes the
7367 * size and density of simulated secondary display devices.
7368 * <p>
7369 * Format: {width}x{height}/{dpi};...
7370 * </p><p>
7371 * Example:
7372 * <ul>
7373 * <li><code>1280x720/213</code>: make one overlay that is 1280x720 at 213dpi.</li>
7374 * <li><code>1920x1080/320;1280x720/213</code>: make two overlays, the first
7375 * at 1080p and the second at 720p.</li>
7376 * <li>If the value is empty, then no overlay display devices are created.</li>
7377 * </ul></p>
7378 *
7379 * @hide
7380 */
7381 public static final String OVERLAY_DISPLAY_DEVICES = "overlay_display_devices";
Christopher Tate06efb532012-08-24 15:29:27 -07007382
Jeff Sharkey625239a2012-09-26 22:03:49 -07007383 /**
7384 * Threshold values for the duration and level of a discharge cycle,
7385 * under which we log discharge cycle info.
7386 *
7387 * @hide
7388 */
7389 public static final String
7390 BATTERY_DISCHARGE_DURATION_THRESHOLD = "battery_discharge_duration_threshold";
7391
7392 /** @hide */
7393 public static final String BATTERY_DISCHARGE_THRESHOLD = "battery_discharge_threshold";
7394
7395 /**
7396 * Flag for allowing ActivityManagerService to send ACTION_APP_ERROR
7397 * intents on application crashes and ANRs. If this is disabled, the
7398 * crash/ANR dialog will never display the "Report" button.
7399 * <p>
7400 * Type: int (0 = disallow, 1 = allow)
7401 *
7402 * @hide
7403 */
7404 public static final String SEND_ACTION_APP_ERROR = "send_action_app_error";
7405
7406 /**
7407 * Maximum age of entries kept by {@link DropBoxManager}.
7408 *
7409 * @hide
7410 */
7411 public static final String DROPBOX_AGE_SECONDS = "dropbox_age_seconds";
7412
7413 /**
7414 * Maximum number of entry files which {@link DropBoxManager} will keep
7415 * around.
7416 *
7417 * @hide
7418 */
7419 public static final String DROPBOX_MAX_FILES = "dropbox_max_files";
7420
7421 /**
7422 * Maximum amount of disk space used by {@link DropBoxManager} no matter
7423 * what.
7424 *
7425 * @hide
7426 */
7427 public static final String DROPBOX_QUOTA_KB = "dropbox_quota_kb";
7428
7429 /**
7430 * Percent of free disk (excluding reserve) which {@link DropBoxManager}
7431 * will use.
7432 *
7433 * @hide
7434 */
7435 public static final String DROPBOX_QUOTA_PERCENT = "dropbox_quota_percent";
7436
7437 /**
7438 * Percent of total disk which {@link DropBoxManager} will never dip
7439 * into.
7440 *
7441 * @hide
7442 */
7443 public static final String DROPBOX_RESERVE_PERCENT = "dropbox_reserve_percent";
7444
7445 /**
7446 * Prefix for per-tag dropbox disable/enable settings.
7447 *
7448 * @hide
7449 */
7450 public static final String DROPBOX_TAG_PREFIX = "dropbox:";
7451
7452 /**
7453 * Lines of logcat to include with system crash/ANR/etc. reports, as a
7454 * prefix of the dropbox tag of the report type. For example,
7455 * "logcat_for_system_server_anr" controls the lines of logcat captured
7456 * with system server ANR reports. 0 to disable.
7457 *
7458 * @hide
7459 */
7460 public static final String ERROR_LOGCAT_PREFIX = "logcat_for_";
7461
7462 /**
7463 * The interval in minutes after which the amount of free storage left
7464 * on the device is logged to the event log
7465 *
7466 * @hide
7467 */
7468 public static final String SYS_FREE_STORAGE_LOG_INTERVAL = "sys_free_storage_log_interval";
7469
7470 /**
7471 * Threshold for the amount of change in disk free space required to
7472 * report the amount of free space. Used to prevent spamming the logs
7473 * when the disk free space isn't changing frequently.
7474 *
7475 * @hide
7476 */
7477 public static final String
7478 DISK_FREE_CHANGE_REPORTING_THRESHOLD = "disk_free_change_reporting_threshold";
7479
7480 /**
7481 * Minimum percentage of free storage on the device that is used to
7482 * determine if the device is running low on storage. The default is 10.
7483 * <p>
7484 * Say this value is set to 10, the device is considered running low on
7485 * storage if 90% or more of the device storage is filled up.
7486 *
7487 * @hide
7488 */
7489 public static final String
7490 SYS_STORAGE_THRESHOLD_PERCENTAGE = "sys_storage_threshold_percentage";
7491
7492 /**
7493 * Maximum byte size of the low storage threshold. This is to ensure
7494 * that {@link #SYS_STORAGE_THRESHOLD_PERCENTAGE} does not result in an
7495 * overly large threshold for large storage devices. Currently this must
7496 * be less than 2GB. This default is 500MB.
7497 *
7498 * @hide
7499 */
7500 public static final String
7501 SYS_STORAGE_THRESHOLD_MAX_BYTES = "sys_storage_threshold_max_bytes";
7502
7503 /**
7504 * Minimum bytes of free storage on the device before the data partition
7505 * is considered full. By default, 1 MB is reserved to avoid system-wide
7506 * SQLite disk full exceptions.
7507 *
7508 * @hide
7509 */
7510 public static final String
7511 SYS_STORAGE_FULL_THRESHOLD_BYTES = "sys_storage_full_threshold_bytes";
7512
7513 /**
7514 * The maximum reconnect delay for short network outages or when the
7515 * network is suspended due to phone use.
7516 *
7517 * @hide
7518 */
7519 public static final String
7520 SYNC_MAX_RETRY_DELAY_IN_SECONDS = "sync_max_retry_delay_in_seconds";
7521
7522 /**
7523 * The number of milliseconds to delay before sending out
Erik Kline8f29dcf2014-12-08 16:25:20 +09007524 * {@link ConnectivityManager#CONNECTIVITY_ACTION} broadcasts. Ignored.
Jeff Sharkey625239a2012-09-26 22:03:49 -07007525 *
7526 * @hide
7527 */
7528 public static final String CONNECTIVITY_CHANGE_DELAY = "connectivity_change_delay";
7529
Vinit Deshapnde1f12cb52013-08-21 13:09:01 -07007530
7531 /**
7532 * Network sampling interval, in seconds. We'll generate link information
7533 * about bytes/packets sent and error rates based on data sampled in this interval
7534 *
7535 * @hide
7536 */
7537
7538 public static final String CONNECTIVITY_SAMPLING_INTERVAL_IN_SECONDS =
7539 "connectivity_sampling_interval_in_seconds";
7540
Jeff Sharkey625239a2012-09-26 22:03:49 -07007541 /**
Jason Monk602b2322013-07-03 17:04:33 -04007542 * The series of successively longer delays used in retrying to download PAC file.
7543 * Last delay is used between successful PAC downloads.
7544 *
7545 * @hide
7546 */
7547 public static final String PAC_CHANGE_DELAY = "pac_change_delay";
7548
7549 /**
Jeff Sharkey625239a2012-09-26 22:03:49 -07007550 * Setting to turn off captive portal detection. Feature is enabled by
7551 * default and the setting needs to be set to 0 to disable it.
7552 *
7553 * @hide
7554 */
7555 public static final String
7556 CAPTIVE_PORTAL_DETECTION_ENABLED = "captive_portal_detection_enabled";
7557
7558 /**
7559 * The server used for captive portal detection upon a new conection. A
7560 * 204 response code from the server is used for validation.
7561 *
7562 * @hide
7563 */
7564 public static final String CAPTIVE_PORTAL_SERVER = "captive_portal_server";
7565
7566 /**
7567 * Whether network service discovery is enabled.
7568 *
7569 * @hide
7570 */
7571 public static final String NSD_ON = "nsd_on";
7572
7573 /**
7574 * Let user pick default install location.
7575 *
7576 * @hide
7577 */
7578 public static final String SET_INSTALL_LOCATION = "set_install_location";
7579
7580 /**
7581 * Default install location value.
7582 * 0 = auto, let system decide
7583 * 1 = internal
7584 * 2 = sdcard
7585 * @hide
7586 */
7587 public static final String DEFAULT_INSTALL_LOCATION = "default_install_location";
7588
7589 /**
7590 * ms during which to consume extra events related to Inet connection
7591 * condition after a transtion to fully-connected
7592 *
7593 * @hide
7594 */
7595 public static final String
7596 INET_CONDITION_DEBOUNCE_UP_DELAY = "inet_condition_debounce_up_delay";
7597
7598 /**
7599 * ms during which to consume extra events related to Inet connection
7600 * condtion after a transtion to partly-connected
7601 *
7602 * @hide
7603 */
7604 public static final String
7605 INET_CONDITION_DEBOUNCE_DOWN_DELAY = "inet_condition_debounce_down_delay";
7606
7607 /** {@hide} */
7608 public static final String
7609 READ_EXTERNAL_STORAGE_ENFORCED_DEFAULT = "read_external_storage_enforced_default";
7610
7611 /**
7612 * Host name and port for global http proxy. Uses ':' seperator for
7613 * between host and port.
7614 */
7615 public static final String HTTP_PROXY = "http_proxy";
7616
7617 /**
7618 * Host name for global http proxy. Set via ConnectivityManager.
7619 *
7620 * @hide
7621 */
7622 public static final String GLOBAL_HTTP_PROXY_HOST = "global_http_proxy_host";
7623
7624 /**
7625 * Integer host port for global http proxy. Set via ConnectivityManager.
7626 *
7627 * @hide
7628 */
7629 public static final String GLOBAL_HTTP_PROXY_PORT = "global_http_proxy_port";
7630
7631 /**
7632 * Exclusion list for global proxy. This string contains a list of
7633 * comma-separated domains where the global proxy does not apply.
7634 * Domains should be listed in a comma- separated list. Example of
7635 * acceptable formats: ".domain1.com,my.domain2.com" Use
7636 * ConnectivityManager to set/get.
7637 *
7638 * @hide
7639 */
7640 public static final String
7641 GLOBAL_HTTP_PROXY_EXCLUSION_LIST = "global_http_proxy_exclusion_list";
7642
7643 /**
Jason Monk602b2322013-07-03 17:04:33 -04007644 * The location PAC File for the proxy.
7645 * @hide
7646 */
7647 public static final String
7648 GLOBAL_HTTP_PROXY_PAC = "global_proxy_pac_url";
7649
7650 /**
Jeff Sharkey625239a2012-09-26 22:03:49 -07007651 * Enables the UI setting to allow the user to specify the global HTTP
7652 * proxy and associated exclusion list.
7653 *
7654 * @hide
7655 */
7656 public static final String SET_GLOBAL_HTTP_PROXY = "set_global_http_proxy";
7657
7658 /**
7659 * Setting for default DNS in case nobody suggests one
7660 *
7661 * @hide
7662 */
7663 public static final String DEFAULT_DNS_SERVER = "default_dns_server";
7664
Jeff Sharkey0ac10282012-10-01 12:50:22 -07007665 /** {@hide} */
7666 public static final String
7667 BLUETOOTH_HEADSET_PRIORITY_PREFIX = "bluetooth_headset_priority_";
7668 /** {@hide} */
7669 public static final String
7670 BLUETOOTH_A2DP_SINK_PRIORITY_PREFIX = "bluetooth_a2dp_sink_priority_";
7671 /** {@hide} */
7672 public static final String
Sanket Agarwal1bec6a52015-10-21 18:23:27 -07007673 BLUETOOTH_A2DP_SRC_PRIORITY_PREFIX = "bluetooth_a2dp_src_priority_";
7674 /** {@hide} */
7675 public static final String
Jeff Sharkey0ac10282012-10-01 12:50:22 -07007676 BLUETOOTH_INPUT_DEVICE_PRIORITY_PREFIX = "bluetooth_input_device_priority_";
Kim Schulz0d376052013-08-22 11:18:02 +02007677 /** {@hide} */
7678 public static final String
7679 BLUETOOTH_MAP_PRIORITY_PREFIX = "bluetooth_map_priority_";
Casper Bonde2a5f6082015-03-19 10:36:45 +01007680 /** {@hide} */
7681 public static final String
7682 BLUETOOTH_SAP_PRIORITY_PREFIX = "bluetooth_sap_priority_";
Jeff Sharkey0ac10282012-10-01 12:50:22 -07007683
7684 /**
Adam Lesinski31c05d12015-06-09 17:34:04 -07007685 * Device Idle (Doze) specific settings.
7686 * This is encoded as a key=value list, separated by commas. Ex:
7687 *
7688 * "inactive_timeout=60000,sensing_timeout=400000"
7689 *
7690 * The following keys are supported:
7691 *
7692 * <pre>
7693 * inactive_to (long)
7694 * sensing_to (long)
7695 * motion_inactive_to (long)
7696 * idle_after_inactive_to (long)
7697 * idle_pending_to (long)
7698 * max_idle_pending_to (long)
7699 * idle_pending_factor (float)
7700 * idle_to (long)
7701 * max_idle_to (long)
7702 * idle_factor (float)
7703 * min_time_to_alarm (long)
7704 * max_temp_app_whitelist_duration (long)
7705 * </pre>
7706 *
7707 * <p>
7708 * Type: string
7709 * @hide
7710 * @see com.android.server.DeviceIdleController.Constants
7711 */
7712 public static final String DEVICE_IDLE_CONSTANTS = "device_idle_constants";
7713
7714 /**
Joe LaPennaf33b5bf2016-03-23 15:19:47 -07007715 * Device Idle (Doze) specific settings for watches. See {@code #DEVICE_IDLE_CONSTANTS}
7716 *
7717 * <p>
7718 * Type: string
7719 * @hide
7720 * @see com.android.server.DeviceIdleController.Constants
7721 */
7722 public static final String DEVICE_IDLE_CONSTANTS_WATCH = "device_idle_constants_watch";
7723
7724 /**
Adam Lesinskia6232df2015-06-11 18:16:41 -07007725 * App standby (app idle) specific settings.
7726 * This is encoded as a key=value list, separated by commas. Ex:
7727 *
7728 * "idle_duration=5000,parole_interval=4500"
7729 *
7730 * The following keys are supported:
7731 *
7732 * <pre>
Adam Lesinskif0ef3c12016-01-13 12:26:07 -08007733 * idle_duration2 (long)
Adam Lesinskia6232df2015-06-11 18:16:41 -07007734 * wallclock_threshold (long)
7735 * parole_interval (long)
7736 * parole_duration (long)
Adam Lesinskif0ef3c12016-01-13 12:26:07 -08007737 *
7738 * idle_duration (long) // This is deprecated and used to circumvent b/26355386.
Adam Lesinskia6232df2015-06-11 18:16:41 -07007739 * </pre>
7740 *
7741 * <p>
7742 * Type: string
7743 * @hide
7744 * @see com.android.server.usage.UsageStatsService.SettingsObserver
7745 */
7746 public static final String APP_IDLE_CONSTANTS = "app_idle_constants";
7747
7748 /**
Dianne Hackborna750a632015-06-16 17:18:23 -07007749 * Alarm manager specific settings.
7750 * This is encoded as a key=value list, separated by commas. Ex:
7751 *
7752 * "min_futurity=5000,allow_while_idle_short_time=4500"
7753 *
7754 * The following keys are supported:
7755 *
7756 * <pre>
7757 * min_futurity (long)
7758 * min_interval (long)
7759 * allow_while_idle_short_time (long)
7760 * allow_while_idle_long_time (long)
7761 * allow_while_idle_whitelist_duration (long)
7762 * </pre>
7763 *
7764 * <p>
7765 * Type: string
7766 * @hide
7767 * @see com.android.server.AlarmManagerService.Constants
7768 */
7769 public static final String ALARM_MANAGER_CONSTANTS = "alarm_manager_constants";
7770
7771 /**
Makoto Onuki4362a662016-03-08 18:59:09 -08007772 * ShortcutManager specific settings.
7773 * This is encoded as a key=value list, separated by commas. Ex:
7774 *
7775 * "reset_interval_sec=86400,max_daily_updates=5"
7776 *
7777 * The following keys are supported:
7778 *
7779 * <pre>
7780 * reset_interval_sec (long)
7781 * max_daily_updates (int)
7782 * max_icon_dimension_dp (int, DP)
7783 * max_icon_dimension_dp_lowram (int, DP)
7784 * max_shortcuts (int)
7785 * icon_quality (int, 0-100)
7786 * icon_format (String)
7787 * </pre>
7788 *
7789 * <p>
7790 * Type: string
7791 * @hide
7792 * @see com.android.server.pm.ShortcutService.ConfigConstants
7793 */
7794 public static final String SHORTCUT_MANAGER_CONSTANTS = "shortcut_manager_constants";
7795
7796 /**
Jeff Sharkey0ac10282012-10-01 12:50:22 -07007797 * Get the key that retrieves a bluetooth headset's priority.
7798 * @hide
7799 */
7800 public static final String getBluetoothHeadsetPriorityKey(String address) {
Elliott Hughescb64d432013-08-02 10:00:44 -07007801 return BLUETOOTH_HEADSET_PRIORITY_PREFIX + address.toUpperCase(Locale.ROOT);
Jeff Sharkey0ac10282012-10-01 12:50:22 -07007802 }
7803
7804 /**
7805 * Get the key that retrieves a bluetooth a2dp sink's priority.
7806 * @hide
7807 */
7808 public static final String getBluetoothA2dpSinkPriorityKey(String address) {
Elliott Hughescb64d432013-08-02 10:00:44 -07007809 return BLUETOOTH_A2DP_SINK_PRIORITY_PREFIX + address.toUpperCase(Locale.ROOT);
Jeff Sharkey0ac10282012-10-01 12:50:22 -07007810 }
7811
7812 /**
Sanket Agarwal1bec6a52015-10-21 18:23:27 -07007813 * Get the key that retrieves a bluetooth a2dp src's priority.
7814 * @hide
7815 */
7816 public static final String getBluetoothA2dpSrcPriorityKey(String address) {
7817 return BLUETOOTH_A2DP_SRC_PRIORITY_PREFIX + address.toUpperCase(Locale.ROOT);
7818 }
7819
7820 /**
Jeff Sharkey0ac10282012-10-01 12:50:22 -07007821 * Get the key that retrieves a bluetooth Input Device's priority.
7822 * @hide
7823 */
7824 public static final String getBluetoothInputDevicePriorityKey(String address) {
Elliott Hughescb64d432013-08-02 10:00:44 -07007825 return BLUETOOTH_INPUT_DEVICE_PRIORITY_PREFIX + address.toUpperCase(Locale.ROOT);
Jeff Sharkey0ac10282012-10-01 12:50:22 -07007826 }
7827
Jeff Sharkey6e2bee72012-10-01 13:39:08 -07007828 /**
Kim Schulz0d376052013-08-22 11:18:02 +02007829 * Get the key that retrieves a bluetooth map priority.
7830 * @hide
7831 */
7832 public static final String getBluetoothMapPriorityKey(String address) {
7833 return BLUETOOTH_MAP_PRIORITY_PREFIX + address.toUpperCase(Locale.ROOT);
7834 }
Casper Bonde2a5f6082015-03-19 10:36:45 +01007835
7836 /**
7837 * Get the key that retrieves a bluetooth map priority.
7838 * @hide
7839 */
7840 public static final String getBluetoothSapPriorityKey(String address) {
7841 return BLUETOOTH_SAP_PRIORITY_PREFIX + address.toUpperCase(Locale.ROOT);
7842 }
7843
Kim Schulz0d376052013-08-22 11:18:02 +02007844 /**
Jeff Sharkey6e2bee72012-10-01 13:39:08 -07007845 * Scaling factor for normal window animations. Setting to 0 will
7846 * disable window animations.
7847 */
7848 public static final String WINDOW_ANIMATION_SCALE = "window_animation_scale";
7849
7850 /**
7851 * Scaling factor for activity transition animations. Setting to 0 will
7852 * disable window animations.
7853 */
7854 public static final String TRANSITION_ANIMATION_SCALE = "transition_animation_scale";
7855
7856 /**
7857 * Scaling factor for Animator-based animations. This affects both the
7858 * start delay and duration of all such animations. Setting to 0 will
7859 * cause animations to end immediately. The default value is 1.
7860 */
7861 public static final String ANIMATOR_DURATION_SCALE = "animator_duration_scale";
7862
7863 /**
7864 * Scaling factor for normal window animations. Setting to 0 will
7865 * disable window animations.
7866 *
7867 * @hide
7868 */
7869 public static final String FANCY_IME_ANIMATIONS = "fancy_ime_animations";
7870
7871 /**
7872 * If 0, the compatibility mode is off for all applications.
7873 * If 1, older applications run under compatibility mode.
7874 * TODO: remove this settings before code freeze (bug/1907571)
7875 * @hide
7876 */
7877 public static final String COMPATIBILITY_MODE = "compatibility_mode";
7878
7879 /**
7880 * CDMA only settings
7881 * Emergency Tone 0 = Off
7882 * 1 = Alert
7883 * 2 = Vibrate
7884 * @hide
7885 */
7886 public static final String EMERGENCY_TONE = "emergency_tone";
7887
7888 /**
7889 * CDMA only settings
7890 * Whether the auto retry is enabled. The value is
7891 * boolean (1 or 0).
7892 * @hide
7893 */
7894 public static final String CALL_AUTO_RETRY = "call_auto_retry";
7895
7896 /**
Sungmin Choie099ab12014-06-09 14:45:51 +09007897 * See RIL_PreferredNetworkType in ril.h
Jeff Sharkey6e2bee72012-10-01 13:39:08 -07007898 * @hide
7899 */
7900 public static final String PREFERRED_NETWORK_MODE =
7901 "preferred_network_mode";
7902
7903 /**
Jeff Sharkey6e2bee72012-10-01 13:39:08 -07007904 * Name of an application package to be debugged.
7905 */
7906 public static final String DEBUG_APP = "debug_app";
7907
7908 /**
7909 * If 1, when launching DEBUG_APP it will wait for the debugger before
7910 * starting user code. If 0, it will run normally.
7911 */
7912 public static final String WAIT_FOR_DEBUGGER = "wait_for_debugger";
7913
7914 /**
7915 * Control whether the process CPU usage meter should be shown.
7916 */
7917 public static final String SHOW_PROCESSES = "show_processes";
7918
7919 /**
Ruchi Kandoi62b8a492014-04-17 18:01:40 -07007920 * If 1 low power mode is enabled.
7921 * @hide
7922 */
7923 public static final String LOW_POWER_MODE = "low_power";
7924
John Spurlockf8f524c2014-06-10 14:47:29 -04007925 /**
7926 * Battery level [1-99] at which low power mode automatically turns on.
Dianne Hackborn14272302014-06-10 23:13:02 -07007927 * If 0, it will not automatically turn on.
John Spurlockf8f524c2014-06-10 14:47:29 -04007928 * @hide
7929 */
7930 public static final String LOW_POWER_MODE_TRIGGER_LEVEL = "low_power_trigger_level";
7931
Ruchi Kandoi62b8a492014-04-17 18:01:40 -07007932 /**
Dianne Hackbornb2117d12016-02-16 18:26:35 -08007933 * If not 0, the activity manager will aggressively finish activities and
Jeff Sharkey6e2bee72012-10-01 13:39:08 -07007934 * processes as soon as they are no longer needed. If 0, the normal
7935 * extended lifetime is used.
7936 */
Dianne Hackborn89ad4562014-08-24 16:45:38 -07007937 public static final String ALWAYS_FINISH_ACTIVITIES = "always_finish_activities";
Jeff Sharkey6e2bee72012-10-01 13:39:08 -07007938
Christopher Tate66488d62012-10-02 11:58:01 -07007939 /**
Dianne Hackbornb2117d12016-02-16 18:26:35 -08007940 * @hide
7941 * If not 0, the activity manager will implement a looser version of background
7942 * check that is more compatible with existing apps.
7943 */
7944 public static final String LENIENT_BACKGROUND_CHECK = "lenient_background_check";
7945
7946 /**
Eric Laurent7ee1e4f2012-10-26 18:11:21 -07007947 * Use Dock audio output for media:
7948 * 0 = disabled
7949 * 1 = enabled
7950 * @hide
7951 */
7952 public static final String DOCK_AUDIO_MEDIA_ENABLED = "dock_audio_media_enabled";
7953
7954 /**
Phil Burkdeaa8d92016-02-23 17:12:04 -08007955 * The surround sound formats AC3, DTS or IEC61937 are
7956 * available for use if they are detected.
7957 * This is the default mode.
7958 *
7959 * Note that AUTO is equivalent to ALWAYS for Android TVs and other
7960 * devices that have an S/PDIF output. This is because S/PDIF
7961 * is unidirectional and the TV cannot know if a decoder is
7962 * connected. So it assumes they are always available.
7963 * @hide
7964 */
7965 public static final int ENCODED_SURROUND_OUTPUT_AUTO = 0;
7966
7967 /**
7968 * AC3, DTS or IEC61937 are NEVER available, even if they
7969 * are detected by the hardware. Those formats will not be
7970 * reported.
7971 *
7972 * An example use case would be an AVR reports that it is capable of
7973 * surround sound decoding but is broken. If NEVER is chosen
7974 * then apps must use PCM output instead of encoded output.
7975 * @hide
7976 */
7977 public static final int ENCODED_SURROUND_OUTPUT_NEVER = 1;
7978
7979 /**
7980 * AC3, DTS or IEC61937 are ALWAYS available, even if they
7981 * are not detected by the hardware. Those formats will be
7982 * reported as part of the HDMI output capability. Applications
7983 * are then free to use either PCM or encoded output.
7984 *
7985 * An example use case would be a when TV was connected over
7986 * TOS-link to an AVR. But the TV could not see it because TOS-link
7987 * is unidirectional.
7988 * @hide
7989 */
7990 public static final int ENCODED_SURROUND_OUTPUT_ALWAYS = 2;
7991
7992 /**
7993 * Set to ENCODED_SURROUND_OUTPUT_AUTO,
7994 * ENCODED_SURROUND_OUTPUT_NEVER or
7995 * ENCODED_SURROUND_OUTPUT_ALWAYS
7996 * @hide
7997 */
7998 public static final String ENCODED_SURROUND_OUTPUT = "encoded_surround_output";
7999
8000 /**
Eric Laurent05274f32012-11-29 12:48:18 -08008001 * Persisted safe headphone volume management state by AudioService
8002 * @hide
8003 */
8004 public static final String AUDIO_SAFE_VOLUME_STATE = "audio_safe_volume_state";
8005
8006 /**
Geremy Condraa0735112013-03-26 21:49:26 -07008007 * URL for tzinfo (time zone) updates
8008 * @hide
8009 */
8010 public static final String TZINFO_UPDATE_CONTENT_URL = "tzinfo_content_url";
8011
8012 /**
8013 * URL for tzinfo (time zone) update metadata
8014 * @hide
8015 */
8016 public static final String TZINFO_UPDATE_METADATA_URL = "tzinfo_metadata_url";
8017
8018 /**
8019 * URL for selinux (mandatory access control) updates
8020 * @hide
8021 */
8022 public static final String SELINUX_UPDATE_CONTENT_URL = "selinux_content_url";
8023
8024 /**
8025 * URL for selinux (mandatory access control) update metadata
8026 * @hide
8027 */
8028 public static final String SELINUX_UPDATE_METADATA_URL = "selinux_metadata_url";
8029
8030 /**
8031 * URL for sms short code updates
8032 * @hide
8033 */
8034 public static final String SMS_SHORT_CODES_UPDATE_CONTENT_URL =
8035 "sms_short_codes_content_url";
8036
8037 /**
8038 * URL for sms short code update metadata
8039 * @hide
8040 */
8041 public static final String SMS_SHORT_CODES_UPDATE_METADATA_URL =
8042 "sms_short_codes_metadata_url";
8043
8044 /**
Amit Mahajan9069fab2015-05-01 11:05:47 -07008045 * URL for apn_db updates
8046 * @hide
8047 */
8048 public static final String APN_DB_UPDATE_CONTENT_URL = "apn_db_content_url";
8049
8050 /**
8051 * URL for apn_db update metadata
8052 * @hide
8053 */
8054 public static final String APN_DB_UPDATE_METADATA_URL = "apn_db_metadata_url";
8055
8056 /**
Geremy Condraa0735112013-03-26 21:49:26 -07008057 * URL for cert pinlist updates
8058 * @hide
8059 */
8060 public static final String CERT_PIN_UPDATE_CONTENT_URL = "cert_pin_content_url";
8061
8062 /**
8063 * URL for cert pinlist updates
8064 * @hide
8065 */
8066 public static final String CERT_PIN_UPDATE_METADATA_URL = "cert_pin_metadata_url";
8067
Geremy Condra757ee522013-03-29 16:39:45 -07008068 /**
Ben Gruver633dc9b2013-04-04 12:05:49 -07008069 * URL for intent firewall updates
8070 * @hide
8071 */
8072 public static final String INTENT_FIREWALL_UPDATE_CONTENT_URL =
8073 "intent_firewall_content_url";
8074
8075 /**
8076 * URL for intent firewall update metadata
8077 * @hide
8078 */
8079 public static final String INTENT_FIREWALL_UPDATE_METADATA_URL =
8080 "intent_firewall_metadata_url";
8081
8082 /**
Geremy Condra4e7f7e82013-03-26 21:09:01 -07008083 * SELinux enforcement status. If 0, permissive; if 1, enforcing.
8084 * @hide
8085 */
8086 public static final String SELINUX_STATUS = "selinux_status";
8087
Geremy Condraa0735112013-03-26 21:49:26 -07008088 /**
Amith Yamasanid8415f42013-08-07 20:15:10 -07008089 * Developer setting to force RTL layout.
8090 * @hide
8091 */
8092 public static final String DEVELOPMENT_FORCE_RTL = "debug.force_rtl";
8093
8094 /**
Daniel Sandlerdea64622013-09-23 16:05:57 -04008095 * Milliseconds after screen-off after which low battery sounds will be silenced.
8096 *
8097 * If zero, battery sounds will always play.
8098 * Defaults to @integer/def_low_battery_sound_timeout in SettingsProvider.
8099 *
8100 * @hide
8101 */
8102 public static final String LOW_BATTERY_SOUND_TIMEOUT = "low_battery_sound_timeout";
8103
8104 /**
Evan Charltoncc7b0432014-01-14 14:47:11 -08008105 * Milliseconds to wait before bouncing Wi-Fi after settings is restored. Note that after
Dianne Hackborna3fb40d2014-08-12 15:06:50 -07008106 * the caller is done with this, they should call {@link ContentResolver#delete} to
Evan Charltoncc7b0432014-01-14 14:47:11 -08008107 * clean up any value that they may have written.
8108 *
8109 * @hide
8110 */
8111 public static final String WIFI_BOUNCE_DELAY_OVERRIDE_MS = "wifi_bounce_delay_override_ms";
8112
John Spurlockc6d1c602014-01-17 15:22:06 -05008113 /**
8114 * Defines global runtime overrides to window policy.
8115 *
Jorim Jaggib10e33f2015-02-04 21:57:40 +01008116 * See {@link com.android.server.policy.PolicyControl} for value format.
John Spurlockc6d1c602014-01-17 15:22:06 -05008117 *
8118 * @hide
8119 */
8120 public static final String POLICY_CONTROL = "policy_control";
Evan Charltoncc7b0432014-01-14 14:47:11 -08008121
8122 /**
John Spurlockae641c92014-06-30 18:11:40 -04008123 * Defines global zen mode. ZEN_MODE_OFF, ZEN_MODE_IMPORTANT_INTERRUPTIONS,
8124 * or ZEN_MODE_NO_INTERRUPTIONS.
John Spurlocke677d712014-02-13 12:52:19 -05008125 *
8126 * @hide
8127 */
8128 public static final String ZEN_MODE = "zen_mode";
8129
8130 /** @hide */ public static final int ZEN_MODE_OFF = 0;
John Spurlockae641c92014-06-30 18:11:40 -04008131 /** @hide */ public static final int ZEN_MODE_IMPORTANT_INTERRUPTIONS = 1;
8132 /** @hide */ public static final int ZEN_MODE_NO_INTERRUPTIONS = 2;
John Spurlock4f1163c2015-04-02 17:41:21 -04008133 /** @hide */ public static final int ZEN_MODE_ALARMS = 3;
John Spurlocke677d712014-02-13 12:52:19 -05008134
8135 /** @hide */ public static String zenModeToString(int mode) {
John Spurlockae641c92014-06-30 18:11:40 -04008136 if (mode == ZEN_MODE_IMPORTANT_INTERRUPTIONS) return "ZEN_MODE_IMPORTANT_INTERRUPTIONS";
John Spurlock4f1163c2015-04-02 17:41:21 -04008137 if (mode == ZEN_MODE_ALARMS) return "ZEN_MODE_ALARMS";
John Spurlockae641c92014-06-30 18:11:40 -04008138 if (mode == ZEN_MODE_NO_INTERRUPTIONS) return "ZEN_MODE_NO_INTERRUPTIONS";
8139 return "ZEN_MODE_OFF";
John Spurlocke677d712014-02-13 12:52:19 -05008140 }
8141
John Spurlockb2278d62015-04-07 12:47:12 -04008142 /** @hide */ public static boolean isValidZenMode(int value) {
8143 switch (value) {
8144 case Global.ZEN_MODE_OFF:
8145 case Global.ZEN_MODE_IMPORTANT_INTERRUPTIONS:
8146 case Global.ZEN_MODE_ALARMS:
8147 case Global.ZEN_MODE_NO_INTERRUPTIONS:
8148 return true;
8149 default:
8150 return false;
8151 }
8152 }
8153
John Spurlocke677d712014-02-13 12:52:19 -05008154 /**
Julia Reynolds9b11fdb2015-07-31 09:49:55 -04008155 * Value of the ringer before entering zen mode.
8156 *
8157 * @hide
8158 */
8159 public static final String ZEN_MODE_RINGER_LEVEL = "zen_mode_ringer_level";
8160
8161 /**
John Spurlock056c5192014-04-20 21:52:01 -04008162 * Opaque value, changes when persisted zen mode configuration changes.
8163 *
8164 * @hide
8165 */
8166 public static final String ZEN_MODE_CONFIG_ETAG = "zen_mode_config_etag";
8167
8168 /**
Chris Wren7bd241232014-02-28 16:25:05 -05008169 * Defines global heads up toggle. One of HEADS_UP_OFF, HEADS_UP_ON.
8170 *
8171 * @hide
8172 */
Chris Wren10d82df2014-03-01 10:34:51 -05008173 public static final String HEADS_UP_NOTIFICATIONS_ENABLED =
8174 "heads_up_notifications_enabled";
Chris Wren7bd241232014-02-28 16:25:05 -05008175
8176 /** @hide */ public static final int HEADS_UP_OFF = 0;
8177 /** @hide */ public static final int HEADS_UP_ON = 1;
8178
8179 /**
Jerome Poichet147b4d72014-05-12 18:13:27 -07008180 * The name of the device
8181 *
8182 * @hide
8183 */
8184 public static final String DEVICE_NAME = "device_name";
8185
8186 /**
Jeff Davidson56f9f732014-08-14 16:47:23 -07008187 * Whether the NetworkScoringService has been first initialized.
8188 * <p>
8189 * Type: int (0 for false, 1 for true)
8190 * @hide
8191 */
8192 public static final String NETWORK_SCORING_PROVISIONED = "network_scoring_provisioned";
8193
8194 /**
Jim Miller6848dc82014-10-13 18:51:53 -07008195 * Whether the user wants to be prompted for password to decrypt the device on boot.
8196 * This only matters if the storage is encrypted.
8197 * <p>
8198 * Type: int (0 for false, 1 for true)
8199 * @hide
8200 */
8201 public static final String REQUIRE_PASSWORD_TO_DECRYPT = "require_password_to_decrypt";
8202
8203 /**
Etan Cohen93bbf272015-05-04 18:01:47 -07008204 * Whether the Volte is enabled
Libin.Tang@motorola.com0499bb52014-10-10 14:55:57 -05008205 * <p>
8206 * Type: int (0 for false, 1 for true)
8207 * @hide
8208 */
Etan Cohene41a9cf2014-10-22 10:50:46 -07008209 public static final String ENHANCED_4G_MODE_ENABLED = "volte_vt_enabled";
Libin.Tang@motorola.com0499bb52014-10-10 14:55:57 -05008210
8211 /**
Etan Cohen93bbf272015-05-04 18:01:47 -07008212 * Whether VT (Video Telephony over IMS) is enabled
8213 * <p>
8214 * Type: int (0 for false, 1 for true)
8215 *
8216 * @hide
8217 */
8218 public static final String VT_IMS_ENABLED = "vt_ims_enabled";
8219
8220 /**
Etan Cohen9c8f21b2014-12-23 15:02:19 -08008221 * Whether WFC is enabled
8222 * <p>
8223 * Type: int (0 for false, 1 for true)
8224 *
8225 * @hide
8226 */
8227 public static final String WFC_IMS_ENABLED = "wfc_ims_enabled";
8228
8229 /**
8230 * WFC Mode.
8231 * <p>
8232 * Type: int - 2=Wi-Fi preferred, 1=Cellular preferred, 0=Wi-Fi only
8233 *
8234 * @hide
8235 */
8236 public static final String WFC_IMS_MODE = "wfc_ims_mode";
8237
8238 /**
8239 * Whether WFC roaming is enabled
8240 * <p>
8241 * Type: int (0 for false, 1 for true)
8242 *
8243 * @hide
8244 */
8245 public static final String WFC_IMS_ROAMING_ENABLED = "wfc_ims_roaming_enabled";
8246
8247 /**
Amit Mahajan4fea0922014-11-18 12:56:28 -08008248 * Whether user can enable/disable LTE as a preferred network. A carrier might control
8249 * this via gservices, OMA-DM, carrier app, etc.
8250 * <p>
8251 * Type: int (0 for false, 1 for true)
8252 * @hide
8253 */
8254 public static final String LTE_SERVICE_FORCED = "lte_service_forced";
8255
8256 /**
Svet Ganov2acf0632015-11-24 19:10:59 -08008257 * Ephemeral app cookie max size in bytes.
8258 * <p>
8259 * Type: int
8260 * @hide
8261 */
8262 public static final String EPHEMERAL_COOKIE_MAX_SIZE_BYTES =
8263 "ephemeral_cookie_max_size_bytes";
8264
8265 /**
8266 * The duration for caching uninstalled ephemeral apps.
8267 * <p>
8268 * Type: long
8269 * @hide
8270 */
8271 public static final String UNINSTALLED_EPHEMERAL_APP_CACHE_DURATION_MILLIS =
8272 "uninstalled_ephemeral_app_cache_duration_millis";
8273
8274 /**
Fyodor Kupolov07140f72016-02-17 10:46:11 -08008275 * Allows switching users when system user is locked.
8276 * <p>
8277 * Type: int
8278 * @hide
8279 */
8280 public static final String ALLOW_USER_SWITCHING_WHEN_SYSTEM_USER_LOCKED =
8281 "allow_user_switching_when_system_user_locked";
8282
8283 /**
Daichi Hirono82ab9802016-03-02 13:23:29 +09008284 * Boot count since the device starts running APK level 24.
8285 * <p>
8286 * Type: int
8287 */
8288 public static final String BOOT_COUNT = "boot_count";
8289
8290 /**
Christopher Tate66488d62012-10-02 11:58:01 -07008291 * Settings to backup. This is here so that it's in the same place as the settings
8292 * keys and easy to update.
8293 *
8294 * These keys may be mentioned in the SETTINGS_TO_BACKUP arrays in System
8295 * and Secure as well. This is because those tables drive both backup and
8296 * restore, and restore needs to properly whitelist keys that used to live
8297 * in those namespaces. The keys will only actually be backed up / restored
8298 * if they are also mentioned in this table (Global.SETTINGS_TO_BACKUP).
8299 *
8300 * NOTE: Settings are backed up and restored in the order they appear
8301 * in this array. If you have one setting depending on another,
8302 * make sure that they are ordered appropriately.
8303 *
8304 * @hide
8305 */
8306 public static final String[] SETTINGS_TO_BACKUP = {
Christopher Tate58f41ec2013-01-11 15:40:36 -08008307 BUGREPORT_IN_POWER_MENU,
Christopher Tate66488d62012-10-02 11:58:01 -07008308 STAY_ON_WHILE_PLUGGED_IN,
Christopher Tate66488d62012-10-02 11:58:01 -07008309 AUTO_TIME,
8310 AUTO_TIME_ZONE,
8311 POWER_SOUNDS_ENABLED,
8312 DOCK_SOUNDS_ENABLED,
Ritesh Reddyf8f12132015-11-20 16:43:28 +00008313 CHARGING_SOUNDS_ENABLED,
Christopher Tate66488d62012-10-02 11:58:01 -07008314 USB_MASS_STORAGE_ENABLED,
8315 ENABLE_ACCESSIBILITY_GLOBAL_GESTURE_ENABLED,
8316 WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON,
8317 WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY,
Christopher Tate16eb7cd2012-10-09 15:26:30 -07008318 WIFI_WATCHDOG_POOR_NETWORK_TEST_ENABLED,
Christopher Tate66488d62012-10-02 11:58:01 -07008319 WIFI_NUM_OPEN_NETWORKS_KEPT,
8320 EMERGENCY_TONE,
8321 CALL_AUTO_RETRY,
Amith Yamasani94005242014-10-31 11:35:13 -07008322 DOCK_AUDIO_MEDIA_ENABLED,
Phil Burkdeaa8d92016-02-23 17:12:04 -08008323 ENCODED_SURROUND_OUTPUT,
Amith Yamasani94005242014-10-31 11:35:13 -07008324 LOW_POWER_MODE_TRIGGER_LEVEL
Christopher Tate66488d62012-10-02 11:58:01 -07008325 };
8326
Christopher Tate06efb532012-08-24 15:29:27 -07008327 // Populated lazily, guarded by class object:
Dianne Hackborn139748f2012-09-24 11:36:57 -07008328 private static NameValueCache sNameValueCache = new NameValueCache(
8329 SYS_PROP_SETTING_VERSION,
8330 CONTENT_URI,
8331 CALL_METHOD_GET_GLOBAL,
8332 CALL_METHOD_PUT_GLOBAL);
Christopher Tate06efb532012-08-24 15:29:27 -07008333
Christopher Tateaa036a22014-05-19 16:33:27 -07008334 // Certain settings have been moved from global to the per-user secure namespace
8335 private static final HashSet<String> MOVED_TO_SECURE;
8336 static {
8337 MOVED_TO_SECURE = new HashSet<String>(1);
8338 MOVED_TO_SECURE.add(Settings.Global.INSTALL_NON_MARKET_APPS);
8339 }
8340
Svetoslav683914b2015-01-15 14:22:26 -08008341 /** @hide */
8342 public static void getMovedToSecureSettings(Set<String> outKeySet) {
8343 outKeySet.addAll(MOVED_TO_SECURE);
8344 }
8345
Christopher Tate06efb532012-08-24 15:29:27 -07008346 /**
8347 * Look up a name in the database.
8348 * @param resolver to access the database with
8349 * @param name to look up in the table
8350 * @return the corresponding value, or null if not present
8351 */
Dianne Hackborn139748f2012-09-24 11:36:57 -07008352 public static String getString(ContentResolver resolver, String name) {
Christopher Tate06efb532012-08-24 15:29:27 -07008353 return getStringForUser(resolver, name, UserHandle.myUserId());
8354 }
8355
8356 /** @hide */
Dianne Hackborn139748f2012-09-24 11:36:57 -07008357 public static String getStringForUser(ContentResolver resolver, String name,
Christopher Tate06efb532012-08-24 15:29:27 -07008358 int userHandle) {
Christopher Tateaa036a22014-05-19 16:33:27 -07008359 if (MOVED_TO_SECURE.contains(name)) {
8360 Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.Global"
8361 + " to android.provider.Settings.Secure, returning read-only value.");
8362 return Secure.getStringForUser(resolver, name, userHandle);
8363 }
Christopher Tate06efb532012-08-24 15:29:27 -07008364 return sNameValueCache.getStringForUser(resolver, name, userHandle);
8365 }
8366
8367 /**
8368 * Store a name/value pair into the database.
8369 * @param resolver to access the database with
8370 * @param name to store
8371 * @param value to associate with the name
8372 * @return true if the value was set, false on database errors
8373 */
8374 public static boolean putString(ContentResolver resolver,
8375 String name, String value) {
8376 return putStringForUser(resolver, name, value, UserHandle.myUserId());
8377 }
8378
8379 /** @hide */
8380 public static boolean putStringForUser(ContentResolver resolver,
8381 String name, String value, int userHandle) {
Christopher Tate06efb532012-08-24 15:29:27 -07008382 if (LOCAL_LOGV) {
8383 Log.v(TAG, "Global.putString(name=" + name + ", value=" + value
8384 + " for " + userHandle);
8385 }
Christopher Tateaa036a22014-05-19 16:33:27 -07008386 // Global and Secure have the same access policy so we can forward writes
8387 if (MOVED_TO_SECURE.contains(name)) {
8388 Log.w(TAG, "Setting " + name + " has moved from android.provider.Settings.Global"
8389 + " to android.provider.Settings.Secure, value is unchanged.");
8390 return Secure.putStringForUser(resolver, name, value, userHandle);
8391 }
Christopher Tate06efb532012-08-24 15:29:27 -07008392 return sNameValueCache.putStringForUser(resolver, name, value, userHandle);
8393 }
8394
8395 /**
8396 * Construct the content URI for a particular name/value pair,
8397 * useful for monitoring changes with a ContentObserver.
8398 * @param name to look up in the table
8399 * @return the corresponding content URI, or null if not present
8400 */
8401 public static Uri getUriFor(String name) {
8402 return getUriFor(CONTENT_URI, name);
8403 }
8404
8405 /**
8406 * Convenience function for retrieving a single secure settings value
8407 * as an integer. Note that internally setting values are always
8408 * stored as strings; this function converts the string to an integer
8409 * for you. The default value will be returned if the setting is
8410 * not defined or not an integer.
8411 *
8412 * @param cr The ContentResolver to access.
8413 * @param name The name of the setting to retrieve.
8414 * @param def Value to return if the setting is not defined.
8415 *
8416 * @return The setting's current value, or 'def' if it is not defined
8417 * or not a valid integer.
8418 */
8419 public static int getInt(ContentResolver cr, String name, int def) {
8420 String v = getString(cr, name);
8421 try {
8422 return v != null ? Integer.parseInt(v) : def;
8423 } catch (NumberFormatException e) {
8424 return def;
8425 }
8426 }
8427
8428 /**
8429 * Convenience function for retrieving a single secure settings value
8430 * as an integer. Note that internally setting values are always
8431 * stored as strings; this function converts the string to an integer
8432 * for you.
8433 * <p>
8434 * This version does not take a default value. If the setting has not
8435 * been set, or the string value is not a number,
8436 * it throws {@link SettingNotFoundException}.
8437 *
8438 * @param cr The ContentResolver to access.
8439 * @param name The name of the setting to retrieve.
8440 *
8441 * @throws SettingNotFoundException Thrown if a setting by the given
8442 * name can't be found or the setting value is not an integer.
8443 *
8444 * @return The setting's current value.
8445 */
8446 public static int getInt(ContentResolver cr, String name)
8447 throws SettingNotFoundException {
8448 String v = getString(cr, name);
8449 try {
8450 return Integer.parseInt(v);
8451 } catch (NumberFormatException e) {
8452 throw new SettingNotFoundException(name);
8453 }
8454 }
8455
8456 /**
8457 * Convenience function for updating a single settings value as an
8458 * integer. This will either create a new entry in the table if the
8459 * given name does not exist, or modify the value of the existing row
8460 * with that name. Note that internally setting values are always
8461 * stored as strings, so this function converts the given value to a
8462 * string before storing it.
8463 *
8464 * @param cr The ContentResolver to access.
8465 * @param name The name of the setting to modify.
8466 * @param value The new value for the setting.
8467 * @return true if the value was set, false on database errors
8468 */
8469 public static boolean putInt(ContentResolver cr, String name, int value) {
8470 return putString(cr, name, Integer.toString(value));
8471 }
8472
8473 /**
8474 * Convenience function for retrieving a single secure settings value
8475 * as a {@code long}. Note that internally setting values are always
8476 * stored as strings; this function converts the string to a {@code long}
8477 * for you. The default value will be returned if the setting is
8478 * not defined or not a {@code long}.
8479 *
8480 * @param cr The ContentResolver to access.
8481 * @param name The name of the setting to retrieve.
8482 * @param def Value to return if the setting is not defined.
8483 *
8484 * @return The setting's current value, or 'def' if it is not defined
8485 * or not a valid {@code long}.
8486 */
8487 public static long getLong(ContentResolver cr, String name, long def) {
8488 String valString = getString(cr, name);
8489 long value;
8490 try {
8491 value = valString != null ? Long.parseLong(valString) : def;
8492 } catch (NumberFormatException e) {
8493 value = def;
8494 }
8495 return value;
8496 }
8497
8498 /**
8499 * Convenience function for retrieving a single secure settings value
8500 * as a {@code long}. Note that internally setting values are always
8501 * stored as strings; this function converts the string to a {@code long}
8502 * for you.
8503 * <p>
8504 * This version does not take a default value. If the setting has not
8505 * been set, or the string value is not a number,
8506 * it throws {@link SettingNotFoundException}.
8507 *
8508 * @param cr The ContentResolver to access.
8509 * @param name The name of the setting to retrieve.
8510 *
8511 * @return The setting's current value.
8512 * @throws SettingNotFoundException Thrown if a setting by the given
8513 * name can't be found or the setting value is not an integer.
8514 */
8515 public static long getLong(ContentResolver cr, String name)
8516 throws SettingNotFoundException {
8517 String valString = getString(cr, name);
8518 try {
8519 return Long.parseLong(valString);
8520 } catch (NumberFormatException e) {
8521 throw new SettingNotFoundException(name);
8522 }
8523 }
8524
8525 /**
8526 * Convenience function for updating a secure settings value as a long
8527 * integer. This will either create a new entry in the table if the
8528 * given name does not exist, or modify the value of the existing row
8529 * with that name. Note that internally setting values are always
8530 * stored as strings, so this function converts the given value to a
8531 * string before storing it.
8532 *
8533 * @param cr The ContentResolver to access.
8534 * @param name The name of the setting to modify.
8535 * @param value The new value for the setting.
8536 * @return true if the value was set, false on database errors
8537 */
8538 public static boolean putLong(ContentResolver cr, String name, long value) {
8539 return putString(cr, name, Long.toString(value));
8540 }
8541
8542 /**
8543 * Convenience function for retrieving a single secure settings value
8544 * as a floating point number. Note that internally setting values are
8545 * always stored as strings; this function converts the string to an
8546 * float for you. The default value will be returned if the setting
8547 * is not defined or not a valid float.
8548 *
8549 * @param cr The ContentResolver to access.
8550 * @param name The name of the setting to retrieve.
8551 * @param def Value to return if the setting is not defined.
8552 *
8553 * @return The setting's current value, or 'def' if it is not defined
8554 * or not a valid float.
8555 */
8556 public static float getFloat(ContentResolver cr, String name, float def) {
8557 String v = getString(cr, name);
8558 try {
8559 return v != null ? Float.parseFloat(v) : def;
8560 } catch (NumberFormatException e) {
8561 return def;
8562 }
8563 }
8564
8565 /**
8566 * Convenience function for retrieving a single secure settings value
8567 * as a float. Note that internally setting values are always
8568 * stored as strings; this function converts the string to a float
8569 * for you.
8570 * <p>
8571 * This version does not take a default value. If the setting has not
8572 * been set, or the string value is not a number,
8573 * it throws {@link SettingNotFoundException}.
8574 *
8575 * @param cr The ContentResolver to access.
8576 * @param name The name of the setting to retrieve.
8577 *
8578 * @throws SettingNotFoundException Thrown if a setting by the given
8579 * name can't be found or the setting value is not a float.
8580 *
8581 * @return The setting's current value.
8582 */
8583 public static float getFloat(ContentResolver cr, String name)
8584 throws SettingNotFoundException {
8585 String v = getString(cr, name);
8586 if (v == null) {
8587 throw new SettingNotFoundException(name);
8588 }
8589 try {
8590 return Float.parseFloat(v);
8591 } catch (NumberFormatException e) {
8592 throw new SettingNotFoundException(name);
8593 }
8594 }
8595
8596 /**
8597 * Convenience function for updating a single settings value as a
8598 * floating point number. This will either create a new entry in the
8599 * table if the given name does not exist, or modify the value of the
8600 * existing row with that name. Note that internally setting values
8601 * are always stored as strings, so this function converts the given
8602 * value to a string before storing it.
8603 *
8604 * @param cr The ContentResolver to access.
8605 * @param name The name of the setting to modify.
8606 * @param value The new value for the setting.
8607 * @return true if the value was set, false on database errors
8608 */
8609 public static boolean putFloat(ContentResolver cr, String name, float value) {
8610 return putString(cr, name, Float.toString(value));
8611 }
Wink Savillefb40dd42014-06-12 17:02:31 -07008612
8613
8614 /**
8615 * Subscription to be used for voice call on a multi sim device. The supported values
8616 * are 0 = SUB1, 1 = SUB2 and etc.
8617 * @hide
8618 */
8619 public static final String MULTI_SIM_VOICE_CALL_SUBSCRIPTION = "multi_sim_voice_call";
8620
8621 /**
8622 * Used to provide option to user to select subscription during dial.
8623 * The supported values are 0 = disable or 1 = enable prompt.
8624 * @hide
8625 */
8626 public static final String MULTI_SIM_VOICE_PROMPT = "multi_sim_voice_prompt";
8627
8628 /**
8629 * Subscription to be used for data call on a multi sim device. The supported values
8630 * are 0 = SUB1, 1 = SUB2 and etc.
8631 * @hide
8632 */
8633 public static final String MULTI_SIM_DATA_CALL_SUBSCRIPTION = "multi_sim_data_call";
8634
8635 /**
8636 * Subscription to be used for SMS on a multi sim device. The supported values
8637 * are 0 = SUB1, 1 = SUB2 and etc.
8638 * @hide
8639 */
8640 public static final String MULTI_SIM_SMS_SUBSCRIPTION = "multi_sim_sms";
8641
8642 /**
8643 * Used to provide option to user to select subscription during send SMS.
8644 * The value 1 - enable, 0 - disable
8645 * @hide
8646 */
8647 public static final String MULTI_SIM_SMS_PROMPT = "multi_sim_sms_prompt";
8648
8649
8650
8651 /** User preferred subscriptions setting.
8652 * This holds the details of the user selected subscription from the card and
8653 * the activation status. Each settings string have the coma separated values
8654 * iccId,appType,appId,activationStatus,3gppIndex,3gpp2Index
8655 * @hide
8656 */
8657 public static final String[] MULTI_SIM_USER_PREFERRED_SUBS = {"user_preferred_sub1",
8658 "user_preferred_sub2","user_preferred_sub3"};
Zheng Fub218ff42015-04-13 16:31:16 -07008659
8660 /**
8661 * Whether to enable new contacts aggregator or not.
8662 * The value 1 - enable, 0 - disable
8663 * @hide
8664 */
8665 public static final String NEW_CONTACT_AGGREGATOR = "new_contact_aggregator";
Zheng Fu31ce78c2015-04-15 16:57:53 -07008666
8667 /**
8668 * Whether to enable contacts metadata syncing or not
8669 * The value 1 - enable, 0 - disable
Zheng Fu31ce78c2015-04-15 16:57:53 -07008670 */
8671 public static final String CONTACT_METADATA_SYNC = "contact_metadata_sync";
Wei Liua1817702015-08-11 21:21:12 -07008672
8673 /**
8674 * Whether to enable cellular on boot.
8675 * The value 1 - enable, 0 - disable
8676 * @hide
8677 */
8678 public static final String ENABLE_CELLULAR_ON_BOOT = "enable_cellular_on_boot";
Christopher Tate06efb532012-08-24 15:29:27 -07008679 }
8680
8681 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08008682 * User-defined bookmarks and shortcuts. The target of each bookmark is an
8683 * Intent URL, allowing it to be either a web page or a particular
8684 * application activity.
8685 *
8686 * @hide
8687 */
8688 public static final class Bookmarks implements BaseColumns
8689 {
8690 private static final String TAG = "Bookmarks";
8691
8692 /**
8693 * The content:// style URL for this table
8694 */
8695 public static final Uri CONTENT_URI =
8696 Uri.parse("content://" + AUTHORITY + "/bookmarks");
8697
8698 /**
8699 * The row ID.
8700 * <p>Type: INTEGER</p>
8701 */
8702 public static final String ID = "_id";
8703
8704 /**
8705 * Descriptive name of the bookmark that can be displayed to the user.
8706 * If this is empty, the title should be resolved at display time (use
8707 * {@link #getTitle(Context, Cursor)} any time you want to display the
8708 * title of a bookmark.)
8709 * <P>
8710 * Type: TEXT
8711 * </P>
8712 */
8713 public static final String TITLE = "title";
8714
8715 /**
8716 * Arbitrary string (displayed to the user) that allows bookmarks to be
8717 * organized into categories. There are some special names for
8718 * standard folders, which all start with '@'. The label displayed for
8719 * the folder changes with the locale (via {@link #getLabelForFolder}) but
8720 * the folder name does not change so you can consistently query for
8721 * the folder regardless of the current locale.
8722 *
8723 * <P>Type: TEXT</P>
8724 *
8725 */
8726 public static final String FOLDER = "folder";
8727
8728 /**
8729 * The Intent URL of the bookmark, describing what it points to. This
8730 * value is given to {@link android.content.Intent#getIntent} to create
8731 * an Intent that can be launched.
8732 * <P>Type: TEXT</P>
8733 */
8734 public static final String INTENT = "intent";
8735
8736 /**
8737 * Optional shortcut character associated with this bookmark.
8738 * <P>Type: INTEGER</P>
8739 */
8740 public static final String SHORTCUT = "shortcut";
8741
8742 /**
8743 * The order in which the bookmark should be displayed
8744 * <P>Type: INTEGER</P>
8745 */
8746 public static final String ORDERING = "ordering";
8747
8748 private static final String[] sIntentProjection = { INTENT };
8749 private static final String[] sShortcutProjection = { ID, SHORTCUT };
8750 private static final String sShortcutSelection = SHORTCUT + "=?";
8751
8752 /**
8753 * Convenience function to retrieve the bookmarked Intent for a
8754 * particular shortcut key.
8755 *
8756 * @param cr The ContentResolver to query.
8757 * @param shortcut The shortcut key.
8758 *
8759 * @return Intent The bookmarked URL, or null if there is no bookmark
8760 * matching the given shortcut.
8761 */
8762 public static Intent getIntentForShortcut(ContentResolver cr, char shortcut)
8763 {
8764 Intent intent = null;
8765
8766 Cursor c = cr.query(CONTENT_URI,
8767 sIntentProjection, sShortcutSelection,
8768 new String[] { String.valueOf((int) shortcut) }, ORDERING);
8769 // Keep trying until we find a valid shortcut
8770 try {
8771 while (intent == null && c.moveToNext()) {
8772 try {
8773 String intentURI = c.getString(c.getColumnIndexOrThrow(INTENT));
Christian Mehlmauera34d2c92010-05-25 19:04:20 +02008774 intent = Intent.parseUri(intentURI, 0);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08008775 } catch (java.net.URISyntaxException e) {
8776 // The stored URL is bad... ignore it.
8777 } catch (IllegalArgumentException e) {
8778 // Column not found
Dianne Hackborna33e3f72009-09-29 17:28:24 -07008779 Log.w(TAG, "Intent column not found", e);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08008780 }
8781 }
8782 } finally {
8783 if (c != null) c.close();
8784 }
8785
8786 return intent;
8787 }
8788
8789 /**
8790 * Add a new bookmark to the system.
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07008791 *
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08008792 * @param cr The ContentResolver to query.
8793 * @param intent The desired target of the bookmark.
8794 * @param title Bookmark title that is shown to the user; null if none
8795 * or it should be resolved to the intent's title.
8796 * @param folder Folder in which to place the bookmark; null if none.
8797 * @param shortcut Shortcut that will invoke the bookmark; 0 if none. If
8798 * this is non-zero and there is an existing bookmark entry
8799 * with this same shortcut, then that existing shortcut is
8800 * cleared (the bookmark is not removed).
8801 * @return The unique content URL for the new bookmark entry.
8802 */
8803 public static Uri add(ContentResolver cr,
8804 Intent intent,
8805 String title,
8806 String folder,
8807 char shortcut,
8808 int ordering)
8809 {
8810 // If a shortcut is supplied, and it is already defined for
8811 // another bookmark, then remove the old definition.
8812 if (shortcut != 0) {
Jeff Hamilton7cd51ef2010-05-12 17:30:27 -05008813 cr.delete(CONTENT_URI, sShortcutSelection,
8814 new String[] { String.valueOf((int) shortcut) });
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08008815 }
8816
8817 ContentValues values = new ContentValues();
8818 if (title != null) values.put(TITLE, title);
8819 if (folder != null) values.put(FOLDER, folder);
Jean-Baptiste Queru3b9f0a32010-06-21 13:46:59 -07008820 values.put(INTENT, intent.toUri(0));
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08008821 if (shortcut != 0) values.put(SHORTCUT, (int) shortcut);
8822 values.put(ORDERING, ordering);
8823 return cr.insert(CONTENT_URI, values);
8824 }
8825
8826 /**
8827 * Return the folder name as it should be displayed to the user. This
8828 * takes care of localizing special folders.
8829 *
8830 * @param r Resources object for current locale; only need access to
8831 * system resources.
8832 * @param folder The value found in the {@link #FOLDER} column.
8833 *
8834 * @return CharSequence The label for this folder that should be shown
8835 * to the user.
8836 */
8837 public static CharSequence getLabelForFolder(Resources r, String folder) {
8838 return folder;
8839 }
8840
8841 /**
8842 * Return the title as it should be displayed to the user. This takes
8843 * care of localizing bookmarks that point to activities.
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07008844 *
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08008845 * @param context A context.
8846 * @param cursor A cursor pointing to the row whose title should be
8847 * returned. The cursor must contain at least the {@link #TITLE}
8848 * and {@link #INTENT} columns.
8849 * @return A title that is localized and can be displayed to the user,
8850 * or the empty string if one could not be found.
8851 */
8852 public static CharSequence getTitle(Context context, Cursor cursor) {
8853 int titleColumn = cursor.getColumnIndex(TITLE);
8854 int intentColumn = cursor.getColumnIndex(INTENT);
8855 if (titleColumn == -1 || intentColumn == -1) {
8856 throw new IllegalArgumentException(
8857 "The cursor must contain the TITLE and INTENT columns.");
8858 }
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07008859
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08008860 String title = cursor.getString(titleColumn);
8861 if (!TextUtils.isEmpty(title)) {
8862 return title;
8863 }
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07008864
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08008865 String intentUri = cursor.getString(intentColumn);
8866 if (TextUtils.isEmpty(intentUri)) {
8867 return "";
8868 }
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07008869
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08008870 Intent intent;
8871 try {
Christian Mehlmauera34d2c92010-05-25 19:04:20 +02008872 intent = Intent.parseUri(intentUri, 0);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08008873 } catch (URISyntaxException e) {
8874 return "";
8875 }
Jaikumar Ganesh9bfbfbd2009-05-15 12:05:56 -07008876
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08008877 PackageManager packageManager = context.getPackageManager();
8878 ResolveInfo info = packageManager.resolveActivity(intent, 0);
8879 return info != null ? info.loadLabel(packageManager) : "";
8880 }
8881 }
8882
8883 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08008884 * Returns the device ID that we should use when connecting to the mobile gtalk server.
8885 * This is a string like "android-0x1242", where the hex string is the Android ID obtained
8886 * from the GoogleLoginService.
8887 *
8888 * @param androidId The Android ID for this device.
8889 * @return The device ID that should be used when connecting to the mobile gtalk server.
8890 * @hide
8891 */
8892 public static String getGTalkDeviceId(long androidId) {
8893 return "android-" + Long.toHexString(androidId);
8894 }
Billy Lau6ad2d662015-07-18 00:26:58 +01008895
Billy Laua7238a32015-08-01 12:45:02 +01008896 private static final String[] PM_WRITE_SETTINGS = {
8897 android.Manifest.permission.WRITE_SETTINGS
8898 };
8899 private static final String[] PM_CHANGE_NETWORK_STATE = {
8900 android.Manifest.permission.CHANGE_NETWORK_STATE,
8901 android.Manifest.permission.WRITE_SETTINGS
8902 };
8903 private static final String[] PM_SYSTEM_ALERT_WINDOW = {
8904 android.Manifest.permission.SYSTEM_ALERT_WINDOW
8905 };
8906
Billy Lau6ad2d662015-07-18 00:26:58 +01008907 /**
8908 * Performs a strict and comprehensive check of whether a calling package is allowed to
8909 * write/modify system settings, as the condition differs for pre-M, M+, and
8910 * privileged/preinstalled apps. If the provided uid does not match the
8911 * callingPackage, a negative result will be returned.
8912 * @hide
8913 */
8914 public static boolean isCallingPackageAllowedToWriteSettings(Context context, int uid,
8915 String callingPackage, boolean throwException) {
8916 return isCallingPackageAllowedToPerformAppOpsProtectedOperation(context, uid,
8917 callingPackage, throwException, AppOpsManager.OP_WRITE_SETTINGS,
Billy Laua7238a32015-08-01 12:45:02 +01008918 PM_WRITE_SETTINGS, false);
Billy Lau6ad2d662015-07-18 00:26:58 +01008919 }
8920
8921 /**
8922 * Performs a strict and comprehensive check of whether a calling package is allowed to
8923 * write/modify system settings, as the condition differs for pre-M, M+, and
8924 * privileged/preinstalled apps. If the provided uid does not match the
Billy Laua7238a32015-08-01 12:45:02 +01008925 * callingPackage, a negative result will be returned. The caller is expected to have
Lorenzo Colittid5427052015-10-15 16:29:00 +09008926 * the WRITE_SETTINGS permission declared.
Billy Lau6ad2d662015-07-18 00:26:58 +01008927 *
8928 * Note: if the check is successful, the operation of this app will be updated to the
8929 * current time.
8930 * @hide
8931 */
8932 public static boolean checkAndNoteWriteSettingsOperation(Context context, int uid,
8933 String callingPackage, boolean throwException) {
8934 return isCallingPackageAllowedToPerformAppOpsProtectedOperation(context, uid,
8935 callingPackage, throwException, AppOpsManager.OP_WRITE_SETTINGS,
Billy Laua7238a32015-08-01 12:45:02 +01008936 PM_WRITE_SETTINGS, true);
8937 }
8938
8939 /**
8940 * Performs a strict and comprehensive check of whether a calling package is allowed to
8941 * change the state of network, as the condition differs for pre-M, M+, and
Lorenzo Colittid5427052015-10-15 16:29:00 +09008942 * privileged/preinstalled apps. The caller is expected to have either the
8943 * CHANGE_NETWORK_STATE or the WRITE_SETTINGS permission declared. Either of these
8944 * permissions allow changing network state; WRITE_SETTINGS is a runtime permission and
8945 * can be revoked, but (except in M, excluding M MRs), CHANGE_NETWORK_STATE is a normal
8946 * permission and cannot be revoked. See http://b/23597341
Billy Laua7238a32015-08-01 12:45:02 +01008947 *
Lorenzo Colittid5427052015-10-15 16:29:00 +09008948 * Note: if the check succeeds because the application holds WRITE_SETTINGS, the operation
8949 * of this app will be updated to the current time.
Billy Laua7238a32015-08-01 12:45:02 +01008950 * @hide
8951 */
8952 public static boolean checkAndNoteChangeNetworkStateOperation(Context context, int uid,
8953 String callingPackage, boolean throwException) {
Lorenzo Colittid5427052015-10-15 16:29:00 +09008954 if (context.checkCallingOrSelfPermission(android.Manifest.permission.CHANGE_NETWORK_STATE)
8955 == PackageManager.PERMISSION_GRANTED) {
8956 return true;
8957 }
Billy Laua7238a32015-08-01 12:45:02 +01008958 return isCallingPackageAllowedToPerformAppOpsProtectedOperation(context, uid,
8959 callingPackage, throwException, AppOpsManager.OP_WRITE_SETTINGS,
8960 PM_CHANGE_NETWORK_STATE, true);
Billy Lau6ad2d662015-07-18 00:26:58 +01008961 }
8962
8963 /**
8964 * Performs a strict and comprehensive check of whether a calling package is allowed to
8965 * draw on top of other apps, as the conditions differs for pre-M, M+, and
8966 * privileged/preinstalled apps. If the provided uid does not match the callingPackage,
8967 * a negative result will be returned.
8968 * @hide
8969 */
8970 public static boolean isCallingPackageAllowedToDrawOverlays(Context context, int uid,
8971 String callingPackage, boolean throwException) {
8972 return isCallingPackageAllowedToPerformAppOpsProtectedOperation(context, uid,
8973 callingPackage, throwException, AppOpsManager.OP_SYSTEM_ALERT_WINDOW,
Billy Laua7238a32015-08-01 12:45:02 +01008974 PM_SYSTEM_ALERT_WINDOW, false);
Billy Lau6ad2d662015-07-18 00:26:58 +01008975 }
8976
8977 /**
8978 * Performs a strict and comprehensive check of whether a calling package is allowed to
8979 * draw on top of other apps, as the conditions differs for pre-M, M+, and
8980 * privileged/preinstalled apps. If the provided uid does not match the callingPackage,
8981 * a negative result will be returned.
8982 *
8983 * Note: if the check is successful, the operation of this app will be updated to the
8984 * current time.
8985 * @hide
8986 */
8987 public static boolean checkAndNoteDrawOverlaysOperation(Context context, int uid, String
8988 callingPackage, boolean throwException) {
8989 return isCallingPackageAllowedToPerformAppOpsProtectedOperation(context, uid,
8990 callingPackage, throwException, AppOpsManager.OP_SYSTEM_ALERT_WINDOW,
Billy Laua7238a32015-08-01 12:45:02 +01008991 PM_SYSTEM_ALERT_WINDOW, true);
Billy Lau6ad2d662015-07-18 00:26:58 +01008992 }
8993
8994 /**
8995 * Helper method to perform a general and comprehensive check of whether an operation that is
8996 * protected by appops can be performed by a caller or not. e.g. OP_SYSTEM_ALERT_WINDOW and
8997 * OP_WRITE_SETTINGS
8998 * @hide
8999 */
9000 public static boolean isCallingPackageAllowedToPerformAppOpsProtectedOperation(Context context,
Billy Laua7238a32015-08-01 12:45:02 +01009001 int uid, String callingPackage, boolean throwException, int appOpsOpCode, String[]
9002 permissions, boolean makeNote) {
Billy Lau6ad2d662015-07-18 00:26:58 +01009003 if (callingPackage == null) {
9004 return false;
9005 }
9006
9007 AppOpsManager appOpsMgr = (AppOpsManager)context.getSystemService(Context.APP_OPS_SERVICE);
9008 int mode = AppOpsManager.MODE_DEFAULT;
9009 if (makeNote) {
9010 mode = appOpsMgr.noteOpNoThrow(appOpsOpCode, uid, callingPackage);
9011 } else {
9012 mode = appOpsMgr.checkOpNoThrow(appOpsOpCode, uid, callingPackage);
9013 }
9014
9015 switch (mode) {
9016 case AppOpsManager.MODE_ALLOWED:
9017 return true;
Billy Laua7238a32015-08-01 12:45:02 +01009018
Billy Lau6ad2d662015-07-18 00:26:58 +01009019 case AppOpsManager.MODE_DEFAULT:
9020 // this is the default operating mode after an app's installation
Billy Laua7238a32015-08-01 12:45:02 +01009021 // In this case we will check all associated static permission to see
9022 // if it is granted during install time.
9023 for (String permission : permissions) {
9024 if (context.checkCallingOrSelfPermission(permission) == PackageManager
9025 .PERMISSION_GRANTED) {
9026 // if either of the permissions are granted, we will allow it
9027 return true;
9028 }
Billy Lau6ad2d662015-07-18 00:26:58 +01009029 }
Billy Laua7238a32015-08-01 12:45:02 +01009030
Billy Lau6ad2d662015-07-18 00:26:58 +01009031 default:
9032 // this is for all other cases trickled down here...
9033 if (!throwException) {
9034 return false;
9035 }
9036 }
Billy Laua7238a32015-08-01 12:45:02 +01009037
9038 // prepare string to throw SecurityException
9039 StringBuilder exceptionMessage = new StringBuilder();
9040 exceptionMessage.append(callingPackage);
9041 exceptionMessage.append(" was not granted ");
9042 if (permissions.length > 1) {
9043 exceptionMessage.append(" either of these permissions: ");
9044 } else {
9045 exceptionMessage.append(" this permission: ");
9046 }
9047 for (int i = 0; i < permissions.length; i++) {
9048 exceptionMessage.append(permissions[i]);
9049 exceptionMessage.append((i == permissions.length - 1) ? "." : ", ");
9050 }
9051
9052 throw new SecurityException(exceptionMessage.toString());
Billy Lau6ad2d662015-07-18 00:26:58 +01009053 }
9054
9055 /**
9056 * Retrieves a correponding package name for a given uid. It will query all
9057 * packages that are associated with the given uid, but it will return only
9058 * the zeroth result.
9059 * Note: If package could not be found, a null is returned.
9060 * @hide
9061 */
9062 public static String getPackageNameForUid(Context context, int uid) {
9063 String[] packages = context.getPackageManager().getPackagesForUid(uid);
9064 if (packages == null) {
9065 return null;
9066 }
9067 return packages[0];
9068 }
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08009069}