Wiki

Regole di validazione

Controlli di validazione degli asset eseguiti al check-in : le 9 regole integrate, le severità error / warning / info, la configurazione JSON, export / import / reset.

Introduzione

Le regole di validazione sono controlli sugli asset di Unreal eseguiti al momento del check-in : denominazione, dimensione delle texture, dipendenze mancanti, ecc. Servono a far rispettare automaticamente le convenzioni dello studio, prima che i contenuti entrino nel repository. Si configurano per repository.

Accesso e ruoli

La scheda Regole è accessibile al super admin e al project_admin sui repository che amministra.

Popolamento automatico La prima volta che si aprono le regole di un repository che non ne ha ancora, le 9 regole predefinite vengono create automaticamente. Si parte quindi sempre da un insieme completo, da regolare.

Severità

Severità	Effetto al check-in
`error`	Blocca il check-in finché il problema non è corretto.
`warning`	Avverte ma lascia passare.
`info`	Puramente informativo.

Le 9 regole integrate

L'elenco delle regole integrate, ciascuna con il suo interruttore di attivazione e il suo menu di severità error/warning/info.

Regola	Predefinito	Cosa verifica
`blueprint_compilation`	error	I Blueprint compilano senza errori prima del check-in.
`naming_convention`	warning	Prefissi di denominazione (stile Allar UE5) : `T_` texture, `M_` materiali, `BP_` blueprint, `SM_` static mesh, `WBP_` widget, ecc.
`max_texture_size`	warning	Dimensione massima delle texture : per impostazione predefinita 4096 × 4096, potenza di 2 richiesta.
`material_complexity`	warning	Complessità dei materiali : per impostazione predefinita max 256 istruzioni, 16 campioni di texture.
`import_settings`	warning	Impostazioni di importazione conformi (texture, mesh).
`missing_dependency`	error	Nessuna dipendenza mancante (ignora per impostazione predefinita il contenuto del motore).
`circular_dependency`	error	Nessuna dipendenza circolare (profondità di ricerca 20 per impostazione predefinita).
`unreferenced_asset`	info	Segnala gli asset non referenziati (esclude mappe e widget per impostazione predefinita).
`duplicate_asset`	warning	Rileva gli asset duplicati (ignora i `.umap` per impostazione predefinita).

Attivare e configurare

Una regola espansa sul suo editor di configurazione JSON con il pulsante Save Config.

Per ogni regola :

Interruttore : attiva / disattiva la regola. Salvataggio immediato.
Severità : menu a discesa error / warning / info. Salvataggio immediato.
Configurazione (JSON) : espandi la regola (chevron) per modificarne i parametri in JSON, poi Save Config. Un JSON non valido blocca il salvataggio con il dettaglio dell'errore.

Esempio : abbassare max_texture_size a 2048 per un progetto mobile, o portare naming_convention a error per imporla in modo rigoroso.

Export, import, reset

Export : scarica un file rules.json contenente lo stato di tutte le regole (attivazione, severità, configurazione).
Import : ricarica un rules.json e applica ogni voce alle regole corrispondenti (le chiavi sconosciute vengono ignorate).
Reset to Defaults : ripristina tutte le regole ai loro valori predefiniti. Le configurazioni personalizzate vengono perse (viene chiesta conferma).

L'export / import serve a replicare una politica di validazione da un repository all'altro, o a versionarla offline.

rules.json nel repository

Un rules.json committato non viene applicato da chiunque Un file .uversion/rules.json committato viene applicato alla politica del repository solo se l'autore del commit possiede la capacità manage_rules. Altrimenti il file viene memorizzato ma le regole non cambiano. È una salvaguardia : un collaboratore con diritto di scrittura su quel percorso non può disattivare la validazione committando un file.

Errori comuni

Un check-in è bloccato

Una regola in error è fallita. Il messaggio indica quale. Correggi l'asset, o (se la regola è troppo rigida per il tuo contesto) abbassa la sua severità a warning.

Reset cancella le mie impostazioni

Reset to Defaults è distruttivo per le tue configurazioni personalizzate. Fai un Export prima se vuoi poter tornare indietro.

Una regola sembra non fare nulla

Verifica che sia attivata (interruttore) e che la sua severità non sia info se ti aspettavi un blocco. Solo error blocca il check-in.