Merge "Fix storage directory API docs" into sc-dev

This commit is contained in:
TreeHugger Robot
2021-05-27 20:34:54 +00:00
committed by Android (Google) Code Review

View File

@@ -698,14 +698,9 @@ public class Environment {
* *
* @see #getExternalStorageState() * @see #getExternalStorageState()
* @see #isExternalStorageRemovable() * @see #isExternalStorageRemovable()
* @deprecated To improve user privacy, direct access to shared/external * @deprecated Alternatives such as {@link Context#getExternalFilesDir(String)},
* storage devices is deprecated. When an app targets * {@link MediaStore}, or {@link Intent#ACTION_OPEN_DOCUMENT} offer better
* {@link android.os.Build.VERSION_CODES#Q}, the path returned * performance.
* from this method is no longer directly accessible to apps.
* Apps can continue to access content stored on shared/external
* storage by migrating to alternatives such as
* {@link Context#getExternalFilesDir(String)},
* {@link MediaStore}, or {@link Intent#ACTION_OPEN_DOCUMENT}.
*/ */
@Deprecated @Deprecated
public static File getExternalStorageDirectory() { public static File getExternalStorageDirectory() {
@@ -1014,14 +1009,9 @@ public class Environment {
* @return Returns the File path for the directory. Note that this directory * @return Returns the File path for the directory. Note that this directory
* may not yet exist, so you must make sure it exists before using * may not yet exist, so you must make sure it exists before using
* it such as with {@link File#mkdirs File.mkdirs()}. * it such as with {@link File#mkdirs File.mkdirs()}.
* @deprecated To improve user privacy, direct access to shared/external * @deprecated Alternatives such as {@link Context#getExternalFilesDir(String)},
* storage devices is deprecated. When an app targets * {@link MediaStore}, or {@link Intent#ACTION_OPEN_DOCUMENT} offer better
* {@link android.os.Build.VERSION_CODES#Q}, the path returned * performance.
* from this method is no longer directly accessible to apps.
* Apps can continue to access content stored on shared/external
* storage by migrating to alternatives such as
* {@link Context#getExternalFilesDir(String)},
* {@link MediaStore}, or {@link Intent#ACTION_OPEN_DOCUMENT}.
*/ */
@Deprecated @Deprecated
public static File getExternalStoragePublicDirectory(String type) { public static File getExternalStoragePublicDirectory(String type) {