Wiki
Doğrulama kuralları
Check-in sırasında çalıştırılan asset doğrulama denetimleri : 9 yerleşik kural, error / warning / info önem düzeyleri, JSON yapılandırması, dışa aktarma / içe aktarma / sıfırlama.
Giriş
Doğrulama kuralları, check-in anında çalıştırılan Unreal asset denetimleridir : adlandırma, doku boyutu, eksik bağımlılıklar vb. İçerik depoya girmeden önce stüdyonun kurallarını otomatik olarak uygulatmaya yararlar. Depo bazında yapılandırılırlar.
Erişim ve roller
Kurallar sekmesi, süper yöneticiye ve yönettiği depolarda project_admin rolüne erişilebilir.
Önem düzeyleri
| Önem düzeyi | Check-in üzerindeki etkisi |
|---|---|
error | Sorun düzeltilene kadar check-in'i engeller. |
warning | Uyarır ama geçmesine izin verir. |
info | Tamamen bilgilendirme amaçlı. |
9 yerleşik kural
| Kural | Varsayılan | Neyi denetler |
|---|---|---|
blueprint_compilation | error | Blueprint'ler check-in'den önce hatasız derlenir. |
naming_convention | warning | Adlandırma önekleri (Allar UE5 stili) : T_ dokular, M_ materyaller, BP_ blueprint'ler, SM_ statik mesh'ler, WBP_ widget'lar vb. |
max_texture_size | warning | Doku maksimum boyutu : varsayılan 4096 × 4096, 2'nin kuvveti zorunlu. |
material_complexity | warning | Materyal karmaşıklığı : varsayılan olarak en fazla 256 komut, 16 doku örneği. |
import_settings | warning | Uyumlu içe aktarma ayarları (dokular, mesh'ler). |
missing_dependency | error | Eksik bağımlılık yok (varsayılan olarak motor içeriğini yoksayar). |
circular_dependency | error | Döngüsel bağımlılık yok (varsayılan arama derinliği 20). |
unreferenced_asset | info | Referans verilmeyen asset'leri işaretler (varsayılan olarak haritaları ve widget'ları hariç tutar). |
duplicate_asset | warning | Yinelenen asset'leri algılar (varsayılan olarak .umap dosyalarını yoksayar). |
Etkinleştirme ve yapılandırma
Her kural için :
- Anahtar : kuralı etkinleştirir / devre dışı bırakır. Anında kaydedilir.
- Önem düzeyi : error / warning / info açılır menüsü. Anında kaydedilir.
- Yapılandırma (JSON) : parametrelerini JSON olarak düzenlemek için kuralı açın (ok işareti), ardından Save Config. Geçersiz bir JSON, hata ayrıntısıyla birlikte kaydetmeyi engeller.
Örnek : bir mobil proje için max_texture_size değerini 2048'e düşürün veya katı biçimde uygulatmak için
naming_convention değerini error yapın.
Dışa aktarma, içe aktarma, sıfırlama
- Export : tüm kuralların durumunu (etkinleştirme, önem düzeyi, yapılandırma) içeren bir
rules.jsondosyası indirir. - Import : bir
rules.jsondosyasını yeniden yükler ve her girişi ilgili kurallara uygular (bilinmeyen anahtarlar yoksayılır). - Reset to Defaults : tüm kuralları varsayılan değerlerine döndürür. Özel yapılandırmalar kaybolur (onay istenir).
Dışa / içe aktarma, bir doğrulama politikasını bir depodan diğerine kopyalamaya veya çevrimdışı olarak sürümlemeye yarar.
Depodaki rules.json
.uversion/rules.json dosyası, depo politikasına yalnızca commit'in yazarı
manage_rules yetkisine sahipse uygulanır. Aksi takdirde dosya saklanır ama kurallar değişmez. Bu bir
korumadır : bu yolda yazma yetkisi olan bir katkıcı, bir dosya commit ederek doğrulamayı devre dışı bırakamaz.
Sık karşılaşılan tuzaklar
Bir check-in engellendi
error düzeyindeki bir kural başarısız oldu. Mesaj hangisi olduğunu gösterir. Asset'i düzeltin veya
(kural sizin bağlamınız için fazla katıysa) önem düzeyini warning seviyesine düşürün.
Sıfırlama ayarlarımı siliyor
Reset to Defaults, özel yapılandırmalarınız için yıkıcıdır. Geri dönebilmek istiyorsanız önce bir Export yapın.
Bir kural hiçbir şey yapmıyor gibi görünüyor
Etkin olduğundan (anahtar) ve bir engelleme bekliyorsanız önem düzeyinin info olmadığından emin olun.
Yalnızca error check-in'i engeller.