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

Você pode executar revisões de código em um workbench "headless" (sem nenhuma 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 aquelas que foram utilizadas pela última vez na interface com o usuário. Se uma revisão de código nunca tiver sido executada, as configurações padrão na página Preferências Java - Revisão de Código (na revisão de código Rápida) serão executadas no código. By default, after the code review runs, two reports are generated: an HTML report and a JSML (JScrib Markup Language) report. Eles estão localizados na pasta de metadados do espaço de trabalho na pasta com.ibm.r2a.command.line.mode. Você pode especificar qual tipo de relatório é gerado e o local em que eles aparecem depois da revisão de código ser executada.

Nota: Você pode executar revisões de código no modo headless apenas no espaço de trabalho. Se desejar 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 a revisão de código nele.
Antes de executar as revisões de código no modo headless: O ambiente de desenvolvimento não precisa estar em execução.

You cannot run several executions of code review in headless mode on the same workspace at the same time, nor can you use headless mode while an Eclipse graphical user interface has locked the workspace.

Nota: Devido às limitações do sistema operacional Windows, o comprimento da cadeia que é utilizado para executar o modo da linha de comandos (C:\path\java.exe …) deve ser o menor possível ou os parâmetros no final da cadeia poderão ser cortados e perdidos pelo sistema. Usuários do Windows devem utilizar as seguintes boas práticas para obterem resultados ótimos:
  • A variável PATH deve incluir o máximo de caminhos possíveis, por exemplo, o caminho Java e o caminho para os arquivos JAR.
  • O caminho para o espaço de trabalho deve ser o menor possível, por exemplo, C:\workspace.
  • O caminho para o local onde os relatórios são gerados também deve ser o menor possível, por exemplo, C:\report.
To run code reviews in a headless workbench, you launch the command line mode application using the command <eclipse_dir>/jre/bin/java <virtual machine options> -cp <eclipse_dir>/startup.jar org.eclipse.core.launcher.Main <command line mode options> <eclipse options>, along with your product configuration. You can find your product configuration at Help > About > Configuration Details > System properties. <virtual machine options> are located under the eclipse.vmargs property. The main Eclipse options are located under the eclipse.commands property, to which you add the workspace path using the Eclipse token -data. <command line mode options> refers to command-line mode options.
Nota: You might need to append additional parameters to the commands in the following steps, depending on your operating system configuration. The parameters are located in the system configuration details under "System properties".
To run a code review in a headless workbench:
  1. Abra uma janela ou shell de linha de comandos.
    • For Windows, enter the following command: <eclipse_dir>/jre/bin/java -Xj9 -Dorg.eclipse.swt.browser.internal.flash -Dorg.eclipse.emf.ecore.EPackage.Registry.INSTANCE=org.eclipse.emf.ecore.impl.EPackageRegistryImpl -cp <eclipse_dir>/startup.jar org.eclipse.core.launcher.Main -application com.ibm.r2a.command.line.mode.CommandLineModeApplication -plugincustomization <pluginCustomizationPath> -data <workspace_dir> -reportDirectory <your_report_directory> -onlyClient CodeReview
    • For Linux, enter the following command: <eclipse_dir>/jre/bin/java -Xj9 -Dorg.eclipse.swt.browser.internal.flash -Dorg.eclipse.emf.ecore.EPackage.Registry.INSTANCE=org.eclipse.emf.ecore.impl.EPackageRegistryImpl -cp <eclipse_dir>/startup.jar org.eclipse.core.launcher.Main -application com.ibm.r2a.command.line.mode.CommandLineModeApplication -os linux -ws gtk -plugincustomization <pluginCustomizationPath> -data <workspace_dir> -reportDirectory <your_report_directory> -onlyClient CodeReview
    Substitua <dir_eclipse> pelo caminho para o diretório do Eclipse. O diretório do Eclipse deve ser aquele localizado no diretório raiz do projeto. Substitua <dir_espaço_de_trabalho> pelo caminho para o diretório do espaço de trabalho. Substitua <pluginCustomizationPath> pelo caminho do arquivo pluginCustomization.ini. Inclua quaisquer opções adicionais no final da linha de comandos. Para obter informações sobre parâmetros opcionais, consulte o tópico de referência relacionada sobre o modo headless de revisão de código. In these commands:
    • -Xj9 –Dorg.eclipse.swt.browser.internal.flash - Dorg.eclipse.emf.ecore.EPackage.Registry.INSTANCE=org.eclipse.emf.ecore.impl.EPackageRegistryImpl corresponds to the virtual machine arguments that are required by RASD products.
    • -data <dir_espaço_de_trabalho> -plugincustomization <pluginCustomizationPath> corresponde aos argumentos obrigatórios do Eclipse.
    • Os outros argumentos estão relacionados ao aplicativo para o modo de linha de comandos.
    Utilize aspas duplas quando o caminho contiver espaços. Se estiver utilizando o Windows, utilize barras duplas invertidas (\\) em vez do caractere de barra invertida. A seguir há 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 Executadas no Modo Headless
Referências relacionadas
Referência do Modo Headless de Revisão de Código
Revisão de Código Quick