ICriticalNative Interface

Definição

[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

Atributos

RegisterAttribute

Implementações

IJavaObject IJavaPeerable IAnnotation IDisposable

Comentários

Um método nativo crítico deve ser estático, pode ter apenas tipos de parâmetro primitivo e deve retornar um tipo primitivo ou void. A anotação altera a ABI de transição JNI, portanto, a implementação nativa deve omitir os parâmetros e jclass os JNIEnv parâmetros.

Enquanto um método nativo crítico é executado, a coleta de lixo não pode suspender seu thread e pode ser bloqueada. Não use essa anotação em métodos de execução longa ou métodos que executam E/S significativa ou adquiram bloqueios nativos que podem ser mantidos por um longo tempo. Essa anotação não tem efeito sobre métodos não nativos.

Essa otimização é uma API pública testada pelo CTS a partir do Android 14. Para obter compatibilidade máxima, evite chamar métodos nativos críticos no Android 13 e anteriores. A vinculação JNI dinâmica funciona apenas no Android 12 e posterior; os métodos usados no Android 8 até o Android 11 devem ser explicitamente registrados com JNI RegisterNatives. No Android 7 e anteriores, a anotação é ignorada, portanto, a incompatibilidade resultante da ABI pode causar falhas e marshalling de argumentos incorretos.

Java documentação para dalvik.annotation.optimization.CriticalNative.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.