Appium تبعية Maven: الإعداد باستخدام Eclipse مثال على المشروع
⚡ ملخص ذكي
Appium تتيح إدارة تبعيات Maven لمشروع أتمتة الهاتف المحمول تعريف عنصر java-client في pom.xml، بحيث يقوم Maven بحل كل ملف jar تلقائيًا ويتم تشغيل نفس الإصدار على أي جهاز دون الحاجة إلى تنزيلات يدوية.
ما هي تفاصيل 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، حيث تتوفر كل نسخة منشورة ومقتطفاتها الجاهزة.
أو أضف مباشرةً ملف 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) في هذه الخطوة،
- انتقل إلى جديد >> حدد مشروع Maven
- انقر على زر "التالي"
يفتح معالج المشروع الجديد مع تمييز مشروع Maven، كما هو موضح هنا.
الخطوة 2) ثم في نافذة "مشروع Maven جديد"، أدخل "Appium أدخل كلمة "اختبار" في خانتي "معرف المجموعة" و"معرف القطعة الأثرية". في هذه الخطوة، عليك إدخال ما يلي:
- معرف مجموعة
- معرف القطعة الأثرية
- التجريبية
- تجيهز المنصة و تسليمها
- اسم و Descriptأيون
- نهاية
يبدو نموذج مشروع Maven الجديد المكتمل كما في لقطة الشاشة أدناه.
سيؤدي النقر على زر "إنهاء" إلى فتح فصل دراسي جديد ضمن معرف المجموعة المحدد (Appiumاسم الاختبار.
الخطوة 3) لتبدأ Appium لإنشاء ملف برمجي، انقر بزر الماوس الأيمن على 'src/main/java' في نافذة مستكشف الملفات على الجانب الأيسر. ثم اختر جديد >> فئة. اكتب Appium الكود داخل الفئة المحددة.
تظهر أدناه قائمة السياق المستخدمة لإنشاء هذا الصنف.
الخطوة 4) في نفس المشروع، انقر على ملف pom.xml في قائمة المستكشف على اليسار. ستظهر جميع التبعيات افتراضيًا في علامة التبويب "pom.xml". انظر إلى الصورة أدناه.
إذا لم يكن ملف pom.xml الافتراضي موجودًا، فما عليك سوى إضافة جميع عناصر Maven Appium التبعيات، على سبيل المثالtracتم استخراجه من موقع مستودع Maven المركزي:
https://central.sonatype.com/artifact/io.appium/java-client
ملف pom.xml المُعدَّل مع Appium تظهر أدناه التبعيات المضافة.
الخطوة 5) الآن، انقر بزر الماوس الأيمن على 'pom.xml' في مستكشف الملفات على اليسار، أو على كود XML الخاص بـ 'Appiumقم باختبار المشروع. ثم انقر فوق خيار "تشغيل كـ >> تنظيف Maven"، كما هو موضح أدناه.
أثناء التشغيل، يمكنك رؤية جميع ملفات JAR المتعلقة بـ Maven ورسالة نجاح، كما هو موضح في مخرجات وحدة التحكم أدناه. هذه هي طريقة تشغيل Appium Java اختبار تبعية Maven للعميل في بيئة مُهيأة باستخدام Maven.
كيفية تشغيل 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 بدلاً من آخر خطأ. عادةً ما تكون الأسطر اللاحقة نتيجةً لفقدان العنصر الأول.








