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