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( 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()

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

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)

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

طريقة ملائمة لـ ERROR(/#run(Collection)).

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

ضربة طويلة

public void run ( listeners)

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

المعلمات
listeners : مجموعة أدوات معالجة النتائج
الرميات
AdbCommandRejectedException
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()

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

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