يساعد إنشاء رحلات في Android Studio على تسهيل كتابة الاختبارات الشاملة والحفاظ عليها من خلال السماح لك باستخدام اللغة الطبيعية لوصف الخطوات والتأكيدات لكل اختبار، ويُطلق على ذلك اسم الرحلة. من خلال الاستفادة من إمكانات Gemini في الرؤية والاستدلال، يتم تحويل الخطوات المكتوبة بلغة طبيعية إلى إجراءات ينفّذها Gemini في تطبيقك، ما يجعل كتابة رحلات المستخدمين وفهمها أمرًا سهلاً. بالإضافة إلى ذلك، يمكنك كتابة وصف أكثر تعقيدًا لعمليات التأكّد، والتي يقيّمها Gemini استنادًا إلى ما يراه على الجهاز لتحديد ما إذا كانت رحلاتك ناجحة أم لا.
وبما أنّ Gemini يحدّد الإجراءات التي يجب اتّخاذها لتحقيق الأهداف، تكون الرحلات أكثر مرونة في مواجهة التغييرات الطفيفة في تصميم تطبيقك أو سلوكه، ما يؤدي إلى تقليل الاختبارات غير المستقرة عند تنفيذها على إصدارات مختلفة من تطبيقك وإعدادات مختلفة للأجهزة.
يمكنك كتابة الرحلات وتنفيذها مباشرةً من Android Studio على أي جهاز Android محلي أو بعيد. توفر بيئة التطوير المتكاملة تجربة محرّر جديدة لتصميم الرحلات، بالإضافة إلى نتائج غنية بصريًا تساعدك في فهم طريقة تفكير Gemini وتنفيذه لرحلتك بشكل أفضل.
كتابة رحلة
توفّر Android Studio نموذج ملف وتجربة محرِّر جديدة تسهّل إنشاء الرحلات وتعديلها. تتم كتابة رحلات المستخدمين باستخدام بنية XML لتنظيم وصف الرحلة وخطواتها.
لإنشاء رحلة وبدء تعديلها، اتّبِع الخطوات التالية:
- من لوحة المشروع في "استوديو Android"، انقر بزر الماوس الأيمن على وحدة التطبيق التي تريد كتابة رحلة لها.
- انقر على جديد > اختبار > ملف رحلة.
- في مربّع الحوار الذي يظهر، أدخِل اسم رحلتك ووصفها.
- انقر على موافق. ينشئ "استوديو Android" ملف XML لرحلتك بالاسم الذي اخترته. يمكنك استخدام طريقة عرض الرمز لتعديل XML مباشرةً، أو طريقة عرض التصميم للحصول على تجربة تعديل محسّنة.
- عند عرض رحلتك في طريقة عرض التصميم، استخدِم حقل النص لوصف كل خطوة في رحلتك. يمكن أن تتضمّن كل خطوة إجراءات وصفية تريد أن ينفّذها Gemini أو تأكيدات تريد أن يقيّمها Gemini.
- اضغط على Enter في لوحة المفاتيح لبدء طلب جديد في الرحلة نفسها. يمكنك تكرار ذلك حسب الحاجة لكل خطوة من رحلة المستخدم التي تريد تحديدها.
نصائح لكتابة الرحلات
يمكن أن يؤدي كتابة رحلاتك بطريقة مفصّلة ومنظَّمة إلى زيادة احتمال تنفيذ Gemini لرحلاتك المقصودة بدقة أكبر وبطريقة أكثر تحديدًا. في ما يلي بعض النصائح لمساعدتك في كتابة رحلاتك بشكل أكثر فعالية: * فصل التأكيدات عن الإجراءات: يقيّم Gemini حالة تطبيقك باستمرار لتحديد ما إذا كان في حالة "صحيحة" لمواصلة الرحلة. ومع ذلك، قد تحتاج إلى تحديد تأكيدات أكثر تعقيدًا كخطوة منفصلة. بالإضافة إلى ذلك، ابدأ كل طلب باستخدام عبارات رئيسية مثل "تأكَّد من أنّ" أو "أكِّد أنّ" أو "تحقَّق من أنّ" لإعلام Gemini بأنّ هذه الخطوة تهدف إلى التأكيد على صحة المعلومات. * توجيه Gemini من خلال التمرير السريع: بالإضافة إلى التفاعلات الأساسية، مثل النقر أو إدخال البيانات باستخدام لوحة المفاتيح، يتيح Gemini تنفيذ إجراءات تتطلّب منه التمرير سريعًا على الشاشة في اتجاهات معيّنة. على سبيل المثال، للتمرير سريعًا خلال المحتوى أو إغلاق بعض عناصر واجهة المستخدم، ما عليك سوى وصف اتجاه التمرير السريع والغرض منه. يتم التمرير سريعًا في Gemini تلقائيًا من وسط الشاشة، ولكن يمكنك توجيهه للتمرير سريعًا في جزء آخر من شاشة الجهاز. * تجنُّب التفاعلات المعقّدة وتغييرات الإعدادات: لا يتيح Gemini حاليًا جميع التفاعلات وتغييرات الإعدادات، مثل الإيماءات المتعددة الأصابع أو تدوير الشاشة أو إجراءات الطي. يعمل الفريق على تحسين إمكانات Gemini.
تشغيل رحلتك
يمكنك تشغيل رحلتك الاختبارية على أي جهاز محلي أو بعيد متاح، تمامًا مثل أي اختبار آخر يتضمّن أدوات، وينشئ Android Studio نتائج غنية بصريًا تساعدك في فهم عملية تنفيذ رحلتك الاختبارية.
لاختبار رحلة، اتّبِع الخطوات التالية:
- اختَر جهازًا مستهدفًا من شريط الأدوات الرئيسي، كما تفعل عند تشغيل اختبار مزوَّد بأدوات.
- انتقِل إلى ملف XML الخاص برحلة المستخدم الذي تريد اختباره وافتحه في المحرِّر.
- في المحرّر، نفِّذ أحد الإجراءات التالية:
- إذا كنت في طريقة عرض التصميم، انقر على
تنفيذ رحلة العميل. - إذا كنت في طريقة العرض الرمز، انقر على
تشغيل في الهامش بجانب المكان الذي تم فيه تحديد اسم الرحلة في ملف XML.
- إذا كنت في طريقة عرض التصميم، انقر على
ينشئ Android Studio إعداد اختبار الرحلات لك ويشغّله على الجهاز المستهدَف. أثناء التنفيذ، ينشئ Android Studio تطبيقك وينشره، ويتصل بـ Gemini لتحديد الإجراءات التي يجب اتّخاذها في كل خطوة من رحلتك.
تظهر أيضًا نتائج محدودة في المحرّر أثناء تنفيذ رحلة، مثل لقطات الشاشة والإجراءات المتّخذة والأسباب أثناء تنفيذ كل خطوة في رحلتك. ما عليك سوى تمرير مؤشر الماوس فوق الصورة المصغّرة في المحرّر للاطّلاع على مزيد من المعلومات. يمكن أن يكون ذلك مفيدًا عند تكرار الطلبات في رحلتك.
عرض النتائج
عندما يكمل Android Studio اختبار رحلة المستخدم، ستظهر لوحة نتائج الاختبار تلقائيًا لعرض النتائج.
مقارنةً بالاختبارات الأخرى التي يتم تنفيذها في Android Studio، هناك بعض الاختلافات في طريقة عرض نتائج الرحلات.
- تقسّم لوحة الاختبارات الرحلة إلى خطوات منفصلة. يمكنك النقر على كل خطوة لمعرفة المزيد من المعلومات حول كيفية تنفيذ Gemini لها.
- تعرض لوحة النتائج معلومات مفصّلة لمساعدتك في فهم الطريقة التي فهم بها Gemini رحلتك واستنتجها، وكيف تم تنفيذها.
- تظهر لقطات الشاشة التي تم إرسالها إلى Gemini كأداة مساعدة مرئية في كل إجراء من الخطوة.
- يتم وصف كل إجراء تم اتخاذه والسبب الذي دفع Gemini إلى اتخاذ هذا الإجراء بجانب كل لقطة شاشة.
- يتم ترقيم كل إجراء في الخطوة.
المشاكل المعروفة
- عند اختبار رحلة مستخدم، يتم منح جميع أذونات تطبيقك تلقائيًا.
- عند اختبار رحلة مستخدم على جهاز يعمل بنظام التشغيل Android 15 (المستوى 35 من واجهة برمجة التطبيقات)، قد يظهر لك تحذير على الجهاز يفيد بأنّه تم حظر تطبيق غير آمن باسم "AndroidX Crawler". يمكنك النقر على التثبيت على أي حال لتخطّي عملية التحقّق هذه. بدلاً من ذلك، يمكنك ضبط خيارات المطوّرين على الجهاز وإيقاف الخيار التحقّق من التطبيقات عبر USB.
- لا تظهر ملفات الرحلات حاليًا في عرض Android في لوحة المشاريع. للاطّلاع على ملفات الرحلة في مشروعك، استخدِم طريقة العرض المشروع.
- إذا كانت إجراءات متعددة ضمن رحلة مستخدم تتشارك في الطلب نفسه بالضبط، قد تكون نتائج الاختبار المعروضة في "محرّر رحلة المستخدم" غير صحيحة. على وجه التحديد، ستعرض جميع الإجراءات التي تتضمّن الطلب المكرّر نتائج الاختبار المرتبطة بأحدث نسخة معدَّلة من هذا الطلب. لحلّ هذه المشكلة، تأكَّد من أنّ كل إجراء يتضمّن طلبًا فريدًا، مثلاً من خلال إضافة بادئة أو لاحقة مميّزة.
- يظهر المربّع المنبثق الخاص بالقلم في المرة الثانية التي يتم فيها تحميل لوحة المفاتيح على محاكي جديد. عادةً ما يؤدي ظهور هذه النافذة المنبثقة إلى تعذُّر إجراء الاختبارات التي تتفاعل مع حقول النص. عند حدوث ذلك، أغلق النافذة المنبثقة وأعِد تشغيل رحلة المستخدم.
- قد تظهر أحيانًا عناصر تطبيق الزاحف في شرح الوكيل.
- يتعذّر أحيانًا تنفيذ الرحلة ويظهر الخطأ
IllegalStateException. عند حدوث ذلك، يمكنك النقر على نتائج الاختبار للاطّلاع على الخطأ الكامل. إذا لم يتم تحديد المكوّن الإضافي لنظام Gradle المتوافق مع Android (
com.android.application) في ملفbuild.gradleذي المستوى الأعلى، قد يظهر لك الخطأ التالي عند تنفيذ رحلة:Failed to apply plugin class 'com.android.tools.journeys.JourneysGradlePlugin'لحلّ هذه المشكلة، تأكَّد من تحديد المكوّن الإضافي في ملف
build.gradleذي المستوى الأعلى. لمزيد من المعلومات، راجِع ضبط نظام إنشاء Android.