ميزة "المسارات" في "استوديو Android"

يساعد إنشاء رحلات في Android Studio على تسهيل كتابة الاختبارات الشاملة وصيانتها، وذلك من خلال السماح لك باستخدام اللغة الطبيعية لوصف الخطوات والتأكيدات لكل اختبار، ويُعرف ذلك باسم الرحلة. من خلال الاستفادة من إمكانات Gemini في الرؤية والاستدلال، يتم تحويل الخطوات المكتوبة باللغة الطبيعية إلى إجراءات ينفّذها Gemini في تطبيقك، ما يجعل رحلات المستخدمين سهلة الكتابة والفهم. بالإضافة إلى ذلك، يمكنك كتابة وصف لتأكيدات أكثر تعقيدًا، ويقيّمها Gemini استنادًا إلى ما يراه على الجهاز لتحديد ما إذا كانت رحلاتك ناجحة أم لا.

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

يمكنك كتابة الرحلات وتنفيذها مباشرةً من Android Studio على أي جهاز محلي أو بعيد يعمل بنظام التشغيل Android. توفّر بيئة التطوير المتكاملة تجربة محرّر جديدة لتصميم الرحلات، بالإضافة إلى نتائج غنية بصريًا تساعدك في فهم طريقة تفكير Gemini وتنفيذه لرحلتك بشكل أفضل.

كتابة رحلة

يوفّر "استوديو Android" نموذج ملف وتجربة محرِّر جديدة تسهّل إنشاء رحلات المستخدمين وتعديلها. تتم كتابة الرحلات باستخدام بنية لغة الترميز القابلة للتوسيع (XML) لتنظيم وصف الرحلة وخطواتها.

لإنشاء رحلة وبدء تعديلها، اتّبِع الخطوات التالية:

1. من لوحة المشروع في "استوديو Android"، انقر بزر الماوس الأيمن على وحدة التطبيق التي تريد كتابة رحلة لها.
2. انقر على جديد > اختبار > ملف رحلة.
3. في مربّع الحوار الذي يظهر، أدخِل اسم رحلتك ووصفها.
4. انقر على موافق. ينشئ "استوديو Android" ملف XML لرحلتك بالاسم الذي اخترته. يمكنك استخدام طريقة عرض الرمز لتعديل XML مباشرةً، أو طريقة عرض التصميم للحصول على تجربة تعديل محسّنة.
5. عند عرض رحلتك في طريقة عرض التصميم، استخدِم حقل النص لوصف كل خطوة في رحلتك. يمكن أن تتضمّن كل خطوة إجراءات وصفية تريد أن ينفّذها Gemini أو تأكيدات تريد أن يقيّمها Gemini.
6. اضغط على Enter في لوحة المفاتيح لبدء طلب جديد في الرحلة نفسها. يمكنك تكرار ذلك حسب الحاجة لكل خطوة من رحلة المستخدم التي تريد تحديدها.

نصائح لكتابة الرحلات

يمكن أن يؤدي كتابة رحلاتك بطريقة مفصّلة ومنظَّمة إلى زيادة احتمال تنفيذ Gemini للرحلات التي تريدها بدقة وبطريقة أكثر تحديدًا. في ما يلي بعض النصائح لمساعدتك في كتابة رحلاتك بشكل أكثر فعالية:

• فصل التأكيدات عن الإجراءات: يقيّم Gemini باستمرار حالة تطبيقك لتحديد ما إذا كانت الحالة "صحيحة" لمواصلة الرحلة. ومع ذلك، قد تحتاج إلى تحديد تأكيدات أكثر تعقيدًا كخطوة منفصلة. بالإضافة إلى ذلك، ابدأ كل طلب باستخدام عبارات رئيسية مثل "تأكَّد من أنّ" أو "أكِّد أنّ" أو "تحقَّق من أنّ" للإشارة إلى Gemini بأنّ هذه الخطوة تهدف إلى التأكيد.
• توجيه Gemini من خلال التمرير السريع: بالإضافة إلى التفاعلات الأساسية، مثل النقر أو إدخال البيانات باستخدام لوحة المفاتيح، يتيح Gemini إجراءات تتطلّب منه التمرير سريعًا على الشاشة في اتجاهات معيّنة. على سبيل المثال، للتمرير سريعًا خلال المحتوى أو إغلاق بعض عناصر واجهة المستخدم، عليك وصف اتجاه التمرير السريع والغرض منه. يتم التمرير سريعًا في Gemini تلقائيًا من وسط الشاشة، ولكن يمكنك تحديد جزء آخر من شاشة الجهاز للتمرير سريعًا منه.
• تجنُّب التفاعلات المعقّدة وتغييرات الإعدادات: لا يتيح Gemini جميع التفاعلات وتغييرات الإعدادات، مثل الإيماءات المتعددة الأصابع أو تدوير الشاشة أو إجراءات الطي. يعمل الفريق على تحسين إمكانات Gemini.

تشغيل رحلتك

يمكنك تشغيل رحلتك على أي جهاز محلي أو بعيد متاح، تمامًا مثل أي اختبار آخر مزوّد بأدوات، وينشئ Android Studio نتائج غنية بصريًا تساعدك في فهم تنفيذ رحلتك.

لاختبار رحلة، اتّبِع الخطوات التالية:

1. اختَر جهازًا مستهدفًا من شريط الأدوات الرئيسي، كما تفعل عند تشغيل اختبار مزوَّد بأدوات.
2. انتقِل إلى ملف XML الخاص برحلة المستخدم الذي تريد اختباره وافتحه في المحرِّر.
3. في المحرِّر، نفِّذ أحد الإجراءات التالية:
   1. إذا كنت في طريقة عرض التصميم، انقر على تنفيذ رحلة العميل.
   2. إذا كنت في طريقة عرض الرمز، انقر على تشغيل test في الهامش بجانب المكان الذي تم فيه تحديد اسم الرحلة في ملف XML.

ينشئ "استوديو Android" إعداد اختبار الرحلات ويشغّله على الجهاز المستهدَف. أثناء التنفيذ، ينشئ Android Studio تطبيقك وينشره، ويتواصل مع Gemini لتحديد الإجراءات التي يجب اتّخاذها في كل خطوة من خطوات رحلتك.

مرِّر مؤشر الماوس فوق الصورة المصغّرة في المحرّر للاطّلاع على مزيد من المعلومات. يمكن أن يكون ذلك مفيدًا عند تكرار الطلبات في رحلتك.

عرض النتائج

عندما يكمل "استوديو Android" اختبار رحلة المستخدم، ستظهر لوحة نتائج الاختبار تلقائيًا لعرض النتائج.

مقارنةً بالاختبارات المزوّدة بأدوات التي يمكنك إجراؤها في "استوديو Android"، هناك بعض الاختلافات في طريقة عرض نتائج الرحلات.

• تعرض لوحة الاختبارات الرحلة على شكل خطوات منفصلة. يمكنك النقر على كل خطوة لمعرفة المزيد من المعلومات حول كيفية تنفيذ 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.