AttributionSource 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
此类表示应对其授予权限保护数据的访问的源。
[Android.Runtime.Register("android/content/AttributionSource", ApiSince=31, DoNotGenerateAcw=true)]
public sealed class AttributionSource : Java.Lang.Object, Android.OS.IParcelable, IDisposable
[<Android.Runtime.Register("android/content/AttributionSource", ApiSince=31, DoNotGenerateAcw=true)>]
type AttributionSource = class
inherit Object
interface IParcelable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- 继承
- 特性
- 实现
注解
此类表示应对其授予权限保护数据的访问的源。 可以链接属性源来表示受保护数据将流经多个应用程序的情况。 例如,应用 A 可能会向应用 B 询问联系人,反过来应用 B 可能会向应用 C 询问联系人。 在这种情况下,归因链将是 A - B ->> C,数据流为 C -> B -> A。使用归因源机制有两个主要好处:如果你代表调用应用访问专用数据来发送回,请避免代表调用应用执行显式权限检查;避免双重数据访问指责在检查调用应用的权限时以及访问这些权限背后的数据时(对于运行时权限)。 此外,如果未显式指责调用方,则数据访问将计入你的应用与你只是代理的上一个应用。
每个 Context 属性都有一个归因源,你可以通过 Context#getAttributionSource() 表示自身来获取它,这是一个链。 你可以将工作归咎于另一个应用,或者更准确地归咎于一系列应用,通过它访问的数据将流动, Context#createContext( ContextParams) 并指定下一个应用的归因源来接收你正在访问 AttributionSource.Builder#setNext( AttributionSource)的受保护数据。 创建此归因链可确保数据源在发布数据之前检查属性链中的每个应用是否有权访问数据。 如果数据位于敏感权限后面(例如危险),则数据源还将相应地记录序列中的应用访问此数据。 同样,如果你代表另一个应用访问数据,例如使用麦克风的语音识别器,以便它可以向呼叫应用提供识别,这非常有用。
你可以创建你和任何其他应用的归因链,而无需进行任何验证,因为这是通过 android.app.AppOpsManager API 提供的内容。 这支持处理无权访问调用方属性源的情况,并且可以直接使用 AttributionSource.Builder API。 但是,如果数据流经两个以上的应用(超过访问调用方的数据),则需要对调用应用的上下文具有句柄 AttributionSource 才能创建归属上下文。 这意味着,你要么需要让另一个应用有一个 API 来向你发送其归属源,要么使用通过管道传递调用方属性源的平台 API。
如果没有属性链中每个应用的参与(除了上述特殊情况之外),你无法伪造归属链。 若要创建受信任的归因源,需要创建一个归因上下文,该上下文指向由它引用的应用显式创建的归因源,以递归方式创建。
由于创建归因上下文会导致对属性链中应用的所有权限进行检查,因此在访问权限保护 API 时需要收到安全异常,因为链中的某些应用可能没有权限。
Java文档android.content.AttributionSource。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。
属性
| 名称 | 说明 |
|---|---|
| AttributionTag |
访问权限保护数据的应用的属性标记。 |
| Class |
返回此 |
| Creator |
获取属性源的可包裹创建者。 |
| DeviceId |
获取此归因源的设备 ID。 |
| Handle |
基础 Android 实例的句柄。 (继承自 Object) |
| JniIdentityHashCode |
获取互操作运行时分配给此Java对等的标识哈希代码。 (继承自 Object) |
| JniManagedPeerState |
获取运行时上次分配的状态标志。 (继承自 JavaObject) |
| JniPeerMembers |
获取用于调用此Java对等方成员的 JNI 元数据。 |
| Next |
要接收权限保护数据的下一个应用。 |
| PackageName |
正在访问权限保护数据的包。 |
| PeerReference |
获取此Java对等方的 JNI 对象引用。 (继承自 Object) |
| Pid |
正在访问权限保护数据的 PID。 |
| ThresholdClass |
此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。 (继承自 Object) |
| ThresholdType |
此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。 (继承自 Object) |
| Uid |
正在访问权限保护数据的 UID。 |
方法
| 名称 | 说明 |
|---|---|
| CheckCallingUid() |
如果你正在处理 IPC,并且你不信任调用方,则需要验证归因源是否为调用应用,以防止调用方将源从另一个应用传递,而无需在归因链中包括自己。 |
| Clone() |
创建并返回此对象的副本。 (继承自 Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
将此对等方的构造委托给运行时的值管理器。 (继承自 JavaObject) |
| DescribeContents() |
描述此可包裹实例封送表示形式中包含的特殊对象类型。 例如,如果对象将在 writeToParcel(Parcel,int) 的输出中包含文件描述符,则此方法的返回值必须包含CONTENTS_FILE_DESCRIPTOR位。 |
| Dispose() |
释放此Java对等方持有的资源。 (继承自 Object) |
| Dispose(Boolean) |
释放此Java对等方持有的资源。 (继承自 Object) |
| DisposeUnlessReferenced() |
要求值管理器释放此对等方,除非其映射保留此相同的托管实例。 (继承自 JavaObject) |
| EnforceCallingUid() |
如果你正在处理 IPC,并且你不信任调用方,则需要验证归因源是否为调用应用,以防止调用方将源从另一个应用传递,而无需在归因链中包括自己。 |
| Equals(Object) |
测试另一个托管对等方是否引用同一Java对象。 (继承自 JavaObject) |
| Equals(Object) |
指示其他对象是否“等于”此对象。 (继承自 Object) |
| GetHashCode() |
返回对象的哈希代码值。 (继承自 Object) |
| IsTrusted(Context) |
检查此归因源是否可信。 |
| JavaFinalize() |
已过时.
当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。 (继承自 Object) |
| MyAttributionSource() |
返回表示整个调用过程的泛型 |
| Notify() |
唤醒正在等待此对象的监视器的单个线程。 (继承自 Object) |
| NotifyAll() |
唤醒正在等待此对象的监视器的所有线程。 (继承自 Object) |
| SetHandle(IntPtr, JniHandleOwnership) |
设置 Handle 属性。 (继承自 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
在不创建 JNI 引用副本的情况下,将引用值存储在控制块中。 (继承自 JavaObject) |
| ToArray<T>() |
从此Java数组包装器创建托管数组。 (继承自 Object) |
| ToString() |
返回对象的字符串表示形式。 (继承自 Object) |
| UnregisterFromRuntime() |
从互操作运行时取消注册此Java对等。 (继承自 Object) |
| Wait() |
导致当前线程等待,直到它被唤醒,通常是通过 通知 或 中断。 (继承自 Object) |
| Wait(Int64, Int32) |
使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。 (继承自 Object) |
| Wait(Int64) |
使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。 (继承自 Object) |
| WriteToParcel(Parcel, ParcelableWriteFlags) |
将此对象平展到一个地块。 |
显式接口实现
| 名称 | 说明 |
|---|---|
| IJavaPeerable.Disposed() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.Finalized() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.JniObjectReferenceControlBlock |
获取此对等方使用的本机控制块指针。 (继承自 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
存储运行时提供的标识哈希代码。 (继承自 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
替换存储的托管对等状态标志。 (继承自 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
更新对等引用,并在引用无效时释放已释放的对等方控制块。 (继承自 JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
从运行时的Java对象查找中删除此实例。 |
扩展方法
| 名称 | 说明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
获取实例 |
| JavaAs<TResult>(IJavaPeerable) |
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
重复使用兼容的托管对等,或获取请求类型的包装器。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
尝试强制 |