ICriticalNative 接口
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
标记符合条件的本机方法,以使用最快的Java本机接口 (JNI) 转换。
[Android.Runtime.Register("dalvik/annotation/optimization/CriticalNative", "", "Dalvik.Annotation.Optimization.ICriticalNativeInvoker", ApiSince=34)]
public interface ICriticalNative : IDisposable, Java.Interop.IJavaPeerable, Java.Lang.Annotation.IAnnotation
[<Android.Runtime.Register("dalvik/annotation/optimization/CriticalNative", "", "Dalvik.Annotation.Optimization.ICriticalNativeInvoker", ApiSince=34)>]
type ICriticalNative = interface
interface IAnnotation
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- 属性
- 实现
注解
关键本机方法必须是静态方法,可能只有基元参数类型,并且必须返回基元类型或 void。 批注会更改 JNI 转换 ABI,因此本机实现必须省略 JNIEnv 和 jclass 参数。
虽然执行关键本机方法,但垃圾回收无法暂停其线程,并可能被阻止。 不要对长时间运行的长时间运行的方法或方法使用此批注,这些方法执行大量 I/O 或获取可以保留的本机锁。 此批注对非本机方法没有影响。
此优化是在 Android 14 中经过 CTS 测试的公共 API。 为了获得最大的兼容性,请避免在 Android 13 及更早版本上调用关键的本机方法。 动态 JNI 链接仅适用于 Android 12 及更高版本;在 Android 8 到 Android 11 上使用的方法必须显式注册到 JNI RegisterNatives。 在 Android 7 及更早版本中,将忽略批注,因此生成的 ABI 不匹配可能会导致错误的参数封送和崩溃。
Java文档dalvik.annotation.optimization.CriticalNative。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。
属性
| 名称 | 说明 |
|---|---|
| Handle |
获取基础 Android 对象的 JNI 值。 (继承自 IJavaObject) |
| JniIdentityHashCode |
返回包装实例的值 |
| JniManagedPeerState |
托管对等方的状态。 (继承自 IJavaPeerable) |
| JniObjectReferenceControlBlock |
标记符合条件的本机方法,以使用最快的Java本机接口 (JNI) 转换。 (继承自 IJavaPeerable) |
| JniPeerMembers |
成员访问和调用支持。 (继承自 IJavaPeerable) |
| PeerReference |
返回JniObjectReference包装的Java对象实例。 (继承自 IJavaPeerable) |
方法
| 名称 | 说明 |
|---|---|
| AnnotationType() |
返回此批注的批注接口。 (继承自 IAnnotation) |
| Disposed() |
在释放实例时调用。 (继承自 IJavaPeerable) |
| DisposeUnlessReferenced() |
如果没有对此实例的未完成引用,则调用 |
| Equals(Object) |
如果指定的对象表示逻辑上等效于此批注的批注,则返回 true。 (继承自 IAnnotation) |
| Finalized() |
在实例完成时调用。 (继承自 IJavaPeerable) |
| GetHashCode() |
返回此批注的哈希代码。 (继承自 IAnnotation) |
| SetJniIdentityHashCode(Int32) |
设置由 |
| SetJniManagedPeerState(JniManagedPeerStates) |
标记符合条件的本机方法,以使用最快的Java本机接口 (JNI) 转换。 (继承自 IJavaPeerable) |
| SetPeerReference(JniObjectReference) |
设置由 |
| ToString() |
返回此批注的字符串表示形式。 (继承自 IAnnotation) |
| UnregisterFromRuntime() |
取消注册此实例,使运行时不会从将来 Java.Interop.JniRuntime+JniValueManager.PeekValue 的调用中返回它。 (继承自 IJavaPeerable) |
扩展方法
| 名称 | 说明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
获取实例 |
| JavaAs<TResult>(IJavaPeerable) |
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
标记符合条件的本机方法,以使用最快的Java本机接口 (JNI) 转换。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
尝试强制 |