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...

Utilizzare l'editor di configurazione di compilazione del motore

Godot è dotato di un ampio insieme di funzionalità integrate. Sebbene ciò sia comodo, significa anche che la sua dimensione binaria è maggiore di quanto potrebbe essere, soprattutto per i progetti che utilizzano solo una piccola parte del suo insieme di funzionalità.

Per ridurre le dimensioni del file binario, è possibile compilare modelli di esportazione personalizzati disabilitando alcune funzionalità. Questa procedura è descritta in dettaglio in Ottimizzare una compilazione per dimensioni. Tuttavia, determinare quali funzionalità bisognerebbe disabilitate può essere un compito noioso. A tale scopo, l'editor di configurazione della compilazione del motore fornisce un'interfaccia per visualizzare e gestire facilmente queste funzionalità, essendo anche in grado di rilevare le funzionalità attualmente utilizzate nel progetto.

Il menu Progetto > Strumenti > Editor di configurazione della compilazione del motore consente di creare e gestire i profili di compilazione per il progetto in Godot.

D'ora in poi, hai due possibiltà:

• Guarda l'elenco e deseleziona manualmente le funzionalità che non ti servono.

• Premi il pulsante Detect from Project per rilevare automaticamente le funzionalità attualmente utilizzate nel progetto e disabilitare quelle non utilizzate. Tieni presente che questa operazione sovrascriverà l'elenco di funzionalità esistente, quindi se hai deselezionato manualmente alcuni elementi, il loro stato sarà ripristinato in base al loro utilizzo effettivo nel progetto.

Aprire l'editor di configurazione di compilazione del motore

Una volta cliccato su Detect from Project, verrà avviata la fase di rilevamento del progetto. Questa operazione può richiedere da pochi secondi a diversi minuti, a seconda delle dimensioni del progetto. Al termine del rilevamento, apparirà un elenco aggiornato delle funzionalità, alcune delle quali disabilitate:

Elenco delle funzionalità aggiornato dopo aver utilizzato il rilevamento delle funzionalità (esempio tratto dalla demo piattaforme 3D)

Avvertimento

Deselezionando le opzioni in questa finestra, le dimensioni del file binario non si ridurranno direttamente in fase di esportazione. Poiché è possibile rimuovere le opzioni dal file binario solo in fase di compilazione, è comunque necessario compilare i modelli di esportazione personalizzati con il profilo di compilazione specificato per poter effettivamente usufruire dall'editor di configurazione di compilazione del motore.

Ora puoi salvare il profilo di compilazione cliccando su Salva con nome in alto. È possibile salvare il profilo di compilazione ovunque, ma è consigliabile salvarlo da qualche parte nella cartella del progetto e aggiungerlo al controllo versioni per poterlo recuperare in seguito quando necessario. Questo permette anche di utilizzare il controllo versioni per tenere traccia delle modifiche apportate al profilo di compilazione.

Il profilo di compilazione è un file JSON (con estensione .gdbuild) che, dopo il rilevamento nell'esempio precedente, dovrebbe apparire così:

{
    "disabled_build_options": {
        "disable_navigation_3d": true,
        "disable_xr": true,
        "module_godot_physics_3d_enabled": false,
        "module_msdfgen_enabled": false,
        "module_openxr_enabled": false
    },
    "disabled_classes": [
        "AESContext",
        ...
        "ZIPReader"
    ],
    "type": "build_profile"
}

È possibile passare questo file come opzione SCons durante la compilazione dei modelli di esportazione:

scons target=template_release build_profile=/path/to/profile.gdbuild

Il sistema di compilazione lo userà per disabilitare le classi non utilizzate e pertanto ridurre la dimensione dell'eseguibile.

Limitazioni

La funzionalità di Detect from Project si basa sulla lettura delle scene e degli script nel progetto. Non sarà in grado di rilevare le funzionalità utilizzate nei seguenti casi:

• Funzionalità utilizzate negli script GDScript creati proceduralmente ed eseguiti in fase di esecuzione.

• Funzionalità utilizzate nelle espressioni.

• Funzionalità utilizzate nelle estensioni GDExtension, a meno che il binding del linguaggio non consenta di definire le classi utilizzate e l'estensione non sfrutti tale funzionalità. Consulta GH-104129 per ulteriori dettagli.

• Funzionalità utilizzate nei :ref:`PCK esterni caricati in fase di esecuzione <doc_exporting_pcks>.

• Potrebbero verificarsi alcuni casi estremi. In caso di dubbi, si prega di aprire una segnalazione su GitHub allegando un progetto di riproduzione minima.

Vedi anche

È possibile ottenere ulteriori riduzioni delle dimensioni passando altre opzioni che riducono le dimensioni del file binario. Consultare Ottimizzare una compilazione per dimensioni per ulteriori informazioni.