github/gitignore · UnrealEngine.gitignore
شرح قالب .gitignore لـ Unreal Engine
يشرح سبب تجاهل UnrealEngine.gitignore لمجلدات Binaries وIntermediate وSaved وDerivedDataCache وملفات الحلول المولَّدة، وبنية قواعد النفي في مجلد Build.
UnrealEngine.gitignore قالب لمشاريع C++ في محرك Unreal. يستبعد المجلدات الضخمة التي ينشئها المحرك للترجمة والطهي (cooking) وذاكرة المظللات (shaders)، وملفات مشاريع بيئة التطوير التي يعيد المحرر إنشاءها.
الأسطر الخمسة الخاصة بمجلد Build/ مثال جيد على أولوية gitignore. فهي تستبعد كل محتوى المجلد، ثم تعيد المجلدات الفرعية لكل منصة، ثم تعيد داخلها تضمين الأيقونات وملفات PakBlacklist فقط.
شرح القواعد
| النمط | ما الذي يتجاهله ولماذا |
|---|---|
Binaries/*Intermediate/*Saved/*DerivedDataCache/* | المجلدات التي ينشئها المحركالوحدات المترجمة، وملفات البناء الوسيطة، وذاكرات السجلات والحفظ التلقائي والإعدادات، والبيانات المشتقة للمظللات والأصول. كلها يعيد المحرر أو البناء إنشاءها. |
Plugins/**/Binaries/*Plugins/**/Intermediate/* | نتائج بناء الملحقاتتنشئ ملحقات المشروع أيضًا مجلدي Binaries وIntermediate خاصين بها. يطابق ** الملحقات على أي عمق. |
Build/*!Build/*/Build/*/**!Build/*/PakBlacklist*.txt!Build/**/*.ico | بنية الاستثناء في مجلد Buildيستبعد Build/* المحتوى ويعيد !Build/*/ المجلدات الفرعية. يجب أن تبقى المجلدات مُضمَّنة حتى يمكن استبعاد محتواها مجددًا عبر Build/*/** ثم تضمين ملفات PakBlacklist والأيقونات فقط عبر !. إنها طريقة للالتفاف على القاعدة التي تمنع إعادة تضمين ملفات فرعية إذا استُبعد مجلدها الأعلى. |
*.sln*.suo*.xcodeproj*.xcworkspace.vs/.vsconfig | مشاريع بيئة التطوير المولَّدةملفات Visual Studio وXcode التي يمكن إعادة إنشائها في أي وقت عبر 'Generate Project Files' من .uproject. |
*.obj*.o*.pch*.dll*.lib*.exe*.app*.ipa | مخرجات الترجمةنتائج ترجمة C++ وربطها ونتائج التحزيم. |
*_BuiltData.uasset | بيانات الإضاءة المبنيةبيانات لكل خريطة تنتج عن بناء الإضاءة. حجمها كبير وتتغير كثيرًا ويمكن إعادة بنائها. |
SourceArt/**/*.pngSourceArt/**/*.tga | الأعمال الفنية الأصليةقاعدة لإخراج مجلد الخامات الأصلية قبل الاستيراد من المستودع. إن أردت إدارة إصدارات الملفات الأصلية فاحذفها واستخدم Git LFS. |
ملاحظات عملية
- تتبّع الأصول الثنائية مثل
.uassetو.umapعبر Git LFS أمر لا غنى عنه عمليًا. Config/وContent/وSource/و.uprojectمما يجب إيداعه. أما الإعدادات فيSaved/Configفهي شخصية، واستبعادها هو الصحيح.- قبل تغيير بنية
Build/أدخل في أداة اختبار الأنماط مسارًا مثلBuild/Windows/Application.icoوتحقق من النتيجة.
القالب الأصلي
UnrealEngine.gitignore
# Visual Studio 2015 user specific files.vs/# Compiled Object files*.slo*.lo*.o*.obj# Precompiled Headers*.gch*.pch# Compiled Dynamic libraries*.so*.dylib*.dll# Fortran module files*.mod# Compiled Static libraries*.lai*.la*.a*.lib# Executables*.exe*.out*.app*.ipa# These project files can be generated by the engine*.xcodeproj*.xcworkspace*.sln*.suo*.opensdf*.sdf*.VC.db*.VC.opendb.vsconfig# Precompiled AssetsSourceArt/**/*.pngSourceArt/**/*.tga# Binary FilesBinaries/*Plugins/**/Binaries/*# BuildsBuild/*# Whitelist PakBlacklist-<BuildConfiguration>.txt files!Build/*/Build/*/**!Build/*/PakBlacklist*.txt# Don't ignore icon files in Build!Build/**/*.ico# Built data for maps*_BuiltData.uasset# Configuration files generated by the EditorSaved/*# Compiled source files for the engine to useIntermediate/*Plugins/**/Intermediate/*# Cache files for the editor to useDerivedDataCache/*
مصدر القوالب: github/gitignore/UnrealEngine.gitignore @356fd7b (2026-09-11) · CC0-1.0