Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: Added note in getCacheDir() that developers can use directory

Browse Source 
obtained from getExternalCacheDir() to store app caches larger than
1 MB.

Bug: 22505268
Change-Id: I9972ba5ef7b43a135c00ac48a2e5ccb1fcc5b103
This commit is contained in:
Kevin Hufnagle
2016-09-23 16:44:03 -07:00
parent d91c303e6c
commit e9681e192a
1 changed files with 5 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
core/java/android/content/Context.java
View File

@@ -1130,7 +1130,9 @@ public abstract class Context {
* <strong>Note: you should not <em>rely</em> on the system deleting these * <strong>Note: you should not <em>rely</em> on the system deleting these
* files for you; you should always have a reasonable maximum, such as 1 MB, * files for you; you should always have a reasonable maximum, such as 1 MB,
* for the amount of space you consume with cache files, and prune those * for the amount of space you consume with cache files, and prune those
* files when exceeding that space.</strong> * files when exceeding that space.</strong> If your app requires a larger
* cache (larger than 1 MB), you should use {@link #getExternalCacheDir()}
* instead.
* <p> * <p>
* The returned path may change over time if the calling app is moved to an * The returned path may change over time if the calling app is moved to an
* adopted storage device, so only relative paths should be persisted. * adopted storage device, so only relative paths should be persisted.
@@ -1142,6 +1144,7 @@ public abstract class Context {
* @see #openFileOutput * @see #openFileOutput
* @see #getFileStreamPath * @see #getFileStreamPath
* @see #getDir * @see #getDir
* @see #getExternalCacheDir
*/ */
public abstract File getCacheDir(); public abstract File getCacheDir();
@@ -1190,7 +1193,7 @@ public abstract class Context {
* </ul> * </ul>
* <p> * <p>
* If a shared storage device is emulated (as determined by * If a shared storage device is emulated (as determined by
* {@link Environment#isExternalStorageEmulated(File)}), it's contents are * {@link Environment#isExternalStorageEmulated(File)}), its contents are
* backed by a private user data partition, which means there is little * backed by a private user data partition, which means there is little
* benefit to storing data here instead of the private directory returned by * benefit to storing data here instead of the private directory returned by
* {@link #getCacheDir()}. * {@link #getCacheDir()}.