شرح قالب .gitignore لـ Gradle

Gradle.gitignore لا يتجاوز 9 أسطر، لكنه يستخدم أنماط النفي ثلاث مرات ليحمي بدقة ما لا يجوز تجاهله. ويُستخدم في معظم الحالات مع قالبي Java وKotlin.

يتيح مغلّف Gradle (gradlew وgradle/wrapper/gradle-wrapper.jar وgradle-wrapper.properties) لمن لم يثبّت Gradle البناء بالإصدار نفسه، لذا يجب إيداعه. وترشد وثائق Gradle الرسمية أيضًا إلى وضع ملفات المغلّف تحت إدارة الإصدارات.

شرح القواعد

النمط	ما الذي يتجاهله ولماذا
.gradle	ذاكرة Gradleمجلد تُحفظ فيه ذاكرة المهام وتجزئات الملفات لكل مشروع. إذا حُذف أُعيد إنشاؤه في البناء التالي.
**/build/!**/src/**/build/	مجلد البناء والاستثناءيستبعد مجلدات المخرجات build/ في كل الوحدات، لكنه يعيدها إن وُجدت مصادفةً داخل شجرة المصدر (src/) حزمة أو مجلد باسم build. فهو يمنع مثلًا أن يُحسب src/main/java/com/example/build/ من مخرجات البناء فيختفي.
!gradle-wrapper.jar!gradle-wrapper.properties	حماية المغلّفيعيد تضمين ملف jar الخاص بالمغلّف حتى لا تتجاهله قاعدة *.jar في قالبي Java وKotlin. ولأن git يتبع آخر قاعدة مطابقة، يجب أن يأتي هذا السطر بعد *.jar ليكون له أثر.
gradle-app.setting.gradletasknamecache	ذاكرة الواجهة الرسومية والمهامإعدادات واجهة Gradle الرسومية وذاكرة أسماء المهام للإكمال التلقائي في الصدفة.
.project.classpath	ملفات Eclipse المولَّدةملفات المشروع التي ينشئها Eclipse Buildship من إعدادات Gradle. يمكن إعادة إنشائها من سكربتات البناء في أي وقت.

ملاحظات عملية

• في المولّد اختر Java (أو Kotlin) أولًا ثم Gradle. إن انعكس الترتيب جاء !gradle-wrapper.jar أولًا ثم أعاد *.jar تجاهله بعده. يمكنك التحقق بإدخال gradle/wrapper/gradle-wrapper.jar في أداة اختبار الأنماط.
• لا يُتجاهَل gradle.properties. لكن ضع معلومات التوقيع الشخصية والرموز في ~/.gradle/gradle.properties داخل مجلد المستخدم لا في ملفات المشروع.
• لا يتضمن هذا القالب local.properties (مسار Android SDK)، فاستخدم معه قالب Android في مشاريع Android.

القالب الأصلي

.gradle**/build/!**/src/**/build/# Ignore Gradle GUI configgradle-app.setting# Avoid ignoring Gradle wrapper jar file (.jar files are usually ignored)!gradle-wrapper.jar# Avoid ignore Gradle wrapper properties!gradle-wrapper.properties# Cache of project.gradletasknamecache# Eclipse Gradle plugin generated files# Eclipse Core.project# JDT-specific (Eclipse Java Development Tools).classpath

قوالب تُستخدم معه

شروح قوالب أخرى