Lumberyard
Guía del usuario (Version 1.20)

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. En el directorio raíz de Lumberyard, diríjase a cualquier rama que contenga un directorio _WAF_ o 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 Project Interpreter (Intérprete del proyecto) y elija Add Local (Añadir local).

      
                Add Local (Añadir local)
    3. Vaya a la carpeta en la que se encuentra python.exe.  El archivo ejecutable de Python debe estar en la misma carpeta que el proyecto o puede que haya problemas al ejecutar Waf.

      
                Compruebe la ubicación de python.exe
  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 al nodo \dev\Tools\Build\waf-<version> y amplíelo. Debería ver un archivo llamado lmbr_waf dentro 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:

      • Debe seleccionarse Single instance only (Únicamente una instancia).

      • Script Parameters (Parámetros de script) 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.

      • Working directory (Directorio de trabajo) debe ser la raíz del proyecto (por ejemplo, el directorio dev).

      
              Configuración de la depuración

      A continuación, debe configurar archivos wscript como archivos 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. 

    4. Seleccione File (Archivo), Settings (Configuración), Editor, File Types (Tipos de archivos), Python.

    5. Para añadir un patrón registrado para wscript, elija Python en Recognized File Types (Tipos de archivos reconocidos).

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

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

      
                Añada el comodín wscript
  7. Asegúrese de que IncrediBuild está desactivado.

    1. Abra el archivo _WAF_/usersettings.options.

    2. Compruebe que use_incredibuild se ha definido en falso, como en el siguiente ejemplo. use_incredibuild = False

  8. (Opcional) Habilite la descripción del archivo.

    De forma predeterminada, PyCharm desactiva la descripción del archivo. Esta característica facilita la navegación en los archivos de origen, tal como se muestra en la imagen siguiente.

    
            Descripción de archivo

    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).