2. إعداد DXPR builder للتنمية المحلية

ستعلمك هذه الوثائق كيفية استنساخ مستودع منشئ DXPR واستخدامه للتطوير المحلي وتشغيل اختبارات DXPR maven محليًا.

المتطلبات الأساسية

• راجع وثائق إعداد الجهاز قبل متابعة هذا الدليل.

استنساخ وإعداد DXPR Builder

1. افتح محطة طرفية، إذا كنت تستخدم Window، فتأكد من أنها محطة Ubuntu التي قمت بإعدادها في دليل إعداد الجهاز.
2. cd في الدليل حيث تقوم بتخزين مشاريع الويب الخاصة بك. على سبيل المثال /mnt/d/dxpr/
3. استنساخ مستودع DXPR Builder: git clone [email protected]:dxpr/dxpr_builder.git .
4. افتح دليل المشروع في محرر النصوص المفضل لديك.
5. انسخ الملف .env.example وأعد تسميته ليصبح .env
6. افتح ملف .env وقم بتعيين المتغير DXPR_ACCESS_TOKEN=[access_token] واحفظ الملف — أي. تجاهل الأقواس المربعة. يمكنك الحصول على الرمز المميز الخاص بك من صفحة التنزيلات على dxpr.com في علامة التبويب JSON Web Token.

7. الآن بعد أن قمت بإعداد كل شيء، ما عليك سوى تشغيل البرنامج النصي التالي داخل المجلد dxpr_builder عن طريق كتابة هذا الأمر والانتظار حتى يتم تثبيت الموقع بنجاح. ./scripts/qa-demo.install.sh .
   يجب أن يستغرق هذا عدة دقائق حتى ترى شيئًا مثل هذا:

    my_drupal9_project_qa_demo | [ملاحظة] تم تنفيذ مهمة التثبيت: install_finished
   my_drupal9_project_qa_demo | [نجاح] اكتمل التثبيت.
   my_drupal9_project_qa_demo | [30 يوليو 2021 09:18:32] إشعار: fpm قيد التشغيل، pid 1
   my_drupal9_project_qa_demo | [30 يوليو 2021 09:18:32] إشعار: جاهز للتعامل مع الاتصالات

   ما عليك سوى تشغيل أمر التثبيت مرة واحدة فقط، وفي المرة القادمة، فقط قم بتشغيل ./scripts/qa-demo.sh

8. افتح المتصفح وانتقل إلى http://drupal.docker.localhost:8000/
9. يمكنك الآن فتح المشروع في أي محرر — على سبيل المثال. VSCode - وابدأ في تغيير الملفات. بعد الحفظ، ستقوم المكدس تلقائيًا بتشغيل المهام الصعبة، وإعادة بناء الأصول إذا لزم الأمر، ومواصلة مراقبة التغييرات. يمكنك رؤية السجلات في الوحدة الطرفية إذا كنت بحاجة إلى التحقق من وجود أي أخطاء جسيمة عند إنشاء الأصول.
10. لإيقاف المكدس، اضغط على CTRL + c . إنها دائمًا طريقة جيدة لتنظيف بيئتك بعد إيقاف المكدس، فقط قم بتشغيل هذا الأمر: ./scripts/qa-demo.cleanup.sh

هل أحتاج إلى انتظار التثبيت التجريبي في كل مرة أقوم فيها بتشغيل المكدس؟

لحسن الحظ، لن تفعل ذلك، في المرة القادمة التي تحتاج فيها إلى تشغيل المكدس، فقط قم بتشغيل ./scripts/qa-demo.sh الذي سيطلق موقع الويب في ثوانٍ. إذا كنت تريد إيقاف المكدس، فافعل نفس ما هو مذكور في الخطوة 8 في قسم الاستنساخ والإعداد أعلاه.

تشغيل الاختبارات

لإجراء الاختبارات، إذا اتبعت الخطوات الموجودة في قسم الاستنساخ والإعداد ، فما عليك سوى تشغيل: ./scripts/qa-demo.test.sh . إذا لم يكن الأمر كذلك، فما عليك سوى اتباع قسم الاستنساخ والإعداد . تأكد أيضًا من إيقاف أوامر qa-demo.install.sh أو qa-demo.sh قبل تشغيل أمر الاختبار.

استكشاف الأخطاء وإصلاحها

• تأكد دائمًا من إعداد ملف .env الخاص بك قبل الانتقال إلى تصحيح الأخطاء والتأكد من عدم وجود أي شيء مفقود هناك.
• إذا كان ملف .env الخاص بك جيدًا، فحاول إيقاف الأمر قيد التشغيل حاليًا وتشغيل الأمر ./scripts/qa-demo.sh قبل المضي قدمًا. سيؤدي هذا إلى تنظيف المكدس وإعادة تشغيل التثبيت التجريبي لضمان الجودة .
• إذا كان لا يزال لا يعمل، فقد يكون التثبيت التجريبي لـ QA تالفًا، وأفضل إجراء هو إعادة تثبيت المكدس. Ctrl+c للخروج من الأمر قيد التشغيل حاليًا، ثم قم بتشغيل هذا الأمر: ./scripts/qa-demo.install.sh واتبع الخطوات من 5 إلى 8 كما هو محدد مسبقًا في قسم الاستنساخ والإعداد . إذا كان هذا الأمر يلقي أخطاء، فأوقفه وأعد تشغيله مرة أخرى.
• تأكد دائمًا من عدم تشغيل أي من أوامر qa-demo.install.sh أو qa-demo.sh أو qa-demo.test.sh في نفس الوقت حتى لو كانت في محطات طرفية مختلفة لأن ذلك سيؤدي إلى حدوث أخطاء، يجب عليك إيقاف أي أمر قيد التشغيل حاليًا ثم تشغيل الأمر المطلوب.
• بالنسبة لمستخدمي Mac ، تأكد من تثبيت libs المطلوبة. اتبع هذا الموضوع StackOverflow .

تثبيت الإصدار التجريبي من Bootstrap 4 أو 5

• قم بإنشاء مجلد آخر باستخدام رمز dxpr_builder، على سبيل المثال عن طريق نسخ المجلد الموجود

• قم بتحرير ملف .env لتبديل البيئة إلى Bootstrap 5 (أو 4):

   ### إعداد موضوع DXPR
  
  ### علامة صورة موضوع DXPR المراد استخدامها — أي الإنتاج.
  
  DXPR_THEME_TAG= 5.x

• اضبط إعدادات المشروع لتجنب التعارض مع العرض التوضيحي لـ Bootstrap 3 عن طريق إضافة bs5 إلى المتغيرات أدناه وزيادة رقم المنفذ:

   ### إعدادات المشروع
  
  # التغيير إلى اسم مختلف في حالة تشغيل مثيلات أخرى بنفس الاسم
  
  PROJECT_NAME= dxpr_builderbs5_project
  
  PROJECT_BASE_URL= drupalbs5.docker.localhost
  
  ### اسم الشبكة الذي يستخدمه موقع qa-demo عند تشغيل مكدس عامل الإرساء في dxp_builder
  
  QA_DEMO_NETWORK= qabs5-demo
  
  # التغيير إلى منفذ مختلف في حالة تشغيل مثيلات أخرى على المنفذ 8080
  
  PROJECT_PORT = 8002

• لتثبيت Bootstrap 4 بدلاً من 5، قم بما سبق باستبدال 5.x بـ 2.x واستبدال "bs5" بـ "bs4"
• افتح العرض التوضيحي على http://drupal.docker.localhost: 8002/ حيث يكون رقم المنفذ (8002) هو الرقم الذي أدخلته في ملف .env
• قم الآن بتشغيل ./scripts/qa-demo.install.sh كالمعتاد