AppOpsManager 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
应用操作用于两个目的:访问控制和跟踪。
[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
- 继承
- 特性
注解
应用操作用于两个目的:访问控制和跟踪。 应用操作涵盖各种功能,包括帮助运行时权限访问控制和跟踪电池消耗跟踪。 访问控制应用操作可以控制每个 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 |
已过时.
结果 |
| ModeDefault |
已过时.
|
| ModeErrored |
已过时.
|
| ModeForeground |
已过时.
特殊模式,表示“仅当应用处于前台时允许”。这不会从 unsafeCheckOp(String, int, String), noteOp(String, int, String), startOp(String, int, String) 返回。 |
| ModeIgnored |
已过时.
|
| 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 |
已过时.
|
属性
| 名称 | 说明 |
|---|---|
| Class |
返回此 |
| 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 绑定基础结构。 |
方法
显式接口实现
| 名称 | 说明 |
|---|---|
| IJavaPeerable.Disposed() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.Finalized() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.JniObjectReferenceControlBlock |
获取此对等方使用的本机控制块指针。 (继承自 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
存储运行时提供的标识哈希代码。 (继承自 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
替换存储的托管对等状态标志。 (继承自 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
更新对等引用,并在引用无效时释放已释放的对等方控制块。 (继承自 JavaObject) |
扩展方法
| 名称 | 说明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
获取实例 |
| JavaAs<TResult>(IJavaPeerable) |
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
重复使用兼容的托管对等,或获取请求类型的包装器。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
尝试强制 |