Configurar PyCharm para depurar Waf - Guía del usuario de Lumberyard

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Configurar PyCharm para depurar Waf

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

PyCharm es un entorno de desarrollo integrado para Python que incluye un depurador gráfico que resulta útil para la depuración de Waf.

Para configurar PyCharm y Waf para la depuración

  1. Descargue PyCharm Community Edition.

  2. Inicie PyCharm.

  3. En la pantalla de bienvenida, elija Open Directory (Abrir directorio)

  4. Vaya al directorio lumberyard_version\dev. Debe haber un archivo llamado wscript y waf_branch_spec.py en esta carpeta.

  5. Configure el intérprete Python.

    1. Seleccione File (Archivo), Settings (Configuración), Project: dev (Proyecto: dev), Project Interpreter (Intérprete de proyecto) para abrir la página de intérprete de proyectos.

    2. Haga clic en el icono del engranaje a la derecha del Intérprete del proyecto y elija Agregar….

      
                Captura de pantalla que muestra el icono de engranaje que desea seleccionar.
    3. Seleccione el botón de opción Entorno existente y, a continuación, haga clic en el icono de puntos suspensivos () situado a la derecha del mismo.

      Visualización de GUI del botón de opción «Entorno existente» y del botón de puntos suspensivos a la derecha del campo «Intérprete».
    4. Desplácese hasta la carpeta que contiene el ejecutable python. El ejecutable estará contenido en la ruta lumberyard_version\dev\Tools\Python\3.7.5\platform, la ruta exacta depende de la plataforma. El archivo ejecutable de Python debe estar en la misma carpeta que el proyecto o puede que haya problemas al ejecutar Waf.

      Ventana que muestra el árbol de directorios completo y la ubicación de python.exe en Windows.
  6. Configure un perfil de depuración para Waf.

    1. Para configurar Waf para la depuración, utilice el explorador de proyectos en el panel izquierdo.  Si no ve el explorador de proyectos, pulse Alt+1).  Vaya a la .\dev\Tools\Build\waf-<version>y amplíelo. Debería aparecer un archivo llamadolmbr_wafdentro de este nodo.

      
                El archivo lmbr_waf
    2. Haga clic con el botón derecho en lmbr_waf y seleccioneCreate lmbr_waf (Crear lmbr_waf)

      nota

      La operación Indexing... (Indexando...) debe finalizar antes de que aparezca la opción. Puede comprobar el estado en la barra en la parte inferior.

      
                Create lmbr_waf (Crear lmbr_waf)
    3. En el cuadro de diálogo Create Run/Debug Configuration (Crear ejecución/Configuración de depuración), asegúrese de que los valores siguientes se configuran correctamente:

      • Permitir ejecución paralela no debe estar sin seleccionar.

      • Parámetros es el comando que utilizar para ejecutar Waf para la sesión de ejecución/depuración.

      • Python Interpreter (Intérprete de Python) debe ser el intérprete especificado anteriormente.

      • El Directorio de trabajo debe ser el directorio dev.

      
              Configuración de la depuración
  7. Configure los archivos wscript como archivos de Python depurables. Waf utiliza archivos llamados wscript para definir las reglas de compilación por proyecto.  Se trata de módulos de Python que se cargan de forma dinámica y que pueden depurarse como cualquier otro módulo de Python. 

    1. Elija Archivo, Configuración, Editor, Tipos de archivo.

    2. Elija Python en Tipos de archivo reconocidos. Seleccione el icono + a la derecha de la sección Patrones registrados para agregar un nuevo tipo de archivo.

    3. En Registered Patterns (Patrones registrados), haga clic en el signo más verde (+).

    4. En el cuadro de diálogo Add Wildcard (Añadir comodín), escriba wscript.

      
                Añada el comodín wscript
  8. Desactiva IncrediBuild.

    1. Abra el archivo _WAF_/usersettings.options.

    2. Verifique que use_incredibuild = False

  9. (Opcional) Habilite la descripción del archivo. Esta característica facilita el acceso a los archivos de origen.

    Para habilitar la descripción de archivos, haga clic con el botón derecho en la pestaña Project (Proyecto) y seleccione Show Members (Mostrar miembros).