Appium تبعية Maven: الإعداد باستخدام Eclipse مثال على المشروع

⚡ ملخص ذكي

Appium تتيح إدارة تبعيات Maven لمشروع أتمتة الهاتف المحمول تعريف عنصر java-client في pom.xml، بحيث يقوم Maven بحل كل ملف jar تلقائيًا ويتم تشغيل نفس الإصدار على أي جهاز دون الحاجة إلى تنزيلات يدوية.

  • 🔴 ما يفعله مافن: Apache Maven يدير دورة حياة البناء ويحل التبعيات من ملف pom.xml واحد تعريفي.
  • ☑️ قطعة أثرية واحدة: تعتمد مكتبة io.appium java-client على... Selenium واجهة برمجة التطبيقات، وبرنامج التشغيل عن بعد، وملفات الدعم بشكل غير مباشر.
  • ✅ نظام الإصدار: قم بمطابقة إصدار عميل جافا مع Selenium النطاق الذي يُعلن عنه لتجنب خطأ NoSuchMethodError أثناء التشغيل.
  • 🧪 تخطيط ثابت: يقوم برنامج Surefire بتنفيذ الفئات الموجودة ضمن src/test/java فقط، لذلك يتم تجميع الاختبارات الموضوعة في غير مكانها ولكنها لا تعمل أبدًا.
  • 🛠️ سطر الأوامر: يقوم الأمر mvn clean test بتجميع وتنفيذ مجموعة الاختبارات، وكتابة النتائج إلى target/surefire-reports.
  • 📊 المتطلبات الأساسية: مافن لا يبدأ أبداً Appium الخادم أو الجهاز، لذلك يجب أن يكون كلاهما جاهزًا قبل بدء عملية البناء.

Appium إعداد تبعيات Maven باستخدام ملف pom.xml وعنصر java-client

ما هي تفاصيل Apache Maven?

Apache Maven هو Java- القائم على إدارة المشاريع وأداة التشغيل الآلي. فهو يوفر إطارًا متعدد المهام للمطورين لتسهيل دورة حياة البناء الكاملة Java التطبيقات. تم تعريف Maven مسبقًا وإعلانه بتنسيق XML يسمى POM (نموذج كائن المشروع) ويشار إليه باسم "pom.xml". يمكن استخدامه أيضًا للغات أخرى مثل C# وScala وRuby وما إلى ذلك.

باستخدام إطار عمل Maven، يمكنك بسهولة إدارة المهام التالية في أي مشروع:

  • دورة البناء
  • وثائق المشروع
  • تقرير الشيكات
  • إدارة سكروم
  • تخليص المعلومات

الاستخدامات الأساسية لـ Maven هي:

  • يفرض بنية الدليل القياسية.
  • توفير هيكل المشروع قابل لإعادة الاستخدام وسهل الصيانة.
  • حل تبعيات الحزم.
  • توفير إطار إدارة التكوين.

إن القدرة على حل التبعيات هي بالضبط ما يحتاجه Appium احتياجات المشروع، لأن Java يستعين العميل بسلسلة من Selenium ملفات JAR التي لا يرغب أحد في تنزيلها يدويًا.

التحميل Appium تبعيات المخضرم

قبل أن تبدأ في كتابة Appium لاختبار التبعيات باستخدام Maven، ستحتاج إلى تنزيل Appium الاعتماد على Maven — Appium ملف JAR للتنزيل — من موقع مستودع مافن المركزي. تُظهر لقطة الشاشة أدناه قائمة عناصر java-client على Maven Central، حيث تتوفر كل نسخة منشورة ومقتطفاتها الجاهزة.

Appium قائمة عناصر java-client في صفحة البحث في مستودع Maven المركزي

أو أضف مباشرةً ملف POM.xml المذكور أدناه:

<dependency>
  <groupId>io.appium</groupId>
  <artifactId>java-client</artifactId>
  <version>3.4.1</version>
</dependency>

⚠️ ملاحظة حول الإصدار: القادم 3.4.1 الإحداثيات المذكورة أعلاه هي المثال الأصلي، ولا تزال تُظهر الشكل الصحيح للكتلة. وهي أقدم من بروتوكول W3C WebDriver، لذا يجب على أي مشروع جديد تحديث الإصدار. في وقت كتابة هذا التقرير، الإصدار الحالي على Maven Central هو 10.1.1، الأمر الذي يتطلب Selenium 4.42.0 أو الأحدث.

<dependency>
  <groupId>io.appium</groupId>
  <artifactId>java-client</artifactId>
  <version>10.1.1</version>
</dependency>

يرجى الذهاب من خلال موقعنا البرنامج التعليمي مافن لمعرفة كيفية تكوين Maven باستخدام Eclipse.

Appium هيكل مشروع Maven والتبعيات المطلوبة

يفرض Maven تخطيطًا ثابتًا، ومعرفة ذلك تمنع معظم الالتباس الذي سيحدث لاحقًا في هذا الشرح. يحتوي المشروع المُنشأ على أربعة مواقع مهمة:

  • pom.xml — نموذج كائن المشروع في جذر المشروع، حيث يتم الإعلان عن كل تبعية ومكون إضافي.
  • src / main / java — فئات التطبيق والمساعدة.
  • src/test/java — فئات الاختبار، والمجلد الوحيد الذي يقوم الملحق Surefire بفحصه عند تشغيل عملية البناء.
  • الهدف — تم تجميع المخرجات وتقارير الاختبار، وإعادة إنشائها في كل عملية بناء.

استخدم Appium يُعدّ java-client التبعية الإلزامية الوحيدة، لأنه يُعلن عن Selenium واجهة برمجة التطبيقات، وبرنامج التشغيل عن بُعد، ومكونات الدعم بشكل غير مباشر. لا تزال العديد من الفرق تعتمد عليها. Selenium بشكل صريح بحيث يكون الإصدار مرئيًا في مكان واحد، وأضف مُشغِّل اختبار:

<dependencies>
  <dependency>
    <groupId>io.appium</groupId>
    <artifactId>java-client</artifactId>
    <version>10.1.1</version>
  </dependency>
  <dependency>
    <groupId>org.seleniumhq.selenium</groupId>
    <artifactId>selenium-java</artifactId>
    <version>4.42.0</version>
  </dependency>
</dependencies>

حافظ على توافق الإصدارين. ينص إصدار عميل جافا على ما يلي: Selenium النطاق الذي يدعمه، ودمج عميل قديم مع عميل أحدث بكثير Selenium يُعدّ هذا السبب الأكثر شيوعًا لظهور خطأ NoSuchMethodError أثناء التشغيل. مستودع عميل جافا يوثق هذا التقرير عملية الاقتران لكل إصدار.

اختبار التطبيق مع Appium ومافن

مع وجود هذا الاعتماد، Eclipse تُنشئ آلية العمل الموضحة أدناه مشروعًا قابلاً للتنفيذ من الصفر. بعد تهيئة Appium Java إضافة Maven في Eclipseمساحة العمل جاهزة لاختبار أي شيء Android .apk التطبيق مع Appium ومافن، كما هو موضح في Appium مثال مشروع Maven أدناه.

الخطوة 1) في هذه الخطوة،

  1. انتقل إلى جديد >> حدد مشروع Maven
  2. انقر على زر "التالي"

يفتح معالج المشروع الجديد مع تمييز مشروع Maven، كما هو موضح هنا.

Eclipse معالج إنشاء مشروع جديد مع تحديد مشروع Maven

الخطوة 2) ثم في نافذة "مشروع Maven جديد"، أدخل "Appium أدخل كلمة "اختبار" في خانتي "معرف المجموعة" و"معرف القطعة الأثرية". في هذه الخطوة، عليك إدخال ما يلي:

  1. معرف مجموعة
  2. معرف القطعة الأثرية
  3. التجريبية
  4. تجيهز المنصة و تسليمها
  5. اسم و Descriptأيون
  6. نهاية

يبدو نموذج مشروع Maven الجديد المكتمل كما في لقطة الشاشة أدناه.

نافذة مشروع Maven جديدة مع معرّف المجموعة، ومعرّف العنصر، والإصدار، والتغليف مُعبأة.

سيؤدي النقر على زر "إنهاء" إلى فتح فصل دراسي جديد ضمن معرف المجموعة المحدد (Appiumاسم الاختبار.

الخطوة 3) لتبدأ Appium لإنشاء ملف برمجي، انقر بزر الماوس الأيمن على 'src/main/java' في نافذة مستكشف الملفات على الجانب الأيسر. ثم اختر جديد >> فئة. اكتب Appium الكود داخل الفئة المحددة.

تظهر أدناه قائمة السياق المستخدمة لإنشاء هذا الصنف.

انقر بزر الماوس الأيمن على قائمة src/main/java التي تعرض New و Class في Eclipse مستكشف

الخطوة 4) في نفس المشروع، انقر على ملف pom.xml في قائمة المستكشف على اليسار. ستظهر جميع التبعيات افتراضيًا في علامة التبويب "pom.xml". انظر إلى الصورة أدناه.

علامة تبويب محرر pom.xml في Eclipse قائمة بتبعيات المشروع التي تم حلها

إذا لم يكن ملف pom.xml الافتراضي موجودًا، فما عليك سوى إضافة جميع عناصر Maven Appium التبعيات، على سبيل المثالtracتم استخراجه من موقع مستودع Maven المركزي:

https://central.sonatype.com/artifact/io.appium/java-client

ملف pom.xml المُعدَّل مع Appium تظهر أدناه التبعيات المضافة.

عرض مصدر ملف pom.xml بعد Appium تم لصق تبعية java-client في

الخطوة 5) الآن، انقر بزر الماوس الأيمن على 'pom.xml' في مستكشف الملفات على اليسار، أو على كود XML الخاص بـ 'Appiumقم باختبار المشروع. ثم انقر فوق خيار "تشغيل كـ >> تنظيف Maven"، كما هو موضح أدناه.

Eclipse قم بتشغيل القائمة الفرعية "تشغيل كـ" مع تحديد خيار "تنظيف Maven".

أثناء التشغيل، يمكنك رؤية جميع ملفات JAR المتعلقة بـ Maven ورسالة نجاح، كما هو موضح في مخرجات وحدة التحكم أدناه. هذه هي طريقة تشغيل Appium Java اختبار تبعية Maven للعميل في بيئة مُهيأة باستخدام Maven.

Eclipse وحدة التحكم تعرض ملفات Maven jar التي تم تنزيلها ورسالة نجاح عملية البناء

كيفية تشغيل Appium الاختبارات باستخدام أوامر Maven

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

mvn clean
mvn clean test
mvn clean install
mvn test -Dtest=LoginTest

لكل منهم وظيفة مميزة:

  • تنظيف إم في إن يحذف target هذا هو الأمر الذي يُنشئ الدليل بحيث لا يبقى أي شيء قديم في الإصدار التالي. Eclipse شرح الخطوات المذكورة أعلاه يؤدي إلى تفعيلها.
  • اختبار mvn النظيف يقوم بتجميع المشروع وتنفيذ فئات الاختبار. يقوم ملحق Maven Surefire باستلامها تلقائيًا من src/test/javaباستخدام أنماط التضمين الافتراضية Test*.java, *Test.java, *Tests.java و *TestCase.java.
  • تثبيت نظيف لـ mvn يقوم بتشغيل الاختبارات ثم يضع العنصر المعبأ في مستودعك المحلي، حتى يتمكن مشروع آخر من الاعتماد عليه.
  • mvn test -Dtest=LoginTest يُضيّق نطاق التشغيل إلى فئة واحدة أثناء عملية تصحيح الأخطاء.

هناك نقطتان تقع في فخ الناس. أولاً، Appium يجب أن يكون الخادم قيد التشغيل وأن يكون الجهاز أو المحاكي متصلاً قبل بدء عملية البناء، لأن Maven لا يقوم بتشغيل أي منهما - تحقق من الجهاز باستخدام بنك التنمية الآسيوي تحقق أولاً. ثانياً، تُكتب النتائج إلى target/surefire-reportsوهو المجلد الذي يجب أن تقوم مهمة التكامل المستمر بأرشفته. دليل استخدام Surefire يغطي هذا الدليل خيارات التكوين بالتفصيل، وتُشغّل نفس الأوامر... Appium جناح من Jenkins.

مشترك Appium أخطاء مافن وكيفية إصلاحها

معظم حالات الفشل في Appium لا يعود سبب مشاكل إعداد Maven إلى كود الاختبار نفسه، بل إلى عدد قليل من الأسباب المتكررة. يوضح الجدول أدناه العلاقة بين كل عرض وحلّه المعتاد.

عرض سبب محتمل حل
تعذر حل التبعيات الخاصة بـ io.appium:java-client سلسلة إصدار خاطئة، أو لا يوجد اتصال بالشبكة بـ Maven Central انسخ الإحداثيات مباشرةً من قائمة Maven Central وأعد تشغيل عملية البناء
خطأ NoSuchMethodError أو خطأ NoClassDefFoundError من Selenium فئة إصدارات java-client و selenium-java غير متوافقة طابق ال Selenium الإصدار ضمن النطاق الذي يحدده إصدار عميل جافا
يتم تجميع الاختبارات بنجاح ولكن لا يتم تشغيل أي منها. توجد فئات الاختبار في src/main/java، أو أن اسم الفئة لا يتطابق مع نمط تضمين Surefire انقل الملفات إلى src/test/java وقم بتسمية الفئة بحيث ينتهي اسمها بـ Test
تم رفض الاتصال على المنفذ 4723 استخدم Appium الخادم لا يعمل ابدأ ال Appium الخادم قبل البناء
قدرة غير صالحة أو غير مدعومة أسماء القدرات القديمة المستخدمة مع برنامج تشغيل حديث Revانظر إلى الوضع الحالي القدرات المطلوبة لمنصتك
إصدار رئيسي غير مدعوم لملف الفئة تختلف حزمة تطوير جافا (JDK) المستخدمة من قبل Maven عن تلك المستخدمة على مستوى المُصرّف في ملف pom.xml قم بمحاذاة خصائص maven.compiler.source و target مع ما قمت بتثبيته JDK

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

الأسئلة الشائعة

استخدم أحدث إصدار مُدرج على Maven Central بدلاً من نسخة منسوخة من دليل قديم. في وقت كتابة هذا التقرير، كان الإصدار 10.1.1، والذي يتوقع Selenium 4.42.0 أو أحدث في مسار الفئة.

تقوم نماذج التعلم الآلي بإصلاح محددات العناصر بعد تغيير واجهة المستخدم، وتجميع حالات الفشل المكررة عبر الأجهزة، والتنبؤ بالاختبارات التي من المحتمل أن يتسبب فيها الالتزام في حدوث خلل، بحيث يغطي تشغيل Maven الأقصر المنطقة الخطرة.

يُكمل Copilot عناصر groupId وartifactId وversion من خلال تعليق من سطر واحد. غالبًا ما يُشير إلى رقم إصدار قديم، لذا تأكد من صحة الإحداثيات في Maven Central قبل إرسال الملف.

ليس تمامًا. يُعلن عميل جافا عن Selenium تنتقل العناصر بشكل غير مباشر. لا تزال العديد من الفرق تحدد إصدار Selenium Java بشكل صريح حتى يكون الإصدار مرئيًا وتكون التحديثات متعمدة وليست عرضية.

كلاهما يحل نفس المشكلات. يستخدم Maven لغة XML التصريحية ويناسب الفرق التي ترغب في دورة حياة ثابتة. Gradle البرامج النصية في Groovy أو Kotlin ويتم بناؤها بشكل تدريجي، مما يساعد في المستودعات الكبيرة متعددة الوحدات.

في src/test/java. يقوم Surefire بفحص هذا الدليل فقط أثناء عملية البناء، لذلك يتم تجميع فئة موجودة في src/main/java ولكنها لا تُنفذ أبدًا، مما يبدو وكأنه اختبار ناجح بصمت.

لا. يقوم Maven بحلّ ملفات JAR وتشغيل الاختبارات فقط. ابدأ Appium قم بتشغيل الخادم وقم بتوصيل جهاز أو محاكي أولاً، أو قم بتشغيل الخادم من طريقة إعداد الاختبار الخاصة بك أو خطوة من خطوات خط أنابيب التكامل المستمر.

اطلع على المستودع، وابدأ Appium قم بتشغيل الأمر mvn clean test على الخادم والجهاز. Archive target/surefire-reports كمنتج بناء بحيث تظل حالات الفشل قابلة للقراءة بعد تدمير العامل.

تلخيص هذه التدوينة بـ: