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:
| 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.
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 |
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 |
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 |

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