Resumen de herramientas de depuración¶
Esta guía te proporcionará una descripción general de las herramientas de depuración disponibles en el motor.
Godot viene con un potente depurador y perfiladores para rastrear errores, inspeccionar tu juego en tiempo de ejecución, monitorear métricas esenciales y medir el rendimiento. También ofrece opciones para visualizar cajas de colisión y polígonos de navegación en el juego en ejecución.
Finalmente, tienes opciones para depurar el juego que se está ejecutando en un dispositivo remoto y para recargar cambios en tus escenas o tu código mientras el juego está en ejecución.
Panel del Depurador¶
Muchas de las herramientas de depuración de Godot forman parte del panel de depuración, sobre el cual puedes encontrar información en Panel del depurador.
Menú de opciones de depuración¶
Existen algunas opciones de depuración comunes que puedes activar o desactivar mientras ejecutas tu juego en el editor, las cuales pueden ayudarte en la depuración de tu juego.
Puedes encontrar estas opciones en el menú Depuración del editor.
Aquí están las descripciones de las opciones:
Exportar con Depuración Remota¶
Al exportar y publicar, el ejecutable resultante intentará conectarse a la IP de tu computadora para ser depurado.
Exportación Mini con Recursos en Red¶
Esta opción acelera las pruebas para juegos con una gran huella en dispositivos remotos.
Cuando Small Deploy with Network FS está activado, en lugar de exportar el juego completo, el despliegue del juego construye un ejecutable mínimo. Luego, el editor proporciona archivos del proyecto a través de la red.
Además, en Android, el juego se despliega utilizando el cable USB para acelerar el proceso de despliegue.
Ver Formas de Colisión¶
Esta opción hace que las formas de colisión y los nodos (raycast) sean visibles en el juego mientras se está ejecutando.
Sincronizar cambios de escena¶
Con esta opción, cualquier cambio que realices en una escena en el editor durante la ejecución del juego aparecerá instantáneamente. Cuando se utiliza de forma remota en un dispositivo, esto es más eficiente con el sistema de archivos de red.
Sincronizar Cambios en Scripts¶
Cualquier script que se guarde será recargado en el juego en ejecución. Cuando se utiliza de forma remota en un dispositivo, esto es más eficiente con el sistema de archivos de red.
Herramientas y opciones de depuración del editor de scripts¶
El editor de scripts tiene su propio conjunto de herramientas de depuración para usar con puntos de interrupción y dos opciones. Las herramientas de puntos de interrupción también se pueden encontrar en la pestaña Depurador del depurador.
El botón Interrumpir causa una pausa en el script, similar a un punto de interrupción. Continuar permite que el juego continúe después de pausar en un punto de interrupción. Paso Siguiente va a la siguiente línea de código, y Entrar en ingresa a una función si es posible. De lo contrario, hace lo mismo que Paso Siguiente.
La opción Mantener el Depurador Abierto mantiene el depurador abierto después de que una escena haya sido cerrada. Y la opción Depurar con Editor Externo te permite depurar tu juego con un editor externo.
Advertencia
Los puntos de interrupción no se activarán en el código si está ejecutándose en un hilo. Esta es una limitación actual del depurador de GDScript.
Configuración de depuración en el proyecto¶
En la configuración del proyecto, hay una categoría Depuración con tres subcategorías que controlan diferentes aspectos.
Ajustes¶
Estas son algunas configuraciones generales, como imprimir el FPS actual en el panel de Salida, el número máximo de funciones al perfilar y otras.
GDScript¶
Estas configuraciones te permiten activar o desactivar advertencias específicas de GDScript, como las relacionadas con variables no utilizadas. También puedes desactivar completamente las advertencias.
Formas¶
Las formas son donde puedes ajustar el color de las formas que solo aparecen con fines de depuración, como las formas de colisión y navegación.
Remoto en el panel de escenas¶
Al ejecutar el juego, en el editor aparecerán dos opciones en la parte superior del panel Escenas, Remoto y Local. Mientras uses Remoto puedes inspeccionar o cambiar los parámetros de los nodos del juego en ejecución.
Nota
Algunas configuraciones del editor relacionadas con la depuración se pueden encontrar dentro de Configuración del Editor, en las secciones de Red > Depuración y Depurador.