Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Qt Creator

Qt Creator è un IDE gratuito e open source per tutte le piattaforme desktop.

Importare il progetto

  • Dalla schermata principale di Qt Creator selezionare New Project > Import Project > Import Existing Project.

../../../_images/qtcreator-new-project.png
  • In Location selezionare la cartella radice di Godot.

../../../_images/qtcreator-set-project-path.png
  • Successivamente, si può scegliere quali cartelle e file saranno visibili al progetto. Sebbene i file C/C++ siano aggiunti automaticamente, altre estensioni possono essere potenzialmente utili: *.glsl per i file di shader, *.py per i file del sistema di compilazione, *.java per lo sviluppo su piattaforme Android, *.mm per lo sviluppo su piattaforme macOS.

../../../_images/qtcreator-apply-import-filter.png

Nota

È possibile modificare questa configurazione in futuro, cliccando con il pulsante destro sul progetto e selezionando l'opzione Edit Files....

../../../_images/qtcreator-edit-files-menu.png
  • Termina l'importazione.

  • Aprire il file project_name.includes e aggiungere una riga contenente . per abilitare correttamente il completamento del codice.

../../../_images/qtcreator-project-name-includes.png
  • Dal menu a sinistra selezionare Projects e apri la scheda Build.

  • Eliminare il passaggio di compilazione predefinito make.

../../../_images/qtcreator-projects-build.png
  • Cliccare su Add Build Step > Custom Process Step per aggiungere una nuova fase di compilazione con le seguenti impostazioni:

    Comando

    scons

    Argomenti

    Consultare Introduzione al sistema di compilazione per un elenco completo di argomenti.

../../../_images/qtcreator-set-scons-command.webp

Nota

Se la compilazione fallisce con il messaggio Could not start process "scons", potrebbe significare che scons non è presente nella variabile d'ambiente PATH. In tal caso, sarà necessario specificare il percorso completo dell'eseguibile di SCons.

Debugging the project

  • Dal menu a sinistra selezionare Projects e aprire la scheda Run.

  • Under Executable specify the path to your executable located in the <Godot root directory>/bin folder. The name depends on your build configuration, e.g. godot.linuxbsd.editor.dev.x86_64 for 64-bit LinuxBSD platform with platform=editor and dev_build=yes. You can use %{buildDir} to reference the project root, e.g., %{buildDir}/bin/godot.linuxbsd.editor.dev.x86_64.

  • Se si desidera eseguire un progetto specifico, specificare la cartella radice in Working directory.

  • Se si desidera eseguire l'editor, aggiungere -e al campo Command line arguments.

../../../_images/qtcreator-run-command.png

Per saperne di più sugli argomenti della riga di comando, fare riferimento al tutorial sulla riga di comando.

Configurazione dello stile del codice

Developers must follow the project's code style and the IDE should help them follow it.

  • Open Preferences > C++ > Code Style.

  • Set the Formatting mode to Full formatting to instruct Qt Creator to use the .clang-format file supplied in Godot's root folder:

../../../_images/qtcreator-options-cpp.webp
  • Specify when you want clang-format to run (either while typing or when you saving the file). It is recommended to enable formatting on save at least.

Se ci si imbatte in qualsiasi problema, chiedi aiuto in uno dei Canali della comunità di Godot.