Wiki

Regras de validação

Verificações de validação de assets executadas no check-in : as 9 regras integradas, as severidades error / warning / info, a configuração JSON, exportar / importar / reset.

Introdução

As regras de validação são verificações de assets do Unreal executadas no momento do check-in : nomenclatura, tamanho de textura, dependências ausentes, etc. Elas servem para fazer cumprir as convenções do estúdio automaticamente, antes que o conteúdo entre no repositório. Elas são configuradas por repositório.

Acesso e funções

A aba Regras está disponível para o super admin e para o project_admin nos repositórios que ele administra.

Semeadura automática Na primeira vez que se abrem as regras de um repositório que ainda não tem nenhuma, as 9 regras padrão são criadas automaticamente. Portanto, você sempre parte de um conjunto completo, pronto para ajustar.

Severidades

Severidade	Efeito no check-in
`error`	Bloqueia o check-in enquanto o problema não for corrigido.
`warning`	Avisa mas deixa passar.
`info`	Puramente informativo.

As 9 regras integradas

A lista das regras integradas, cada uma com seu interruptor de ativação e seu menu de severidade error/warning/info.

Regra	Padrão	O que ela verifica
`blueprint_compilation`	error	Os Blueprints compilam sem erros antes do check-in.
`naming_convention`	warning	Prefixos de nomenclatura (estilo Allar UE5) : `T_` texturas, `M_` materiais, `BP_` blueprints, `SM_` static meshes, `WBP_` widgets, etc.
`max_texture_size`	warning	Tamanho máximo das texturas : por padrão 4096 × 4096, potência de 2 obrigatória.
`material_complexity`	warning	Complexidade dos materiais : por padrão máx. 256 instruções, 16 amostras de textura.
`import_settings`	warning	Ajustes de importação em conformidade (texturas, meshes).
`missing_dependency`	error	Nenhuma dependência ausente (ignora por padrão o conteúdo do motor).
`circular_dependency`	error	Sem dependência circular (profundidade de busca 20 por padrão).
`unreferenced_asset`	info	Sinaliza os assets não referenciados (exclui mapas e widgets por padrão).
`duplicate_asset`	warning	Detecta os assets duplicados (ignora os `.umap` por padrão).

Ativar e configurar

Uma regra expandida no seu editor de configuração JSON com o botão Save Config.

Para cada regra :

Interruptor : ativa / desativa a regra. Salvamento imediato.
Severidade : menu suspenso error / warning / info. Salvamento imediato.
Configuração (JSON) : expanda a regra (chevron) para editar seus parâmetros em JSON, depois Save Config. Um JSON inválido bloqueia o salvamento com o detalhe do erro.

Exemplo : baixar max_texture_size para 2048 em um projeto mobile, ou passar naming_convention para error para impô-la estritamente.

Exportar, importar, reset

Export : baixa um arquivo rules.json contendo o estado de todas as regras (ativação, severidade, configuração).
Import : recarrega um rules.json e aplica cada entrada às regras correspondentes (as chaves desconhecidas são ignoradas).
Reset to Defaults : redefine todas as regras para seus valores padrão. As configurações personalizadas são perdidas (confirmação solicitada).

Exportar / importar serve para replicar uma política de validação de um repositório para outro, ou para versioná-la offline.

rules.json no repositório

Um rules.json commitado não é aplicado por qualquer um Um arquivo .uversion/rules.json commitado só é aplicado à política do repositório se o autor do commit possuir a capacidade manage_rules. Caso contrário, o arquivo é armazenado mas as regras não mudam. É uma salvaguarda : um contribuidor com direito de escrita nesse caminho não pode desativar a validação commitando um arquivo.

Armadilhas comuns

Um check-in está bloqueado

Uma regra em error falhou. A mensagem indica qual. Corrija o asset, ou (se a regra for estrita demais para o seu contexto) baixe sua severidade para warning.

Reset apaga minhas configurações

Reset to Defaults é destrutivo para suas configurações personalizadas. Faça um Export antes se quiser poder voltar atrás.

Uma regra parece não fazer nada

Verifique se ela está ativada (interruptor) e se sua severidade não é info caso você esperasse um bloqueio. Apenas error bloqueia o check-in.