Revisões de Código São Executadas no Modo Headless

Você poderá executar revisões de código nos arquivos de origem Java a partir de uma linha de comandos em um workbench "headless" (sem nenhuma interface com o usuário para o ambiente de desenvolvimento). Isso pode ser útil, se você desejar executar as revisões de código não assistidas, regularmente, ou se desejar incluí-las em um script Ant.

Uma interface de linha de comandos permite especificar o seu linha de comandos e quaisquer parâmetros opcionais. A linha de comandos ativa um ambiente Eclipse apenas com os recursos principais necessários para executar as revisões de código e sem os recursos de interface do usuário. Por padrão, execute uma revisão de código no código fonte utilizando as regras na revisão de código Rápida ou as que foram especificadas na UI na última vez que a revisão de código foi executada.

Antes de executar revisões de código no modo headless, é necessário ter um espaço de trabalho contendo um projeto com arquivos de origem Java. O ambiente de desenvolvimento não precisa estar em execução.
Nota: Devido às limitações do sistema operacional Windows, o comprimento da cadeia utilizada para executar o modo de linha de comandos (C:\path\java.exe …) deve ser o mais curto possível ou os parâmetros ao final da cadeia devem ser cortados e perdidos pelo sistema. Usuários do Windows devem utilizar as boas práticas a seguir para obter os melhores resultados:
  • A variável PATH deve incluir o máximo de caminhos possível, como por exemplo o caminho Java e o caminho dos arquivos JAR.
  • O caminho ao espaço de trabalho deve ser o mais curto possível, por exemplo, C:\workspace.
  • O caminho até o local em que os relatórios são gerados também deve ser o mais curto possível, por exemplo, C:\report.

Não é possível executar várias execuções de revisão de código no modo headless ao mesmo tempo no mesmo espaço de trabalho; também não é possível utilizar o modo headless enquanto uma interface gráfica com o usuário Eclipse tiver bloqueado o espaço de trabalho.

Exemplo

A linha de comandos a seguir executa revisões de código em um S.O. Windows a partir do espaço de trabalho D:\workspace. Um relatório HTML é produzido em D:\workspace\report.
D:\eclipse\jre\bin\java -Xj9 -Dorg.eclipse.swt.browser.internal.flash -Dorg.eclipse.emf.ecore.EPackage.Registry.INSTANCE=org.eclipse.emf.ecore.impl.EPackageRegistryImpl -cp D:\eclipse\startup.jar org.eclipse.core.launcher.Main -application com.ibm.r2a.command.line.mode.CommandLineModeApplication -plugincustomization <pluginCustomizationPath> -data <workspace_dir> -reportDirectory D:\workspace\report -onlyClient CodeReview
Nota: Pode ser necessário anexar parâmetros adicionais nos comandos deste exemplo para executá-lo, dependendo da configuração de seu sistema operacional. Os parâmetros estão localizados nos detalhes de configuração do sistema sob "Propriedades do Sistema", em Ajuda > Sobre > Detalhes de Configuração > Propriedades do Sistema.
Tarefas relacionadas
Executando Revisões de Código de uma Linha de Comandos
Executando Revisões de Código de um Script Ant
Referências relacionadas
Referência do Modo Headless de Revisão de Código
Revisão de Código Quick
Termos de Utilização | Feedback
(C) Copyright IBM Corporation 2004, 2005. Todos os Direitos Reservados.