Controllo del Codice Sorgente

I progetti di Wonderland Engine sono stati progettati per integrarsi bene con qualsiasi sistema di controllo del codice sorgente e più frequentemente vengono usati con git.

Poiché i file di progetto sono basati su JSON, possono essere uniti manualmente. Assicurati di rimuovere le virgole finali dagli ultimi elementi di oggetti e liste!

UUID

Per evitare conflitti per gli ID delle risorse di nuovi oggetti, puoi far generare al tuo editor UUID invece di ID sequenziali brevi e leggibili:

Vai a: Visualizza > Impostazioni Progetto > Editor > ids (imposta su uuid).

.gitignore

Quello che segue è un file .gitignore che rappresenta una buona pratica.

Nota che, a seconda della tua Configurazione CI/CD, potresti voler aggiungere cache per ridurre il tempo speso a comprimere immagini su macchine di build meno potenti.

Includere cache ha il vantaggio aggiuntivo di velocizzare il primo caricamento del progetto dopo aver clonato il progetto.

 1# Dipendenze NPM
 2**/node_modules/
 3
 4# File di progetto confezionati
 5**/deploy/
 6
 7# Dati locali dell'editor
 8**/.editor/
 9
10# Bundle JS della cache dell'editor
11**/cache/js/
12
13# Stato UI locale
14**/imgui.ini
15
16# File di backup di Blender
17*.blend1

Git LFS

L’estensione Git Large File Storage può accelerare le operazioni di Git sul tuo repository, specialmente poiché WebXR di solito contiene file grandi per asset 3D, texture e audio.

Ecco alcune raccomandazioni su cosa tracciare con git lfs track <extensions>:

 1# File audio
 2*.mp3 *.wav *.ogg *.webm
 3# File video
 4*.mp4
 5# File modello 3D binario
 6*.glb *.fbx *.bin *.blend *.ply
 7# File immagine
 8*.png *.jpeg *.webp *.bmp *.exr *.hdr *.basis
 9# File di font
10*.ttf *.otf
11# Archivi
12*.zip *.tar.gz

package-lock.json

package-lock.json memorizza le versioni esatte delle dipendenze attualmente installate con il tuo sistema. Quando usi npm install, quel file sarà aggiornato alla versione più recente della dipendenza che rispetta i vincoli indicati in package.json.

Puoi usare npm ci per installare le esatte versioni delle dipendenze dal tuo package-lock.json. Per avere build replicabili, vorrai committare questo file.