Preferências de Erros e Avisos de API

As seguintes preferências podem ser definidas utilizando a página de preferências Abre página de preferências da Consola Programação de Plug-ins> Erros e Avisos de API.

Os problemas de API surgem durante as compilações de projectos (automáticas e completas), e as ferramentas dividem os tipos de problemas em três categorias:

  1. Problemas de utilização - um código restrito está a ser chamado por plug-ins não autorizados
  2. Incompatibilidades da API - as alterações entre versões não são compatíveis
  3. Problemas de versões - as versões de plug-in ou de código (identificadores @since tags) não são correctas
  4. Opções de análise - opções gerais

Também pode configurar as gravidades dos problemas por projecto, com a página de propriedades Erros e Avisos de API de um projecto.

Utilização de API

página de preferências das opções de Utilização de API

Geral

Opção

Descrição

Predefinição

Utilização não suportada de identificadores Javadoc da API

Quando activada, o construtor de análise da API verifica a utilização incorrecta de identificadores Javadoc de API.

Ignorar

Referência não definida no ambiente de execução especificado

Quando activada, o construtor de análises da API irá verificar se existem referências a bibliotecas do sistema que podem ser ilegais de acordo com o ambiente de execução especificado para o lote.

Ignorar

Restrições

Opção

Descrição

Predefinição

Implementar um interface assinalada '@noimplement'

Quando activada, o construtor de análise da API verifica a implementação ilegal de interfaces assinaladas.

Aviso

Expandir um tipo assinalado '@noextend'

Quando activada, o construtor de análise da API verifica a existência de classes que expandam tipos assinalados.

Aviso

Referência a um campo ou método assinalado @noreference'

Quando activada, o construtor de análise da API verifica a existência de referências de campos e métodos a membros identificados.

Aviso

Instanciar uma classe com identificador '@noinstantiate'

Quando activada, o construtor de análise da API verifica se as classes identificadas não estão instanciadas.

Aviso

Sobrepor um método assinalado '@nooverride'

Quando activada, o construtor de análise da API verifica se os métodos identificados em classes ascendentes não foram sobrepostos em qualquer classe descendente, quer por expansão (reimplementar com uma chamada ao ascendente sobreposto), quer reimplementando (sem chamada ao ascendente sobreposto).

Aviso

Fugas

Opção

Descrição

Predefinição

Expande uma classe alheia a API

Quando activada, o construtor de análise da API verifica se há classes de API a expandirem tipos alheios a API.

Aviso

Implementa uma interface alheia a API

Quando activada, o construtor de análise da API verifica se há classes de API a implementarem uma interface alheia a API.

Aviso

Campo com tipo alheio a API

Quando activada, o construtor de análise da API verifica se há tipos de API com campos públicos ou protegidos com tipos alheios a API.

Aviso

Método com tipo de retorno alheio a API

Quando activada, o construtor de análise da API verifica se há tipos de API com métodos públicos ou protegidos com tipos de retorno alheios a API.

Aviso

Método com tipo de parâmetro alheio a API

Quando activada, o construtor de análise da API verifica se há tipos de API com métodos públicos ou protegidos com tipos de parâmetro alheios a API.

Aviso

Compatibilidade de API

página de preferências Compatibilidade de API

Opção

Descrição

Predefinição

Comunicar descontinuidades da API mesmo ser autorizadas por incremento da versão principal

Quando activada, o construtor de análise da API irá comunicar problemas de descontinuidade da API mesmo se a versão principal do agrupamento já tenha sido incrementada.

Desactivado

Agrupamento

Opção

Descrição

Predefinição

Um tipo API tornou-se alheio a API

Quando activada, o construtor de análise da API irá verificar se algum tipo API no agrupamento actual foi alterado para um tipo não API.

Erro

Foi removido um tipo

Quando activada, o construtor de análise da API verifica se há tipos API que tenham sido removidos do âmbito da API no agrupamento indicado.

Erro

Um tipo API novamente exportado passou a ser não API

Quando activada, o construtor de análise da API irá verificar se algum tipo API novamente exportado no agrupamento actual foi alterado para tipo não API.

Erro

Foi removido um tipo novamente exportado

Quando activada, o construtor de análise da API irá verificar se algum tipo API novamente exportado foi removido do âmbito da API no agrupamento especificado.

Erro

Classe

Opção

Descrição

Predefinição

Foi adicionado um método que precisa de ser implementado:

Quando activada, o construtor de análise da API irá verificar se algum método público ou protegido adicionado a algum tipo API precisa de ser implementado.

Erro

Foram adicionadas restrições

Quando activada, o construtor de análise da API irá verificar se foram adicionadas restrições API a alguma classe API.

Erro

Foi adicionado um parâmetro de tipo

Quando activada, o construtor de análise da API irá verificar se algum parâmetro de tipo foi adicionado a alguma classe de API.

Erro

A hierarquia de superinterfaces foi reduzida

Quando activada, o construtor de análise da API verifica se foram removidas interfaces ascendentes de classes de API.

Erro

A palavra-chave 'abstract' foi adicionada

Quando activada, o construtor de análise da API verifica se foi adicionada a palavra-chave 'abstract' a classes de API.

Erro

A palavra-chave 'final' foi adicionada

Quando activada, o construtor de análise da API verifica se foi adicionada a palavra-chave 'final' a classes de API.

Erro

Convertido em anotação, enum ou interface

Quando activada, o construtor de análise da API irá verificar se alguma classe API foi alterada para anotação, enum ou interface.

Erro

A visibilidade foi reduzida

Quando activada, o construtor de análise da API verifica se há classes de API públicas tornadas privadas ou de âmbito predefinido.

Erro

Foi removido um campo

Quando activada, o construtor de análise da API verifica se foram removidos campos públicos ou protegidos de classes de API.

Erro

Foi removido um método

Quando activada, o construtor de análise da API verifica se foram removidos métodos públicos ou protegidos de classes de API.

Erro

Foi removido um construtor

Quando activada, o construtor de análise da API verifica se foram removidos construtores públicos ou protegidos de classes de API.

Erro

A hierarquia de superclasses foi reduzida

Quando activada, o construtor de análise da API irá verificar se alguma superclasse foi removida da hierarquia.

Erro

Foi removido um tipo de membro

Quando activada, o construtor de análise da API irá verificar se algum tipo de membro foi removido de alguma classe API.

Erro

Foi removido um parâmetro de tipo

Quando activada, o construtor de análise da API verifica se foram removidos parâmetros de tipo de classes de API.

Erro

Interface

Opção

Descrição

Predefinição

Foi adicionado um campo (interface não identificada como '@noimplement')

Quando activada, o construtor de análise da API verifica se foram adicionados campos públicos a interfaces de API.

Erro

Foi adicionado um método (interface não identificada como '@noimplement')

Quando activada, o construtor de análise da API verifica se foram adicionados métodos públicos a interfaces de API.

Erro

Foram adicionadas restrições

Quando activada, o construtor de análise da API irá verificar se foram adicionadas restrições API a alguma interface API.

Erro

Foi adicionado um parâmetro de tipo

Quando activada, o construtor de análise da API verifica se foram adicionados parâmetros de tipo a interfaces de API.

Erro

Convertido em classe, enum ou anotação

Quando activada, o construtor de análise da API irá verificar se alguma interface API foi alterada para classe, enum ou anotação.

Erro

A hierarquia de superinterfaces foi reduzida

Quando activada, o construtor de análise da API verifica se foram removidas interfaces ascendentes de interfaces de API.

Erro

Foi removido um parâmetro de tipo

Quando activada, o construtor de análise da API verifica se foram removidos parâmetros de tipo de interfaces de API.

Erro

Foi removido um campo

Quando activada, o construtor de análise da API verifica se foram removidos campos públicos de interfaces de API.

Erro

Foi removido um método

Quando activada, o construtor de análise da API verifica se foram removidos métodos públicos de interfaces de API.

Erro

Foi removido um tipo de membro

Quando activada, o construtor de análise da API verifica se foram removidos membros de tipo de interfaces de API.

Erro

Enum

Opção

Descrição

Predefinição

A hierarquia de superinterfaces foi reduzida

Quando activada, o construtor de análise da API verifica se foram removidas interfaces ascendentes de enumerações de API.

Erro

Convertido em anotação, classe ou interface

Quando activada, o construtor de análise da API irá verificar se algum enum API foi alterado para anotação, classe ou interface.

Erro

Foi removido um campo

Quando activada, o construtor de análise da API verifica se foram removidos campos públicos de enumerações de API.

Erro

Foi removida uma constante de enumeração

Quando activada, o construtor de análise da API verifica se foram removidas constantes de enumerações de API.

Erro

Foi removido um método

Quando activada, o construtor de análise da API verifica se foram removidos métodos públicos de enumerações de API.

Erro

Foi removido um tipo de membro

Quando activada, o construtor de análise da API verifica se foram removidos tipos de membro de enumerações de API.

Erro

Anotação

Opção

Descrição

Predefinição

Foi adicionado um método sem um valor predefinido

Quando activada, o construtor de análise da API verifica se foi adicionado um método sem valor predefinido a anotações de API.

Erro

Convertido em classe, enum ou interface

Quando activada, o construtor de análise da API irá verificar se alguma anotação API foi alterada para classe, enum ou interface.

Erro

Foi removido um campo

Quando activada, o construtor de análise da API verifica se foram removidos campos públicos de anotações de API.

Erro

Foi removido um método

Quando activada, o construtor de análise da API irá verificar se foi removido algum método público de alguma anotação API.

Erro

Foi removido um tipo de membro

Quando activada, o construtor de análise da API irá verificar se algum tipo de membro foi removido de alguma anotação API.

Erro

Campo

Opção

Descrição

Predefinição

Foi adicionado um valor de constante

Quando activada, o construtor de análise da API verifica se foi adicionado algum valor de constante a constantes de campos públicos ou protegidos anteriormente não iniciados, relativamente a tipos de API.

Erro

O tipo foi modificado

Quando activada, o construtor de análise da API verifica se o tipo de quaisquer campos públicos ou protegidos foi alterado para tipos de API.

Erro

O valor de constante foi modificado

Quando activada, o construtor de análise da API verifica se o valor de quaisquer campos públicos ou protegidos foi alterado para tipos de API.

Erro

A visibilidade foi reduzida

Quando activada, o construtor de análise da API verifica se foram tornados privados campos públicos ou protegidos em tipos de API.

Erro

A palavra-chave 'final' foi removida da constante estática

Quando activada, o construtor de análise da API verifica se a palavra-chave 'final' foi removida de campos públicos ou protegidos em tipos de API.

Erro

A palavra-chave 'final' foi adicionada

Quando activada, o construtor de análise da API verifica se foi adicionada a palavra-chave 'final' campos públicos ou protegidos em tipos de API.

Erro

A palavra-chave 'static' foi removida

Quando activada, o construtor de análise da API verifica se foi removida a palavra-chave 'static' de campos públicos ou protegidos em tipos de API.

Erro

A palavra-chave 'static' foi adicionada

Quando activada, o construtor de análise da API verifica se foi adicionada a palavra-chave 'static' campos públicos ou protegidos em tipos de API.

Erro

O valor de constante foi removido

Quando activada, o construtor de análise da API verifica se o valor de um campo constante foi removido de constantes de campos públicos ou protegidos em tipos de API.

Erro

Foi removido um argumento de tipo

Quando activada, o construtor de análise da API irá verificar se algum argumento de tipo foi removido de algum campo público ou protegido nalgum tipo API.

Erro

Método

Opção

Descrição

Predefinição

Foi adicionada a restrição @nooverride

Quando activada, o construtor de análise da API irá verificar se as restrições de algum método público ou protegido foram alteradas para algum tipo API através da adição do identificador @nooverride.

Erro

Foi adicionado um parâmetro de tipo

Quando activada, o construtor de análise da API verifica se foi adicionado um parâmetro de tipo a métodos públicos ou protegidos em tipos de API.

Erro

Convertido argumento de variável em tipo de conjunto

Quando activada, o construtor de análise da API verifica se foi expandido algum argumento varargs em conjunto de objectos para quaisquer métodos públicos ou protegidos em tipos de API.

Erro

A visibilidade foi reduzida

Quando activada, o construtor de análise da API verifica se foram tornados privados métodos públicos ou protegidos em tipos de API.

Erro

A palavra-chave 'abstract' foi adicionada

Quando activada, o construtor de análise da API verifica se foram tornados abstractos métodos públicos ou protegidos em tipos de API.

Erro

A palavra-chave 'static' foi adicionada

Quando activada, o construtor de análise da API verifica se foram tornados estáticos métodos públicos ou protegidos em tipos de API.

Erro

A palavra-chave 'static' foi removida

Quando activada, o construtor de análise da API verifica se foram tornados não estáticos métodos públicos ou protegidos em tipos de API.

Erro

A palavra-chave 'final' foi adicionada (tipo identificado '@noextend')

Quando activada, o construtor de análise da API verifica se há métodos públicos ou protegidos tornados finais em tipos de API que tenham sido identificados como @noextend.

Erro

O valor predefinido da anotação foi removido

Quando activada, o construtor de análise da API irá verificar se foi removido o valor predefinido associado a algum método de anotação API.

Erro

Foi removido um parâmetro de tipo

Quando activada, o construtor de análise da API verifica se foi removido algum parâmetro de tipo de métodos públicos ou protegidos em tipos de API.

Erro

Construtor

Opção

Descrição

Predefinição

Foi adicionado um parâmetro de tipo

Quando activada, o construtor de análise da API verifica se foi adicionado um parâmetro de tipo a construtores públicos em tipos de API.

Erro

Convertido argumento de variável em tipo de conjunto

Quando activada, o construtor de análise da API verifica se foram expandidos parâmetros varargs em conjuntos de objectos para construtores públicos para tipos de API.

Erro

A visibilidade foi reduzida

Quando activada, o construtor de análise da API verifica se alguns construtores públicos foram tornados não públicos em tipos de API.

Erro

Foi removido um parâmetro de tipo

Quando activada, o construtor de análise da API verifica se foi removido algum parâmetro de tipo de construtores públicos em tipos de API.

Erro

Tipo de parâmetro

Opção

Descrição

Predefinição

Foi adicionado um limite de classe

Quando activada, o construtor de análise da API irá verificar se foi adicionado algum limite de classe a algum parâmetro de tipo de algum tipo API.

Erro

Foi adicionado um limite de interface

Quando activada, o construtor de análise da API irá verificar se foi adicionado algum limite de interface a algum parâmetro de tipo de algum tipo API.

Erro

Foi modificado um limite de classe

Quando activada, o construtor de análise da API irá verificar se foi alterado algum limite de classe a algum parâmetro de tipo de algum tipo API.

Erro

Foi alterado um limite de interface

Quando activada, o construtor de análise da API irá verificar se foi aletrado algum limite de interface a algum parâmetro de tipo de algum tipo API.

Erro

Foi removido um limite de classe

Quando activada, o construtor de análise da API irá verificar se foi removido algum limite de classe a algum parâmetro de tipo de algum tipo API.

Erro

Foi removido um limite de interface

Quando activada, o construtor de análise da API irá verificar se foi removido algum limite de interface a algum parâmetro de tipo de algum tipo API.

Erro

Gestão de Versões

página de preferências de opções de Gestão de Versões de API

Opção

Descrição

Predefinição

Registar identificadores '@since' ausentes

Quando activada, o construtor de análise da API verifica se faltam identificadores @since a tipos ou membros adicionados desde que a versão da linha de base da API está a ser utilizada.

Erro

Registar identificadores '@since' mal formados

Quando activada, o construtor de análise da API verifica se há identificadores @since a serem utilizados e que estejam mal formados (sintaxe incorrecta).

Erro

Registar versão de identificador '@since' não válida

Quando activada, o construtor de análise da API verifica se há identificadores @since a serem utilizados e que tenham a versão errada.

Erro

Registar versão de agrupamento incompatível

Quando activada, o construtor de análise da API verifica se a versão do agrupamento para o plug-in será incorrecta, com base em alterações de API e na actual linha de base de API em utilização.

Erro

Ignorar incremento de versão menor sem alterações à API

Se estiver activado o registo de números de versão incompatíveis, esta opção poderá ser usada para dizer ao construtor de análise da API que ignore alterações de versão menores, caso não tenha havido uma alteração de API comparada com a actual linha de base de API.

Activado

Ignorar incremento de versão maior sem alterações à API

Se estiver activado o registo de números de versão incompatíveis, esta opção poderá ser usada para dizer ao construtor de análise da API que ignore alterações de versão maiores, caso não tenha havido uma alteração de API comparada com a actual linha de base de API.

Activado

Opções de análise

Página de preferências de opções de análise

Opção

Descrição

Predefinição

Agrupamento em falta requerido por restrição/pré-requisito

Quando activada, o construtor de análise da API irá comunicar alguma restrição ou pré-requisito em falta que impede que o construtor efectue uma análise completa. Independentemente do valor desta opção, a análise é efectuada ignorando o agrupamento correspondente.

Erro

Filtros de problemas de API não utilizados

Quando activado, o construtor de análise da API vai comunicar quaisquer filtros de problemas da API que já não estejam a ser utilizados.

Aviso

Opções de pesquisas de utilização da API

Página de preferências Opções de pesquisas de utilização da API

Opção

Descrição

Predefinição

Problema de tipo não solucionado

Quando activado, o construtor de análises da API irá registar quaisquer tipos da API que foram removidos que estão incluídos em qualquer pesquisa de utilização listados na página de preferências Pesquisas de utilização da API.

Erro

Problema de método não solucionado

Quando activado, o construtor de análises da API irá registar quaisquer métodos que tenham sido removidos que estejam incluídos em qualquer pesquisa de utilização listados na página de preferências Pesquisas de utilização da API.

Erro

Problema de campo não solucionado

Quando activado, o construtor de análises da API irá registar quaisquer campos que foram removidos que estão incluídos em qualquer pesquisa de utilização listada na página de preferências Pesquisas de utilização da API.

Erro


Referência relacionada

Preferências do PDE
Página de Propriedades Erros e Avisos de API
Preferências de Linhas de Base de API
Preferências das pesquisas de utilização da API