ورودی Android

با انجام اشاره‌ها و رویدادهای کلیدی روی عناصر میانای کاربر، با برنامه‌های Android تعامل برقرار کنید.

کاربرد

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

گزینه‌ها

  • --device=PARAM - شماره سریال دستگاه یا شناسه شبیه‌ساز (همان‌طور که توسط «adb devices» گزارش شده است).
  • -h,--help - پیام راهنما را برای فرمان مشخص‌شده نشان می‌دهد.

android گزینه:

  • --sdk=PARAM - مسیر کیت توسعه نرم‌افزار 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 است که با کاما از هم جدا شده‌اند و ویژگی‌هایی را مشخص می‌کند که عنصر هدف باید داشته باشد. انتخاب‌کننده‌ها را در علامت نقل‌قول تکی قرار دهید تا از تفسیر فاصله‌ها، کاماها، یا نویسه‌های خاص توسط پوسته جلوگیری شود.

انتخابگرها با سلسله‌مراتب گره دسترس‌پذیری زنده برنامه مطابقت دارند:

  • ویژگی‌های رشته: به‌طور پیش‌فرض به‌عنوان زیررشته‌های غیرحساس به حروف بزرگ و کوچک مطابقت داده می‌شود (برای مثال، text=submit با «Submit order» (ارسال سفارش) مطابقت دارد). * را ارسال کنید تا با هر عنصری که مقدار غیرخالی برای آن ویژگی دارد مطابقت داشته باشد. برای مطابقت دادن مقدار، آن را در خط مورب قرار دهید تا به‌عنوان عبارت باقاعده حساس به حروف بزرگ و کوچک با هر بخشی از مقدار مطابقت داشته باشد (برای مثال، 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 را ارسال کنید.
  • 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