كيفية تنزيل وتثبيت CUCUMBER في Windows
⚡ ملخص ذكي
Cucumber التثبيت على Windows يحتاج إلى أربعة أجزاء بالترتيب: روبي مع مجموعة أدوات التطوير الخاصة بها، و Cucumber الجوهرة نفسها، ومحرر مثل RubyMine، ومكتبة برامج تشغيل المتصفح. يتم تثبيت كل منها في دقائق.
Cucumber قد يبدو التثبيت مُرهقًا، ولكنه سهل نسبيًا بمجرد ترتيب القطع بالترتيب الصحيح. إليك خارطة طريق المكونات التي يجب تثبيتها لإتمام العملية. Cucumber عمل.
المتطلبات الأساسية للتثبيت Cucumber on Windows
Cucumber يتم توزيعها كحزمة Ruby، لذا لن يعمل أي شيء حتى يتم تثبيت Ruby. تأكد مما يلي قبل تنزيل أي شيء:
- Windows 10 أو أحدث، 64 بت. لم يعد برنامج RubyInstaller يوصي بالإصدار 32 بت إلا إذا كنت تعتمد على ملفات DLL الأصلية 32 بت أو كائنات COM.
- صلاحيات المسؤول. يقوم برنامج التثبيت بالكتابة إلى مجلد "ملفات البرامج" وتعديل متغير بيئة PATH.
- اتصال بالإنترنت. كلا أمري تثبيت gem أدناه يجلبان الحزم من RubyGems.
- حوالي 1 جيجابايت من مساحة القرص الحرة بالنسبة لـ Ruby بالإضافة إلى مجموعة تطوير MSYS2، والمزيد إذا أضفت RubyMine.
- متصفح لأتمتة العمليات. Watir محركات الأقراص Chrome أو Edge أو Firefox من خلال Seleniumلذلك يجب تثبيت واحد على الأقل.
هناك أمران جديران بالتذكر لاستخدامهما لاحقًا: روبي -v يطبع نسخة روبي، و gem -v يعرض إصدار RubyGems. إذا فشل أيٌّ من الأمرين، فهذا يعني أن متغير PATH لم يتم تحديثه، ويجب إعادة تشغيل برنامج التثبيت بدلاً من محاولة تصحيح الأخطاء.
قم بتثبيت روبي وDevKit
ابدأ بحزمة Ruby+Devkit، التي تتضمن مجموعة أدوات المترجم التي تحتاجها الأحجار الكريمة ذات امتدادات C.
الخطوة 1) اذهب إلى https://rubyinstaller.org/downloads/ ثم اختر برنامج التثبيت. ستظهر صفحة التنزيل أدناه.
⚠️ ملاحظة حول الإصدار: تم استبدال أرشيف DevKit المنفصل الذي أشارت إليه التعليمات الأصلية بمجموعة أدوات MSYS2، والتي روبي + ديفكيت تُضمّن حزمة التثبيت كمكوّن قابل للتحديد. يوصي RubyInstaller حاليًا بإصدار Ruby+Devkit 4.0.X (x64) للمستخدمين الجدد، وسيتم تحديث الحزمة لاحقًا. تثبيت ريدك بدلاً من إعادة تشغيل ملف dk.rb. الخطوات التالية لم تتغير.
الخطوة الثانية) افتح الملف الذي تم تنزيله. في الشاشة الأولى:
- قبول الترخيص
- انقر فوق زر التالي
الخطوة 3) في الشاشة التالية:
- حدد مجلد التثبيت الخاص بك
- حدد جميع الخيارات
- انقر على تثبيت
الخطوة الرابعة) في الشاشة التالية، انقر فوق التالي.
الخطوة 5) انتظر حتى يكتمل التثبيت.
الخطوة 6) انقر فوق "إنهاء".
الخطوة 7) بمجرد اكتمال التثبيت، قم بتشغيل Ruby من Windows قائمة البدأ.
الخطوة 8) ستظهر لك نافذة موجه أوامر روبي مشابهة لما يلي: Windows نافذة موجه الأوامر (cmd).
تثبيت Cucumber
بوجود Ruby في PATH، فإن الجوهرة نفسها عبارة عن أمر واحد.
الخطوة 1) اكتب تركيب الأحجار الكريمة خيار في موجه أوامر روبي. يقوم هذا الأمر بتنزيل وتثبيت Cucumber في سطر الأوامر نفسه.
بعد بضع ثوانٍ Cucumber تبدأ عملية التثبيت وتُبلغ عن كل تبعية يتم جلبها.
الخطوة الثانية) للتحقق مما إذا Cucumber تم التثبيت بنجاح، النوع خيار – نسخةلاحظ وجود شرطتين - فالشرطة الواحدة ليست خيارًا طويلًا صالحًا.
تثبيت IDE روبيماين
لا يُشترط وجود محرر نصوص، لكن RubyMine يدعم لغة Gherkin ويمكنه الانتقال من خطوة إلى تعريفها. اتبع الخطوات التالية لتثبيته.
الخطوة 1) انقر فوق التالي للمتابعة في تثبيت RubyMine.
الخطوة الثانية: اختر موقع التثبيت.
الخطوة 3) اضبط خيارات التثبيت.
الخطوة الرابعة) اختر مجلد قائمة ابدأ.
الخطوة 5) انقر فوق تثبيت.
الخطوة 6) انقر فوق "إنهاء".
الخطوة 7) اختر لا تستورد الإعدادات.
الخطوة 8) انقر فوق "تقييم".
الخطوة 9) قبول الترخيص.
الخطوة 10) اختر تخطي المتبقي وتعيين الإعدادات الافتراضية.
الخطوة 11) افتح المحرر.
الخطوة 12) إنشاء مشروع جديد.
⚠️ ملاحظة حول الإصدار: روبيماين خدمة مدفوعة JetBrains منتج ذو تقييم محدود المدة، وهو ما يبدأه زر "التقييم" في الخطوة 8. وهناك بديل مجاني هو Visual Studio Code مع روبي و Cucumber (امتداد Gherkin)؛ بقية هذا الدليل يعمل بنفس الطريقة في أي من المحررين.
تثبيت watir-webdriver
Cucumber لا يقوم البرنامج إلا بتنفيذ الخطوات. يجب على برنامج آخر فتح المتصفح، وهذه المهمة منوطة بـ Watir، غلاف روبي حول Seleniumإذا كنت تفضل التحكم في المتصفح مباشرةً، فيمكن للمشروع نفسه استدعاء برنامج عادي. نص WebDriver.
الخطوة 1) انقر على تشغيل موجه الأوامر باستخدام روبي ثم قم بتشغيل أمر التثبيت gem install watir-webdriver.
الخطوة 2) تم تثبيت حزمة watir-webdriver بنجاح.
⚠️ ملاحظة حول إيقاف الخدمة: تم دمج جوهرة watir-webdriver في البرنامج الرئيسي واتير جوهرة في Watir 6.0، ومستودعها الخاص الآن يُشير فقط إلى البديل. على جهاز جديد، قم بتشغيل تركيب الأحجار الكريمة في الماء بدلاً من ذلك. تم الاحتفاظ بالأمر التاريخي المذكور أعلاه لأنه ما تظهره لقطات الشاشة.
Cucumber هيكل مجلد المشروع
Cucumber يكتشف النظام الملفات وفقًا للاتفاقية، وليس وفقًا للإعدادات، لذا فإنّ تصميم الملفّات أكثر أهمية مما يبدو للوهلة الأولى. يبدو المشروع البسيط كالتالي:
| مسار | يحمل |
|---|---|
| سمات/ | كل ملف بامتداد .feature، مكتوب بلغة غيركين. Cucumber يتم البحث هنا افتراضياً. |
| الميزات/تعريفات الخطوات/ | ملفات روبي التي تتطابق كتلها مع كل سطر من سطور Given و When و Then. |
| الميزات/الدعم/ | يتم تحميل رمز الإعداد قبل تشغيل أي خطوة، مثل env.rb، وهو المكان الذي يتم فيه عادةً فتح المتصفح وإغلاقه. |
قاعدتان توفران الكثير من الارتباك لاحقاً. Cucumber يتجاهل الكلمة المفتاحية عندما تتطابق مع خطوة، لذلك بافتراض أن لدي المتغير أ و ثم لدي المتغير أ تتعارض مع نفس التعريف. ويجب أن يتطابق نص الخطوة في ملف الميزة تمامًا مع التعبير النمطي في ملف الخطوة، بما في ذلك علامات الترقيم.
الاسم الأول Cucumber سيناريو
يقوم المثال أدناه بضرب رقمين، وهو ما يكفي لإثبات أن ملف الميزة وملف الخطوة والجوهرة كلها تتحدث مع بعضها البعض.
الخطوة 1) افتح محرر RubyMine من Windows قائمة البدأ.
تظهر لوحة تحكم RubyMine كما هو موضح أدناه.
الخطوة 2) أنشئ مشروعًا جديدًا في محرر RubyMine.
أعطِ المشروع اسمًا وموقعًا، ثم أكّد.
الخطوة 3) إنشاء دليل ملفات.
يظهر المجلد الجديد في شجرة المشروع.
الخطوة الرابعة) أنشئ ملفًا واحفظه في yourfolder/features/ مع اسم اسم ملفك.ميزة.
تأكد من أن اسم الملف ينتهي بالامتداد .feature.
الخطوة 5) لتنفيذ السيناريو الخاص بنا، احفظ الأوامر التالية في ملف الميزات.
Code:
Feature: Multiplication I multiply two numbers Scenario: multiply a and b Given I have variable a And I have variable b When I multiplication a and b Then I display the Result
الخطوة 6) الآن قم بتشغيل ملف الميزة الأول.
انقر على تشغيل موجه الأوامر باستخدام روبي وقم بتشغيل أمر Cucumber من مجلد المشروع.
تعرض وحدة التحكم النتيجة كما هو موضح أدناه.
الخطوة 7) إنشاء ملف تعريف الخطوة لملف الميزة.
أنشئ مجلدًا جديدًا في محرر RubyMine.
الخطوة 8) احفظ الملف في yourfolder/features/step_definititons مع اسم test_step.rb.
الخطوة 9) اكتب الكود التالي في ملف الخطوات.
Code:
Given(/^I have variable a$/) do @a = 50 end And(/^I have variable b$/) do @b = 70 end When(/^I multiplication a and b$/) do @mul = @a * @b end Then(/^I display the Result$/) do puts "Multiplication of #{@a} and #{@b} is #{@mul}" end
الخطوة 10) الآن قم بتشغيل ملف الميزة مرة أخرى.
تُطبع النتيجة في وحدة التحكم، ويتم الإبلاغ عن كل خطوة على أنها ناجحة.
مشترك Cucumber أخطاء التثبيت وكيفية إصلاحها
معظم حالات الفشل في هذه المرحلة تنجم عن البيئة وليس عن Cucumberهذه هي الأشياء التي تستحق التعرف عليها من النظرة الأولى.
| رسالتك | سبب | حل |
|---|---|---|
| لم يتم التعرف على كلمة "cucumber" كأمر داخلي أو خارجي | دليل Ruby bin غير موجود في PATH، أو أنك في نافذة cmd عادية. | ساعات العمل تشغيل موجه الأوامر باستخدام روبيأو أعد تثبيت Ruby مع تحديد خيار PATH. |
| SSL_connect returned=1 errno=0 state=error: certificate verify failed | لا تستطيع RubyGems التحقق من صحة سلسلة الشهادات، والتي عادة ما تكون خلف وكيل مؤسسي. | قم بتحديث RubyGems باستخدام الأمر gem update –system، أو قم بتكوين الوكيل باستخدام مفتاح التبديل –http-proxy. |
| خطأ: فشل بناء امتداد gem الأصلي | مجموعة تطوير MSYS2 مفقودة. | قم بتشغيل برنامج تثبيت ridk واختر خيارات مجموعة أدوات MSYS2 و MINGW. |
| خيار غير صالح: -version | تم استخدام واصلة واحدة للخيار الطويل. | اكتب الخيار – الإصدار مع شرطتين. |
| خطوة غير محددة، مع مقتطف برمجي مقترح مطبوع أسفلها | Cucumber تم العثور على ملف الميزات ولكن لم يتم العثور على تعريف مطابق. | الصق المقتطف المقترح في ملف ضمن features/step_definitions واملأ النص. |
| لا يمكن تحميل هذا الملف — واتير | تم تثبيت الجوهرة لإصدار روبي مختلف عن الإصدار قيد التشغيل. | تحقق من الأمر ruby -v و gem list watir في نفس موجه الأوامر، ثم أعد تثبيت الجوهرة هناك. |
بمجرد أن يُبلغ سيناريو الضرب عن نجاح العملية، يكتمل التثبيت ويمكن للمشروع نفسه أن يتطور إلى مشروع كامل اختبار الأتمتة الجناح، سواء تم استخدامه لـ الاختبار الوظيفي أو ليليًا اختبار الانحدار.












































