La ejecución autónoma permite automatizar las ejecuciones de prueba de componentes desde
una línea de mandatos o un script Ant sin intervención del usuario y sin utilizar la interfaz de
usuario gráfica del producto.
Objetivo
La línea de mandatos lanza un entorno de trabajo "autónomo" (sin
intervención del usuario para el entorno de desarrollo) y ejecuta las configuraciones de prueba de
componentes que se encuentran en un área de trabajo especificada.
Nota: En algunos entornos, la
longitud de una línea de mandatos puede ser limitada. Si especifica errores debido a una línea de
mandatos truncada, intente sustituir partes de los mandatos por variables.
La sintaxis de línea de
mandatos básica para ejecutar una prueba de componentes es la siguiente:
<Directorio de Eclipse>/jre/bin/java<opciones de máquina virtual><parámetros obligatorios><parámetros opcionales>
Parámetros obligatorios
Hay tres categorías de parámetros obligatorios:
- VM de producto
- Eclipse
- Línea de mandatos
En algunos entornos, deberá añadir parámetros adicionales a estos mandatos, dependiendo de la
configuración del sistema operativo. Los parámetros para lanzar el entorno de trabajo están
ubicados en los detalles de configuración del sistema bajo
Propiedades del
sistema en .
Las
<opciones de máquina virtual> están ubicadas bajo la propiedad
eclipse.vmargs y las opciones principales de Eclipse están ubicadas bajo la
propiedad
eclipse.commands.
- Parámetros de VM de producto
- -Xj9
- Lanza la aplicación para la modalidad de línea de mandatos, conjuntamente con otros parámetros
listados bajo .
- -cp <classpath>/startup.jar org.eclipse.core.launcher.Main
- Lanza Eclipse en modalidad autónoma con la vía de acceso de clases especificada. Utilice
comillas dobles cuando la vía de acceso contenga espacios y barras invertidas dobles
(\\) en lugar del carácter de barra invertida. A continuación se proporciona
un ejemplo "C:\\Archivos de programa\\IBM\\Rational\\".
- -Dorg.eclipse.emf.ecore.EPackage.Registry.INSTANCE=org.eclipse.emf.ecore.impl.EPackageRegistryImpl
- Especifica las definiciones que necesitan algunos componentes de entorno de
trabajo.
- Parámetros de Eclipse
- -plugincustomization <vía de acceso de
personalización de conector>
- Sustituye la vía de acceso de personalización del conector por la vía de acceso del archivo
pluginCustomization.ini para el conector.
- -application com.ibm.r2a.command.line.mode.CommandLineModeApplication
- Especifica la aplicación utilizada para la prueba de componentes y el perfilado.
- -data <workspace>
- Especifica la ubicación del área de trabajo en el que están ubicadas las configuraciones de
lanzamiento. Utilice
comillas dobles cuando la vía de acceso contenga espacios y barras invertidas dobles
(\\) en lugar del carácter de barra invertida. A continuación se proporciona
un ejemplo "C:\\Archivos de programa\\IBM\\Rational\\".
- -os linux
- Especifica Linux como sistema operativo.
- -ws gtk
- Un parámetro necesario para algunos componentes de entorno de trabajo. Esta opción es
obligatoria solamente para Linux.
- Parámetros de línea de mandatos
- -onlyClient ComponentTest
- Especifica que la línea de mandatos actual aplica solamente la característica de
componentes.
Si se omite este parámetro, es posible que se activen otras características, lo que implica un mal
rendimiento y resultados no relacionados con pruebas de rendimiento.
- -reportDirectory vía_acceso_directorios
- Especifica el directorio en el que deben generarse los archivos de informe. Utilice
comillas dobles cuando la vía de acceso contenga espacios y barras invertidas dobles
(\\) en lugar del carácter de barra invertida. A continuación se proporciona
un ejemplo "C:\\Archivos de programa\\IBM\\Rational\\".
Parámetros opcionales
- -profile
- Ejecuta todas las configuraciones de lanzamiento en el área de trabajo con la prueba de
componentes y el perfilado en marcha.
- -persistKind html|xml
- Especifica que se debe generar solamente un informe HTML o XML. Por omisión, se seleccionan
ambos informes.
- -multifile
- Genera un archivo de informe para cada configuración de lanzamiento. Esta opción se aplica
solamente a los informes HTML. Por omisión, se genera un solo archivo de informe para todas las
configuraciones de lanzamiento invocadas desde una línea de mandatos.
- -fullreport
- Genera un informe completo que contiene todos los veredictos de prueba de error aprobados,
anómalos e inconclusos. Por omisión, en el informe solo aparecen los resultados no aprobados.
- -launch config1 config2 ...
- Lanza las configuraciones de lanzamiento especificadas. Por omisión, se lanzan todas las
configuraciones de lanzamiento de prueba de componentes contenidas en el área de trabajo
especificada.
Si las configuraciones de lanzamiento especificadas no son para pruebas de componentes, no se
lanzan, incluso aunque la opción -profile esté en marcha.
Utilice las comillas cuando los nombres de configuración contengan espacios, por ejemplo
"Mi configuración".
- -timeStampMode
- Genera resultados en un directorio intermedio cuyo nombre es la indicación de la hora de la
prueba (con el formato AAAAMMDD_HHMMSS) en el directorio del informe. Utilice
esta opción si desea ejecutar la misma configuración de lanzamiento más de una vez.
Ejemplo
Este script Ant de ejemplo para Windows ejecuta silenciosamente
todas las configuraciones de lanzamiento ubicadas en
D:\workspace y genera los
resultados en un directorio llamado
batch_report ubicado en el área de trabajo:
<?xml version="1.0" encoding="UTF-8">
<project name="MyTestProject" default="ComponentTestHeadless" >
<target name="ComponentTestHeadless">
<property name="eclipse_dir" value="D:\\eclipse"/>
<property name="workspace_dir" value="D:\\workspace"/>
<property name="options" value=" -onlyClient ComponentTest -reportDirectory ${workspace_dir}\\batch_report -fullreport -timeStampMode"/>
<exec executable="${eclipse_dir}/jre/bin/java" dir="${eclipse_dir}" vmlauncher="false">
<arg line="-Xj9 -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>