语言

AppOpsManager 类

定义

应用操作用于两个目的:访问控制和跟踪。

[Android.Runtime.Register("android/app/AppOpsManager", DoNotGenerateAcw=true)]
public class AppOpsManager : Java.Lang.Object
[<Android.Runtime.Register("android/app/AppOpsManager", DoNotGenerateAcw=true)>]
type AppOpsManager = class
    inherit Object
继承
AppOpsManager
特性

注解

应用操作用于两个目的:访问控制和跟踪。 应用操作涵盖各种功能,包括帮助运行时权限访问控制和跟踪电池消耗跟踪。 访问控制应用操作可以控制每个 uid 或每个包。 使用哪一个取决于维护此应用操作的 API 提供程序。 对于任何安全或隐私相关的应用操作,提供商需要控制每个 uid 的应用操作,因为所有安全和隐私都基于 Android 中的 uid。 若要控制应用操作的访问,可设置为:MODE_DEFAULT默认行为,可能与应用操作或应用操作MODE_ALLOWED允许访问MODE_IGNORED不允许访问,即不要执行请求的操作或返回否或占位符数据,MODE_ERRORED在访问时引发 SecurityException。 可以使用 ... 取消此操作noThrow 方法,用于检查模式 API 提供程序需要检查 noteOp(String, int, String) 返回的模式(如果允许访问受应用操作限制的操作)。 unsafeCheckOp(String, int, String) 应用于检查模式(如果未授予任何访问权限)。 例如,这可用于在 UI 中显示应用操作状态,或者在稍后调用 noteOp(String, int, String)之前检查状态。 如果操作引用时间跨度(例如音频录制会话),API 提供程序应使用 startOp(String、int、String)和 finishOp(String、int、String)而不是 noteOp(String、int、String)。 运行时权限和应用操作 每个平台定义的运行时权限(除了后台修饰符)都有一个关联的应用操作,用于跟踪,但也允许无提示故障。 例如,如果运行时权限被拒绝,调用方将获取 SecurityException,但如果授予权限并且应用操作MODE_IGNORED则调用方获取占位符行为,例如位置回调不会发生。 应用操作权限 App-ops 权限是可重写的平台定义权限。 默认情况下,应用操作权限的安全检查应检查权限授予状态。 如果应用操作状态设置为MODE_ALLOWED或MODE_IGNORED应检查应用操作状态,而不是权限授予状态。 此功能允许默认向满足特定权限级别的要求的应用授予访问权限。 仍可根据需要重写该行为。 跟踪 App-ops 跟踪许多重要事件,包括对运行时权限保护 API 的所有访问。 这是通过跟踪应用操作的记录或启动来完成的。 跟踪的数据只能由系统组件读取。 仅跟踪 noteOp(String、int、String)/startOp(String、int、String)未跟踪 unsafeCheckOp(String、int、String)。 因此,在提供对受保护操作或数据的访问权限时,必须最终调用 noteOp(String、int、String)或 startOp(String、int、String)。 某些应用正在转发对其他应用的访问。 例如,应用可能会从系统的位置提供程序获取位置,然后将该位置进一步发送到第三个应用。 在这种情况下,传递数据的应用需要调用 noteProxyOp(String, String)来向访问代理发出信号。 如果在具有不同属性标记的标记的两个部分之间转发访问,则单个应用内部也可能有意义。 应用可以注册 OnOpNotedCallback,了解系统正在跟踪哪些访问。 由于每个运行时权限都有关联的应用操作,因此此 API 对于想要查找意外的专用数据访问的应用特别有用。

Android 参考。android.app.AppOpsManager

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

构造函数

名称 说明
AppOpsManager(IntPtr, JniHandleOwnership)

初始化现有 Java Native Interface 对象的托管表示形式。

字段

名称 说明
ModeAllowed
已过时.

结果#checkOp,,#noteOp#startOp:允许给定调用方执行给定操作。

ModeDefault
已过时.

#checkOp结果,:#noteOp#startOp给定调用方应使用其默认安全检查。

ModeErrored
已过时.

#checkOpNoThrow结果,,#noteOpNoThrow#startOpNoThrow:不允许给定调用方执行给定操作,并且此尝试应导致其出现致命错误,通常是一个SecurityException。

ModeForeground
已过时.

特殊模式,表示“仅当应用处于前台时允许”。这不会从 unsafeCheckOp(String, int, String), noteOp(String, int, String), startOp(String, int, String) 返回。

ModeIgnored
已过时.

#checkOp结果,,#noteOp#startOp:不允许给定调用方执行给定操作,并且此尝试应以无提示方式失败(不应导致应用崩溃)。

OpNotedCallbackFlagIgnoreAsync
已过时.

忽略异步操作记下的事件。

OpstrAddVoicemail

访问电话状态相关信息所必需的。

OpstrAnswerPhoneCalls

接听来电

OpstrBodySensors

访问人体传感器,例如心率等。

OpstrCallPhone

允许应用程序发起电话呼叫。

OpstrCamera

需要能够访问相机设备。

OpstrCoarseLocation

访问粗略的位置信息。

OpstrFineLocation

访问精细的位置信息。

OpstrGetUsageStats

访问 UsageStatsManager。

OpstrManageContacts

允许应用程序管理用户的联系人数据。

OpstrMockLocation

将模拟位置注入系统。

OpstrMonitorHighPowerLocation

使用相对较高的电源请求持续监视位置数据。

OpstrMonitorLocation

持续监视位置数据。

OpstrPictureInPicture

访问图片中的图片。

OpstrProcessOutgoingCalls

用于转移传出调用的访问 API

OpstrReadCalendar

允许应用程序读取用户的日历数据。

OpstrReadCallLog

允许应用程序读取用户的呼叫日志。

OpstrReadCellBroadcasts

读取以前收到的单元格广播消息。

OpstrReadContacts

允许应用程序读取用户的联系人数据。

OpstrReadExternalStorage

读取外部存储。

OpstrReadPhoneNumbers

常量值:“android:read_phone_numbers”

OpstrReadPhoneState

访问电话状态相关信息所必需的。

OpstrReadSms

允许应用程序读取短信。

OpstrReceiveMms

允许应用程序接收彩信。

OpstrReceiveSms

允许应用程序接收短信。

OpstrReceiveWapPush

允许应用程序接收 WAP 推送消息。

OpstrRecordAudio

需要能够访问麦克风设备。

OpstrSendSms

允许应用程序发送短信。

OpstrSystemAlertWindow

需要在其他应用的基础上绘制。

OpstrUseFingerprint

使用指纹 API。

OpstrUseSip

通过 VOIP 或 WiFi 进行 SIP 呼叫的访问 API

OpstrWriteCalendar

允许应用程序写入用户的日历数据。

OpstrWriteCallLog

允许应用程序写入用户的呼叫日志。

OpstrWriteContacts

允许应用程序写入用户的联系人数据。

OpstrWriteExternalStorage

写入外部存储。

OpstrWriteSettings

写入/修改/更新系统设置所必需的。

WatchForegroundChanges
已过时.

#startWatchingMode(String, String, int, OnOpChangedListener)标志:如果操作的 uid 的前景状态发生更改,则还会获取报告。

属性

名称 说明
Class

返回此 Object的运行时类。

(继承自 Object)
Handle

基础 Android 实例的句柄。

(继承自 Object)
JniIdentityHashCode

获取互操作运行时分配给此Java对等的标识哈希代码。

(继承自 Object)
JniManagedPeerState

获取运行时上次分配的状态标志。

(继承自 JavaObject)
JniPeerMembers

为 Android.App.AppOpsManager 提供 JNI 绑定基础结构。

PeerReference

获取此Java对等方的 JNI 对象引用。

(继承自 Object)
ThresholdClass

为 Android.App.AppOpsManager 提供 JNI 绑定基础结构。

ThresholdType

为 Android.App.AppOpsManager 提供 JNI 绑定基础结构。

方法

名称 说明
CheckOp(String, Int32, String, String)

检查应用程序是否可以执行操作。

CheckOp(String, Int32, String)

检查应用程序是否可以执行操作。

CheckOpNoThrow(String, Int32, String, String)

与 checkOp(String、int、String、String)类似,但不引发 SecurityException,而是返回MODE_ERRORED。

CheckOpNoThrow(String, Int32, String)

与 checkOp(String,int,String)类似,但不引发 SecurityException,而是返回MODE_ERRORED。

CheckOpRawNoThrow(String, Int32, String, String)

与 checkOp(String,int,String,String)类似,但返回与操作关联的原始模式。

CheckPackage(Int32, String)

此方法在 API 级别 30 中已弃用。

Clone()

创建并返回此对象的副本。

(继承自 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)

将此对等方的构造委托给运行时的值管理器。

(继承自 JavaObject)
Dispose()

释放此Java对等方持有的资源。

(继承自 Object)
Dispose(Boolean)

释放此Java对等方持有的资源。

(继承自 Object)
DisposeUnlessReferenced()

要求值管理器释放此对等方,除非其映射保留此相同的托管实例。

(继承自 JavaObject)
Equals(Object)

测试另一个托管对等方是否引用同一Java对象。

(继承自 JavaObject)
Equals(Object)

指示其他对象是否“等于”此对象。

(继承自 Object)
FinishOp(String, Int32, String, String)

报告应用程序不再执行以前以 startOp(String,int,String,String,String,String)启动的操作。

FinishOp(String, Int32, String)

此方法在 API 级别 30 中已弃用。

FinishProxyOp(String, Int32, String, String)

报告应用程序不再执行以前以 startProxyOp(String,int,String,String,String,String)启动的操作。

GetHashCode()

返回对象的哈希代码值。

(继承自 Object)
IsOpActive(String, Int32, String)

检查包的给定操作是否处于活动状态,即有人是否调用 startOp(String, int, String), 但尚未调用 finishOp(String, int, String)。

JavaFinalize()
已过时.

当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。

(继承自 Object)
NoteOp(String, Int32, String, String, String)

记下执行操作的应用程序,并检查应用程序是否允许执行该操作。

NoteOp(String, Int32, String)

此方法在 API 级别 30 中已弃用。

NoteOpNoThrow(String, Int32, String, String, String)

与 noteOp(String、int、String、String、String)类似,但不引发 SecurityException,而是返回MODE_ERRORED。

NoteOpNoThrow(String, Int32, String)

此方法在 API 级别 30 中已弃用。

NoteProxyOp(String, String, Int32, String, String)

记下处理 IPC 时代表另一个应用程序执行操作的应用程序。

NoteProxyOp(String, String)

此方法在 API 级别 30 中已弃用。

NoteProxyOpNoThrow(String, String, Int32, String, String)

与 noteProxyOp(String、String、int、String、String)类似,但与其引发 SecurityException,而是返回MODE_ERRORED。

NoteProxyOpNoThrow(String, String, Int32)

此方法在 API 级别 30 中已弃用。

NoteProxyOpNoThrow(String, String)

此方法在 API 级别 30 中已弃用。

Notify()

唤醒正在等待此对象的监视器的单个线程。

(继承自 Object)
NotifyAll()

唤醒正在等待此对象的监视器的所有线程。

(继承自 Object)
PermissionToOp(String)

获取与给定权限关联的应用操作名称。

SetHandle(IntPtr, JniHandleOwnership)

设置 Handle 属性。

(继承自 Object)
SetOnOpNotedCallback(IExecutor, AppOpsManager+OnOpNotedCallback, AppOpsManagerCallbackFlag)

设置新的 OnOpNotedCallback。

SetOnOpNotedCallback(IExecutor, AppOpsManager+OnOpNotedCallback)

设置新的 OnOpNotedCallback。

SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

在不创建 JNI 引用副本的情况下,将引用值存储在控制块中。

(继承自 JavaObject)
StartOp(String, Int32, String, String, String)

报告应用程序已开始执行长时间运行的操作。

StartOp(String, Int32, String)

此方法在 API 级别 30 中已弃用。

StartOpNoThrow(String, Int32, String, String, String)

与 startOp(String、int、String、String、String)类似,但与其引发 SecurityException,而是返回MODE_ERRORED。

StartOpNoThrow(String, Int32, String)

此方法在 API 级别 30 中已弃用。

StartProxyOp(String, Int32, String, String, String)

报告应用程序在处理 IPC 时已开始代表另一个应用程序执行长时间运行的操作。

StartProxyOpNoThrow(String, Int32, String, String, String)

与 startProxyOp(String,int,String,String,String,String)类似,但不引发 SecurityException,而是返回MODE_ERRORED。

StartWatchingActive(String[], IExecutor, AppOpsManager+IOnOpActiveChangedListener)

开始监视对应用操作的活动状态的更改。

StartWatchingMode(String, String, AppOpsManager+IOnOpChangedListener)

监视对给定应用包中给定操作的操作模式的更改。

StartWatchingMode(String, String, WatchForeground, AppOpsManager+IOnOpChangedListener)

监视对给定应用包中给定操作的操作模式的更改。

StopWatchingActive(AppOpsManager+IOnOpActiveChangedListener)

停止监视对应用操作的活动状态的更改。

StopWatchingMode(AppOpsManager+IOnOpChangedListener)

停止监视以前以 startWatchingMode(String、String、OnOpChangedListener)开头的监视。

ToArray<T>()

从此Java数组包装器创建托管数组。

(继承自 Object)
ToString()

返回对象的字符串表示形式。

(继承自 Object)
UnregisterFromRuntime()

从互操作运行时取消注册此Java对等。

(继承自 Object)
UnsafeCheckOp(String, Int32, String)

此方法在 API 级别 36 中已弃用。

UnsafeCheckOpNoThrow(String, Int32, String)

此方法在 API 级别 36 中已弃用。

UnsafeCheckOpRaw(String, Int32, String)

此方法在 API 级别 36 中已弃用。

UnsafeCheckOpRawNoThrow(String, Int32, String)

此方法在 API 级别 36 中已弃用。

Wait()

导致当前线程等待,直到它被唤醒,通常是通过 通知 或 中断。

(继承自 Object)
Wait(Int64, Int32)

使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。

(继承自 Object)
Wait(Int64)

使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。

(继承自 Object)

显式接口实现

名称 说明
IJavaPeerable.Disposed()

将此对等方标记为已释放,并将disposing调用Dispose设置为 true.

(继承自 JavaObject)
IJavaPeerable.Finalized()

将此对等方标记为已释放,并将disposing调用Dispose设置为 false.

(继承自 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

获取此对等方使用的本机控制块指针。

(继承自 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

存储运行时提供的标识哈希代码。

(继承自 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

替换存储的托管对等状态标志。

(继承自 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

更新对等引用,并在引用无效时释放已释放的对等方控制块。

(继承自 JavaObject)

扩展方法

名称 说明
GetJniTypeName(IJavaPeerable)

获取实例 self类型的 JNI 名称。

JavaAs<TResult>(IJavaPeerable)

尝试强制self键入TResult,检查强制是否在Java端有效。

JavaCast<TResult>(IJavaObject)

执行 Android 运行时检查的类型转换。

JavaCast<TResult>(IJavaObject)

重复使用兼容的托管对等,或获取请求类型的包装器。

TryJavaCast<TResult>(IJavaPeerable, TResult)

尝试强制self键入TResult,检查强制是否在Java端有效。

适用于