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

Merge "docs: Update READ_EXTERNAL_STORAGE explanation" into tm-dev am: 19a290e320

Browse Source 
Original change: https://googleplex-android-review.googlesource.com/c/platform/frameworks/base/+/20066630

Change-Id: Ifda6a4f15f2ab787be64883bda898b13818ef704
Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
This commit is contained in:
Kevin Hufnagle
2022-10-13 16:37:15 +00:00
committed by Automerger Merge Worker
parent cd0d5d1e67 19a290e320
commit 117f42954d
1 changed files with 21 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

29
core/res/AndroidManifest.xml
View File

@@ -1035,25 +1035,38 @@
android:priority="900" /> android:priority="900" />
<!-- Allows an application to read from external storage. <!-- Allows an application to read from external storage.
<p>Any app that declares the {@link #WRITE_EXTERNAL_STORAGE} permission is implicitly <p class="note"><strong>Note: </strong>Starting in API level 33, this permission has no
granted this permission.</p> effect. If your app accesses other apps' media files, request one or more of these permissions
instead: <a href="#READ_MEDIA_IMAGES"><code>READ_MEDIA_IMAGES</code></a>,
<a href="#READ_MEDIA_VIDEO"><code>READ_MEDIA_VIDEO</code></a>,
<a href="#READ_MEDIA_AUDIO"><code>READ_MEDIA_AUDIO</code></a>. Learn more about the
<a href="{@docRoot}training/data-storage/shared/media#storage-permission">storage
permissions</a> that are associated with media files.</p>
<p>This permission is enforced starting in API level 19. Before API level 19, this <p>This permission is enforced starting in API level 19. Before API level 19, this
permission is not enforced and all apps still have access to read from external storage. permission is not enforced and all apps still have access to read from external storage.
You can test your app with the permission enforced by enabling <em>Protect USB You can test your app with the permission enforced by enabling <em>Protect USB
storage</em> under Developer options in the Settings app on a device running Android 4.1 or storage</em> under <b>Developer options</b> in the Settings app on a device running Android
higher.</p> 4.1 or higher.</p>
<p>Also starting in API level 19, this permission is <em>not</em> required to <p>Also starting in API level 19, this permission is <em>not</em> required to
read/write files in your application-specific directories returned by read or write files in your application-specific directories returned by
{@link android.content.Context#getExternalFilesDir} and {@link android.content.Context#getExternalFilesDir} and
{@link android.content.Context#getExternalCacheDir}. {@link android.content.Context#getExternalCacheDir}.</p>
<p class="note"><strong>Note:</strong> If <em>both</em> your <a <p>Starting in API level 29, apps don't need to request this permission to access files in
their app-specific directory on external storage, or their own files in the
<a href="{@docRoot}reference/android/provider/MediaStore"><code>MediaStore</code></a>. Apps
shouldn't request this permission unless they need to access other apps' files in the
<code>MediaStore</code>. Read more about these changes in the
<a href="{@docRoot}training/data-storage#scoped-storage">scoped storage</a> section of the
developer documentation.</p>
<p>If <em>both</em> your <a
href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#min">{@code href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#min">{@code
minSdkVersion}</a> and <a minSdkVersion}</a> and <a
href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#target">{@code href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#target">{@code
targetSdkVersion}</a> values are set to 3 or lower, the system implicitly targetSdkVersion}</a> values are set to 3 or lower, the system implicitly
grants your app this permission. If you don't need this permission, be sure your <a grants your app this permission. If you don't need this permission, be sure your <a
href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#target">{@code href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#target">{@code
targetSdkVersion}</a> is 4 or higher. targetSdkVersion}</a> is 4 or higher.</p>
<p> This is a soft restricted permission which cannot be held by an app it its <p> This is a soft restricted permission which cannot be held by an app it its
full form until the installer on record allowlists the permission. full form until the installer on record allowlists the permission.