Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 90e7948c authored by Kevin Hufnagle's avatar Kevin Hufnagle Committed by Automerger Merge Worker
Browse files

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

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



Change-Id: I09965aa6738d1b41599c1e10bdabca6bb4bf19ec
Signed-off-by: default avatarAutomerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
parents 4805f106 d13571c3

core/res/AndroidManifest.xml

+22 −7
Original line number Diff line number Diff line
@@ -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"