سيعلمك هذا الدليل كيفية استنساخ وإعداد مشروع أتمتة اختبار DXPR Maven للتطوير والاختبار المحلي. سيكون لديك بيئة تشغيل Java مع تكوين إطار عمل Maven وTestNG عند إعداد البيئة بنجاح.

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

  1. راجع وثائق إعداد الجهاز قبل متابعة هذا الدليل.
  2. تأكد من أنك قمت بالفعل بإعداد مشروع DXPR Builder على جهازك.

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

  1. استنساخ مستودع DXPR Maven: git clone [email protected]:dxpr/dxpr_maven.git .
  2. افتح دليل المشروع في محرر النصوص المفضل لديك.
  3. انسخ الملف .env.example وأعد تسميته ليصبح .env
  4. افتح ملف .env وقم بتعيين المتغير DXPR_ACCESS_TOKEN=[access_token] واحفظ الملف. يمكنك الحصول على الرمز المميز الخاص بك من صفحة التنزيلات على dxpr.com في علامة التبويب JSON Web Token.
  5. يمكنك الآن البدء في تطوير مشروع maven وتغيير الملفات في المحرر المفضل لديك. محرر أكواد Java الموصى به هو إصدار مجتمع Intellij IDEA . بمجرد قيامك بتغيير أي ملف ورغبتك في إجراء الاختبارات، انتقل إلى الخطوات التالية.
  6. تأكد من اتباع الشرط الأساسي الثاني قبل المتابعة وأن موقع الويب التجريبي لضمان الجودة جاهز للعمل على http://drupal.docker.localhost:8000/ .
  7. في علامة تبويب طرفية منفصلة، ​​تأكد من أنك في الدليل الجذر لمشروع DXPR maven، ثم قم بالتشغيل
    ./scripts/qa-demo.test.sh
    يبدأ هذا الأمر شبكة السيلينيوم وعقدة الكروم المستقلة لإجراء الاختبارات عليها. بعد تنفيذ الأمر، سيتم فتح نسخة طرفية داخل حاوية مخضرمة حيث لديك بيئة تشغيل Java.
  8. في هذا المثيل الطرفي داخل الحاوية المخضرمة، ستحتاج إلى تشغيل هذا الأمر مرة واحدة فقط لكل نسخة
    ./scripts/maven.properties.install.sh
    سيؤدي هذا إلى تكوين بعض المتغيرات البيئية الضرورية لتشغيل تطبيق Java.
  9. الآن، يمكنك البدء في تنفيذ أوامر maven كما لو كنت ستفعل ذلك في بيئة تشغيل Java. لتشغيل مجموعة اختبار TestNG، سنستخدم الأمر mvn ، run
    ./scripts/qa-demo.wait.sh $DEMO_HOST mvn test -DsuiteXmlFile=$TEST_SUITE
    دعونا نشرح ما يفعله هذا الأمر:
  • ./scripts/qa-demo.wait.sh : هذا البرنامج النصي ينتظر فقط حتى يصبح موقع QA التجريبي جاهزًا للتعامل مع الاتصالات.
  • $DEMO_HOST : هذا المتغير عبارة عن معلمة تم تمريرها إلى برنامج الانتظار النصي الذي يتم حله إلى اسم مضيف موقع الويب التجريبي لضمان الجودة.
  • mvn test -DsuiteXmlFile=$TEST_SUITE : هذه هي الطريقة التي تقوم بها عادةً بتشغيل مجموعة اختبار باستخدام أمر mvn الذي يحدد اسم ملف مجموعة الاختبار عبر المتغير $TEST_SUITE .

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

كيفية إنهاء مثيل محطة حاوية مخضرم

إذا كانت هناك عملية قيد التشغيل داخل الوحدة الطرفية المخضرمة، فاضغط على ctrl+c أولاً. إذا لم يكن الأمر كذلك، فما عليك سوى كتابة exit والضغط على Enter ، سيؤدي هذا إلى الخروج من الجلسة الطرفية داخل الحاوية المخضرمة. يعد تنظيف البيئة دائمًا خطوة جيدة عن طريق تشغيل هذا الأمر
./scripts/test.dev.cleanup.sh
سيؤدي هذا إلى إيقاف وإزالة كافة الحاويات والشبكات المستخدمة. قد تحتاج أيضًا إلى إيقاف موقع الويب التجريبي لضمان الجودة الذي بدأته قبل فتح جلسة المحطة الطرفية المخضرمة. راجع إعداد دليل مشروع DXPR Builder لمعرفة كيفية إيقافه بشكل صحيح.

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

  • إذا حصلت على خطأ عند محاولة إجراء الاختبارات، فتأكد من أن العرض التجريبي لضمان الجودة جاهز للتعامل مع الاتصالات.
  • إذا كان العرض التوضيحي لضمان الجودة قيد التشغيل ولكنك لا تزال تحصل على أخطاء، فقم بإنهاء مثيل المحطة الطرفية للحاوية المخضرمة وأعد تشغيل هذا الأمر
    ./scripts/qa-demo.test.sh
    سيؤدي هذا إلى إعادة فتح مثيل محطة الحاوية المخضرمة ويمكنك البدء في تشغيل الاختبارات مرة أخرى.
  • إذا كنت لا تزال تواجه مشكلة، فتأكد من أن موقع الويب التجريبي لضمان الجودة يعمل كما هو متوقع. إذا كنت تعتقد أنه معطل أو به مشكلة، فيمكنك الرجوع إلى دليل مشروع DXPR Builder وإعادة تثبيت موقع الويب باتباع قسم استكشاف الأخطاء وإصلاحها.