UiAutomatorRunner

public class UiAutomatorRunner
extends Object implements IRemoteAndroidTestRunner

java.lang.Object
   ↳ com.android.tradefed.testtype.UiAutomatorRunner

يُجري اختبار UI Automator على الجهاز ويُبلغ عن النتائج. اختبار UI Automator هو أداة تشغيل اختبار مخصّصة لتنفيذ اختبارات أتمتة واجهة المستخدم التي تستخدم إطار عمل UI Automator. يحاكي برنامج تشغيل الاختبار على الجهاز تنسيق إخراج اختبار الأجهزة، ما يتيح إعادة استخدام رمز التحليل الحالي في ddmlib وTF. في الأساس، هذا برنامج تضمين لهذا الأمر: adb shell uiautomator runtest (ملفات jar) -e class (فئات الاختبار) ...

ملخّص

طُرق وضع التصميم العامة

UiAutomatorRunner(IDevice remoteDevice, String[] jarPaths, String runnerPath)

إنشاء UiAutomatorRunner لتشغيل اختبارات التشغيل الآلي لواجهة المستخدم

الإجراءات العامة

void addBooleanArg(String name, boolean value)

تضيف هذه السمة وسيطة منطقية لتضمينها في أمر القياس.

void addInstrumentationArg(String name, String value)

تضيف هذه السمة وسيطة لتضمينها في أمر القياس.

void cancel()

تطلب هذه السمة إلغاء عملية التشغيل التجريبي هذه.

IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType()

تعرض هذه السمة نوع تغطية الاختبار التي ينتجها المشغّل.

String getPackageName()

تعرِض هذه السمة اسم حزمة آخر فئة Java تمت إضافتها

String getRunnerName()

إرجاع اسم فئة UiAutomatorTestRunner التلقائي

void removeInstrumentationArg(String name)

يزيل وسيطة تمت إضافتها سابقًا.

void run(ITestRunListener... listeners)

نفِّذ مجموعة الاختبارات هذه.

void run(Collection<ITestRunListener> listeners)

نفِّذ مجموعة الاختبارات هذه.

void setAdditionalTestOutputLocation(String additionalTestDataPath)

تضبط هذه السمة موقع الناتج الإضافي للاختبار الذي سيتم نسخه إلى الجهاز المضيف قبل إلغاء تثبيت تطبيق الاختبار.

void setClassName(String className)

يتم ضبطها لتنفيذ الاختبارات في هذه الفئة فقط، ويجب استدعاؤها قبل "التشغيل".

void setClassNames(String[] classNames)

يتم ضبطها لتنفيذ الاختبارات في الفئات المقدَّمة فقط، ويجب استدعاؤها قبل "التشغيل".

void setCoverage(boolean coverage)

تضبط هذه السمة وضع تغطية الرمز البرمجي لعملية الاختبار هذه.

void setCoverageReportLocation(String arg0)

تضبط هذه السمة الموقع الجغرافي لتقارير التغطية التي تم إنشاؤها.

void setDebug(boolean debug)

تضبط هذه السمة وضع تصحيح الأخطاء لهذا التشغيل التجريبي.

void setIgnoreSighup(boolean value)

تضبط هذه السمة الخيار في uiautomator لتجاهل SIGHUP.

void setLogOnly(boolean logOnly)

يضبط عملية الاختبار هذه على وضع التسجيل فقط، ويتخطّى تنفيذ الاختبار.

void setMaxTimeToOutputResponse(long timeout, TimeUnit unit)

تضبط هذه السمة الحد الأقصى للوقت المسموح به بين إخراج أمر shell الذي يشغّل الاختبارات على الأجهزة.

void setMaxTimeout(long maxTimeout, TimeUnit unit)

تضبط هذه السمة الحد الأقصى للوقت المسموح به لإنهاء عملية القياس.

void setMaxtimeToOutputResponse(int maxTimeToOutputResponse)

تم إيقاف هذه الطريقة نهائيًا. استخدِم setMaxTimeToOutputResponse(long,TimeUnit) بدلاً من ذلك.

void setMethodName(String className, String testName)

يتم ضبطها لتشغيل طريقة الاختبار المحدّدة فقط. يجب استدعاؤها قبل "التشغيل".

void setRunName(String runName)

ضبط اسم تشغيل مخصّص ليتم إرساله إلى ITestRunListener في run(ITestRunListener)

في حال عدم تحديدها، سيتم استخدام اسم الحزمة

void setTestCollection(boolean b)

يضبط هذا التشغيل التجريبي على وضع جمع الاختبارات.

void setTestPackageName(String packageName)

يجب استدعاء هذه الدالة قبل الدالة run، وهي تضبط جميع الاختبارات في الحزمة المحدّدة.

void setTestSize(IRemoteAndroidTestRunner.TestSize size)

يتم ضبطها لتشغيل الاختبارات ذات الحجم المحدّد فقط.

طُرق محمية

String getRunCommand()
String getRunnerPath()

طُرق وضع التصميم العامة

UiAutomatorRunner

public UiAutomatorRunner (IDevice remoteDevice, 
                String[] jarPaths, 
                String runnerPath)

إنشاء UiAutomatorRunner لتشغيل اختبارات التشغيل الآلي لواجهة المستخدم

المعلَمات
remoteDevice IDevice: الجهاز البعيد الذي سيتم التفاعل معه: إجراء الاختبار وجمع النتائج وما إلى ذلك
jarPaths String: مسارات ملفات jar التي تتضمّن حالات اختبار UI Automator، ويجب أن تكون المسارات مطلقة أو نسبية إلى /data/local/tmp/ على الجهاز
runnerPath String: بديل لتطبيق uiautomator، ويمكن أن يكون null وسيتم استخدام الإعداد التلقائي في هذه الحالة

الإجراءات العامة

addBooleanArg

public void addBooleanArg (String name, 
                boolean value)

تضيف هذه السمة وسيطة منطقية لتضمينها في أمر القياس.

المعلَمات
name ‫String: اسم وسيطة حزمة أدوات القياس
value boolean: قيمة الوسيطة

addInstrumentationArg

public void addInstrumentationArg (String name, 
                String value)

تضيف هذه السمة وسيطة لتضمينها في أمر القياس.

يجب استدعاء هذه الدالة قبل الدالة run. إذا تمّ تقديم وسيطة بالاسم المحدّد، سيتم استبدال قيمتها.

المعلَمات
name ‫String: اسم وسيطة حزمة أدوات القياس
value String: قيمة الوسيطة

إلغاء

public void cancel ()

تطلب هذه السمة إلغاء عملية التشغيل التجريبي هذه.

getCoverageOutputType

public IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

تعرض هذه السمة نوع تغطية الاختبار التي ينتجها المشغّل. يمكنك الاطّلاع على CoverageOutput.

المرتجعات
IRemoteAndroidTestRunner.CoverageOutput

getPackageName

public String getPackageName ()

تعرِض هذه السمة اسم حزمة آخر فئة Java تمت إضافتها

المرتجعات
String

getRunnerName

public String getRunnerName ()

إرجاع اسم فئة UiAutomatorTestRunner التلقائي

المرتجعات
String

removeInstrumentationArg

public void removeInstrumentationArg (String name)

يزيل وسيطة تمت إضافتها سابقًا.

المعلَمات
name ‫String: اسم وسيطة حزمة أدوات القياس التي ستتم إزالتها

ضربة طويلة

public void run (ITestRunListener... listeners)

نفِّذ مجموعة الاختبارات هذه.

طريقة ملائمة لـ run(Collection)

المعلَمات
listeners ‫ITestRunListener: يستمع إلى نتائج الاختبار
عمليات الطرح
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

ضربة طويلة

public void run (Collection<ITestRunListener> listeners)

نفِّذ مجموعة الاختبارات هذه.

المعلَمات
listeners ‫Collection: مجموعة من أدوات معالجة الأحداث لنتائج الاختبار
عمليات الطرح
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

setAdditionalTestOutputLocation

public void setAdditionalTestOutputLocation (String additionalTestDataPath)

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

المعلَمات
additionalTestDataPath String

setClassName

public void setClassName (String className)

يتم ضبطها لتنفيذ الاختبارات في هذه الفئة فقط، ويجب استدعاؤها قبل "التشغيل".

المعلَمات
className ‫String: اسم الفئة المؤهَّل بالكامل (مثل x.y.z)

setClassNames

public void setClassNames (String[] classNames)

يتم ضبطها لتنفيذ الاختبارات في الفئات المقدَّمة فقط، ويجب استدعاؤها قبل "التشغيل".

إذا كنت ستوفّر أكثر من فئة واحدة، يجب توفير InstrumentationTestRunner يتوافق مع بنية وسيطة الفئات المتعددة.

المعلَمات
classNames ‫String: مصفوفة من أسماء الفئات المؤهَّلة بالكامل (مثل x.y.z)

setCoverage

public void setCoverage (boolean coverage)

تضبط هذه السمة وضع تغطية الرمز البرمجي لعملية الاختبار هذه.

المعلَمات
coverage boolean

setCoverageReportLocation

public void setCoverageReportLocation (String arg0)

تضبط هذه السمة الموقع الجغرافي لتقارير التغطية التي تم إنشاؤها.

المعلَمات
arg0 String

setDebug

public void setDebug (boolean debug)

تضبط هذه السمة وضع تصحيح الأخطاء لهذا التشغيل التجريبي. إذا كانت القيمة صحيحة، سينتظر برنامج تشغيل اختبار Android انضمام برنامج تصحيح الأخطاء قبل مواصلة تنفيذ الاختبار.

المعلَمات
debug boolean

setIgnoreSighup

public void setIgnoreSighup (boolean value)

تضبط هذه السمة الخيار في uiautomator لتجاهل SIGHUP.

المعلَمات
value ‫boolean: تجاهل الإشارة إذا تم ضبطها على "true"

setLogOnly

public void setLogOnly (boolean logOnly)

يضبط عملية الاختبار هذه على وضع التسجيل فقط، ويتخطّى تنفيذ الاختبار.

المعلَمات
logOnly boolean

setMaxTimeToOutputResponse

public void setMaxTimeToOutputResponse (long timeout, 
                TimeUnit unit)

تضبط هذه السمة الحد الأقصى للوقت المسموح به بين إخراج أمر shell الذي يشغّل الاختبارات على الأجهزة.

يتيح ذلك ضبط مهلة في حال تعذّر إكمال الاختبارات. ويختلف هذا الإعداد عن المهلة العادية للاتصال.

لن يتم تحديد أي مهلة تلقائيًا.

المعلَمات
timeout ‫long: الحد الأقصى للمدة الزمنية التي يُسمح خلالها للأمر بعدم عرض أي استجابة. تعني القيمة 0 أنّ الطريقة ستنتظر إلى الأبد (إلى أن يلغي receiver التنفيذ) للحصول على ناتج الأمر ولن تعرض أي خطأ.
unit ‫TimeUnit: وحدات القيم غير الصفرية maxTimeToOutputResponse وmaxTimeout

setMaxTimeout

public void setMaxTimeout (long maxTimeout, 
                TimeUnit unit)

تضبط هذه السمة الحد الأقصى للوقت المسموح به لإنهاء عملية القياس.

يتيح ذلك ضبط مهلة في حال تعذّر إكمال الاختبارات. ويختلف هذا الإعداد عن المهلة العادية للاتصال.

لن يتم تحديد أي مهلة تلقائيًا.

المعلَمات
maxTimeout long: الحد الأقصى للمدة الزمنية التي يُسمح فيها للأمر بعدم عرض أي استجابة. تعني القيمة 0 أنّ الطريقة ستنتظر إلى الأبد (إلى أن يلغي receiver التنفيذ) للحصول على ناتج الأمر ولن تعرض أي خطأ.
unit ‫TimeUnit: وحدات القيم غير الصفرية maxTimeToOutputResponse وmaxTimeout

setMaxtimeToOutputResponse

public void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

تم إيقاف هذا الإجراء نهائيًا.
يُرجى استخدام setMaxTimeToOutputResponse(long,TimeUnit) بدلاً من ذلك.

المعلَمات
maxTimeToOutputResponse int

setMethodName

public void setMethodName (String className, 
                String testName)

يتم ضبطها لتشغيل طريقة الاختبار المحدّدة فقط. يجب استدعاؤها قبل "التشغيل".

المعلَمات
className ‫String: اسم الفئة المؤهَّل بالكامل (مثل x.y.z)
testName ‫String: اسم الطريقة

setRunName

public void setRunName (String runName)

ضبط اسم تشغيل مخصّص ليتم إرساله إلى ITestRunListener في run(ITestRunListener)

في حال عدم تحديدها، سيتم استخدام اسم الحزمة

setTestCollection

public void setTestCollection (boolean b)

يضبط هذا التشغيل التجريبي على وضع جمع الاختبارات. إذا كانت القيمة صحيحة، سيتم تخطّي تنفيذ الاختبار وسيتم ضبط جميع وسيطات المشغّل المناسبة المطلوبة لجمع الاختبار بنجاح.

المعلَمات
b boolean

setTestPackageName

public void setTestPackageName (String packageName)

يجب استدعاء هذه الدالة قبل الدالة run، وهي تضبط جميع الاختبارات في الحزمة المحدّدة.

المعلَمات
packageName ‫String: اسم الحزمة المؤهَّل بالكامل (مثل x.y.z)

setTestSize

public void setTestSize (IRemoteAndroidTestRunner.TestSize size)

يتم ضبطها لتشغيل الاختبارات ذات الحجم المحدّد فقط. يجب استدعاء هذه الدالة قبل الدالة run.

المعلَمات
size IRemoteAndroidTestRunner.TestSize: TestSize المطلوب تنفيذه

طُرق محمية

getRunCommand

protected String getRunCommand ()

المرتجعات
String

getRunnerPath

protected String getRunnerPath ()

المرتجعات
String