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...
Esportazione per Windows
Vedi anche
Questa pagina descrive come esportare un progetto Godot per Windows. Se si desidera invece compilare i binari dell'editor o dei modelli di esportazione dal codice sorgente, consultare Compilare per Windows.
Il modo più semplice per distribuire un gioco per PC è copiare l'eseguibile (godot.exe), comprimere la cartella e inviarla a qualcun altro. Tuttavia, non è sempre desiderato.
Godot offre un approccio più elegante per la distribuzione su PC utilizzando il sistema di esportazione. Esportando per Windows, l'esportatore prende tutti i file del progetto e crea un file data.pck. Questo file è impacchettato con un eseguibile appositamente ottimizzato, più piccolo, più veloce e senza includere l'editor e il debugger.
Architettura
Esistono 3 diverse architetture di processore su cui è possibile eseguire i progetti Godot esportati in Windows:
x86_64
x86_32
arm64
Il valore predefinito è x86_64, che è l'architettura più comune dei processori per PC al giorno d'oggi. Tutti i processori Intel e AMD moderni, al momento in cui scriviamo, sono x86_64.
x86_32 genererà un eseguibile a 32 bit che è possibile eseguire sia su versioni di Windows a 32 bit sia su versioni moderne a 64 bit. Si sconsiglia vivamente di utilizzare questa opzione a meno che non si stia cercando di eseguire il progetto su una vecchia versione a 32 bit di Windows. È inoltre importante notare che nessuna versione a 32 bit di Windows riceve più supporto da Microsoft.
I processori arm64 sono moderni ma meno comuni degli x86_64, e eseguono Windows su ARM. Lo Snapdragon X Elite è un esempio di processore ARM moderno per Windows. Utilizzando questa opzione di esportazione, il progetto potrà essere eseguito nativamente sui processori ARM senza l'emulatore Prism di Microsoft. Gli eseguibili creati con questa opzione non funzioneranno su Windows normale con un processore x86_64. Se si carica il proprio progetto su una piattaforma che consente più eseguibili, come itch.io, e c'è certezza che un processore Snapdragon X Elite sia abbastanza potente per eseguirlo, consigliamo di fornire una versione per ARM. L'emulazione Prism è tutt'altro che perfetta, e Godot non richiede di compilare o progettare i giochi diversamente per eseguirli su ARM.
Cambiare l'icona dell'eseguibile
Godot utilizzerà automaticamente qualsiasi immagine impostata come icona del progetto nelle impostazioni del progetto stesso e la convertirà in un file ICO per il progetto esportato. Se si desidera creare manualmente un file ICO per avere più controllo sull'aspetto dell'icona a diverse risoluzioni, consultare la pagina Cambiare manualmente l'icona dell'applicazione per Windows.
Incorporamento PCK
L'incorporamento PCK è supportato solo per gli eseguibili fino a circa 3,89 GB. Questa dimensione include entrambi l'eseguibile e il PCK incorporato, quindi in pratica il file PCK può pesare al massimo circa 3,75 GB. Questo valore può variare anche a seconda delle opzioni di compilazione quando si utilizza un modello di esportazione personalizzato.
Firma del codice
Godot è in grado di firmare il codice automaticamente in fase di esportazione. Per farlo, bisogna avere installato Windows SDK (su Windows) o osslsigncode (su qualsiasi altro sistema operativo). Bisognerà inoltre avere un certificato di firma del pacchetto; le informazioni su come crearne uno sono disponibili qui.
Configura
Bisogna modificare le impostazioni in due posti. Primo, nelle impostazioni dell'editor, in Esporta > Windows. Cliccare sulla cartella accanto all'impostazione Sign Tool. Se si utilizza Windows, individuare e selezionare SignTool.exe. Se si utilizzi un sistema operativo diverso, selezionare osslsigncode.
Il secondo posto è la preimpostazione di esportazione per Windows, che si trova in Progetto > Esporta.... Aggiungere una preimpostazione per Windows desktop se non già fatto. Nelle opzioni c'è una categoria relativa alla firma del codice.
Enabled must be set to true, and Identity must be set to the signing
certificate. The other settings can be adjusted as needed. Once this is done
Godot will sign your project on export.
Variabili d'ambiente
È possibile utilizzare le seguenti variabili d'ambiente per impostare le opzioni di esportazione fuori dall'editor. Durante il processo di esportazione, queste variabili sovrascrivono i valori impostati nel menu di esportazione.
Opzioni di esportazione |
Variabile d'ambiente |
|---|---|
Crittografia / Chiave crittografica |
|
Opzioni / Firma del codice / Tipo di identità |
|
Opzioni / Firma del codice / Identità |
|
Opzioni / Firma del codice / Password |
|
Opzioni di esportazione
È possibile trovare un elenco completo delle opzioni di esportazione disponibili nel riferimento alla classe EditorExportPlatformWindows.