Lumberyard
Guía del usuario (Version 1.21)

Parámetros de AZ Code Generator

La versión publicada de AZ Code Generator es preliminar y está sujeta a cambios.

Para obtener los mejores resultados, pase las opciones de AZ Code Generator al sistema de compilación de Waf. Sin embargo, también puede especificar los parámetros de AzCodeGenerator.exe en la línea de comandos.

Parámetros de Waf

La mayoría de los parámetros de AZ Code Generator se especifican mediante la integración de Waf. Los parámetros como, por ejemplo, las rutas de entrada, salida e inclusión se detectan automáticamente y se reenvían. Otros parámetros de AZ Code Generator controlan la forma en que AZ Code Generator aborda la introducción del código fuente y los datos intermedios que se generan.

Especifique cualquiera de estos en la sección arguments del paso az_code_gen del archivo wscript.

Parámetros de compilación de Clang

Los siguientes parámetros AzCodeGenerator.exe se aplican a la compilación de Clang.

Parámetro Descripción
-SuppressIncludeNotFoundError Suprime las declaraciones #include desconocidas durante la compilación.
-OnlyRunDiagnosticsOnMainFile Omite las advertencias y errores de compilación en todos los archivos salvo en archivo principal especificado para la compilación.
-SuppressDiagnostics Omite crear las advertencias y errores de compilación en todos los archivos.
-SuppressErrorsAsWarnings Degrada los errores de compilación a advertencias. Permite que Clang se ejecute con éxito incluso si hay errores.

Datos intermedios

Para incluir información sobre el código fuera del archivo de entrada en los datos JSON intermedios, utilice la siguiente opción.

-inclusion-filter=<wildcard filter for files to allow>

Front-End

Puede elegir el front-end que utilizar especificando la opción -Clang (predeterminada) o -JSON.

Lista de parámetros de AZ Code Generator

En la siguiente lista se enumeran todos los parámetros de AZ Code Generator.

Uso: AzCodeGenerator.exe [options]

Opción Categoría Descripción
-Clang Generales Utiliza el front-end del compilador de Clang.
-clang-settings-file=<string> Análisis de código La ruta del archivo que contiene los ajustes de configuración de Clang.
-codegen-script=<string> Python La ruta completa y el nombre de archivo del script de generación de código que se va a invocar.
-debug Generales Habilita la salida de depuración.
-debug-buffer-size=<uint> Generales Almacena en búfer los últimos n caracteres de la salida de depuración hasta la terminación del programa. El valor predeterminado es 0 que especifica la impresión inmediata.
-debug-only=<debug string> Generales Activa un tipo específico de salida de depuración.
-define=<string> Análisis de código Especifica una definición de preprocesador.
-DelayedTemplateParsing Recorrido de AST Consume y almacena tokens de plantillas para analizar al final de la unidad de traducción.
-EnableIncrementalProcessing Recorrido de AST Habilita el procesamiento incremental.
-force-include=<string> Análisis de código Lista de encabezados que incluir de manera forzada en el análisis de Clang.
-help Generales Muestra opciones básicas por categorías.
-help-hidden Generales Muestra todas las opciones disponibles por categorías.
-help-list Generales Muestra opciones básicas en formato de lista.
-help-list-hidden Generales Muestra todas las opciones disponibles en formato de lista.
-include-path=<string> Análisis de código El encabezado incluye la ruta.
-inclusion-filter=<string> Filtrado de código Especifica un filtro comodín para que otros archivos que no sean los especificados por input-files sean analizados por Clang en los datos intermedios.
-info-output-file=<filename> Generales Archivo al cual anexar la salida de -stats.
-input-file=<string> Análisis de código (Obligatorio) Ruta de archivo de entrada en relación con el valor de input-path.
-input-path=<string> Análisis de código (Obligatorio) La ruta completa de la carpeta de entrada. Todas las rutas input-file deben estar en relación con esta carpeta.
-intermediate-file=<string> Análisis de código Ruta de un archivo que almacena el AST de JSON desde el análisis de Clang.
-JSON Generales Utiliza la entrada de JSON sin procesar para el front-end.
-noscripts Generales Desactiva la ejecución de los scripts de generación de código.
-OnlyRunDiagnosticsOnMainFile Compilación de Clang Ejecuta el diagnóstico (comprobación de errores y advertencias) únicamente en el archivo que se compila. Omite errores y advertencias del resto de archivos.
-output-path=<string> Análisis de código (Obligatorio) La ruta completa de la carpeta de salida.
-output-redirection Salida

Redirige la salida y los mensajes de error desde utilidades internas de Clang y Python.

Opciones:

=none: sin redirección de salida. Salida de Clang y Python a stdout y stderr.

=null: redirige Clang y Python a null, suprimiendo de forma efectiva la salida.

=file: redirige Clang y Python a disco. Utilice redirect-output-file para especificar la ruta.

-output-using-json Salida Genera la salida utilizando objetos JSON en lugar de texto sin formato. Utilice esta opción para facilitar el análisis para llamar aplicaciones.
-print-all-options Generales Imprime todos los valores de las opciones después de analizar la línea de comandos.
-print-options Generales Imprime las opciones no predeterminadas después de analizar la línea de comandos.
-profile Generales Habilita el generador de perfiles interno de AZ Code Generator y emite intervalos para análisis y ejecución de scripts de Clang.
-python-debug-path=<string> Python Ruta de las bibliotecas de depuración y scripts de Python para que AzCodeGenerator.exe los utilice en la depuración.
-python-home=<string> Python (Obligatorio) El equivalente de la variable del entorno PYTHONHOME, que se pasa por alto.
-python-home-debug=<string> Python El equivalente de la variable del entorno PYTHONHOME de Python de depuración, que se pasa por alto.
-python-path=<string> Python La ruta de bibliotecas y scripts de Python para AzCodeGenerator.exe.
-redirect-output-file=<string> Salida La ruta del archivo para salida redirigida. Se utiliza en combinación con la opción -output-redirection=file. El nombre del archivo predeterminado es output.log.
-resource-dir=<string> Análisis de código La ruta completa al directorio de recursos para Clang.
-stats Generales Habilita la salida de estadísticas del programa (disponible con afirmaciones). Utilice la opción -info-output-file=<filename> para especificar el archivo de salida.
-SkipFunctionBodies Recorrido de AST No atraviesa cuerpos de funciones.
-SuppressDiagnostics Compilación de Clang Oculta la información de diagnóstico de compilación de Clang.
-SuppressErrorsAsWarnings Compilación de Clang Suprime los errores de compilación durante el análisis informándoles con advertencias.
-SuppressIncludeNotFoundError Recorrido de AST Suprime errores no encontrados de #include.
-track-memory Generales Habilita el seguimiento de la memoria de -time-passes. El desempeño puede ser lento cuando se utiliza esta opción.
-v Generales Genera la salida de información de depuración detallada.
-version Generales Muestra la versión de AzCodeGenerator.exe.
-view-background Generales Ejecuta el visor de gráficos en segundo plano. Esta opción crea un archivo .tmp que debe eliminarse manualmente.