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, listeners)

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

String getAmInstrumentCommand()
IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType()

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

String getPackageName()

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

String getRunOptions()

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

String getRunnerName()

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

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

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

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, 
                 listeners)

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

المعلمات
runName String: اسم عملية التشغيل المطلوب استخدامها.
listeners : أدوات معالجة الأحداث التي يتم إرسال النتائج إليها.
المرتجعات
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.

المرتجعات
String

getRunnerName

public String getRunnerName ()

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

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

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

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