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

Commit 3915a0e8 authored by Andrew Solovay's avatar Andrew Solovay
Browse files

docs: Info on two special (more-than-'dangerous') permissions

There are a couple of 'signature' permissions that have a special
user-authorization process; mentioned them and put in a link to their
reference docs.

The reference docs for those methods is being updated in a separate
CL, http://ag/784299

See first comment for doc stage location.

bug: 24673125
Change-Id: I4f17784b570d6154482e3fe965bd2de1043babb6
parent ac2be199
Loading
Loading
Loading
Loading
+23 −0
Original line number Diff line number Diff line
@@ -305,6 +305,29 @@ to be as high as possible. You can see which permissions were added with each re
  </li>
</ul>

<div class="sidebox-wrapper">
<div class="sidebox">
  <h3 id="special_permissions">Special Permissions</h3>
  <p>
    There are a couple of permissions that don't behave like normal and
    dangerous permissions. {@link android.Manifest.permission#SYSTEM_ALERT_WINDOW
    SYSTEM_ALERT_WINDOW} and {@link android.Manifest.permission#WRITE_SETTINGS
    WRITE_SETTINGS} are particularly sensitive, so most apps should not use
    them. If an app needs one of these permissions, it must declare the
    permission in the manifest, <em>and</em> send an intent requesting the
    user's authorization. The system responds to the intent by showing a
    detailed management screen to the user.
  </p>

  <p>
    For details on how to request these permissions, see the {@link
    android.Manifest.permission#SYSTEM_ALERT_WINDOW SYSTEM_ALERT_WINDOW} and
    {@link android.Manifest.permission#WRITE_SETTINGS WRITE_SETTINGS} reference
    entries.
  </p>
</div>
</div>

<h3 id="perm-groups">Permission groups</h3>

<p>