Preferencias de errores y avisos de API

Las preferencias siguientes pueden establecerse mediante la página de preferencias Abre la página de preferencias Consola Desarrollo de plug-ins > Errores/Avisos de API.

Los problemas de API se crean durante las construcciones de proyectos (construcciones automáticas y completas), las herramientas desglosan los tipos de problemas encontrados en tres categorías:

  1. Problemas de utilización: existen plug-ins no autorizados que llaman a código restringido
  2. Incompatibilidades de API: los cambios entre versiones no son compatibles
  3. Problemas de versión: las versiones de plug-in o las versiones de código (códigos @since) no son correctas
  4. Opciones de análisis: opciones generales

También puede configurar las gravedades de problema por proyecto, utilizando la página de propiedades Errores/Avisos de API para un proyecto

Utilización de la API

Página de preferencias de la opción Utilización de la API

General

Opción

Descripción

Valor predeterminado

Utilización no soportada de códigos Javadoc de API

Cuando esta opción está habilitada, el constructor de análisis de API comprobará que no se hayan utilizado incorrectamente los códigos Javadoc de API.

Omitir

La referencia no está definida en el entorno de ejecución especificado

Cuando está habilitado, el constructor de análisis de la API comprobará las referencias a las bibliotecas del sistema que pueden no ser legales según el entorno de ejecución especificado para el paquete.

Omitir

Restricciones

Opción

Descripción

Valor predeterminado

Implementar una interfaz marcada como '@noimplement'

Cuando esta opción está habilitada, el constructor de análisis de API buscará implementaciones no permitidas de interfaces marcadas.

Aviso

Ampliar un tipo marcado como '@noextend'

Cuando esta opción está habilitada, el constructor de análisis de API buscará clases que amplíen tipos marcados.

Aviso

Hacer referencia a un campo o método marcado como '@noreference'

Cuando esta opción está habilitada, el constructor de análisis de la API buscará referencias de campo y método a miembros etiquetados.

Aviso

Crea una instancia de una clase etiquetada como '@noinstantiate'

Cuando esta opción está habilitada, el constructor de análisis de API comprobará que no se haya creado una instancia de las clases etiquetadas.

Aviso

Alterar temporalmente un método marcado como '@nooverride'

Cuando esta opción está habilitada, el constructor de análisis de la API comprobará que los métodos marcados en las clases padre no se hayan alterado temporalmente en ninguna clase hijo, ya sea ampliando (reimplementando con una llamada al padre alterado) o reimplementando (sin llamada al padre alterado).

Aviso

Fugas

Opción

Descripción

Valor predeterminado

Amplía una clase no API

Cuando esta opción está habilitada, el constructor de análisis de API buscará si hay clases de API que amplíen tipos no API.

Aviso

Implementa una interfaz no API

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si hay clases de API que implementan una interfaz no API

Aviso

Campo con tipo no API

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si hay tipos de API con campos públicos o protegidos con tipos no API.

Aviso

Método con un tipo de retorno no API

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si hay tipos API que tengan métodos públicos o protegidos con tipos de retorno no API.

Aviso

Método con tipo de parámetro no API

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si hay tipos API que tengan métodos públicos o protegidos con tipos de parámetro no API.

Aviso

Compatibilidad de API

Página de preferencias de la opción Compatibilidad de API

Opción

Descripción

Valor predeterminado

Informar de rotura de API incluso aunque esté autorizada por un incremento de versión principal

Cuando esta opción está habilitada, el constructor de análisis de API informará de problemas relativos a roturas de API incluso aunque ya se haya incrementado la versión principal del paquete.

Inhabilitada

Paquete

Opción

Descripción

Valor predeterminado

Un tipo API se ha convertido en no API

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si hay tipos API en el paquete actual que hayan cambiado para tipos no API.

Error

Se ha eliminado un tipo

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si algunos tipos de API se han eliminado del ámbito de la API en el paquete dado.

Error

Un tipo reexportado API se ha convertido en no API

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si hay tipos API reexportados en el paquete actual que hayan cambiado para tipos no API.

Error

Se ha eliminado un tipo reexportado

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si algunos tipos de API reexportados se han eliminado del ámbito de la API en el paquete dado.

Error

Clase

Opción

Descripción

Valor predeterminado

Se ha añadido un método (que debe implementarse):

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si cualesquiera métodos públicos o protegidos que deban implementarse se han añadido a cualesquiera tipos de API.

Error

Se han añadido restricciones

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han añadido restricciones de API para cualesquiera clases API.

Error

Se ha añadido un parámetro de tipo

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han añadido parámetros de tipo a cualesquiera clases de API.

Error

Se ha reducido la jerarquía de superinterfaces

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han eliminado interfaces padre de cualesquiera clases de API.

Error

Se ha añadido la palabra clave 'abstract'

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se ha añadido la palabra clave 'abstract' a cualesquiera clases de API.

Error

Se ha añadido la palabra clave 'final'

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se ha añadido la palabra clave 'final' a cualesquiera clases de API.

Error

Convertido en anotación, enumeración o interfaz

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si cualesquiera clases de API se han convertido en anotaciones, enumeraciones o interfaces.

Error

Se ha reducido la visibilidad

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si cualesquiera clases de API públicas se han hecho privadas o de ámbito predeterminado.

Error

Se ha eliminado un campo

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han eliminado campos públicos o protegidos de cualesquiera clases de API.

Error

Se ha eliminado un método

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han eliminado métodos públicos o protegidos de cualesquiera clases de API.

Error

Se ha eliminado un constructor

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han eliminado constructores públicos o protegidos de cualesquiera clases de API.

Error

Se ha reducido la jerarquía de superclases

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han eliminado superclases de la jerarquía.

Error

Se ha eliminado un tipo de miembro

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han eliminado tipos de miembro de cualesquiera clases de API.

Error

Se ha eliminado un tipo de parámetro

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han eliminado parámetros de tipo de cualesquiera clases de API.

Error

Interfaz

Opción

Descripción

Valor predeterminado

Se ha añadido un campo (interfaz no etiquetada como '@noimplement')

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han añadido campos públicos a cualesquiera interfaces de API.

Error

Se ha añadido un método (interfaz no etiquetada como '@noimplement')

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han añadido métodos públicos a cualesquiera interfaces de API.

Error

Se han añadido restricciones

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han añadido restricciones de API para cualesquiera interfaces API.

Error

Se ha añadido un parámetro de tipo

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han añadido parámetros de tipo a cualesquiera interfaces de API.

Error

Se ha convertido en clase, enumeración o anotación

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si cualesquiera interfaces de API se han convertido en clases, enumeraciones o interfaces.

Error

Se ha reducido la jerarquía de superinterfaces

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han eliminado interfaces padre para cualesquiera interfaces de API.

Error

Se ha eliminado un tipo de parámetro

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han eliminado parámetros de tipo de cualesquiera interfaces de API.

Error

Se ha eliminado un campo

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han eliminado campos públicos de cualesquiera interfaces de API.

Error

Se ha eliminado un método

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han eliminado métodos públicos de cualesquiera interfaces de API.

Error

Se ha eliminado un tipo de miembro

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han eliminado tipos de miembro de cualesquiera interfaces de API.

Error

Enumeración

Opción

Descripción

Valor predeterminado

Se ha reducido la jerarquía de superinterfaces

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han eliminado interfaces padre de cualesquiera enumeraciones de API.

Error

Convertido en anotación, clase o interfaz

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si cualesquiera enumeraciones de API se han convertido en anotaciones, clases o interfaces.

Error

Se ha eliminado un campo

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han eliminado campos públicos de cualesquiera enumeraciones de API.

Error

Se ha eliminado una constante de enumeración

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han eliminado constantes de enumeración de cualesquiera enumeraciones de API.

Error

Se ha eliminado un método

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han eliminado métodos públicos de cualesquiera enumeraciones de API.

Error

Se ha eliminado un tipo de miembro

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han eliminado tipos de miembro de cualesquiera enumeraciones de API.

Error

Anotación

Opción

Descripción

Valor predeterminado

Se ha añadido un método sin un valor predeterminado

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se ha añadido un método sin valor predeterminado a las anotaciones de API.

Error

Se ha convertido en clase, enumeración o interfaz

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si cualesquiera anotaciones de API se han convertido en clases, enumeraciones o interfaces.

Error

Se ha eliminado un campo

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han eliminado campos públicos de cualesquiera anotaciones de API.

Error

Se ha eliminado un método

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han eliminado métodos públicos de cualesquiera anotaciones de API.

Error

Se ha eliminado un tipo de miembro

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han eliminado tipos de miembro públicos de cualesquiera anotaciones de API.

Error

Campo

Opción

Descripción

Valor predeterminado

Se ha añadido un valor de constante

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se ha añadido un valor de constante a constantes de campo público o protegido no inicializadas para cualesquiera tipos de API.

Error

Se ha modificado el tipo

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si el tipo de cualesquiera campos públicos o protegidos se ha cambiado para cualesquiera tipos de API.

Error

Se ha modificado el valor de constante

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si el valor de cualesquiera constantes de campo públicas o protegidas se ha cambiado para cualesquiera tipos de API.

Error

Se ha reducido la visibilidad

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si cualesquiera campos públicos o protegidos se han hecho privados en cualesquiera tipos de API.

Error

Se ha eliminado la palabra clave 'final' para la constante estática

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se ha eliminado la palabra clave final para cualesquiera campos públicos o protegidos en cualesquiera tipos de API.

Error

Se ha añadido la palabra clave 'final'

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si la palabra clave final se ha añadido a cualesquiera campos públicos o protegidos en cualesquiera tipos de API.

Error

Se ha eliminado la palabra clave 'static'

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si la palabra clave static se ha eliminado de cualesquiera campos públicos o protegidos en cualesquiera tipos de API.

Error

Se ha añadido la palabra clave 'static'

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si la palabra clave static se ha añadido a cualesquiera campos públicos o protegidos en cualesquiera tipos de API.

Error

Se ha eliminado el valor de constante

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si el valor de un campo de constante se ha eliminado para cualesquiera campos públicos o protegidos en cualesquiera tipos de API.

Error

Se ha eliminado un argumento de tipo

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se ha eliminado un argumento de tipo de cualesquiera campos públicos o protegidos de cualesquiera tipos de API.

Error

Método

Opción

Descripción

Valor predeterminado

Se ha añadido la restricción @nooverride

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si las restricciones de cualesquiera métodos públicos o protegidos han cambiado en cualesquiera tipos de API añadiendo el código @nooverride.

Error

Se ha añadido un parámetro de tipo

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se ha añadido un parámetro de tipo a cualesquiera métodos públicos o protegidos para cualesquiera tipos de API.

Error

Se ha convertido un argumento de variable en tipo de matriz

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se ha expandido un argumento varargs a una matriz de objeto para cualesquiera métodos públicos o privados para cualesquiera tipos de API.

Error

Se ha reducido la visibilidad

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si cualesquiera métodos públicos o protegidos se han hecho privados para cualesquiera tipos de API.

Error

Se ha añadido la palabra clave 'abstract'

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si cualesquiera métodos públicos o protegidos se han hecho abstractos en cualesquiera tipos de API.

Error

Se ha añadido la palabra clave 'static'

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si cualesquiera métodos públicos o protegidos se han hecho estáticos en cualesquiera tipos de API.

Error

Se ha eliminado la palabra clave 'static'

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si cualesquiera métodos públicos o protegidos se han hecho no estáticos en cualesquiera tipos de API.

Error

Se ha añadido la palabra clave 'final' (tipo etiquetado como '@noextend')

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se hay métodos públicos o protegidos que se han hecho finales en cualesquiera tipos de API que se hayan etiquetado como @noextend.

Error

Se ha eliminado el valor predeterminado de anotación

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se ha eliminado el valor predeterminado asociado a cualquier método de anotación de API.

Error

Se ha eliminado un tipo de parámetro

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se ha eliminado un parámetro de tipo de cualesquiera métodos públicos o protegidos para cualesquiera tipos de API.

Error

Constructor

Opción

Descripción

Valor predeterminado

Se ha añadido un parámetro de tipo

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se ha añadido un parámetro de tipo a cualesquiera constructores públicos para cualesquiera tipos de API.

Error

Se ha convertido un argumento de variable en tipo de matriz

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han expandido parámetros de varargs a matrices de objeto para cualesquiera constructores públicos para cualesquiera tipos de API.

Error

Se ha reducido la visibilidad

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si cualesquiera constructores públicos se han hecho no públicos en cualesquiera tipos de API.

Error

Se ha eliminado un tipo de parámetro

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se ha eliminado un parámetro de tipo de cualesquiera constructores públicos para cualesquiera tipos de API.

Error

Parámetro de tipo

Opción

Descripción

Valor predeterminado

Se ha añadido un enlace de clase

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se ha añadido un enlace de clase a cualquier parámetro de tipo de cualesquiera tipos de API.

Error

Se ha añadido un enlace de interfaz

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han añadido enlaces de interfaz a cualquier parámetro de tipo de cualesquiera tipos de API.

Error

Se ha modificado un enlace de clase

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han cambiado enlaces de clase en cualquier parámetro de tipo de cualesquiera tipos de API.

Error

Se ha modificado un enlace de interfaz

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han cambiado enlaces de interfaz a cualquier parámetro de tipo de cualesquiera tipos de API.

Error

Se ha eliminado un enlace de clase

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han eliminado enlaces de clase en cualquier parámetro de tipo de cualesquiera tipos de API.

Error

Se ha eliminado un enlace de interfaz

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si se han eliminado enlaces de interfaz en cualquier parámetro de tipo de cualesquiera tipos de API.

Error

Gestión de versiones

Página de preferencias de la opción Gestión de versiones de API

Opción

Descripción

Valor predeterminado

Informar de códigos '@since' faltantes

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si faltan códigos @since para tipos o miembros añadidos desde la versión de la línea base de la API en uso.

Error

Informar de códigos '@since' malformados

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si algunos de los códigos @since que se están utilizando actualmente están mal formados (sintaxis incorrecta).

Error

Informar de versión de código '@since' no válida

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si algunos de los códigos @since que se están utilizando actualmente tienen una versión equivocada.

Error

Informar de versión de paquete incompatible

Cuando esta opción está habilitada, el constructor de análisis de API comprobará si la versión de paquete del plug-in no es correcta, basándose en los cambios de API y en la línea base de API actual que se está utilizando.

Error

Omitir incremento de versión menor sin cambios de API

Si el informe de números de versión incompatibles está habilitado, esta opción puede utilizarse para indicar al constructor de análisis de API que omita cambios de versión menores si no se ha producido un cambio de API comparado con la línea base de API actual.

Activada

Omitir incremento de versión mayor sin cambios de API

Si el informe de números de versión incompatibles está habilitado, esta opción puede utilizarse para indicar al constructor de análisis de API que omita cambios de versión mayores si no se ha producido un cambio de API comparado con la línea base de API actual.

Activada

Opciones de análisis

Página de preferencias Opciones de análisis

Opción

Descripción

Valor predeterminado

En el paquete falta la restricción/el prerrequisito necesario

Cuando esta opción está habilitada, el constructor de análisis de API informará de la restricción o el prerrequisito necesarios faltantes que impiden que el constructor realice una análisis completo. Independientemente del valor de esta opción, se salta el análisis para el paquete correspondiente.

Error

Filtros de problemas de API no utilizados

Cuando esta opción está habilitada, el constructor de análisis de API informará de los filtros de problemas de API que ya no se utilicen.

Aviso

Opciones de exploraciones de utilización de API

Página de preferencias de Opciones de exploraciones de utilización de API

Opción

Descripción

Valor predeterminado

Problema de tipo no resuelto

Cuando esta opción está habilitada, el constructor de análisis de API informará de los tipos de API que se han eliminado incluidos en las exploraciones de utilización listadas en la página de preferencias Exploraciones de utilización de API.

Error

Problema de método no resuelto

Cuando esta opción está habilitada, el constructor de análisis de API informará de los métodos que se han eliminado incluidos en las exploraciones de utilización listadas en la página de preferencias Exploraciones de utilización de API.

Error

Problema de campo no resuelto

Cuando esta opción está habilitada, el constructor de análisis de API informará de los campos que se han eliminado incluidos en las exploraciones de utilización listadas en la página de preferencias Exploraciones de utilización de API.

Error


Consulta relacionada

Preferencias del PDE
Página de propiedades Errores y avisos de API
Preferencias de líneas base de API
Preferencias de Exploraciones de utilización de API