AppOpsManager.NoteOp 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
| 名称 | 说明 |
|---|---|
| NoteOp(String, Int32, String) |
此方法在 API 级别 30 中已弃用。 |
| NoteOp(String, Int32, String, String, String) |
记下执行操作的应用程序,并检查应用程序是否允许执行该操作。 |
NoteOp(String, Int32, String)
此方法在 API 级别 30 中已弃用。
[Android.Runtime.Register("noteOp", "(Ljava/lang/String;ILjava/lang/String;)I", "GetNoteOp_Ljava_lang_String_ILjava_lang_String_Handler")]
public virtual Android.App.AppOpsManagerMode NoteOp(string op, int uid, string packageName);
[<Android.Runtime.Register("noteOp", "(Ljava/lang/String;ILjava/lang/String;)I", "GetNoteOp_Ljava_lang_String_ILjava_lang_String_Handler")>]
abstract member NoteOp : string * int * string -> Android.App.AppOpsManagerMode
override this.NoteOp : string * int * string -> Android.App.AppOpsManagerMode
参数
- op
- String
字符串:此值不能为 null。
- uid
- Int32
int
- packageName
- String
字符串:此值不能为 null。
返回
- 特性
注解
此方法在 API 级别 30 中已弃用。 请改用 noteOp(String、int、String、String、String)
Android 参考。android.app.AppOpsManager.noteOp
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。
适用于
NoteOp(String, Int32, String, String, String)
记下执行操作的应用程序,并检查应用程序是否允许执行该操作。
[Android.Runtime.Register("noteOp", "(Ljava/lang/String;ILjava/lang/String;Ljava/lang/String;Ljava/lang/String;)I", "GetNoteOp_Ljava_lang_String_ILjava_lang_String_Ljava_lang_String_Ljava_lang_String_Handler", ApiSince=30)]
public virtual Android.App.AppOpsManagerMode NoteOp(string op, int uid, string? packageName, string? attributionTag, string? message);
[<Android.Runtime.Register("noteOp", "(Ljava/lang/String;ILjava/lang/String;Ljava/lang/String;Ljava/lang/String;)I", "GetNoteOp_Ljava_lang_String_ILjava_lang_String_Ljava_lang_String_Ljava_lang_String_Handler", ApiSince=30)>]
abstract member NoteOp : string * int * string * string * string -> Android.App.AppOpsManagerMode
override this.NoteOp : string * int * string * string * string -> Android.App.AppOpsManagerMode
参数
- op
- String
字符串:要注意的操作。 OPSTR_* 常量之一。 此值不能为 null。
- uid
- Int32
int:尝试执行操作的应用程序的 uid。
- packageName
- String
字符串:尝试执行操作的应用程序的名称。 此值可能为 null。
- attributionTag
- String
字符串:调用上下文的归属标记或默认属性的 null
- message
- String
字符串:描述操作的记录原因的消息。 此值可能为 null。
返回
如果允许操作,则返回MODE_ALLOWED;如果不允许操作,则返回MODE_IGNORED且应以无提示方式忽略(而不会导致应用崩溃)。
- 特性
注解
记下执行操作的应用程序,并检查应用程序是否允许执行该操作。 如果这是不在受保护操作前面的检查,请改用 unsafeCheckOp(String、int、String)。 app-op 为的包的标识由 uid 和 packageName 参数指定。 如果这两者都应为常规应用设置,并且包需要是 uid 的一部分。 在极少数情况下,对于没有包名称的实体,应用操作会为 null。 由于单个进程可能包含多个包,因此应该从 API(在应用进程中)调用方(在应用进程中)的上下文中读取 packageName,从而最终触发此检查。 如果未为正在运行的进程记下此操作,则无法从上下文中读取 packageName,但应清楚说明的包。 如果 uid 和 packageName 不匹配,则返回MODE_IGNORED。 除了访问检查,此方法还会记录访问权限。 虽然访问检查基于 uid 和/或 packageName,但访问记录基于 packageName 和 attributionTag 完成。 应从包名称读取的同一上下文中读取属性标记。 如果检查与 API 调用无关,则属性标记应为 null。 请注意,例如,为以后注册回调仍然是 API 调用,代码应将属性标记与包名称一起存储,供稍后在此方法中使用。 仅当此方法未在客户端的双向绑定器调用中调用时,才需要设置消息参数。 在这种情况下,消息是一个自由格式文本,旨在帮助应用开发人员确定应用代码触发了笔记的哪个部分。 此消息将传回 OnOpNotedCallback.onAsyncNoted(AsyncNotedAppOp)回调中的应用。 有用的消息的一个很好的示例包括将接收数据或清单接收器名称的侦听器的 System.identityHashCode(Object)。
引发:如果应用已配置为在此操作上崩溃,则 SecurityException。
Android 参考。android.app.AppOpsManager.noteOp
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。