语言

ICriticalNative 接口

定义

标记符合条件的本机方法,以使用最快的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

返回包装实例的值 java.lang.System.identityHashCode() 。

(继承自 IJavaPeerable)
JniManagedPeerState

托管对等方的状态。

(继承自 IJavaPeerable)
JniObjectReferenceControlBlock

标记符合条件的本机方法,以使用最快的Java本机接口 (JNI) 转换。

(继承自 IJavaPeerable)
JniPeerMembers

成员访问和调用支持。

(继承自 IJavaPeerable)
PeerReference

返回JniObjectReference包装的Java对象实例。

(继承自 IJavaPeerable)

方法

名称 说明
AnnotationType()

返回此批注的批注接口。

(继承自 IAnnotation)
Disposed()

在释放实例时调用。

(继承自 IJavaPeerable)
DisposeUnlessReferenced()

如果没有对此实例的未完成引用,则调用 Dispose();否则不执行任何操作。

(继承自 IJavaPeerable)
Equals(Object)

如果指定的对象表示逻辑上等效于此批注的批注,则返回 true。

(继承自 IAnnotation)
Finalized()

在实例完成时调用。

(继承自 IJavaPeerable)
GetHashCode()

返回此批注的哈希代码。

(继承自 IAnnotation)
SetJniIdentityHashCode(Int32)

设置由 JniIdentityHashCode. 返回的值。

(继承自 IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)

标记符合条件的本机方法,以使用最快的Java本机接口 (JNI) 转换。

(继承自 IJavaPeerable)
SetPeerReference(JniObjectReference)

设置由 PeerReference. 返回的值。

(继承自 IJavaPeerable)
ToString()

返回此批注的字符串表示形式。

(继承自 IAnnotation)
UnregisterFromRuntime()

取消注册此实例,使运行时不会从将来 Java.Interop.JniRuntime+JniValueManager.PeekValue 的调用中返回它。

(继承自 IJavaPeerable)

扩展方法

名称 说明
GetJniTypeName(IJavaPeerable)

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

JavaAs<TResult>(IJavaPeerable)

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

JavaCast<TResult>(IJavaObject)

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

JavaCast<TResult>(IJavaObject)

标记符合条件的本机方法,以使用最快的Java本机接口 (JNI) 转换。

TryJavaCast<TResult>(IJavaPeerable, TResult)

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

适用于