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

Commit c4af8385 authored by Jay Thomas Sullivan's avatar Jay Thomas Sullivan
Browse files

Change wording of permission API docs 

Recently, the READ_MEDIA_AUDIO, READ_MEDIA_IMAGES, and READ_MEDIA_VIDEO
permissions were created, but the wording in the documentation was
unclear/inaccurate. Fix it.

Bug: 201318587
Test: manual
Change-Id: I01ca11808b587b668ccce85e4547f7182f96a23e
parent bce590e3

core/res/AndroidManifest.xml

+19 −13
Original line number Diff line number Diff line
@@ -991,10 +991,12 @@ 


    <!-- Allows an application to read audio files from external storage.

      <p>This permission is enforced starting in API level

      {@link android.os.Build.VERSION_CODES#TIRAMISU}.

      {@link android.os.Build.VERSION_CODES#TIRAMISU}. An app which targets

      {@link android.os.Build.VERSION_CODES#TIRAMISU} or higher and needs to read audio files from

      external storage must hold this permission; {@link #READ_EXTERNAL_STORAGE} is not required.

      For apps with a <a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#target">{@code

      targetSdkVersion}</a> of {@link android.os.Build.VERSION_CODES#S} or lower, this permission

      must not be used and the READ_EXTERNAL_STORAGE permission must be used instead.

      targetSdkVersion}</a> of {@link android.os.Build.VERSION_CODES#S_V2} or lower, the

      {@link #READ_EXTERNAL_STORAGE} permission is required, instead, to read audio files.

     <p>Protection level: dangerous -->

    <permission android:name="android.permission.READ_MEDIA_AUDIO"

                android:permissionGroup="android.permission-group.UNDEFINED"
@@ -1010,12 +1012,14 @@ 
                      android:description="@string/permgroupdesc_readMediaVisual"

                      android:priority="1000" />



    <!-- Allows an application to read audio files from external storage.

    <!-- Allows an application to read video files from external storage.

      <p>This permission is enforced starting in API level

    {@link android.os.Build.VERSION_CODES#TIRAMISU}.

      {@link android.os.Build.VERSION_CODES#TIRAMISU}. An app which targets

      {@link android.os.Build.VERSION_CODES#TIRAMISU} or higher and needs to read video files from

      external storage must hold this permission; {@link #READ_EXTERNAL_STORAGE} is not required.

      For apps with a <a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#target">{@code

    targetSdkVersion}</a> of {@link android.os.Build.VERSION_CODES#S} or lower, this permission

    must not be used and the READ_EXTERNAL_STORAGE permission must be used instead.

      targetSdkVersion}</a> of {@link android.os.Build.VERSION_CODES#S_V2} or lower, the

      {@link #READ_EXTERNAL_STORAGE} permission is required, instead, to read video files.

   <p>Protection level: dangerous -->

    <permission android:name="android.permission.READ_MEDIA_VIDEO"

                android:permissionGroup="android.permission-group.UNDEFINED"
@@ -1025,10 +1029,12 @@ 


    <!-- Allows an application to read image files from external storage.

      <p>This permission is enforced starting in API level

      {@link android.os.Build.VERSION_CODES#TIRAMISU}.

      {@link android.os.Build.VERSION_CODES#TIRAMISU}. An app which targets

      {@link android.os.Build.VERSION_CODES#TIRAMISU} or higher and needs to read image files from

      external storage must hold this permission; {@link #READ_EXTERNAL_STORAGE} is not required.

      For apps with a <a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#target">{@code

      targetSdkVersion}</a> of {@link android.os.Build.VERSION_CODES#S} or lower, this permission

      must not be used and the READ_EXTERNAL_STORAGE permission must be used instead.

      targetSdkVersion}</a> of {@link android.os.Build.VERSION_CODES#S_V2} or lower, the

      {@link #READ_EXTERNAL_STORAGE} permission is required, instead, to read image files.

   <p>Protection level: dangerous -->

    <permission android:name="android.permission.READ_MEDIA_IMAGES"

                android:permissionGroup="android.permission-group.UNDEFINED"