إدخال Android

يمكنك التفاعل مع تطبيقات Android من خلال تنفيذ الإيماءات والأحداث الرئيسية على عنصر في واجهة المستخدم.

الاستخدام

android input [-h] [--device=PARAM]

الخيارات

  • ‫--device=PARAM: الرقم التسلسلي للجهاز أو رقم تعريف المحاكي (كما يظهر في "أجهزة adb")
  • ‫-h,--help: يعرض رسالة المساعدة للطلب المحدّد.

‫android خيارات:

  • ‫--sdk=PARAM: المسار إلى حزمة تطوير البرامج (SDK) لنظام التشغيل Android
  • ‫-v,--verbose: لتفعيل الإخراج المطوَّل لتحديد المشاكل وحلّها
  • ‫‎-V,--version: لطباعة معلومات الإصدار والخروج

الأوامر الفرعية

  • key: اضغط على زر الجهاز أو مفتاح تنقّل أو رمز مفتاح Android.
  • ‫scroll: تتيح هذه الدالة الانتقال للأسفل في عنصر حاوية، ويمكنك اختياريًا الانتقال إلى أن يظهر عنصر مستهدَف.
  • swipe: مرِّر سريعًا من عنصر في واجهة المستخدم يتطابق مع أداة اختيار في اتجاه معيّن.
  • ‫tap: انقر على عنصر في واجهة المستخدم يتطابق مع أداة اختيار.
  • ‫text: كتابة نص في عنصر في واجهة المستخدم يتطابق مع أداة اختيار

الوصف

تنفّذ أداة android input تفاعلات المستخدمين وإدخالات الأجهزة على جهاز أو محاكي متصل يعمل بنظام التشغيل Android.

يمكن لوكلاء الذكاء الاصطناعي والنصوص البرمجية للاختبار استخدام android input مع android layout أو android screen لاكتشاف عناصر في واجهة المستخدم والتفاعل معها باستخدام الإيماءات أو ضغطات المفاتيح.

أدوات اختيار عناصر واجهة المستخدم

تستهدف معظم الأوامر الفرعية في input عناصر في واجهة المستخدم باستخدام تعبير محدّد. أداة الاختيار هي قائمة قيم مفصولة بفاصلة من أزواج key=value أو key:value تحدّد السمات التي يجب أن يستوفيها العنصر المستهدَف. يجب وضع أدوات الاختيار بين علامات اقتباس مفردة لمنع تفسير shell للمسافات أو الفواصل أو الأحرف الخاصة.

تتم مطابقة أدوات الاختيار مع التسلسل الهرمي لعُقد أدوات تسهيل الاستخدام المباشرة في التطبيق:

  • سمات السلسلة: تتم مطابقتها كسلاسل فرعية غير حساسة لحالة الأحرف تلقائيًا (على سبيل المثال، يتطابق text=submit مع "إرسال الطلب"). يمكنك تمرير * لمطابقة أي عنصر بقيمة غير فارغة لتلك السمة. يمكنك إحاطة القيمة بشرطات مائلة لمطابقتها كتعبير عادي حسّاس لحالة الأحرف يمكن أن يطابق أي جزء من القيمة (مثلاً، text=/^Submit$/). يمكنك إضافة العلامة i بعد الشرطة المائلة الختامية للحصول على تعبير عادي غير حسّاس لحالة الأحرف (مثلاً، text=/^submit$/i). لا تؤدي الفواصل داخل التعبير العادي إلى تقسيم المحدِّد. لمطابقة نص حرفي يبدأ بـ /، استخدِم تعبيرًا عاديًا مثل text=/^\/help/.
    • ‫text (المرادف: txt): النص المرئي المعروض على العنصر.
    • ‫id (مرادف: res): اسم رقم تعريف مورد العرض (على سبيل المثال، id=submit_button أو اسم المورد الكامل com.example.app:id/submit_button).
    • ‫class (المرادفات: clazz وcls وclz): اسم فئة العنصر أو اسم الفئة البسيط (مثل class=Button أو android.widget.Button)
    • ‫desc (مرادف: content): وصف محتوى تسهيل الاستخدام
  • سمات التفاعل: تتم مطابقتها كقيم منطقية (true أو false).
    • ‫clickable (مرادف: click): يشير إلى ما إذا كان يمكن النقر على العنصر.
    • ‫checkable: تشير إلى ما إذا كان يمكن وضع علامة في مربّع الاختيار أو تبديل حالته.
    • ‫scrollable (مرادف: scroll): يشير إلى ما إذا كان العنصر حاوية قابلة للتمرير.
    • ‫focusable: تشير إلى ما إذا كان يمكن التركيز على العنصر.
    • ‫longclickable (مرادف: longclick): يشير إلى ما إذا كان العنصر يتيح النقرات الطويلة.
  • سمات الحالة: تتم مطابقتها كقيم منطقية (true أو false).
    • ‫checked: تشير إلى ما إذا كان العنصر محدّدًا حاليًا.
    • ‫focused: تشير هذه السمة إلى ما إذا كان التركيز في الوقت الحالي على هذا العنصر.
    • ‫selected: تشير إلى ما إذا كان العنصر محدّدًا حاليًا.

سلوك المطابقة (--match)

عندما يتطابق أحد أدوات الاختيار مع أكثر من عنصر على الشاشة:

  • --match=single (تلقائي): يتعذّر تنفيذ الإجراء مع ظهور رسالة خطأ وإدراج جميع العناصر المطابقة، ما يضمن عدم تفعيل التفاعلات لمكوّن واجهة المستخدم غير الصحيح.
  • ‫--match=first: يتفاعل مع أول عنصر مطابق في التسلسل الهرمي لواجهة المستخدم.

الإيماءات والطلبات المتاحة

  • ‫tap <target>: للنقر على منتصف العنصر المستهدَف
  • ‫text <string> <target>: يمحو النص الحالي ويكتب <string> في العنصر المستهدَف. مرِّر --submit لإرسال حدث مفتاح Enter/OK بعد الكتابة.
  • ‫scroll <target>: يمرّر عنصر حاوية في اتجاه محدّد (--dir=up|down|left|right). استخدِم --until=<selector> لمواصلة التمرير إلى أن يظهر عنصر مطابق.
  • ‫swipe <target>: لتنفيذ إيماءة تمرير سريع تبدأ من <target> في اتجاه (--dir=up|down|left|right)، مع --distance اختياري (جزء من الشاشة) و--speed (وحدات بكسل في الثانية).
  • key <key>: لإرسال حدث زر أو مفتاح في الجهاز (مثل back أو home أو recents أو power أو volume-up أو volume-down أو enter أو tab أو esc أو رمز مفتاح Android صحيح). يسمح باستخدام علامات التعديل --shift و--alt و--ctrl.

تحديد جهاز مستهدَف (--device)

في حال توصيل أجهزة أو محاكيات متعددة، يمكنك تمرير --device=<serial-number> (كما هو موضّح في adb devices) لتوجيه أحداث الإدخال إلى جهاز معيّن.

أمثلة

انقر على زر من خلال النص الظاهر عليه:

android input tap 'text=Submit'

انقر على عنصر يتطابق مع سمات متعددة:

android input tap 'id=submit_btn,class=Button,clickable=true'

النقر على العنصر المطابق الأول عند توفّر عدة عناصر مطابقة:

android input tap --match=first 'class=android.widget.TextView'

اكتب نصًا في حقل إدخال وأرسِله:

android input text 'user@example.com' 'id=email_input' --submit

انتقِل للأسفل في حاوية إلى أن يظهر عنصر:

android input scroll 'id=recycler_view' --dir=down --until='text=Settings'

مرِّر سريعًا لليمين على عنصر بطاقة:

android input swipe 'id=card_view' --dir=left

اضغط على زر الرجوع في الجهاز:

android input key back