मंकीडिवाइस

मंकी रनर क्लास, ऐसा डिवाइस या एम्युलेटर दिखाती है जिसे वर्कस्टेशन की मदद से ऐक्सेस किया जा सकता है monkeyrunner.

इस क्लास का इस्तेमाल, Android डिवाइस या एम्युलेटर को कंट्रोल करने के लिए किया जाता है. ये तरीके, यूज़र इंटरफ़ेस (यूआई) इवेंट भेजते हैं. जानकारी फिर से पाने, ऐप्लिकेशन को इंस्टॉल और हटाने, और ऐप्लिकेशन को चलाने के लिए किया जा सकता है.

आम तौर पर, आपको MonkeyDevice का इंस्टेंस बनाने की ज़रूरत नहीं होती है. इसके बजाय, आप इस्तेमाल किसी डिवाइस के कनेक्शन से नया ऑब्जेक्ट बनाने के लिए MonkeyRunner.waitForConnection() या एम्युलेटर. उदाहरण के लिए, इसका इस्तेमाल करके:

newdevice = MonkeyDevice()

इसका इस्तेमाल करें: 

newdevice = MonkeyRunner.waitForConnection()

खास जानकारी

स्थिरांक
स्ट्रिंग डाउन ऐरो इसका इस्तेमाल इसके type आर्ग्युमेंट के साथ करें press() या touch() DOWN इवेंट भेजने के लिए.
स्ट्रिंग ऊपर इसका इस्तेमाल इसके type आर्ग्युमेंट के साथ करें press() या touch() कोई UP इवेंट भेजने के लिए.
स्ट्रिंग DOWN_AND_UP इसका इस्तेमाल इसके type आर्ग्युमेंट के साथ करें press() या touch() DOWN इवेंट भेजने के बाद तुरंत एक UP इवेंट भेजने के लिए.
माटिंग में इस्तेमाल हुए तरीके
अमान्य ब्रॉडकास्ट इंटेंट (स्ट्रिंग यूआरआई, string कार्रवाई, स्ट्रिंग डेटा, string mimetype, फिर से इस्तेमाल की जा सकने वाली कैटगरी शब्दकोश के अतिरिक्त, कॉम्पोनेंट कॉम्पोनेंट, इटरेबल फ़्लैग)
इस डिवाइस पर इंटेंट को ब्रॉडकास्ट करता है, जैसे कि इंटेंट का इस्तेमाल करें.
अमान्य खींचें (टपल शुरू होता है, टपल खत्म हुआ, फ़्लोट की अवधि, integer चरण)
इस सुविधा की मदद से, डिवाइस की स्क्रीन पर हाथ के जेस्चर (छूकर रखने, और इधर-उधर ले जाने) की सुविधा मिलती है.
ऑब्जेक्ट getप्रॉपर्टी (स्ट्रिंग कुंजी)
सिस्टम एनवायरमेंट वैरिएबल का नाम दिए जाने पर, इस डिवाइस के लिए इसकी वैल्यू दिखाता है. उपलब्ध वैरिएबल के नाम इस तरीके की पूरी जानकारी.
ऑब्जेक्ट getSystemproperty (स्ट्रिंग कुंजी)
. adb shell getprop <key>. This is provided for use by platform developers. के बराबर एपीआई
अमान्य installपैकेज (स्ट्रिंग पाथ)
इस पर PackageFile में मौजूद Android ऐप्लिकेशन या परीक्षण पैकेज इंस्टॉल करता है डिवाइस. अगर ऐप्लिकेशन या परीक्षण पैकेज पहले से इंस्टॉल है, तो उसे बदल दिया जाता है.
शब्दकोश इंस्ट्रुमेंट (string className, शब्दकोश आर्ग्युमेंट)
Android इंस्ट्रुमेंटेशन के तहत, बताए गए कॉम्पोनेंट को चलाता है और नतीजे दिखाता है का सटीक फ़ॉर्मैट तय करता है. कॉन्टेंट बनाने इस डिवाइस में यह कॉम्पोनेंट पहले से मौजूद होना चाहिए.
अमान्य प्रेस (स्ट्रिंग का नाम, शब्दकोश का टाइप)
टाइप के हिसाब से तय किए गए मुख्य इवेंट को, 'की' में भेजता है कीकोड.
अमान्य फिर से चालू करें (इसमें string)
इस डिवाइस को बूटलोडर में फिर से चालू करता है. बूटलोडर ने बूटलोड टाइप के बारे में बताया है.
अमान्य पैकेज हटाएं (स्ट्रिंग पैकेज)
इस डिवाइस से खास पैकेज को मिटाता है. इसमें डेटा और कैश मेमोरी भी शामिल है.
ऑब्जेक्ट शेल (स्ट्रिंग cmd)
adb शेल कमांड लागू करता है और अगर कोई नतीजा मिलता है, तो उसे लौटाता है.
अमान्य startActivity (स्ट्रिंग यूआरआई, string कार्रवाई, स्ट्रिंग डेटा, string mimetype, फिर से इस्तेमाल की जा सकने वाली कैटगरी शब्दकोश के अतिरिक्त, कॉम्पोनेंट कॉम्पोनेंट, फ़्लैग)
इस डिवाइस पर कोई गतिविधि शुरू करता है. इसके लिए, दिए गए तर्क.
MonkeyImage takeSnapshot()
इस डिवाइस के पूरे स्क्रीन बफ़र को कैप्चर करता है, जिससे MonkeyImage ऑब्जेक्ट में मौजूदा डिसप्ले का स्क्रीन कैप्चर है.
अमान्य टच (पूर्णांक x, integer y, पूर्णांक प्रकार)
यह नीति, टाइप के हिसाब से चुने गए टच इवेंट को स्क्रीन पर बताई गई जगह पर भेजती है x और y के हिसाब से.
अमान्य टाइप (स्ट्रिंग मैसेज)
मैसेज में शामिल वर्णों को इस डिवाइस पर भेजता है को डिवाइस के कीबोर्ड पर लिखा गया था. यह कॉल करने के बराबर है message में हर कीकोड के लिए press() मुख्य इवेंट के टाइप DOWN_AND_UP का इस्तेमाल करके.
अमान्य जागना ()
इस डिवाइस की स्क्रीन चालू करता है.

स्थिरांक

स्ट्रिंग नीचे

press() या touch() वैल्यू. इससे पता चलता है कि डिवाइस पर डाउन इवेंट टाइप भेजा जाना चाहिए. बटन को दबाकर या स्क्रीन को छूते हुए दिखाया जा सकता है.

स्ट्रिंग ऊपर की ओर

press() या touch() वैल्यू. इससे पता चलता है कि डिवाइस पर एक यूपी इवेंट टाइप भेजा जाना चाहिए. उंगली से बटन को हटाना या उसे स्क्रीन से ऊपर उठाना.

स्ट्रिंग नीचे

press(), touch() या type() वैल्यू. इससे पता चलता है कि एक डाउन इवेंट टाइप के बाद, एक अप-टू-डेट इवेंट टाइप को किसी कुंजी को टाइप करने या स्क्रीन पर क्लिक करने के हिसाब से डिवाइस.

सार्वजनिक तरीके

अमान्य ब्रॉडकास्ट इंटेंट ( string यूआरआई, string कार्रवाई, string डेटा, string mimetype, इटरेबल कैटगरी शब्दकोश में मौजूद दूसरी चीज़ें, कॉम्पोनेंट कॉम्पोनेंट, इटरेबल फ़्लैग)

इस डिवाइस पर इंटेंट को ब्रॉडकास्ट करता है, जैसे कि इंटेंट का इस्तेमाल करें. इस बारे में ज़्यादा जानने के लिए, Intent पर जाएं आर्ग्युमेंट.

तर्क
यूआरआई इंटेंट का यूआरआई. (Intent.setData() देखें).
ऐक्शन गेम इस इंटेंट के लिए कार्रवाई (Intent.setAction() देखें).
डेटा इस इंटेंट के लिए डेटा यूआरआई (Intent.setData() देखें).
MIME टाइप इंटेंट के लिए MIME टाइप (Intent.setType() देखें).
श्रेणियां बार-बार इस्तेमाल किए जा सकने वाले ऐसे डेटा स्ट्रक्चर में स्ट्रिंग मौजूद होती है जो इसके लिए कैटगरी तय करती है प्रयोजन (देखें Intent.addCategory()).
कुछ और इस इंटेंट के लिए, ज़्यादा डेटा का डिक्शनरी (Intent.putExtra() देखें उदाहरण के लिए).

शब्दकोश के हर आइटम की कुंजी एक string होनी चाहिए. आइटम की वैल्यू कोई भी सामान्य या स्ट्रक्चर्ड डेटा हो सकता है.

घटक इस इंटेंट के लिए कॉम्पोनेंट (ComponentName देखें). इस आर्ग्युमेंट का इस्तेमाल करने पर, इंटेंट को किसी खास क्लास में मौजूद खास क्लास पर भेज दिया जाएगा Android पैकेज.
फ़्लैग बार-बार इस्तेमाल किया जा सकने वाला ऐसा डेटा स्ट्रक्चर जिसमें फ़्लैग शामिल होते हैं. ये फ़्लैग, इंटेंट को हैंडल करने के तरीके को कंट्रोल करते हैं (Intent.setFlags() देखें).

अमान्य खींचें ( टपल शुरू, टपल खत्म, फ़्लोट की अवधि, integer चरण)

इस सुविधा की मदद से, डिवाइस की स्क्रीन पर हाथ के जेस्चर (छूकर रखने, और इधर-उधर ले जाने) की सुविधा मिलती है.

तर्क
शुरू करें टपल के रूप में, खींचने के जेस्चर का शुरुआती पॉइंट (x,y) जहां x और y पूर्णांक हैं.
end टपल (x,y) के रूप में खींचने के जेस्चर का आखिरी पॉइंट जहां x और y पूर्णांक हैं.
कुल समय खींचकर छोड़ने के जेस्चर की अवधि (सेकंड में). डिफ़ॉल्ट समय 1.0 सेकंड होता है.
कदम इंटरपोलेट करते समय उठाए जाने वाले कदमों की संख्या. डिफ़ॉल्ट संख्या 10 है.

ऑब्जेक्ट getप्रॉपर्टी (string कुंजी)

सिस्टम एनवायरमेंट वैरिएबल का नाम दिए जाने पर, इस डिवाइस के लिए इसकी वैल्यू दिखाता है.

तर्क
कुंजी सिस्टम एनवायरमेंट वैरिएबल का नाम. उपलब्ध वैरिएबल के नाम यहां दिए गए हैं टेबल 1. प्रॉपर्टी वैरिएबल के नाम के बारे में लेख पढ़ें.
रिटर्न
  • वैरिएबल की वैल्यू. डेटा का फ़ॉर्मैट, अनुरोध किए गए वैरिएबल के हिसाब से अलग-अलग होता है.

ऑब्जेक्ट getSystemPolicy (string कुंजी)

getProperty() का समानार्थी शब्द.

तर्क
कुंजी सिस्टम एनवायरमेंट वैरिएबल का नाम. उपलब्ध वैरिएबल के नाम यहां दिए गए हैं टेबल 1. प्रॉपर्टी वैरिएबल के नाम.
रिटर्न
  • वैरिएबल की वैल्यू. डेटा का फ़ॉर्मैट, अनुरोध किए गए वैरिएबल के हिसाब से अलग-अलग होता है.

अमान्य installपैकेज (string पाथ)

PackageFile में शामिल Android ऐप्लिकेशन या परीक्षण पैकेज को इंस्टॉल करता है इस डिवाइस पर. अगर ऐप्लिकेशन या परीक्षण पैकेज पहले से इंस्टॉल है, तो वह बदला गया.

तर्क
पथ इंस्टॉल की जाने वाली .apk फ़ाइल का पूरी तरह क्वालिफ़ाइड पाथ और फ़ाइल का नाम.

शब्दकोश इंस्ट्रुमेंट ( string className, शब्दकोश आर्ग)

बताए गए कॉम्पोनेंट को Android इंस्ट्रुमेंटेशन के साथ चलाता है और नतीजे दिखाता है का सटीक फ़ॉर्मैट तय करता है. कॉन्टेंट बनाने इस डिवाइस में यह कॉम्पोनेंट पहले से मौजूद होना चाहिए.

Android की किसी एक टेस्ट केस क्लास का इस्तेमाल करने वाले टेस्ट केस को शुरू करने के लिए, इस तरीके का इस्तेमाल करें. जांच करें Android टेस्टिंग की मदद से यूनिट टेस्टिंग के बारे में ज़्यादा जानने के लिए, बुनियादी बातें फ़्रेमवर्क शामिल है.

तर्क
क्लास का नाम उस Android कॉम्पोनेंट का नाम जो इस डिवाइस पर पहले से इंस्टॉल है, स्टैंडर्ड फ़ॉर्म Packagename/classname, जहां Packagename यह है इस डिवाइस पर मौजूद .apk फ़ाइल के Android पैकेज का नाम, और क्लास का नाम, एक Android कॉम्पोनेंट (गतिविधि, ContentProvider, Service या BroadcastReceiver) शामिल करेंगे. दोनों पैकेज का नाम और क्लास का नाम पूरी तरह क्वालिफ़ाइड होना चाहिए. यहां जाएं: ज़्यादा जानकारी के लिए, ComponentName.
आर्ग्युमेंट एक डिक्शनरी जिसमें फ़्लैग और उनकी वैल्यू शामिल हैं. इन्हें कॉम्पोनेंट में पास किया जाता है, जैसे कि शुरू हो गया है. अगर फ़्लैग कोई मान नहीं लेता है, तो उसके शब्दकोश मान को खाली पर सेट करें स्ट्रिंग.
रिटर्न

  • एक डिक्शनरी, जिसमें कॉम्पोनेंट का आउटपुट शामिल होता है. शब्दकोश का कॉन्टेंट कॉम्पोनेंट से तय होती हैं.

    अगर InstrumentationTestRunner का इस्तेमाल क्लास के नाम के तौर पर किया जाता है कॉम्पोनेंट का नाम डालें, तो नतीजे के शब्दकोश में यह शामिल होता है तो "स्ट्रीम" पर ही क्लिक करें. "stream" का मान एक स्ट्रिंग में शामिल है कोई परीक्षण आउटपुट, जैसे कि InstrumentationTestRunner को कमांड लाइन लिखें. इस आउटपुट के फ़ॉर्मैट के बारे में इसमें बताया गया है अन्य IDE में टेस्ट करना.

अमान्य प्रेस (string का नाम, पूर्णांक प्रकार)

type के तय किए गए मुख्य इवेंट को, 'की' में भेजता है keycode.

तर्क
नाम भेजे जाने वाले कीकोड का नाम. इनकी सूची के लिए KeyEvent पर जाएं कीकोड नाम. पासकोड के नाम का इस्तेमाल करें, न कि पूर्णांक वैल्यू का.
टाइप भेजे जाने वाले मुख्य इवेंट का टाइप. DOWN, UP, और वैल्यू ही डाली जा सकती हैं DOWN_AND_UP.

अमान्य फिर से चालू करें (string बूटलोड टाइप)

इस डिवाइस को bootloadType के बताए गए बूटलोडर में फिर से चालू करता है.

तर्क
में उस बूटलोडर का टाइप जिसमें फिर से चालू किया जाना है. स्वीकार की गई वैल्यू ये हैं "बूटलोडर", "रिकवरी" या "कोई नहीं".

अमान्य पैकेज हटाएं (string पैकेज)

इस डिवाइस से खास पैकेज को मिटाता है. इसमें डेटा और कैश मेमोरी भी शामिल है.

तर्क
पैकेज इस डिवाइस पर मौजूद .apk फ़ाइल का Android पैकेज नाम.

ऑब्जेक्ट शेल (string cmd)

adb शेल कमांड लागू करता है और अगर कोई नतीजा मिलता है, तो उसे लौटाता है.

तर्क
cmd adb शेल में एक्ज़ीक्यूट किया जाने वाला निर्देश. इन निर्देशों का रूप यह है Android डीबग ब्रिज.
रिटर्न
  • निर्देश के नतीजे (अगर कोई हों). नतीजों का फ़ॉर्मैट आदेश.

अमान्य startActivity ( string यूआरआई, string कार्रवाई, string डेटा, string mimetype, इटरेबल कैटगरी शब्दकोश में मौजूद दूसरी चीज़ें, कॉम्पोनेंट कॉम्पोनेंट, इटरेबल फ़्लैग)

इस डिवाइस पर कोई गतिविधि शुरू करता है. इसके लिए, दिए गए तर्क.

तर्क
यूआरआई इंटेंट का यूआरआई. (Intent.setData() देखें).
ऐक्शन गेम इंटेंट के लिए कार्रवाई (Intent.setAction() देखें).
डेटा इंटेंट के लिए डेटा यूआरआई (Intent.setData() देखें).
MIME टाइप इंटेंट के लिए MIME टाइप (Intent.setType() देखें).
श्रेणियां बार-बार इस्तेमाल की जा सकने वाली ऐसी डेटा संरचना जिसमें स्ट्रिंग मौजूद होती हैं. ये स्ट्रिंग, प्रयोजन (देखें Intent.addCategory()).
कुछ और इंटेंट के लिए ज़्यादा डेटा का डिक्शनरी (देखें Intent.putExtra() अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है उदाहरण के लिए).

शब्दकोश के हर आइटम की कुंजी एक string होनी चाहिए. आइटम की वैल्यू कोई भी सामान्य या स्ट्रक्चर्ड डेटा हो सकता है.

घटक इंटेंट के लिए कॉम्पोनेंट (ComponentName देखें). इस आर्ग्युमेंट का इस्तेमाल करने पर, किसी खास Android पैकेज में किसी खास क्लास के लिए इंटेंट.
फ़्लैग बार-बार इस्तेमाल किया जा सकने वाला ऐसा डेटा स्ट्रक्चर जिसमें फ़्लैग शामिल होते हैं. ये फ़्लैग, इंटेंट को हैंडल करने के तरीके को कंट्रोल करते हैं (Intent.setFlags() देखें).

MonkeyImage takeSnapshot ()

इस डिवाइस के पूरे स्क्रीन बफ़र को कैप्चर करता है, जिससे मौजूदा डिसप्ले का स्क्रीन कैप्चर.

रिटर्न
  • उ MonkeyImage ऑब्जेक्ट में मौजूदा डिस्प्ले की इमेज है.

अमान्य टच ( integer x, integer y, string टाइप)

यह नीति, टाइप के हिसाब से चुने गए टच इवेंट को स्क्रीन पर बताई गई जगह पर भेजती है x और y के हिसाब से.

तर्क
x असल डिवाइस पिक्सल में टच की हॉरिज़ॉन्टल पोज़िशन, जिसकी बाईं ओर से शुरू होती है स्क्रीन उसके वर्तमान ओरिएंटेशन में.
y असल डिवाइस पिक्सल में टच की वर्टिकल पोज़िशन, ऊपर से शुरू होती है स्क्रीन उसके वर्तमान ओरिएंटेशन में.
टाइप भेजे जाने वाले मुख्य इवेंट का टाइप. DOWN, UP, और वैल्यू ही डाली जा सकती हैं DOWN_AND_UP.

अमान्य टाइप (string मैसेज)

मैसेज में शामिल वर्णों को इस डिवाइस पर भेजता है को डिवाइस के कीबोर्ड पर लिखा गया था. यह कॉल करने के बराबर है message में हर कीकोड के लिए press() मुख्य इवेंट के टाइप DOWN_AND_UP का इस्तेमाल करके.

तर्क
ग्राहक का मैसेज इस स्ट्रिंग में भेजे जाने वाले वर्ण होते हैं.

अमान्य जागना ()

इस डिवाइस की स्क्रीन चालू करता है.

अन्य जानकारी

टेबल 1.प्रॉपर्टी वैरिएबल के नाम, जिनके साथ इस्तेमाल किए जाते हैं getप्रॉपर्टी() और getSystemproperty().

प्रॉपर्टी ग्रुप प्रॉपर्टी ब्यौरा नोट
build board डिवाइस के सिस्टम बोर्ड के लिए कोड का नाम Build देखें
brand वह कैरियर या सेवा देने वाली कंपनी जिसके लिए OS को पसंद के मुताबिक बनाया गया है.
device डिवाइस के डिज़ाइन का नाम.
fingerprint मौजूदा समय में चल रहे बिल्ड के लिए यूनीक आइडेंटिफ़ायर.
host
ID चेंजलिस्ट नंबर या लेबल.
model डिवाइस का असली उपयोगकर्ता को दिखने वाला नाम.
product प्रॉडक्ट का पूरा नाम.
tags बिल्ड के बारे में जानकारी देने वाले कॉमा लगाकर अलग किए गए टैग, जैसे कि "बिना साइन वाले" और "डीबग".
type बिल्ड टाइप, जैसे कि "उपयोगकर्ता" या "eng".
user
CPU_ABI नेटिव कोड वाले निर्देश सेट का नाम. इसे सीपीयू टाइप के तौर पर और फ़ॉर्म में इस्तेमाल किया जाता है एबीआई कन्वेंशन.
manufacturer प्रॉडक्ट/हार्डवेयर मैन्युफ़ैक्चरर.
version.incremental इस वर्शन को दिखाने के लिए सोर्स कंट्रोल सिस्टम में इस्तेमाल किया गया इंटरनल कोड एक समस्या है.
version.release सॉफ़्टवेयर के इस वर्शन का उपयोगकर्ता को दिखाई देने वाला नाम.
version.sdk ओएस के इस वर्शन से जुड़े, उपयोगकर्ता को दिखने वाला SDK टूल.
version.codename मौजूदा डेवलपमेंट कोडनेम या "REL" अगर सॉफ़्टवेयर का यह वर्शन रिलीज़ किया गया.
display width पिक्सल में डिवाइस के डिसप्ले की चौड़ाई. यहां जाएं: ज़्यादा जानकारी के लिए, DisplayMetrics.
height पिक्सल में डिवाइस की डिसप्ले ऊंचाई.
density डिसप्ले का लॉजिकल सघनता. यह एक ऐसा फ़ैक्टर है, जो डिवाइस के रिज़ॉल्यूशन में डीआईपी (डेंसिटी-इंडिपेंडेंट पिक्सल) यूनिट का इस्तेमाल करें. DIP को समायोजित किया गया कि 1 डीआईपी, 160 पिक्सल-प्रति-इंच डिसप्ले पर एक पिक्सल के बराबर होता है. उदाहरण के लिए, 160-डीपीआई स्क्रीन पर, सघनता = 1.0 होती है. वहीं, 120 डीपीआई स्क्रीन पर डेंसिटी = .75 होती है.

वैल्यू, स्क्रीन के असल साइज़ के हिसाब से नहीं है. हालांकि, इसे इस तरह अडजस्ट किया गया है डिस्प्ले DPI में बड़े बदलावों के अनुरूप हैं. यहां जाएं: ज़्यादा जानकारी के लिए, density.

am.current package मौजूदा समय में चल रहे पैकेज के Android पैकेज का नाम. am.current बटन, इस समय चल रहे इवेंट के बारे में जानकारी देते हैं गतिविधि.
action मौजूदा गतिविधि की कार्रवाई. इसका फ़ॉर्मैट name जैसा ही है किसी पैकेज मेनिफ़ेस्ट में action एलिमेंट की विशेषता शामिल करता है.
comp.class मौजूदा ऐक्टिविटी शुरू करने वाले कॉम्पोनेंट की क्लास का नाम. यहां जाएं: ज़्यादा जानकारी के लिए, comp.package.
comp.package मौजूदा ऐक्टिविटी शुरू करने वाले कॉम्पोनेंट का पैकेज नाम. एक कॉम्पोनेंट पैकेज के नाम और पैकेज में मौजूद क्लास के नाम से तय होता है.
data मौजूदा ऐक्टिविटी को शुरू करने वाले इंटेंट में मौजूद डेटा (अगर कोई हो).
categories मौजूदा गतिविधि को शुरू करने वाले इंटेंट से तय की गई कैटगरी.
clock realtime डिवाइस को फिर से चालू होने के बाद से, मिलीसेकंड की संख्या. इसमें, गहरी नींद में सोना भी शामिल है समय. ज़्यादा जानकारी के लिए, SystemClock पर जाएं.
uptime डिवाइस को फिर से चालू करने के बाद से, मिलीसेकंड की संख्या. इसमें ये शामिल नहीं हैं गहरी नींद का समय
millis UNIX epoch के बाद से मौजूदा समय, मिलीसेकंड में.