Assistente de padrões de utilização da API

Este assistente ajuda a orientá-lo ao longo da criação de padrões de expressões regulares para controlar uma análise da utilização da API.

Para activar o assistente, siga estes passos:

  1. Durante a criação de uma nova configuração de lançamento de relatórios de utilização, vá ao separador Padrões.
  2. No separador, prima o botão Adicionar...

Opção

Descrição

Predefinição

Tipos de padrões Esta lista mostra todos os padrões que podem ser criados com o assistente. Primeiro elemento na lista
Descrição Mostra a descrição legível do tipo de padrão seleccionado na lista Tipos de padrões.  

A primeira página do assistente permite a selecção do tipo de padrão que pretende criar. É dada uma descrição de cada padrão para o ajudar a escolher - basta seleccionar o padrão e a descrição é apresentada no campo Descrição.

Assistente de padrões de utilização da API - página de selecção de padrão

Padrões de arquivo

Quando a análise da utilização da API é feita, são pesquisadas todas as pastas e arquivos dentro de um lote, assegurando que todos ficheiros de classe são analisados. Em alguns casos, um lote poderá conter um arquivo com versões antigas de ficheiros de classe (por exemplo) que não pretende que seja analisado. Nesse caso, pode ser utilizado um padrão de arquivo para ignorar completamente um arquivo específico ou todos os arquivos que correspondam a uma expressão regular fornecida.

Opção

Descrição

Predefinição

Nome de lote O nome simbólico completo do lote em que este padrão se aplica. Por exemplo: org.eclipse.pde.api.tools. vazio
Nome de arquivo O nome completo ou a expressão regular do(s) arquivo(s) em que o padrão se aplica. Por exemplo: *.jar - com o que irá ignorar qualquer ficheiro jar imbricado. vazio

Assistente de padrões de utilização da API - criar padrões de arquivo

Padrões de pacote

Ao extrair referências para análise, o motor de pesquisa de utilização da API utiliza metadados de agrupamento para determinar se uma referência é ou não interna. Em alguns casos, um lote não foi definido para descrever adequadamente quais são as classes internas e quais as que não são. Um padrão de pacote permite aumentar esses lotes mal formados - isto apenas do ponto de vista do motor de pesquisa; o lote em questão não é alterado de qualquer forma - para descrever o que é ou não interno.

Opção

Descrição

Predefinição

Padrão O padrão de expressão regular para corresponder com pacotes. Por exemplo: .*\.internal\..*. vazio
Padrão de API Se o padrão deverá fazer com que pacotes correspondentes sejam considerados ou não uma API. marcado

Assistente de padrões de utilização da API - criar padrões de pacote

Padrões de conversão de relatórios

Quando uma análise de utilização da API termina, pode haver uma quantidade enorme de informação para verificar. Com um padrão de conversão de relatórios, contudo, pode reduzir as informações de referência apresentadas nos relatórios HTML de modo a ver apenas o que lhe interessa. Para tal, pode criar padrões de exclusão utilizados para reduzir as referências incluídas nos relatórios.

Opção

Descrição

Predefinição

Filtrar referências a este padrão Permite ignorar referências incluídas em relatórios em função do padrão. Por exemplo, se o padrão fosse org\.eclipse\.jdt\..*, a selecção desta opção faria com que os relatórios não incluíssem quaisquer referências feitas a JDT. seleccionado
Filtrar referências para este padrão Permite ignorar referências incluídas em relatórios em função do padrão. Por exemplo, se o padrão fosse org\.eclipse\.jdt\..*, a selecção desta opção faria om que os relatórios não incluíssem quaisquer referências a JDT.  
Padrão O padrão de expressão regular. vazio

Assistente de padrões de utilização da API - criar padrões de conversão de relatórios

Tarefas relacionadas

Configurar ferramentas da API

Referência relacionada

Acção Configurar ferramentas da API
Menu Ferramentas de PDE
Relatórios de Utilização da API