Executando Revisões de Código de uma Linha de Comandos

Você pode executar revisões de código em um workbench "headless" (sem interface com o usuário para o ambiente de desenvolvimento) a partir de uma interface de linha de comandos. As regras de revisão de código que são executadas no código fonte são as que foram utilizadas por último na interface com o usuário. Se uma revisão de código nunca foi executada, as configurações padrão na página Revisão de Código das Preferências Java (a revisão de código Quick) serão executadas no código. Por padrão, após a execução da revisão do código, dois relatórios serão gerados: um relatório HTML e um relatório JSML (JScrib Markup Language). Eles serão localizados na pasta de metadados do espaço de trabalho na pasta com.ibm.r2a.command.line.mode. Você pode especificar o tipo de relatório que é gerado e o local no qual o relatório aparece depois que a revisão de código é executada.

Nota: Você pode executar revisões de código no modo headless apenas no espaço de trabalho. Se você deseja analisar um subconjunto do espaço de trabalho, como um ou mais projetos específicos, crie um espaço de trabalho com esses projetos e execute o revisão de código nesse espaço de trabalho.
Antes de executar as revisões de código no modo headless: O ambiente de desenvolvimento não precisa estar em execução.

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.

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.
Para executar revisões de código em um workbench headless, ativa-se o aplicativo no modo linha de comandos utilizando o comando <dir_do_eclipse>/jre/bin/java <opções da máquina virtual> -cp <dir_do_eclipse>/startup.jar org.eclipse.core.launcher.Main <opções do modo da linha de comandos> <opções do eclipse>, juntamente com sua configuração do produto. A sua configuração do produto pode ser localizada em Ajuda > Sobre > Detalhes da Configuração > Propriedades do Sistema. <opções da máquina virtual> estão localizadas sob a propriedade eclipse.vmargs. As opções principais do Eclipse estão localizadas sob a propriedade eclipse.commands, onde você poderá incluir o caminho do espaço de trabalho utilizando o token -data do Eclipse. <opções do modo da linha de comandos> refere-se a opções do modo da linha de comandos.
Nota: Pode ser necessário anexar parâmetros adicionais aos comandos nas etapas a seguir, dependendo da configuração de seu sistemas operacional. Os parâmetros estão localizados nos detalhes da configuração do sistema sob "Propriedades do Sistema".
Para executar uma revisão de código em um workbench headless:
  1. Abra uma janela ou shell de linha de comandos.
    • No Windows, digite o seguinte comando: <dir_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 <dir_eclipse>/startup.jar org.eclipse.core.launcher.Main -application com.ibm.r2a.command.line.mode.CommandLineModeApplication -plugincustomization <caminho_de_customização_do_plug-in> -data <dir_espaço_de_trabalho> -reportDirectory <seu_diretório_de_relatórios> -onlyClient CodeReview
    • No Linux, digite o seguinte comando: <dir_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 <dir_eclipse>/startup.jar org.eclipse.core.launcher.Main -application com.ibm.r2a.command.line.mode.CommandLineModeApplication -os linux -ws gtk -plugincustomization <caminho_customização_de_plug-in -data <dir_espaço_de_trabalho> -reportDirectory <seu_diretório_de_relatórios> -onlyClient CodeReview
    Substitua <eclipse_dir> pelo caminho ao diretório Eclipse. Esse diretório Eclipse deve ser o diretório Eclipse localizado no diretório raiz do projeto. Substitua <dir_do_espaço_de_trabalho> pelo caminho ao diretório do espaço de trabalho. Substitua <Caminho_de_Customização_do_plugin> pelo caminho do seu arquivo pluginCustomization.ini. Inclua suas opções adicionais ao final da linha de comandos. Para obter informações sobre os parâmetros opcionais, consulte o tópico relacionado de referência para o modo headless de revisão de código. Nestes comandos:
    • -Xj9 –Dorg.eclipse.swt.browser.internal.flash - Dorg.eclipse.emf.ecore.EPackage.Registry.INSTANCE=org.eclipse.emf.ecore.impl.EPackageRegistryImpl corresponde aos argumentos de máquina virtual requeridos por produtos RASD.
    • -data <dir_do_espaço_de_trabalho> -plugincustomization <Caminho_de_Customização_do_plugin> corresponde aos argumentos Eclipse requeridos.
    • Os outros argumentos estão relacionados ao aplicativo para o modo da linha de comandos.
    Utilize as aspas duplas quando o caminho contiver espaços. Se estiver utilizando o Windows, utilize barras invertidas duplas (\\) em vez de caracteres de barra invertida. Segue um exemplo: "C:\\Arquivos de Programas\\IBM\\Rational\\".
  2. Pressione Enter.
Os resultados da revisão de código são gerados em um diretório report localizado no espaço de trabalho.
Conceitos relacionados
Revisões de Código São Executadas no Modo Headless
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.