Referência do Modo Headless de Revisão de Código

O modo headless permite automatizar as revisões de código de uma linha de comandos ou um script Ant sem a entrada do usuário ou sem uma interface gráfica com o usuário do produto.

Finalidade

Uma linha de comandos ativa um workbench "headless" (sem interface do usuário para o ambiente de desenvolvimento) e executa configurações de ativação de revisão de código que são encontradas em um espaço de trabalho especificado.

Essa é uma sintaxe de linha de comandos básica para executar a revisão de código no modo headless:

<diretório Eclipse>/jre/bin/java <parâmetros obrigatórios> <parâmetros opcionais>

Parâmetros Obrigatórios

Existem três categorias de parâmetros obrigatórios:
  • Produto VM
  • Eclipse
  • Linha de Comandos

Produto VM

-Xj9
Ativa o aplicativo para o modo de linha de comandos, juntamente com outros parâmetros listados em Ajuda > Sobre a Plataforma Eclipse > Detalhes de Configuração.
-cp <caminho_de_classe>/startup.jar org.eclipse.core.launcher.Main
Ativa o Eclipse no modo headless com o caminho de classe especificado. Utilize as aspas duplas quando o caminho contiver espaços.
Para Windows, utilize barras invertidas duplas (\\) em vez do caractere de barra invertida. Segue um exemplo: "C:\\Arquivos de Programas\\IBM\\Rational\\".
Eclipse
-plugincustomization <Caminho_de_Customização_de_plugin>
Substitui o caminho de customização para o plug-in com o caminho do arquivo pluginCustomization.ini para o seu plug-in.
-application com.ibm.r2a.command.line.mode.CommandLineModeApplication
Especifica o aplicativo utilizado para executar a revisão de código.
-data <espaço de trabalho>
Especifica o local do espaço de trabalho em que as configurações de ativação estão localizadas. Utilize as aspas duplas quando o caminho contiver espaços. Para Windows, utilize barras invertidas duplas (\\) em vez do caractere de barra invertida. Segue um exemplo: "C:\\Arquivos de Programas\\IBM\\Rational\\".
-os linux
Especifica Linux como o sistema operacional. Este parâmetro pode ser encontrado na seção de comandos em Ajuda > Detalhes da Configuração > Propriedades do Sistema > Eclipse.
-ws gtk
Especifica o parâmetro de configuração da interface com o usuário requerido por alguns componentes Eclipse. Este parâmetro pode ser encontrado na seção de comandos em Ajuda > Detalhes da Configuração > Propriedades do Sistema > Eclipse.
Linha de Comandos
-reportDirectory directory_path
Especifica o diretório em que os arquivos de relatório devem ser produzidos. Utilize as aspas duplas quando o caminho contiver espaços. Para Windows, utilize barras invertidas duplas (\\) em vez do caractere de barra invertida. Segue um exemplo: "C:\\Arquivos de Programas\\IBM\\Rational\\".

Parâmetros Opcionais

-persistKind html|xml
Especifica se é necessário produzir um relatório HTML ou XML sozinho. Por padrão, ambos os relatórios são gerados.
-verbose
Produz uma saída simples de estados apenas para fins de depuração.
-excludeClient
Especifica um ou mais clientes, por nome, a serem excluídos da revisão de código.
-onlyClient
Especifica para executar apenas um cliente por nome; por padrão, todos os clientes são executados.
-reportDirectory
Especifica o diretório de relatório no qual os relatórios gerados são colocados após a revisão de código; o diretório de relatório padrão está nos metadados do plug-in da linha de comandos.
-timeStampMode
Especifica o diretório no qual os relatórios gerados são colocados após a revisão de código e aplica um time stamp ao relatório.

Amostra

Este script de amostra Ant executa silenciosamente todas as configurações de ativação que estão localizadas no D:\workspace e produz os resultados em um diretório denominado batch_report localizado no espaço de trabalho.
<?xml version="1.0" encoding="UTF-8">
<project name="MyTestProject" default="CodeReviewHeadless" >

	<target name="CodeReviewHeadless">

		<property name="eclipse_dir" value="D:\\eclipse"/>
		<property name="workspace_dir" value="D:\\workspace"/>
		<property name="options" value=" -plugincustomization <pluginCustomizationPath> -onlyClient CodeReview -reportDirectory ${workspace_dir}\\batch_report -timeStampMode"/>

		<exec executable="${eclipse_dir}/jre/bin/java" dir="${eclipse_dir}" vmlauncher="false">
			<arg line="-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 -data ${workspace_dir} ${options}" />
		</exec>
	</target>

</project>
Termos de Utilização | Feedback
(C) Copyright IBM Corporation 2004, 2005. Todos os Direitos Reservados.