جهاز MonkeyDevice

يشير هذا المصطلح إلى فئة من monkeyrunner تمثّل جهازًا أو محاكيًا يمكن الوصول إليهما من خلال محطة العمل قيد التشغيل. 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 مباشرةً.

الطرق
فراغ	broadcastIntent (معرّف الموارد المنتظم (URI) للسلسلة string، سلسلة البيانات، سلسلة mimetype، فئات قابلة للتكرار القواميس الإضافية، لمكون المكون، العلامات القابلة للتكرار) لبثّ Intent على هذا الجهاز، كما لو كان Intent صادرًا من التطبيق.
فراغ	سحب (بدء الصف نهاية الصف، float. integer خطوة) يحاكي هذا التطبيق إيماءة السحب (اللمس مع الاستمرار والتحريك) على شاشة هذا الجهاز.
كائن	getProperty (مفتاح سلسلة) يتم عرض قيمته لهذا الجهاز استنادًا إلى اسم متغيّر بيئة النظام. يتم سرد أسماء المتغيرات المتوفرة في وصف مفصل لهذه الطريقة.
كائن	getSystemProperty (مفتاح سلسلة) . ما يعادل adb shell getprop <key>. This is provided for use by platform developers. من واجهة برمجة التطبيقات
فراغ	installPackage (مسار سلسلة) تثبيت تطبيق Android أو حزمة الاختبار المضمّنة في packageFile على هذا الخاص بك. إذا سبق تثبيت التطبيق أو حزمة الاختبار، سيتم استبدالهما.
القواميس	الآلة الموسيقية (string className، القاموس) تشغيل المكوِّن المحدد ضمن أداة Android، وعرض النتائج في القاموس الذي يتم تحديد تنسيقه بدقة حسب المكون الذي يتم تشغيله. تشير رسالة الأشكال البيانية يجب أن يكون هذا العنصر موجودًا من قبل على هذا الجهاز.
فراغ	الصحافة (اسم السلسلة، القاموس) إرسال الحدث الرئيسي المحدد حسب النوع إلى المفتاح المحدد من خلال .
فراغ	إعادة التشغيل (سلسلة في) يؤدي هذا الإجراء إلى إعادة تشغيل هذا الجهاز في برنامج الإقلاع الذي يحدّده نوع التحميل.
فراغ	removePackage (إزالة حزمة) (حزمة string) لحذف الحزمة المحدّدة من هذا الجهاز، بما في ذلك بياناتها وذاكرة التخزين المؤقت الخاصة بها
كائن	واجهة أوامر (سلسلة cmd) لتنفيذ أمر Shell adb وعرض النتيجة، إن وجدت.
فراغ	startActivity (معرّف الموارد المنتظم (URI) للسلسلة string، سلسلة البيانات، سلسلة mimetype، فئات قابلة للتكرار القواميس الإضافية، لمكون المكون، بلاغات) لبدء نشاط على هذا الجهاز عن طريق إرسال هدف تم إنشاؤه من الوسيطات المقدمة.
MonkeyImage	takeSnapshot() يلتقط المخزن المؤقت للشاشة بأكمله هذا الجهاز، مما يؤدي إلى عنصر واحد ( MonkeyImage ) يحتوي على لقطة شاشة للعرض الحالي.
فراغ	لمس (عدد صحيح x، integer y، integer) يتم إرسال حدث لمس محدّد حسب النوع إلى المكان المحدّد على الشاشة. في س و ص.
فراغ	النوع (رسالة سلسلة) لإرسال الأحرف المضمَّنة في الرسالة إلى هذا الجهاز، كما لو كانت تمت كتابتها على لوحة مفاتيح الجهاز. يعادل ذلك الاتصال press() لكل رمز مفتاح في message باستخدام نوع الحدث الرئيسي DOWN_AND_UP.
فراغ	تنشيط () لتنشيط شاشة هذا الجهاز.

الثوابت

سلسلة الأسفل

press() أو touch(). تحدِّد هذه السياسة أنّه يجب إرسال نوع حدث "أسفل" إلى الجهاز، وذلك وفقًا لما يلي: الضغط مع الاستمرار على مفتاح أو لمس الشاشة.

سلسلة أعلى

press() أو touch(). تحدِّد هذه السياسة أنّه يجب إرسال نوع حدث UP إلى الجهاز، وذلك حسب تحرير مفتاح أو رفعه من الشاشة.

سلسلة أسفل_و_لأعلى

press(), touch() أو القيمة type(). لتحديد أنه يجب إرسال نوع حدث "أسفل" (DOWN) متبوعًا بنوع حدث UP إلى جهاز، بما يتوافق مع كتابة مفتاح أو النقر على الشاشة.

الطرق العامة

فراغ broadcastIntent ( معرّف الموارد المنتظم string، الإجراء string، بيانات سلسلة سلسلة mimetype، فئات قابلة للتكرار القواميس الإضافية المكون، العلامات القابلة للتكرار)

لبثّ Intent على هذا الجهاز، كما لو كان Intent صادرًا من التطبيق. يمكنك الاطّلاع على Intent للحصول على مزيد من المعلومات حول الوسيطة.

الوسيطات

معرّف موارد منتظم (URI)	معرّف الموارد المنتظم (URI) لـ Intent (اطّلِع على Intent.setData()).
إجراء	الإجراء الخاص بـ Intent (اطّلِع على Intent.setAction()).
بيانات	معرِّف الموارد المنتظم (URI) للبيانات لهذا الغرض (اطّلِع على Intent.setData()).
نوع MIME	نوع MIME للغرض (اطّلِع على Intent.setType()).
الفئات	يشير ذلك المصطلح إلى هيكل بيانات قابل للتكرار يحتوي على سلاسل تحدِّد فئات لهذه القيم. النيّة بالشراء (يُرجى الاطّلاع على Intent.addCategory()).
تطبيقات إضافية	قاموس البيانات الإضافية الخاصة بهدف Intent هذا (الاطّلاع على Intent.putExtra() كمثال). يجب أن يكون المفتاح لكل عنصر في القاموس سلسلة. قيمة العنصر يمكن أن يكون أي نوع من البيانات البسيطة أو المهيكلة.
المكوِّن	مكوّن هذا Intent (راجِع ComponentName). سيؤدي استخدام هذه الوسيطة إلى توجيه Intent إلى فئة معيّنة ضمن فئة حزمة Android.
العلامة	يشير هذا المصطلح إلى بنية بيانات قابلة للتكرار تحتوي على علامات تتحكم في كيفية التعامل مع Intent. (اطّلِع على Intent.setFlags()).

فراغ سحب ( بداية الصف، نهاية الصف، العددية عدد صحيح خطوات)

يحاكي هذا التطبيق إيماءة السحب (اللمس مع الاستمرار والتحريك) على شاشة هذا الجهاز.

الوسيطات

بدء	نقطة البداية لإيماءة السحب في شكل صف (س، ص) حيث تمثِّل x وy عددًا صحيحًا.
end	نقطة نهاية إيماءة السحب في شكل صف (x,y) حيث تمثل x وy عددًا صحيحًا.
المدة	مدة إيماءة السحب بالثواني. القيمة التلقائية هي 1.0 ثانية.
الخطوات	عدد الخطوات المطلوب اتخاذها عند استقراء النقاط. والعدد التلقائي هو 10.

كائن getProperty (مفتاح سلسلة)

يتم عرض قيمته لهذا الجهاز استنادًا إلى اسم متغيّر بيئة النظام.

الوسيطات

مفتاح	تمثّل هذه السمة اسم متغيّر بيئة النظام. يتم سرد أسماء المتغيرات المتوفرة في الجدول 1. أسماء متغيرات المواقع في نهاية هذا الموضوع.

المرتجعات

• قيمة المتغير. يختلف تنسيق البيانات وفقًا للمتغيّر المطلوب.

كائن getSystemProperty (مفتاح سلسلة)

مرادف لـ getProperty().

الوسيطات

مفتاح	تمثّل هذه السمة اسم متغيّر بيئة النظام. يتم سرد أسماء المتغيرات المتوفرة في الجدول 1. أسماء متغيرات المواقع.

المرتجعات

• قيمة المتغير. يختلف تنسيق البيانات وفقًا للمتغيّر المطلوب.

فراغ installPackage (مسار سلسلة)

تثبيت تطبيق Android أو حزمة الاختبار المضمّنة في packageFile على هذا الجهاز. إذا سبق تثبيت التطبيق أو حزمة الاختبار، التي تم استبدالها.

الوسيطات

مسار	المسار المؤهّل بالكامل واسم الملف للملف .apk المطلوب تثبيته.

القواميس الآلة الموسيقية ( string className، الوسيطات القاموس)

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

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

الوسيطات

اسم الفئة	اسم مكوّن Android المثبَّت من قبل على هذا الجهاز، في قسم بالنموذج القياسي packagename/classname حيث يكون اسم الحزمة هو اسم حزمة Android لملف .apk على هذا الجهاز classname هو اسم الفئة لمكون Android (النشاط، ContentProvider أو Service أو BroadcastRecipienter) في هذا الملف. كلاهما يجب أن يكون اسم الحزمة واسم الفئة مؤهلين بالكامل. عرض لمزيد من التفاصيل، يُرجى ComponentName.
الوسيط	قاموس يحتوي على العلامات وقيمها. ويتم تمريرها إلى المكون حيث البدء. إذا لم تأخذ العلامة أي قيمة، اضبط قيمة القاموس على قيمة فارغة السلسلة.

المرتجعات

• قاموس يحتوي على ناتج المكوِّن. محتويات القاموس من خلال المكون نفسه.

  في حال استخدام InstrumentationTestRunner كاسم للصف في وسيطة partnerName، ثم يحتوي قاموس النتيجة على على المفتاح الفردي "stream". قيمة "ساحة المشاركات" عبارة عن سلسلة تحتوي على إخراج الاختبار، كما لو تم تشغيل InstrumentationTestRunner من سطر الأوامر. يتم وصف تنسيق هذا الإخراج في الاختبار في بيئات تطوير تفاعلية أخرى:

فراغ الصحافة (اسم سلسلة، نوع عدد صحيح)

لإرسال الحدث الرئيسي المحدّد من خلال type إلى المفتاح المحدّد من قِبل keycode

الوسيطات

اسم	اسم رمز المفتاح المراد إرساله. يمكنك الانتقال إلى KeyEvent للاطّلاع على قائمة أي أسماء رموز المفاتيح. استخدِم اسم رمز المفتاح، وليس قيمة العدد الصحيح.
كتابة	نوع الحدث الرئيسي المطلوب إرساله. القيم المسموح بها هي DOWN وUP و DOWN_AND_UP

فراغ إعادة التشغيل (نوع التحميل سلسلة)

تؤدي هذه السياسة إلى إعادة تشغيل هذا الجهاز في برنامج الإقلاع الذي حدّده bootloadType.

الوسيطات

بداخل	نوع برنامج الإقلاع المطلوب إعادة التشغيل فيه. القيم المسموح بها هي "bootloader" أو "recovery" أو "بدون"

فراغ removePackage (إزالة حزمة) (حزمة سلسلة)

لحذف الحزمة المحدّدة من هذا الجهاز، بما في ذلك بياناتها وذاكرة التخزين المؤقت الخاصة بها

الوسيطات

طرد	اسم حزمة Android لملف .apk على هذا الجهاز.

كائن واجهة الأوامر (سلسلة cmd)

لتنفيذ أمر Shell adb وعرض النتيجة، إن وجدت.

الوسيطات

cmd	هو الأمر الذي يجب تنفيذه في واجهة adb. يكون شكل هذه الأوامر كما هو موضح في موضوع Android Debug Bridge:

المرتجعات

• تمثّل هذه السمة نتائج الأمر، إن توفّرت. يتم تحديد تنسيق النتائج من خلال الأمر.

فراغ startActivity ( معرّف الموارد المنتظم string، الإجراء string، بيانات سلسلة سلسلة mimetype، فئات قابلة للتكرار القواميس الإضافية المكون، العلامات القابلة للتكرار)

لبدء نشاط على هذا الجهاز عن طريق إرسال هدف تم إنشاؤه من الوسيطات المقدمة.

الوسيطات

معرّف موارد منتظم (URI)	معرّف الموارد المنتظم (URI) لـ Intent (اطّلِع على Intent.setData()).
إجراء	الإجراء الخاص بـ Intent (اطّلِع على Intent.setAction()).
بيانات	معرِّف الموارد المنتظم (URI) للبيانات لـ Intent (اطّلِع على Intent.setData()).
نوع MIME	نوع MIME للغرض (اطّلِع على Intent.setType()).
الفئات	هيكل بيانات قابل للتكرار يحتوي على سلاسل تحدد فئات النيّة بالشراء (يُرجى الاطّلاع على Intent.addCategory()).
تطبيقات إضافية	قاموس البيانات الإضافية لـ Intent (يُرجى الاطّلاع على Intent.putExtra() كمثال). يجب أن يكون المفتاح لكل عنصر في القاموس سلسلة. قيمة العنصر يمكن أن يكون أي نوع من البيانات البسيطة أو المهيكلة.
المكوِّن	مكوّن Intent (اطّلِع على ComponentName). سيؤدي استخدام هذه الوسيطة إلى توجيه في فئة معيّنة ضمن حزمة Android محدَّدة.
العلامة	يشير هذا المصطلح إلى بنية بيانات قابلة للتكرار تحتوي على علامات تتحكم في كيفية التعامل مع Intent. (اطّلِع على Intent.setFlags()).

MonkeyImage لقطة شاشة ()

يلتقط المخزن المؤقت للشاشة بأكمله هذا الجهاز، مما يؤدي إلى لقطة الشاشة للشاشة الحالية.

المرتجعات

• ملف الكائن MonkeyImage الذي يحتوي على صورة الشاشة الحالية.

فراغ لمس ( عدد صحيح x، عدد صحيح y، نوع سلسلة)

يتم إرسال حدث لمس محدّد حسب النوع إلى المكان المحدّد على الشاشة. في س و ص.

الوسيطات

x	الموضع الأفقي للمس الشاشة بوحدات بكسل الجهاز، بدءًا من يسار الشاشة في اتجاهها الحالي.
y	الموضع الرأسي للمسة بوحدات بكسل الجهاز، بدءًا من أعلى الشاشة في اتجاهها الحالي.
كتابة	نوع الحدث الرئيسي المطلوب إرساله. القيم المسموح بها هي DOWN وUP و DOWN_AND_UP

فراغ النوع (رسالة سلسلة)

لإرسال الأحرف المضمَّنة في الرسالة إلى هذا الجهاز، كما لو كانت تمت كتابتها على لوحة مفاتيح الجهاز. يعادل ذلك الاتصال press() لكل رمز مفتاح في message باستخدام نوع الحدث الرئيسي DOWN_AND_UP.

الوسيطات

رسالة	سلسلة تحتوي على الأحرف المراد إرسالها.

فراغ تنشيط ()

لتنشيط شاشة هذا الجهاز.

---

الملحق

الجدول 1.أسماء متغيرات الخصائص المستخدمة مع getProperty() و getSystemProperty():

مجموعة المواقع	الخاصية	الوصف	ملاحظات
build	board	اسم رمز لوحة نظام الجهاز	الاطّلاع على Build
	brand	مشغِّل شبكة الجوّال أو الموفِّر الذي تم تخصيص نظام التشغيل له.
	device	اسم تصميم الجهاز
	fingerprint	معرّف فريد للإصدار المُستخدَم حاليًا
	host
	ID	رقم قائمة التغييرات أو التصنيف
	model	الاسم المرئي للمستخدم النهائي للجهاز
	product	الاسم العام للمنتج.
	tags	علامات مفصولة بفواصل تصف الإصدار، مثل "غير موقَّعة" و "تصحيح الأخطاء".
	type	نوع الإصدار، مثل "مستخدم" أو "eng".
	user
	CPU_ABI	اسم مجموعة تعليمات الرموز البرمجية الأصلية، على شكل نوع وحدة المعالجة المركزية (CPU) بالإضافة إلى ABI.
	manufacturer	الشركة المصنعة للمنتج/الجهاز.
	version.incremental	الرمز الداخلي الذي يستخدمه نظام التحكم في المصدر لتمثيل هذا الإصدار من البرنامج.
	version.release	الاسم المرئي للمستخدم لهذا الإصدار من البرنامج.
	version.sdk	يشير إلى إصدار حزمة تطوير البرامج (SDK) المرئي للمستخدم والمرتبط بهذا الإصدار من نظام التشغيل.
	version.codename	الاسم الرمزي الحالي للتطوير، أو "REL" إذا تم استخدام هذا الإصدار من البرنامج صدرت.
display	width	عرض شاشة الجهاز بالبكسل	عرض يمكنك DisplayMetrics للاطّلاع على التفاصيل.
	height	يشير ذلك إلى ارتفاع شاشة الجهاز بالبكسل.
	density	الكثافة المنطقية للشاشة. هذا عامل يقيّم وحدات بكسل مستقلة الكثافة (DIP) إلى درجة دقة الجهاز يتم ضبط DIP بحيث أي موضع انحدار واحد يساوي وحدة بكسل واحدة على شاشة قياسها 160 بكسل لكل بوصة. على سبيل المثال: على شاشة بدقة 160 نقطة لكل بوصة، تكون الكثافة = 1.0، بينما تبلغ الكثافة 0 .75 على شاشة بدقة 120 نقطة لكل بوصة. لا تتبع القيمة حجم الشاشة الحقيقي بالضبط، ولكن يتم تعديلها إلى التوافق مع التغييرات الكبيرة في عدد النقاط لكل بوصة (DPI) للعرض. عرض لمزيد من التفاصيل، يُرجى density.
am.current	package	اسم حزمة Android للحزمة قيد التشغيل حاليًا.	تعرض مفاتيح am.current معلومات عن الملف قيد التشغيل حاليًا. النشاط.
	action	إجراء النشاط الحالي. يتطابق هذا النص مع تنسيق name. سمة العنصر action في بيان الحزمة.
	comp.class	اسم فئة المكون الذي بدأ النشاط الحالي. عرض لمزيد من التفاصيل، يُرجى comp.package.
	comp.package	اسم حزمة المكون الذي بدأ النشاط الحالي. المكون يتم تحديدها من خلال اسم الحزمة واسم الفئة التي تحتوي عليها الحزمة.
	data	البيانات (إن توفّرت) المضمّنة في Intent الذي بدأ النشاط الحالي
	categories	الفئات المحددة بواسطة Intent الذي بدأ النشاط الحالي.
clock	realtime	عدد المللي ثانية منذ إعادة تشغيل الجهاز، بما في ذلك وضع السكون العميق الوقت.	يمكنك الاطّلاع على SystemClock لمزيد من المعلومات.
	uptime	عدد المللي ثانية منذ إعادة تشغيل الجهاز، لا يشمل حان وقت النوم العميق
	millis	الوقت الحالي منذ حقبة يونكس بالمللي ثانية.