Sistemi di controllo versione
Introduzione
Godot cerca di essere compatibile con i software di controllo versioni, generando file per lo più leggibili e facili da effettuare merge.
Estensioni di controllo versione
Godot supporta anche l'utilizzo di sistemi di controllo versione nell'editor stesso. Tuttavia, il controllo versione nell'editor richiede un'estensione per lo specifico VCS utilizzato.
A partire da luglio 2023 è disponibile solo un plugin Git, ma la comunità potrebbe creare ulteriori estensioni di VCS.
Estensione Git ufficiale
L'utilizzo di Git dall'interno dell'editor è supportato da un'estensione ufficiale. È possibile trovare le ultime versioni su GitHub.
La documentazione su come utilizzare l'estensione Git è disponibile sulla sua wiki.
File da escludere dal VCS
Nota
Questo elenca i file e le cartelle che si dovrebbero ignorare dal controllo versione in Godot 4.1 e successive.
L'elenco dei file e delle cartelle che si dovrebbero ignorare dal controllo versione in Godot 3.x e Godot 4.0 è completamente diverso. Ciò è importante, poiché Godot 3.x e 4.0 potrebbero memorizzare credenziali sensibili in export_presets.cfg (a differenza di Godot 4.1 e successive).
Se si sta utilizzando Godot 3, controllare invece la versione 3.5 di questa pagina di documentazione.
Godot crea automaticamente alcuni file e cartelle quando si apre un progetto nell'editor per la prima volta. Per evitare di sovraccaricare il repository di controllo versione con i dati generati, è consigliabile aggiungerli alle esclusioni del proprio VCS:
.godot/: questa cartella memorizza vari dati della cache del progetto.*.translation: Questi file sono file binari di traduzioni importate, generati dai file CSV.
È possibile assicurare che il gestore dei progetti di Godot generi automaticamente metadati di controllo versione durante la creazione di un progetto. Scegliendo l'opzione Git, vengono creati i file .gitignore e .gitattributes nella radice del progetto:
Creare metadati di controllo versione nella finestra Nuovo progetto del gestore dei progetti
Nei progetti esistenti, selezionare il menu Progetto in cima all'editor, quindi scegliere Controllo versione > Genera metadati di controllo versione.Facendo così verranno creati gli stessi file come se l'operazione sia stata eseguita nel gestore dei progetti.
Lavorare con Git su Windows
La maggior parte dei client Git per Windows è configurata con core.autocrlf impostato su true. Ciò può portare a file considerati modificati da Git inutilmente, poiché le loro terminazioni di riga vengono automaticamente convertite da LF a CRLF.
È meglio impostare questa opzione come:
git config --global core.autocrlf input
La creazione di metadati per il controllo versione attraverso il gestore dei progetti o l'editor imporrà automaticamente le terminazioni di riga LF tramite il file .gitattributes. In tal caso, non è necessario modificare la propria configurazione di Git.