RemoteAndroidTestRunner

public class RemoteAndroidTestRunner
extends Object implements IRemoteAndroidTestRunner

java.lang.Object
   ↳ com.android.ddmlib.testrunner.RemoteAndroidTestRunner

تنفيذ أمر اختبار Android عن بُعد وإعداد تقارير بالنتائج

ملخّص

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

RemoteAndroidTestRunner(String packageName, IShellEnabledDevice remoteDevice)

منشئ بديل

RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice)

منشئ بديل

RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice, RemoteAndroidTestRunner.StatusReporterMode statusReporterMode)

تنشئ هذه السمة أداة تنفيذ اختبار Android عن بُعد.

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

void addBooleanArg(String name, boolean value)

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

void addInstrumentationArg(String name, String value)

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

void cancel()

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

IInstrumentationResultParser createParser(String runName, Collection<ITestRunListener> listeners)

أنشئ InstrumentationResultParser الذي سيتم استخدامه لتحليل ناتج أدوات القياس.

String getAmInstrumentCommand()
IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType()

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

String getPackageName()

تعرِض هذه السمة اسم حزمة التطبيق.

String getRunOptions()

تعرض هذه السمة خيارات أمر am instrument.

String getRunnerName()

تعرِض هذه السمة runnerName.

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

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

void setDebug(boolean debug)

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

void setLogOnly(boolean logOnly)

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

void setMaxTimeToOutputResponse(long maxTimeToOutputResponse, TimeUnit maxTimeUnits)

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

void setMaxTimeout(long maxTimeout, TimeUnit maxTimeUnits)

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

void setMaxtimeToOutputResponse(int maxTimeToOutputResponse)
void setMethodName(String className, String testName)

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

void setRunName(String runName)

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

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

void setRunOptions(String options)

تضبط هذه السمة خيارات أمر أداة am.

void setTestCollection(boolean collect)

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

void setTestPackageName(String packageName)

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

void setTestSize(IRemoteAndroidTestRunner.TestSize size)

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

طُرق محمية

String getArgsCommand()

تعرض هذه السمة بنية سطر الأوامر الكاملة لأدوات القياس الخاصة بوسيطات أدوات القياس المقدَّمة.

String getRunnerPath()

تعرض هذه السمة مسار مكوّن القياس الكامل.

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

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                IShellEnabledDevice remoteDevice)

منشئ بديل يستخدم أداة تشغيل أدوات القياس التلقائية.

المعلَمات
packageName ‫String: حزمة تطبيق Android التي تحتوي على الاختبارات التي سيتم تنفيذها
remoteDevice IShellEnabledDevice: جهاز Android الذي سيتم تنفيذ الاختبارات عليه

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                String runnerName, 
                IShellEnabledDevice remoteDevice)

منشئ بديل يتم استخدام statusReporterMode التلقائي.

المعلَمات
packageName ‫String: حزمة تطبيق Android التي تحتوي على الاختبارات التي سيتم تنفيذها
runnerName ‫String: أداة تنفيذ اختبارات قياس حالة التطبيق إذا كانت القيمة فارغة، سيتم استخدام برنامج التشغيل التلقائي
remoteDevice IShellEnabledDevice: جهاز Android الذي سيتم تنفيذ الاختبارات عليه

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                String runnerName, 
                IShellEnabledDevice remoteDevice, 
                RemoteAndroidTestRunner.StatusReporterMode statusReporterMode)

تنشئ هذه السمة أداة تنفيذ اختبار Android عن بُعد.

المعلَمات
packageName ‫String: حزمة تطبيق Android التي تحتوي على الاختبارات التي سيتم تنفيذها
runnerName ‫String: أداة تنفيذ اختبارات قياس حالة التطبيق إذا كانت القيمة فارغة، سيتم استخدام برنامج التشغيل التلقائي
remoteDevice IShellEnabledDevice: جهاز Android الذي سيتم تنفيذ الاختبارات عليه
statusReporterMode ‫RemoteAndroidTestRunner.StatusReporterMode: وضع إعداد التقارير عن الحالة الذي سيتم استخدامه لأمر أداة

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

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

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

createParser

public IInstrumentationResultParser createParser (String runName, 
                Collection<ITestRunListener> listeners)

أنشئ InstrumentationResultParser الذي سيتم استخدامه لتحليل ناتج أدوات القياس.

المعلَمات
runName String: اسم عملية التشغيل المطلوب استخدامها.
listeners Collection: يمثّل هذا الحقل المستمعين الذين يجب إبلاغهم بالنتائج.
المرتجعات
IInstrumentationResultParser تمثّل هذه السمة InstrumentationResultParser.

getAmInstrumentCommand

public String getAmInstrumentCommand ()

المرتجعات
String

getCoverageOutputType

public IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

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

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

getPackageName

public String getPackageName ()

تعرِض هذه السمة اسم حزمة التطبيق.

المرتجعات
String

getRunOptions

public String getRunOptions ()

تعرض هذه السمة خيارات أمر am instrument.

المرتجعات
String

getRunnerName

public String getRunnerName ()

تعرِض هذه السمة runnerName.

المرتجعات
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 reportPath)

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

المعلَمات
reportPath String

setDebug

public void setDebug (boolean debug)

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

المعلَمات
debug boolean

setLogOnly

public void setLogOnly (boolean logOnly)

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

المعلَمات
logOnly boolean

setMaxTimeToOutputResponse

public void setMaxTimeToOutputResponse (long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

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

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

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

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

setMaxTimeout

public void setMaxTimeout (long maxTimeout, 
                TimeUnit maxTimeUnits)

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

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

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

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

setMaxtimeToOutputResponse

public void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

المعلَمات
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)

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

setRunOptions

public void setRunOptions (String options)

تضبط هذه السمة خيارات أمر أداة am. يمكنك الاطّلاع على com/android/commands/am/Am.java للحصول على القائمة الكاملة بالخيارات.

المعلَمات
options String

setTestCollection

public void setTestCollection (boolean collect)

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

المعلَمات
collect 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 المطلوب تنفيذه

طُرق محمية

getArgsCommand

protected String getArgsCommand ()

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

المرتجعات
String

getRunnerPath

protected String getRunnerPath ()

تعرض هذه السمة مسار مكوّن القياس الكامل.

المرتجعات
String