Parámetros del mandato de aplicación de revisión de código para Linux y Windows

Cuando ejecuta el mandato de aplicación de revisión de código, especifica parámetros como por ejemplo el espacio de trabajo, los proyectos o los directorios en los que están ubicados los archivos de código fuente y las vías de acceso del archivo de reglas y el archivo de salida.

Tabla 1 describe los parámetros de aplicación de la aplicación de revisión de código:

Tabla 1. Parámetros de aplicación de revisión de código
Parámetro Tipo Descripción
-application Necesario com.ibm.rsaz.analysis.commandline.AnalyzeApplication

Utilice este parámetro para especificar el identificador de aplicación Eclipse de la aplicación de revisión de código. Especifique el identificador exactamente tal como se muestra: com.ibm.rsaz.analysis.commandline.AnalyzeApplication.

-data Necesario Este parámetro especifica la vía de acceso del espacio de trabajo Eclipse que la aplicación de revisión de código utiliza. Debe ser una vía de acceso totalmente calificada. Si el espacio de trabajo especificado no existe, se crea.

Si también utiliza el parámetro -projects, la aplicación de revisión de código busca en este espacio de trabajo los proyectos especificados.

Si no especifica el parámetro -projects o el parámetro -directory, la aplicación de revisión del código analiza todos los proyectos en el espacio de trabajo especificado.

-rulefile Necesario Este parámetro especifica la vía de acceso totalmente calificada de un archivo de reglas que contiene un conjunto de reglas de revisión de código y su gravedad asignada. La aplicación de revisión de código aplica estas reglas a los proyectos o los archivos especificados al iniciar la aplicación.

Para COBOL, las reglas pueden incluir categorías y reglas personalizadas y reglas personalizadas escritas por el usuario.

El mismo archivo de reglas puede contener reglas para COBOL y Java™. Durante el proceso, la aplicación de la revisión del código determina el lenguaje de programación de cada archivo de código fuente que encuentra y, a continuación, le aplica las reglas que son aplicables a dicho lenguaje.

El archivo de reglas debe tener la extensión .dat. Debe estar en el sistema de archivos de la estación de trabajo en la que se instaló el archivo eclipse.exe iniciado. No se puede acceder a través de una red ni a través de una intranet o de internet.

Puede crear el archivo de reglas pulsando Exportar para exportar las reglas seleccionadas desde el editor de configuraciones de análisis.

-projects
-directory

Opcional Estos 2 parámetros especifican las ubicaciones de archivos de código fuente a analizar. También puede utilizar los parámetros -includefile y -excludefile para incluir o excluir archivos específicos.

Utilice -projects cuando los archivos de código fuente estén en un proyecto dentro del espacio de trabajo especificado en el parámetro -data.

Utilice -directory cuando los archivos de código fuente estén en un directorio fuera del espacio de trabajo especificado en el parámetro -data.

Si no se especifica -projects ni -directory, la aplicación de revisión de código analiza los archivos de código fuente en todos los proyectos del espacio de trabajo especificado.

Si se especifica -projects P1[, P2, P3 ...]la aplicación procesa todos los archivos de código fuente en la lista de proyectos separados por comas P1, P2, P3......

Si se especifica -directory D1[, D2, D3, ...], la aplicación procesa todos los archivos de código fuente en la lista separada por comas de directorios D1, D2, D3, .....

Si se especifican los dos parámetros -projects y -directory, la aplicación procesa el parámetro -projects e ignora el parámetro -directory.

Proyectos temporales creados con el parámetro -directory: la discusión siguiente se aplica a los directorios ubicados fuera del espacio de trabajo especificado en el parámetro -data.

El uso del parámetro -directory tiene 2 efectos:
  • Para cada directorio especificado en el parámetro -directory, se crea un proyecto temporal con el mismo nombre más un prefijo tal como proyectoGenérico_ o analizadoComoJava_ en el espacio de trabajo que se especifica en el parámetro -data. Por ejemplo, si se especifica el directorio c:\ArchivosFuente\DirectorioCobol_0001 en el parámetro -directory, se crea un proyecto temporal como por ejemplo proyectoGenérico_DirectorioCobol_0001 en el espacio de trabajo. Cada proyecto temporal es un recurso Eclipse enlazado al directorio original correspondiente en el sistema de archivos local.
    Puede suprimir estos proyectos temporales del espacio de trabajo.
    Importante: Siga el procedimiento para suprimir un enlace de recursos de modo que no suprima el contenido del directorio correspondiente en el sistema de archivos. Para obtener más información sobre la supresión de proyectos temporales, consulte Supresión de proyectos temporales creados por el parámetro -directory.
  • Las vías de acceso de directorio en el archivo Resultados de análisis CSV y en el archivo Resultados de análisis XML incluyen los nombres de los proyectos temporales.
    Nota: Es necesario modificar estas vías de acceso antes de utilizar los archivos de resultados como entrada para otras aplicaciones.
PRECAUCIÓN:
No utilice la opción -directory para especificar directorios ubicados dentro del espacio de trabajo especificado en el parámetro -data. Al hacerlo así se crean proyectos temporales en el espacio de trabajo que son recursos enlazados de Eclipse que están enlazados a los directorios especificados. La supresión incorrecta de un proyecto temporal puede provocar la supresión del proyecto, de las carpetas o de las carpetas de código fuente. Para obtener información sobre la supresión de directorios temporales, consulte Supresión de proyectos temporales creados por el parámetro -directory.
-includefile Opcional Este parámetro se utiliza solo cuando el parámetro -directory está presente. Especifica la vía de acceso totalmente calificada de un archivo de texto que contiene una lista de archivos de código fuente a analizar, un archivo por línea.

Cuando el parámetro -directory y el parámetro -includefile están presente, la aplicación de revisión de código analiza solo los archivos de código fuente especificados en el archivo de inclusión y que aparecen en uno de los directorios especificados en el parámetro -directory.

Cada entrada del archivo de inclusión debe ser un nombre de archivo o una vía de acceso relativa más un nombre de archivo. La aplicación de revisión de código busca cada entrada en cada uno de los directorios especificados.

-excludefile Opcional Este parámetro se utiliza solo cuando el parámetro -directory está presente. Especifica la vía de acceso totalmente calificada de un archivo de texto que contiene una lista de archivos de código fuente a excluir del análisis, un archivo por línea.

Cuando el parámetro -directory y el parámetro -excludefile están presentes, la aplicación de revisión de código excluye del análisis los archivos de código fuente especificados en el archivo de exclusión y que aparecen en uno de los directorios especificados en el parámetro -directory. Se analizan todos los archivos que no están excluidos.

Cada entrada del archivo de exclusión debe ser un nombre de archivo o una vía de acceso relativa más un nombre de archivo. La aplicación de revisión de código busca cada entrada en cada uno de los directorios especificados y excluye el archivo si se encuentra.

-exportdirectory Necesario Este parámetro especifica la vía de acceso totalmente calificada del directorio en el que la aplicación de revisión de código graba sus archivos de datos de salida XML y CSV. Estos archivos de datos se pueden utilizar como entrada para otras aplicaciones.

Se generan todos los tipos soportados de archivos de datos de salida.

Si se omite este parámetro, no se generan archivos de datos de salida. Sin embargo, la aplicación sigue grabando información e salida en la salida estándar, si se especifica esa opción.

-nosplash Opcional Este parámetro suprime la visualización de la pantalla inicial de Eclipse.

-verbose Opcional Este parámetro hace que la aplicación de revisión de código grabe información de salida en la salida estándar.
En el sistema operativo Windows, para capturar información de salida no solo debe especificar el parámetro -verbose sino que también debe redirigir la salida estándar a un archivo en la línea de mandatos:
-verbose >archivo_salida
>archivo_salida Opcional Utilice esta redirección en la línea de mandatos para capturar la información de salida de la aplicación en un archivo.

En Windows, también debe especificar el parámetro -verbose para obtener información de salida.


Comentarios