Annotations sous Android

Les annotations AndroidSystème d'exploitation basé sur le noyau Linux conçu initialement pour les smartphones et tablettes et qui peut être trouvé sur d'autres appareils (Android TV, Android Auto, ...) fonctionnent comme les annotations JAVA. D'ailleurs, celles-ci sont utilisables sous AndroidSystème d'exploitation basé sur le noyau Linux conçu initialement pour les smartphones et tablettes et qui peut être trouvé sur d'autres appareils (Android TV, Android Auto, ...).

@TargetApi(Build.VERSION_CODES.versionAndroid)

ou versionAndroid est l'une des versions de l'API du système AndroidSystème d'exploitation basé sur le noyau Linux conçu initialement pour les smartphones et tablettes et qui peut être trouvé sur d'autres appareils (Android TV, Android Auto, ...).

Cette annotation permet d'indiquer au compilateur que la fonction présente dans le code ne sera déclenchée que lorsque l'application tournera à partir de la version AndroidSystème d'exploitation basé sur le noyau Linux conçu initialement pour les smartphones et tablettes et qui peut être trouvé sur d'autres appareils (Android TV, Android Auto, ...) stipulée en paramètre de l'annotation. A vous de faire en sorte que cela soit effectivement le cas, sinon l'application se plantera lamentablement !

Cette annotation est intéressante lorsque vous développez une application pour une version minSDK (L'attribut uses-sdk.minSdkVersion) pour laquelle une fonction n'existait pas encore:

- Sans l'annotation, le compilateur refusera de produire le code dans une version du SDK ne supportant pas la fonction.

- Il déclenchera un warning si le SDK utilisé lors de la compilation connait la fonction, mais que la version minSDK implique une possibilité de lancer l'application dans une version API inférieure ne connaissant pas cette fonction.

Il faudra impérativement controler ensuite la version AndroidSystème d'exploitation basé sur le noyau Linux conçu initialement pour les smartphones et tablettes et qui peut être trouvé sur d'autres appareils (Android TV, Android Auto, ...) utilisée lors de l'exécution avant de déclencher éventuellement l'appel à la fonction en cause, de la manière suivante:

Soit fonctionAPI() une fonction valable uniquement à partir de Build.VERSION_CODES.versionAndroid

if (Build.VERSION.SDK_INT < Build.VERSION_CODES.versionAndroid) {

// Lancer une fonction pour les API < à versionAndroid, probablement deprecated ! Ou rien, ou une faite maison...

}

else

{

// fonctionAPI pour les versions >= versionAndroid

}

Cette annotation sera probablement utilisée de paire avec @SuppressWarnings("deprecation") pour permettre l'utilisation d'une ancienne fonction dépréciée suivant la version AndroidSystème d'exploitation basé sur le noyau Linux conçu initialement pour les smartphones et tablettes et qui peut être trouvé sur d'autres appareils (Android TV, Android Auto, ...) utilisée.