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.
Checking the stable version of the documentation...
Sistema di avvertimento in GDScript
Il sistema di avvertimento in GDScript integra la tipizzazione statica (ma può funzionare anche senza). È qui per aiutare a evitare sbagli difficili da individuare durante lo sviluppo e che potrebbero portare a errori durante l'esecuzione.
È possibile configurare gli avvertimenti nelle Impostazioni del progetto nella sezione intitolata GDScript:
Nota
È necessario abilitare le Impostazioni avanzate per visualizzare la sezione GDScript nella barra laterale. È anche possibile cercare "GDScript" quando le Impostazioni avanzate sono disattivate.
È possibile trovare un elenco di avvertimenti per il file GDScript attivo nella barra di stato dell'editor di script. L'esempio seguente contiene 2 avvertimenti:
Per ignorare i singoli avvertimenti all'interno di un file, utilizzare l'annotazione @warning_ignore. Si può cliccare sul testo "Ignora" a sinistra della descrizione dell'avvertimento. Godot aggiungerà un'annotazione sopra la riga corrispondente e il codice non attiverà più l'avvertimento corrispondente:
Per ignorare più avvertimenti in una determinata regione di un file, utilizzare le annotazioni @warning_ignore_start e @warning_ignore_restore. È possibile omettere @warning_ignore_restore se si desidera ignorare i tipi di avvertimenti specificati fino alla fine del file.
I nomi degli avvertimenti da ignorare corrispondono ai nomi delle impostazioni del progetto. Ad esempio, per ignorare l'avvertimento configurato dall'impostazione del progetto debug/gdscript/warnings/unused_variable, usare @warning_ignore("unused_variable"). Quando si inserisce il nome di un avvertimento nell'annotazione, apparirà una finestra di completamento automatico che elenca tutti gli avvertimenti disponibili.
Gli avvertimenti non impediranno l'esecuzione del gioco, ma si possono trasformare in errori se desiderato. Facendo così, il gioco non verrà compilato a meno che tutti gli avvisi non verranno corretti. Andare alla sezione GDScript delle Impostazioni del progetto per attivare questa opzione per l'avvertimento desiderato. Ecco lo stesso file dell'esempio precedente con l'avvertimento unused_variable attivato come errore:
