Improve docs for SCHEDULE_EXACT_ALARM

Mentioning protection level and explicitly stating that the permission
is revocable.
Updated the hyperlink to a page with more comprehensive guidance.

Test: m offline-sdk-docs && \
  cd $ANDROID_BUILD_TOP/out/target/common/docs/offline-sdk/ && \
  python3 -m http.server 8000
Then manually inspect the contents of
http://localhost:8000/reference/android/Manifest.permission.html#SCHEDULE_EXACT_ALARM

Fixes: 205210647
Change-Id: Ide4c42ed22ee63df90c466f89331e5680cc39660
This commit is contained in:
Suprabh Shukla
2022-05-19 15:31:05 -07:00
parent 92e59dde2f
commit 6a63aa3bfb

View File

@@ -4495,10 +4495,10 @@
android:protectionLevel="signature|privileged"/>
<!-- Allows applications to use exact alarm APIs.
<p>Exact alarms should only be used for user-facing features.
For more details, see <a
href="{@docRoot}about/versions/12/behavior-changes-12#exact-alarm-permission">
Exact alarm permission</a>.
<p>This is a special access permission that can be revoked by the system or the user.
It should only be used to enable <b>user-facing features</b> that require exact alarms.
For more details, please go through the associated
<a href="{@docRoot}training/scheduling/alarms#exact">developer docs</a>.
<p>Apps need to target API {@link android.os.Build.VERSION_CODES#S} or above to be able to
request this permission. Note that apps targeting lower API levels do not need this
permission to use exact alarm APIs.
@@ -4509,6 +4509,7 @@
{@link android.Manifest.permission#USE_EXACT_ALARM} once it targets API
{@link android.os.Build.VERSION_CODES#TIRAMISU}. All apps using exact alarms for secondary
features (which should still be user facing) should continue using this permission.
<p>Protection level: appop
-->
<permission android:name="android.permission.SCHEDULE_EXACT_ALARM"
android:protectionLevel="normal|appop"/>