Annotate @SystemApi with required permissions.

Most @SystemApi methods should be protected with system (or higher)
permissions, so annotate common methods with @RequiresPermission to
make automatic verification easier.

Verification is really only relevant when calling into system
services (where permissions checking can happen on the other side of
a Binder call), so annotate managers with the new @SystemService
annotation, which is now automatically documented.

This is purely a docs change; no logic changes are being made.

Test: make -j32 update-api && make -j32 offline-sdk-docs
Bug: 62263906
Change-Id: I2554227202d84465676aa4ab0dd336b5c45fc651
This commit is contained in:
Jeff Sharkey
2017-06-02 17:36:26 -06:00
parent 373ab72112
commit d86b8fea43
94 changed files with 549 additions and 314 deletions

View File

@@ -18,6 +18,7 @@ import android.Manifest;
import android.annotation.RequiresPermission;
import android.annotation.SuppressAutoDoc;
import android.annotation.SystemApi;
import android.annotation.SystemService;
import android.content.ComponentName;
import android.content.Context;
import android.content.Intent;
@@ -48,6 +49,7 @@ import java.util.List;
* descriptions.
*/
@SuppressAutoDoc
@SystemService(Context.TELECOM_SERVICE)
public class TelecomManager {
/**
@@ -1216,6 +1218,7 @@ public class TelecomManager {
* @hide
*/
@SystemApi
@RequiresPermission(android.Manifest.permission.MODIFY_PHONE_STATE)
public boolean endCall() {
try {
if (isServiceConnected()) {