AppOpsManager.OnOpNotedCallback


public static abstract class AppOpsManager.OnOpNotedCallback
extends Object

java.lang.Object
   ↳ android.app.AppOpsManager.OnOpNotedCallback


Callback an app can set to monitor the app-ops the system has tracked for it. I.e. each time any app calls AppOpsManager.noteOp(String, int, String) or AppOpsManager.startOp(String, int, String) one of a method of this object is called.

There will be a call for all app-ops related to runtime permissions, but not necessarily for all other app-ops.

 setOnOpNotedCallback(getMainExecutor(), new OnOpNotedCallback() {
     ArraySet> opsNotedForThisProcess = new ArraySet<>();

     private synchronized void addAccess(String op, String accessLocation) {
         // Ops are often noted when runtime permission protected APIs were called.
         // In this case permissionToOp() allows to resolve the permission<->op
         opsNotedForThisProcess.add(new Pair(accessType, accessLocation));
     }

     public void onNoted(SyncNotedAppOp op) {
         // Accesses is currently happening, hence stack trace describes location of access
         addAccess(op.getOp(), Arrays.toString(Thread.currentThread().getStackTrace()));
     }

     public void onSelfNoted(SyncNotedAppOp op) {
         onNoted(op);
     }

     public void onAsyncNoted(AsyncNotedAppOp asyncOp) {
         // Stack trace is not useful for async ops as accessed happened on different thread
         addAccess(asyncOp.getOp(), asyncOp.getMessage());
     }
 });
 

Summary

Public constructors

OnOpNotedCallback()

Public methods

abstract void onAsyncNoted(AsyncNotedAppOp asyncOp)

Called when an app-op was noted for this package which cannot be delivered via the other two mechanisms.

abstract void onNoted(SyncNotedAppOp op)

Called when an app-op was noted for this package inside of a synchronous API call, i.e.

abstract void onSelfNoted(SyncNotedAppOp op)

Called when this app noted an app-op for its own package,

This is very similar to onNoted(SyncNotedAppOp) only that the tracking was not caused by the API provider in a separate process, but by one in the app's own process.

Inherited methods

Public constructors

OnOpNotedCallback

public OnOpNotedCallback ()

Public methods

onAsyncNoted

Added in API level 30
public abstract void onAsyncNoted (AsyncNotedAppOp asyncOp)

Called when an app-op was noted for this package which cannot be delivered via the other two mechanisms.

Called as soon as possible after the app-op was noted, but the delivery delay is not guaranteed. Due to how async calls work in Android this might even be delivered slightly before the private data is delivered to the app.

If the app is not running or no OnOpNotedCallback is registered a small amount of noted app-ops are buffered and then delivered as soon as a listener is registered.

Parameters
asyncOp AsyncNotedAppOp: op noted This value cannot be null.

onNoted

Added in API level 30
public abstract void onNoted (SyncNotedAppOp op)

Called when an app-op was noted for this package inside of a synchronous API call, i.e. a API call that returned data or waited until the action was performed.

Called on the calling thread before the API returns. This allows the app to e.g. collect stack traces to figure out where the access came from.

Parameters
op SyncNotedAppOp: op noted This value cannot be null.

onSelfNoted

Added in API level 30
public abstract void onSelfNoted (SyncNotedAppOp op)

Called when this app noted an app-op for its own package,

This is very similar to onNoted(SyncNotedAppOp) only that the tracking was not caused by the API provider in a separate process, but by one in the app's own process.

Parameters
op SyncNotedAppOp: op noted This value cannot be null.