Referencia de modalidad autónoma de prueba de componentes

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 Ayuda > Acerca de > Detalles de configuración. 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 Ayuda > Acerca de > Detalles de configuración.
-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>
Conceptos relacionados
Ejecución autónoma de pruebas de componentes
Tareas relacionadas
Ejecutar pruebas de componente desde una línea de mandatos
Ejecutar pruebas de componente desde un script Ant
Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.