Lumberyard
Guía del usuario (Version 1.21)

Depuración de la utilidad AZ Code Generator

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

Cuando utilice Waf y la utilidad AZ Code Generator, es posible que necesite depurar scripts Waf Python y sus controladores de plantilla. También puede depurar la misma utilidad AZ Code Generator, aunque es menos probable que sea necesario. Puede depurar la utilidad AZ Code Generator utilizando Visual Studio en Windows o Xcode en macOS.

Requisitos previos

Los pasos preliminares necesarios dependerán de su sistema operativo.

Depuración de Windows

Para depurar AZ Code Generator con Visual Studio en Windows, debe generar un archivo de solución HostTools Visual Studio (.sln).

Para generar un archivo de solución HostTools Visual Studio

  1. Escriba el siguiente comando desde la carpeta dev.

    lmbr_waf.bat configure --enabled-game-projects= --specs-to-include-in-project-generation=host_tools --visual-studio-solution-name=HostTools
  2. En Visual Studio, abra el archivo dev/Solutions/HostTools.sln.

Depuración de macOS

Para habilitar la compatibilidad de Waf con Xcode, ejecute los pasos siguientes para generar un proyecto Xcode.

Para generar un proyecto Xcode

  1. Abra el archivo dev/_WAF_/specs/all.json.

  2. Añada temporalmente AzCodeGenerator a modules.

  3. Ejecute ./lmbr_waf.sh configure para volver a generar el proyecto Xcode.

  4. Abra el archivo dev/Solutions/LumberyardSDK.xcodeproj.

Depuración de la utilidad AZ Code Generator de la compilación de Waf

Para depurar la utilidad AZ Code Generator de la compilación de Waf, debe encontrar el archivo de argumentos generado por Waf.

Waf genera un archivo de argumentos que se transfiere a AZ Code Generator como un parámetro de la línea de comando. Todos los parámetros de dicha línea de comando de Waf para AZ Code Generator se encuentran en el archivo de argumentos. Este archivo es útil para depurar invocaciones concretas de AZ Code Generator Waf. Para que el archivo de argumentos que use esté disponible para Waf, añada la opción --zones=az_code_gen a la línea de comando de Waf.

Configuración de los argumentos de depuración de Visual Studio

Para configurar la depuración de AZ Code Generator desde Visual Studio, ejecute los pasos siguientes.

Para depurar AZ Code Generator desde Visual Studio

  1. Ejecute los pasos para configurar la depuración de Windows tal y como se describe en Requisitos previos.

  2. En el explorador de soluciones de Visual Studio, haga clic con el botón derecho en AzCodeGenerator y, a continuación, seleccione Properties (Propiedades).

  3. En Debugging (Depuración), pegue la ruta al archivo de argumentos en Command Arguments (Argumentos de comandos).

  4. Haga clic en OK (Aceptar) para cerrar la ventana Property (Propiedad).

  5. Haga clic con el botón derecho del ratón en AzCodeGenerator y, a continuación, haga clic en Set as StartUp Project (Establecer como proyecto de inicio).

  6. Pulse F5 para lanzar el depurador.

Configuración de los argumentos de depuración de Xcode

Para configurar la depuración de AZ Code Generator desde Xcode, ejecute los pasos siguientes.

Para depurar AZ Code Generator desde Xcode

  1. Ejecute los pasos para configurar la depuración de macOS tal y como se describe en Requisitos previos.

  2. En Xcode, en el menú Product (Producto), Scheme (Esquema), elija AzCodeGenerator.

  3. En la parte inferior del menú Product (Producto), Scheme (Esquema), elija Edit Scheme (Editar esquema).

  4. En Arguments (Argumentos), añada una nueva entrada en Arguments Passed On Launch (Argumentos pasados en el lanzamiento) que contenga los argumentos de depuración.

  5. En Info, en el menú desplegable Executable (Ejecutable), seleccione Other (Otro).

    1. Vaya al directorio dev/BinMac64.Debug/azcg/AzCodeGenerator.

    2. Haga clic en Choose (Elegir).

  6. Seleccione Close (Cierre) en el editor de esquemas.

  7. Elija Product (Producto), Run (Ejecutar) para lanzar el depurador.