diff options
author | android-build-team Robot <android-build-team-robot@google.com> | 2017-09-14 01:03:31 +0000 |
---|---|---|
committer | android-build-team Robot <android-build-team-robot@google.com> | 2017-09-14 01:03:31 +0000 |
commit | 176d8c218f0e4b6b086db7518e378168e8f123ae (patch) | |
tree | afcb1b167f48adb6d377c2ec134a5bdc617f899b | |
parent | d288e88c4988b9589380b112e046a37f69214cf1 (diff) | |
parent | c8ede1e96601ef62521b982c0928d8126cee4dc3 (diff) | |
download | base-176d8c218f0e4b6b086db7518e378168e8f123ae.tar.gz |
release-request-1a7d12a2-ef0c-40db-94e7-136665cd04ea-for-git_oc-vts-release-4334420 snap-temp-L11800000102280223
Change-Id: Ib3b77e1e86e7aacc432aab482a9498d579b41725
-rwxr-xr-x | core/java/android/provider/Settings.java | 42 |
1 files changed, 32 insertions, 10 deletions
diff --git a/core/java/android/provider/Settings.java b/core/java/android/provider/Settings.java index b7514fd6df2c..26f9cd99300d 100755 --- a/core/java/android/provider/Settings.java +++ b/core/java/android/provider/Settings.java @@ -5106,17 +5106,39 @@ public final class Settings { public static final String ALLOW_MOCK_LOCATION = "mock_location"; /** - * A 64-bit number (as a hex string) that is randomly + * On Android 8.0 (API level 26) and higher versions of the platform, + * a 64-bit number (expressed as a hexadecimal string), unique to + * each combination of app-signing key, user, and device. + * Values of {@code ANDROID_ID} are scoped by signing key and user. + * The value may change if a factory reset is performed on the + * device or if an APK signing key changes. + * + * For more information about how the platform handles {@code ANDROID_ID} + * in Android 8.0 (API level 26) and higher, see <a + * href="{@docRoot}preview/behavior-changes.html#privacy-all"> + * Android 8.0 Behavior Changes</a>. + * + * <p class="note"><strong>Note:</strong> For apps that were installed + * prior to updating the device to a version of Android 8.0 + * (API level 26) or higher, the value of {@code ANDROID_ID} changes + * if the app is uninstalled and then reinstalled after the OTA. + * To preserve values across uninstalls after an OTA to Android 8.0 + * or higher, developers can use + * <a href="{@docRoot}guide/topics/data/keyvaluebackup.html"> + * Key/Value Backup</a>.</p> + * + * <p>In versions of the platform lower than Android 8.0 (API level 26), + * a 64-bit number (expressed as a hexadecimal string) that is randomly * generated when the user first sets up the device and should remain - * constant for the lifetime of the user's device. The value may - * change if a factory reset is performed on the device. - * <p class="note"><strong>Note:</strong> When a device has <a - * href="{@docRoot}about/versions/android-4.2.html#MultipleUsers">multiple users</a> - * (available on certain devices running Android 4.2 or higher), each user appears as a - * completely separate device, so the {@code ANDROID_ID} value is unique to each - * user.</p> - * - * <p class="note"><strong>Note:</strong> If the caller is an Instant App the id is scoped + * constant for the lifetime of the user's device. + * + * On devices that have + * <a href="{@docRoot}about/versions/android-4.2.html#MultipleUsers"> + * multiple users</a>, each user appears as a + * completely separate device, so the {@code ANDROID_ID} value is + * unique to each user.</p> + * + * <p class="note"><strong>Note:</strong> If the caller is an Instant App the ID is scoped * to the Instant App, it is generated when the Instant App is first installed and reset if * the user clears the Instant App. */ |