RequiereApi vs TargetApi anotaciones de Android

¿Cuál es la diferencia entre RequiresApiy TargetApi?

Muestra en kotlin:

@RequiresApi(api = Build.VERSION_CODES.M)
@TargetApi(Build.VERSION_CODES.M)
class FingerprintHandlerM() : FingerprintManager.AuthenticationCallback()

NOTA: FingerprintManager.AuthenticationCallbackrequiere apiM

NOTA 2: si no uso TargetApi lint fallará con error class requires api level 23...

@RequiresApi - Indica que el elemento anotado solo debe invocarse en el nivel de API dado o superior.

@TargetApi - Indica que Lint debe tratar este tipo como un objetivo de un nivel de API determinado, sin importar cuál sea el objetivo del proyecto.

Primero asumiré que su versión de min api es más baja que la api a la que va a llamar, porque ahí es donde este tipo de anotaciones tienen sentido

@RequiresApi(Build.VERSION_CODES.N_MR1)
public void hello() { // codes that call system apis introduced in android N_MR1}

Cuando se anota un método con esto, cada vez que llama a ese método, recibe una bonita advertencia roja de que esta llamada requiere una versión de la API que sea superior a su versión de la API mínima, pero no le impide compilar y construir su apk, simplemente fallará en versiones inferiores de Android cuando lo probé.

@TargetApi

Esto no ayuda en absoluto, suprime las advertencias de llamar a nuevas apis en su método, pero cuando llama a este método desde otro lugar, no hay ninguna advertencia de lint, y aún puede construir e instalar su apk solo para cumplir con un crash cuando se llama a ese método.

Similar a lo que dijo Mike, como puede ver en la documentación:

Indica que el elemento anotado solo debe invocarse en el nivel de API determinado o superior.

Esto es similar en propósito a la anotación @TargetApi anterior, pero expresa más claramente que esto es un requisito para la persona que llama, en lugar de usarse para "suprimir" advertencias dentro del método que exceden la minSdkVersion.

Como puede ver aquí, esto en realidad obliga a la persona que llama a verificar la API que se ha utilizado al llamar a este método, en lugar de simplemente eliminar la advertencia de su IDE / LINT.

Puede comparar esto con las anotaciones @NonNull o @Null, que imponen que la persona que llama puede / no puede enviar valores nulos a la función.

De los JavaDocs en https://developer.android.com/reference/android/support/annotation/RequiresApi.html :

[@RequiresApi] Esto es similar en propósito a la anotación @TargetApi anterior, pero expresa más claramente que esto es un requisito para la persona que llama, en lugar de usarse para "suprimir" advertencias dentro del método que exceden la minSdkVersion.

Supongo que son funcionalmente equivalentes, pero @RequiresApiparecen ser más nuevos y tienen una mayor probabilidad de ampliarse para incluir más funciones.

Ambos son para funciones de manejo agregadas a los nuevos niveles de API de Android sin afectar los otros niveles de API.

RequiereApi

@RequiresApi(api = Build.VERSION_CODES.*api_code*)

Aquí dice que el elemento anotado solo debe invocarse en el nivel de API dado o superior. El elemento anotado debajo del nivel de API dado no llamará.

TargetApi

@TargetApi(Build.VERSION_CODES.*api_code*)

Indica que Lint debe tratar este tipo como dirigido a un nivel de API determinado, sin importar cuál sea el objetivo del proyecto. Solo destinado al nivel de API especificado. No se llamará en otro nivel de API.