CLion

CLion è un IDE commerciale di JetBrains per C++.

Importare il progetto

CLion può importare il file del database di compilazione di un progetto, comunemente denominato compile_commands.json. Per generare il file del database di compilazione, aprire il terminale, navigare alla cartella principale di Godot ed eseguire:

scons compiledb=yes

Successivamente, aprire la cartella principale di Godot con CLion. CLion importerà il database di compilazione, indicizzerà il codice base, e fornirà il completamento automatico e altre funzionalità avanzate di navigazione e refactoring del codice.

Compilazione e debug del progetto

CLion does not support compiling and debugging Godot via SCons out of the box. This can be achieved by creating a custom build target and run configuration in CLion. Before creating a custom build target, you must compile Godot once on the command line, to generate the Godot executable. Open the terminal, change into the Godot root directory, and execute:

scons dev_build=yes

To add a custom build target that invokes SCons for compilation:

• Aprire CLion e navigare su Preferences > Build, Execution, Deployment > Custom Build Targets

• Cliccare su Aggiungi target e assegnare un nome al target, ad esempio Godot debug.

• Cliccare su ... accanto alla casella di selezione Build:, quindi cliccare sul pulsante + nella finestra di dialogo External Tools per aggiungere un nuovo strumento esterno.

• Assegnare un nome allo strumento, ad esempio Build Godot debug, impostare Program su scons, impostare Arguments sulle impostazioni di compilazione desiderate (consultare compilare Godot) e impostare Working directory su $ProjectFileDir$, che corrisponde alla cartella radice di Godot. Cliccare su OK per creare lo strumento.

  Nota

  CLion non espande i comandi shell come scons -j$(nproc). Utilizzare invece valori concreti, ad esempio scons -j8.

• Tornando alla finestra di dialogo External Tools, cliccare nuovamente su + per aggiungere un secondo strumento esterno, al fine di pulire la build di Godot tramite SCons. Assegnare un nome allo strumento, ad esempio Clean Godot debug, impostare Program su scons, impostare Arguments su -c (il che pulirà la build) e impostare Working directory su $ProjectFileDir$. Cliccare su OK per creare lo strumento.

• Chiudere la finestra di dialogo External Tools. Nella finestra di dialogo Custom Build Target per il target di compilazione personalizzato Debug Godot, selezionare lo strumento Build Godot debug dalla casella di selezione Build e selezionare lo strumento Clean Godot debug dalla casella di selezione Clean. Cliccare su OK per creare il target di build personalizzato.

• Nella finestra principale dell'IDE, cliccare su Add Configuration.

• Nella finestra di dialogo Run/Debug Configuration, cliccare su Add new..., quindi selezionare Custom Build Application per creare una nuova configurazione di esecuzione/debug personalizzata.

• Assegnare un nome alla configurazione di esecuzione/debug, ad esempio Godot debug, selezionare il target di compilazione personalizzato Godot debug come il Target. Selezionare l'eseguibile di Godot nella cartella bin/ come l'Executable e impostare Program arguments a --editor --path percorso-del-tuo-progetto/, dove percorso-del-tuo-progetto/ dovrebbe essere un percorso che punta a un progetto Godot esistente. Se l'argomento --path è omesso, si potrà effettuare il debug solo della finestra del Gestore dei progetti in Godot. Cliccare su OK per creare la configurazione di esecuzione/debug.

Ora è possibile compilare, eseguire, effettuare il debug, profilare e verificare con Valgrind l'editor Godot tramite la configurazione di esecuzione.

All'avvio di una scena, l'editor Godot genererà un processo separato. È possibile effettuare il debug di questo processo in CLion andando su Run > Attach to process..., digitando godot e selezionando il processo Godot con il pid (ID processo) più alto, che di solito è il progetto in esecuzione.

Ignorare i file oggetto e libreria

Dopo aver compilato Godot in CLion, potrebbero comparire i file di oggetto e di libreria nella vista Project.

È possibile configurare CLion in modo che ignori questi file:

• Aprire CLion e navigare su Preferences > Editor > File Types > Ignored Files and Folders

• Cliccare sul pulsante + per aggiungere *.o e *.a alla lista. In Windows, si aggiungerebbe *.obj e *.dll.

Ora i file dovrebbero essere ignorati nella vista Progetto.