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

Merge "Merge "docs: Update WRITE_EXTERNAL_STORAGE explanation" into tm-dev am: d13571c313" into tm-d1-dev

Browse Source
This commit is contained in:
Automerger Merge Worker
2022-10-21 17:37:09 +00:00
committed by Android (Google) Code Review
parent 1597cde579 90e7948c14
commit f3b78c6624
1 changed files with 22 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

29
core/res/AndroidManifest.xml
View File

@@ -1147,7 +1147,28 @@
android:protectionLevel="dangerous" />
<!-- Allows an application to write to external storage.
<p class="note"><strong>Note:</strong> If <em>both</em> your <a
<p><strong>Note: </strong>If your app targets {@link android.os.Build.VERSION_CODES#R} or
higher, this permission has no effect.
<p>If your app is on a device that runs API level 19 or higher, you don't need to declare
this permission to read and write files in your application-specific directories returned
by {@link android.content.Context#getExternalFilesDir} and
{@link android.content.Context#getExternalCacheDir}.
<p>Learn more about how to
<a href="{@docRoot}training/data-storage/shared/media#update-other-apps-files">modify media
files</a> that your app doesn't own, and how to
<a href="{@docRoot}training/data-storage/shared/documents-files">modify non-media files</a>
that your app doesn't own.
<p>If your app is a file manager and needs broad access to external storage files, then
the system must place your app on an allowlist so that you can successfully request the
<a href="#MANAGE_EXTERNAL_STORAGE><code>MANAGE_EXTERNAL_STORAGE</code></a> permission.
Learn more about the appropriate use cases for
<a href="{@docRoot}training/data-storage/manage-all-files>managing all files on a storage
device</a>.
<p>If <em>both</em> your <a
href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#min">{@code
minSdkVersion}</a> and <a
href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#target">{@code
@@ -1155,12 +1176,6 @@
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
targetSdkVersion}</a> is 4 or higher.
<p>Starting in API level 19, this permission is <em>not</em> required to
read/write files in your application-specific directories returned by
{@link android.content.Context#getExternalFilesDir} and
{@link android.content.Context#getExternalCacheDir}.
<p>If this permission is not allowlisted for an app that targets an API level before
{@link android.os.Build.VERSION_CODES#Q} this permission cannot be granted to apps.</p>
<p>Protection level: dangerous</p>
-->
<permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"