Up to date
This page is up to date for Godot 4.2.
If you still find outdated information, please open an issue.
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.
Truco
You can create a breakpoint by clicking the gutter in the left of the script editor (on the left of the line numbers). When hovering this gutter, you will see a transparent red dot appearing, which turns into an opaque red dot after the breakpoint is placed by clicking. Click the red dot again to remove the breakpoint. Breakpoints created this way persist across editor restarts, even if the script wasn't saved when exiting the editor.
You can also use the breakpoint keyword in GDScript to create a
breakpoint that is stored in the script itself. Unlike breakpoints created by
clicking in the gutter, this keyword-based breakpoint is persistent across
different machines when using version control.
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.
The Keep Debugger Open option keeps the debugger open after a scene has been closed. The Debug with External Editor option lets you debug your game with an external editor. This option is also accessible in Editor Settings > Debugger.
When the debugger breaks on a breakpoint, a green triangle arrow is visible in the script editor's gutter. This arrow indicates the line of code the debugger broke on.
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.