यूज़र इंटरफ़ेस (यूआई) एलिमेंट पर जेस्चर और मुख्य इवेंट का इस्तेमाल करके, Android ऐप्लिकेशन के साथ इंटरैक्ट करना.
इस्तेमाल
android input [-h] [--device=PARAM]
विकल्प
--device=PARAM- डिवाइस का सीरियल नंबर या एम्युलेटर आईडी (जैसा कि 'adb devices' ने बताया है).-h,--help- इससे दिए गए निर्देश के लिए, सहायता मैसेज दिखता है.
android के लिए विकल्प:
--sdk=PARAM- Android SDK का पाथ.-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>टाइप करता है. टाइप करने के बाद, Enter/OK बटन दबाने का इवेंट भेजने के लिए,--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