OnOpNotedCallback

Kotlin |Java

abstract class OnOpNotedCallback

kotlin.Any
↳	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 #noteOp or #startOp 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.

<b>
  setOnOpNotedCallback(getMainExecutor(), new OnOpNotedCallback() {
      ArraySet
 <pair<string, string>
  &gt; opsNotedForThisProcess = new ArraySet&lt;&gt;(); 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&lt;-&gt;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()); } }); 
 </pair<string,></b>

Summary

Public constructors
`OnOpNotedCallback()`

Public methods
abstract Unit	`onAsyncNoted(asyncOp: AsyncNotedAppOp)` Called when an app-op was noted for this package which cannot be delivered via the other two mechanisms.
abstract Unit	`onNoted(op: SyncNotedAppOp)` Called when an app-op was #noteOp for this package inside of a synchronous API call, i.
abstract Unit	`onSelfNoted(op: SyncNotedAppOp)` Called when this app noted an app-op for its own package,

Public constructors

OnOpNotedCallback

OnOpNotedCallback()

Public methods

onAsyncNoted

Added in API level 30

abstract fun onAsyncNoted(asyncOp: AsyncNotedAppOp): Unit

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

abstract fun onNoted(op: SyncNotedAppOp): Unit

Called when an app-op was #noteOp 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

abstract fun onSelfNoted(op: SyncNotedAppOp): Unit

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

This is very similar to onNoted 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`.