logo

بناء جرادل

ال بناء جرادل هي عملية إنشاء مشروع Gradle. عندما نقوم بتشغيل أمر gradle، فإنه سيبحث عن ملف يسمى build.gradle في الدليل الحالي. ويسمى هذا الملف أيضا البرنامج النصي لبناء Gradle . يتم وصف تكوين البناء والمهام والمكونات الإضافية في هذا الملف. يصف البرنامج النصي للبناء المشروع ومهامه.

لنقم بإنشاء مشروع Gradle صغير، وتشغيل بعض أوامر Gradle الأساسية، وفهم كيفية إدارة Gradle للمشروع.

اتبع الخطوات أدناه لإنشاء مشروع Gradle واختباره.

الخطوة 1: افتح سطر الأوامر وقم بإنشاء دليل

أولاً، افتح سطر الأوامر وقم بإنشاء دليل للمشروع وقم بتغيير الدليل إليه.

لنقم بإنشاء دليل تجريبي.

بناء جرادل

الخطوة 2: تهيئة مشروع Gradle

الشجرة الثنائية لاجتياز أمر البريد

لإنشاء مشروع Gradle، قم بتشغيل الحرف الأول يأمر. سيتم إنشاء مشروع بسيط. مع هذا المشروع، سوف نستكشف ونفهم كل ما يتم إنشاؤه.

عندما نقوم بتشغيل أمر gradle init، سيطلب منك بعض المتطلبات الأساسية. أولا، سوف يطلب من نوع المشروع التي نريد إنشاءها. سيعطي أربعة خيارات:

 1: basic 2: application 3: library 4: Gradle plugin 

حدد متطلباتنا. ومن ثم، فإننا نقوم فقط بإنشاء مشروع تجريبي حتى نتمكن من تحديد الخيار الأساسي. لتحديد الخيار الأساسي، اضغط على 1 و يدخل مفتاح. النظر في الإخراج أدناه:

بناء جرادل

التالي سوف يطلب دي اس ال . هناك خياران متاحان لـ DSL:

 1: Groovy 2: Kotlin 

Groovy هو DSL الافتراضي الذي توفره Gradle. يختار بناء السيناريو DSL .

بناء جرادل

بعد ذلك، سوف يطلب اسم المشروع . اكتب اسم المشروع واضغط على مفتاح الإدخال. سوف يستغرق الأمر بعض الوقت لبناء المشروع. بعد التنفيذ الناجح للمشروع، سوف تصلنا رسالة بناء ناجح .

بناء جرادل

لقد نجحنا الآن في إنشاء مشروع Gradle. الآن، ماذا سيحدث للدليل المحدد لدينا؟ النظر في الهيكل أدناه لمشروع Gradle.

بناء جرادل

هذا هو الهيكل الافتراضي لمشروع Gradle. سوف يقوم Gradle بإنشاء الأشياء التالية لنا:

  1. ال gradle الملف هو بناء البرنامج النصي لتكوين المشروع الحالي.
  2. ان جار قابل للتنفيذ يتم استخدام الملف كملف Gradle.
  3. خصائص التكوينلغلاف Gradle.
  4. ال gradlew هو برنامج نصي مجمع Gradle لنظام التشغيل المستند إلى UNIX.
  5. ال واحد هو البرنامج النصي Gradle Wrapper لنظام التشغيل Windows.
  6. البرنامج النصي للإعداداتلتكوين بناء Gradle.

الخطوة 3: إنشاء مهمة

استبدال سلسلة جافا سكريبت

يدعم Gradle واجهات برمجة التطبيقات لإنشاء المهام وإدارتها من خلال DSL المستند إلى Groovy أو DSL المستند إلى Kotlin. يحتوي كل مشروع على مجموعة من المهام لبعض العمليات الأساسية.

كائن المصفوفة في Java

يدعم Gradle مكتبة المهام التي تقوم بتكوين المشروع. على سبيل المثال، هناك مهمة نسخ، والتي تقوم بنسخ الملفات من موقع إلى آخر. تعد مهمة النسخ إحدى المهام الأكثر استخدامًا في Gradle.

لاستخدام مهمة النسخ في البرنامج النصي للإنشاء، اتبع العملية التالية.

الخطوة 1: قم بإنشاء دليل يسمى src.

بناء جرادل

الخطوة 2: إضافة ملف يسمى myfile.txt في الدليل src. أضف السطر المفرد 'Hello, World!' إليها أيضًا يمكننا تركها فارغة.

بناء جرادل

حدد مهمة تسمى نسخ في build.gradle ملف. سيتم نسخ دليل src إلى دليل جديد يسمى dest. ليس علينا إنشاء الدليل dest؛ مهمة النسخ ستفعل ذلك نيابةً عنا.

 task copy(type: Copy, group: 'Custom', description: 'The sources are copied to dest directory') { from 'src' into 'dest' } 

يمكننا تقديم أي شيء في المجموعة والوصف. يمكننا أيضًا حذفها، ولكن سيتم حذفها أيضًا من تقرير المهمة المستخدم لاحقًا.

الآن قم بتنفيذ مهمة النسخ الجديدة:

بناء جرادل

بعد التنفيذ الناجح للمهمة سوف نحصل عليها بناء النجاح رسالة سفول.

ملف build.gradle

ملف build.gradle هو برنامج نصي لإنشاء مشروع Gradle. يتم تعريف جميع المهام والمكونات الإضافية في هذا الملف.

عندما نقوم بتشغيل أمر gradle، فإنه يبحث عن ملف يسمى build.gradle في الدليل الحالي. على الرغم من أننا أطلقنا عليه اسم برنامج نصي للبناء، إلا أنه على وجه التحديد هو برنامج نصي لتكوين البناء. يحدد البرنامج النصي للبناء المشروع ومهامه.

الافتراضي build.gradle يبدو الملف كما يلي:

هريثيك روشان
بناء جرادل

ال build.gradle يحتوي الملف على ثلاثة أقسام افتراضية. وهم على النحو التالي:

    الإضافات:في هذا القسم، يمكننا تطبيق البرنامج المساعد لمكتبة جافا لإضافة دعم لمكتبة جافا.المستودعات:في هذا القسم، يمكننا الإعلان عن المستودع الداخلي والخارجي لحل التبعيات. يمكننا الإعلان عن أنواع المستودعات المختلفة التي يدعمها Gradle مثل Maven وAnt وIvy.التبعيات:في هذا القسم، يمكننا الإعلان عن التبعيات الضرورية لموضوع معين.

بالإضافة إلى ذلك، يمكننا الإعلان عن وحدات أخرى متعلقة بالمشروع مثل المهمة في هذا الملف.

عرض معلومات مشروع Gradle

لفهم البنية والتبعيات ومشكلات تصحيح الأخطاء الخاصة بالبناء، يوفر Gradle العديد من الميزات المضمنة التي تعرض معلومات حول المشروع.

فيما يلي بعض الأوامر الأساسية لعرض معلومات المشروع:

قائمة المشاريع

في Gradle، يمكن إدراج كافة المشاريع الفرعية للمشروع في مساحة العمل في تسلسل هرمي. للقيام بذلك، قم بتشغيل الأمر أدناه من الدليل الجذر للمشروع.

 gradle -q projects 

بناء جرادل

قائمة المهام

يتيح لنا Gradle إدراج جميع المهام الأساسية للمشروع. لسرد المهمة، قم بتشغيل الأمر أدناه:

 gradle -q tasks 

انتاج:

 C:UsersHiMaNshUeclipse-workspace>gradle -q tasks ------------------------------------------------------------ Tasks runnable from root project ------------------------------------------------------------ Build Setup tasks ----------------- init - Initializes a new Gradle build. wrapper - Generates Gradle wrapper files. Help tasks ---------- buildEnvironment - Displays all buildscript dependencies declared in root projec t 'eclipse-workspace'. components - Displays the components produced by root project 'eclipse-workspace '. [incubating] dependencies - Displays all dependencies declared in root project 'eclipse-works pace'. dependencyInsight - Displays the insight into a specific dependency in root proj ect 'eclipse-workspace.' dependentComponents : It displays the dependent components of components in the root pr oject 'eclipse-workspace.' [incubating] help - Displays a help message. model - Displays the configuration model of root project 'eclipse-workspace.' [incubating] projects - Displays the sub-projects of root project 'eclipse-workspace.' properties - Displays the properties of root project 'eclipse-workspace.' tasks - Displays the tasks runnable from root project 'eclipse-workspace.' To see all tasks and more detail, run gradle tasks --all To see more detail about a task, run gradle help --task 

لسرد كافة مهام المشروع، قم بتشغيل الأمر أدناه:

شار توسترينغ جافا
 gradle tasks -all 

لعرض المزيد من التفاصيل حول مهمة ما، قم بتشغيل الأمر أدناه:

 gradle help --task 

قائمة التبعيات

في Gradle، يمكننا إدراج التبعيات التي تم تقسيمها حسب التكوين. لسرد التبعيات، قم بتشغيل الأمر أدناه:

 gradle -q dependencies 

انتاج:

بناء جرادل