IRemoteAndroidTestRunner
public
interface
IRemoteAndroidTestRunner
| com.android.ddmlib.testrunner.IRemoteAndroidTestRunner |
واجهة لتنفيذ أمر اختبار Android عن بُعد وإرسال النتيجة إلى مستمع.
ملخّص
الإجراءات العامة | |
|---|---|
abstract
void
|
addBooleanArg(String name, boolean value)
تضيف هذه السمة وسيطة منطقية لتضمينها في أمر القياس. |
abstract
void
|
addInstrumentationArg(String name, String value)
تضيف هذه السمة وسيطة لتضمينها في أمر القياس. |
abstract
void
|
cancel()
تطلب هذه السمة إلغاء عملية التشغيل التجريبي هذه. |
abstract
IRemoteAndroidTestRunner.CoverageOutput
|
getCoverageOutputType()
تعرض هذه السمة نوع تغطية الاختبار التي ينتجها المشغّل. |
abstract
String
|
getPackageName()
تعرِض هذه السمة اسم حزمة التطبيق. |
abstract
String
|
getRunnerName()
تعرِض هذه السمة runnerName. |
abstract
void
|
removeInstrumentationArg(String name)
يزيل وسيطة تمت إضافتها سابقًا. |
abstract
void
|
run(Collection<ITestRunListener> listeners)
نفِّذ مجموعة الاختبارات هذه. |
abstract
void
|
run(ITestRunListener... listeners)
نفِّذ مجموعة الاختبارات هذه. |
abstract
void
|
setAdditionalTestOutputLocation(String additionalTestDataPath)
تضبط هذه السمة موقع الناتج الإضافي للاختبار الذي سيتم نسخه إلى الجهاز المضيف قبل إلغاء تثبيت تطبيق الاختبار. |
abstract
void
|
setClassName(String className)
يتم ضبطها لتنفيذ الاختبارات في هذه الفئة فقط، ويجب استدعاؤها قبل "التشغيل". |
abstract
void
|
setClassNames(String[] classNames)
يتم ضبطها لتنفيذ الاختبارات في الفئات المقدَّمة فقط، ويجب استدعاؤها قبل "التشغيل". |
abstract
void
|
setCoverage(boolean coverage)
تضبط هذه السمة وضع تغطية الرمز البرمجي لعملية الاختبار هذه. |
abstract
void
|
setCoverageReportLocation(String reportPath)
تضبط هذه السمة الموقع الجغرافي لتقارير التغطية التي تم إنشاؤها. |
abstract
void
|
setDebug(boolean debug)
تضبط هذه السمة وضع تصحيح الأخطاء لهذا التشغيل التجريبي. |
abstract
void
|
setLogOnly(boolean logOnly)
يضبط عملية الاختبار هذه على وضع التسجيل فقط، ويتخطّى تنفيذ الاختبار. |
abstract
void
|
setMaxTimeToOutputResponse(long maxTimeToOutputResponse, TimeUnit maxTimeUnits)
تضبط هذه السمة الحد الأقصى للوقت المسموح به بين إخراج أمر shell الذي يشغّل الاختبارات على الأجهزة. |
abstract
void
|
setMaxTimeout(long maxTimeout, TimeUnit maxTimeUnits)
تضبط هذه السمة الحد الأقصى للوقت المسموح به لإنهاء عملية القياس. |
abstract
void
|
setMaxtimeToOutputResponse(int maxTimeToOutputResponse)
تم إيقاف هذه الطريقة نهائيًا.
استخدِم |
abstract
void
|
setMethodName(String className, String testName)
يتم ضبطها لتشغيل طريقة الاختبار المحدّدة فقط. يجب استدعاؤها قبل "التشغيل". |
abstract
void
|
setRunName(String runName)
ضبط اسم تشغيل مخصّص ليتم إرساله إلى في حال عدم تحديدها، سيتم استخدام اسم الحزمة |
abstract
void
|
setTestCollection(boolean collection)
يضبط هذا التشغيل التجريبي على وضع جمع الاختبارات. |
abstract
void
|
setTestPackageName(String packageName)
يجب استدعاء هذه الدالة قبل الدالة run، وهي تضبط جميع الاختبارات في الحزمة المحدّدة. |
abstract
void
|
setTestSize(IRemoteAndroidTestRunner.TestSize size)
يتم ضبطها لتشغيل الاختبارات ذات الحجم المحدّد فقط. |
الإجراءات العامة
addBooleanArg
public abstract void addBooleanArg (String name,
boolean value)تضيف هذه السمة وسيطة منطقية لتضمينها في أمر القياس.
| المعلَمات | |
|---|---|
name |
String: اسم وسيطة حزمة أدوات القياس |
value |
boolean: قيمة الوسيطة |
يُرجى الاطّلاع أيضًا على:
addInstrumentationArg
public abstract void addInstrumentationArg (String name,
String value)تضيف هذه السمة وسيطة لتضمينها في أمر القياس.
يجب استدعاء هذه الدالة قبل الدالة run. إذا تمّ تقديم وسيطة بالاسم المحدّد، سيتم استبدال قيمتها.
| المعلَمات | |
|---|---|
name |
String: اسم وسيطة حزمة أدوات القياس |
value |
String: قيمة الوسيطة |
إلغاء
public abstract void cancel ()
تطلب هذه السمة إلغاء عملية التشغيل التجريبي هذه.
getCoverageOutputType
public abstract IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()
تعرض هذه السمة نوع تغطية الاختبار التي ينتجها المشغّل. يمكنك الاطّلاع على CoverageOutput.
| المرتجعات | |
|---|---|
IRemoteAndroidTestRunner.CoverageOutput |
|
getPackageName
public abstract String getPackageName ()
تعرِض هذه السمة اسم حزمة التطبيق.
| المرتجعات | |
|---|---|
String |
|
getRunnerName
public abstract String getRunnerName ()
تعرِض هذه السمة runnerName.
| المرتجعات | |
|---|---|
String |
|
removeInstrumentationArg
public abstract void removeInstrumentationArg (String name)
يزيل وسيطة تمت إضافتها سابقًا.
| المعلَمات | |
|---|---|
name |
String: اسم وسيطة حزمة أدوات القياس التي ستتم إزالتها |
ضربة طويلة
public abstract void run (Collection<ITestRunListener> listeners)
نفِّذ مجموعة الاختبارات هذه.
| المعلَمات | |
|---|---|
listeners |
Collection: مجموعة من أدوات معالجة الأحداث لنتائج الاختبار |
| عمليات الطرح | |
|---|---|
AdbCommandRejectedException |
إذا رفضت أداة تصحيح أخطاء Android الأمر |
ShellCommandUnresponsiveException |
إذا لم يعرض الجهاز أي نتيجة اختبار خلال فترة أطول من الحد الأقصى لوقت العرض |
TimeoutException |
في حال انتهاء مهلة الاتصال |
IOException |
في حال فقدان الاتصال بالجهاز |
يُرجى الاطّلاع أيضًا على:
ضربة طويلة
public abstract void run (ITestRunListener... listeners)
نفِّذ مجموعة الاختبارات هذه.
طريقة ملائمة لـ run(Collection)
| المعلَمات | |
|---|---|
listeners |
ITestRunListener: يستمع إلى نتائج الاختبار |
| عمليات الطرح | |
|---|---|
AdbCommandRejectedException |
إذا رفضت أداة تصحيح أخطاء Android الأمر |
ShellCommandUnresponsiveException |
إذا لم يعرض الجهاز أي نتيجة اختبار خلال فترة أطول من الحد الأقصى لوقت العرض |
TimeoutException |
في حال انتهاء مهلة الاتصال |
IOException |
في حال فقدان الاتصال بالجهاز |
يُرجى الاطّلاع أيضًا على:
setAdditionalTestOutputLocation
public abstract void setAdditionalTestOutputLocation (String additionalTestDataPath)
تضبط هذه السمة موقع الناتج الإضافي للاختبار الذي سيتم نسخه إلى الجهاز المضيف قبل إلغاء تثبيت تطبيق الاختبار. على سبيل المثال، تقارير مقاييس الأداء التي يتم إنشاؤها.
| المعلَمات | |
|---|---|
additionalTestDataPath |
String |
setClassName
public abstract void setClassName (String className)
يتم ضبطها لتنفيذ الاختبارات في هذه الفئة فقط، ويجب استدعاؤها قبل "التشغيل".
| المعلَمات | |
|---|---|
className |
String: اسم الفئة المؤهَّل بالكامل (مثل x.y.z) |
setClassNames
public abstract void setClassNames (String[] classNames)
يتم ضبطها لتنفيذ الاختبارات في الفئات المقدَّمة فقط، ويجب استدعاؤها قبل "التشغيل".
إذا كنت ستوفّر أكثر من فئة واحدة، يجب توفير InstrumentationTestRunner يتوافق مع بنية وسيطة الفئات المتعددة.
| المعلَمات | |
|---|---|
classNames |
String: مصفوفة من أسماء الفئات المؤهَّلة بالكامل (مثل x.y.z) |
setCoverage
public abstract void setCoverage (boolean coverage)
تضبط هذه السمة وضع تغطية الرمز البرمجي لعملية الاختبار هذه.
| المعلَمات | |
|---|---|
coverage |
boolean |
setCoverageReportLocation
public abstract void setCoverageReportLocation (String reportPath)
تضبط هذه السمة الموقع الجغرافي لتقارير التغطية التي تم إنشاؤها.
| المعلَمات | |
|---|---|
reportPath |
String |
setDebug
public abstract void setDebug (boolean debug)
تضبط هذه السمة وضع تصحيح الأخطاء لهذا التشغيل التجريبي. إذا كانت القيمة صحيحة، سينتظر برنامج تشغيل اختبار Android انضمام برنامج تصحيح الأخطاء قبل مواصلة تنفيذ الاختبار.
| المعلَمات | |
|---|---|
debug |
boolean |
setLogOnly
public abstract void setLogOnly (boolean logOnly)
يضبط عملية الاختبار هذه على وضع التسجيل فقط، ويتخطّى تنفيذ الاختبار.
| المعلَمات | |
|---|---|
logOnly |
boolean |
setMaxTimeToOutputResponse
public abstract void setMaxTimeToOutputResponse (long maxTimeToOutputResponse,
TimeUnit maxTimeUnits)تضبط هذه السمة الحد الأقصى للوقت المسموح به بين إخراج أمر shell الذي يشغّل الاختبارات على الأجهزة.
يتيح ذلك ضبط مهلة في حال تعذّر إكمال الاختبارات. ويختلف هذا الإعداد عن المهلة العادية للاتصال.
لن يتم تحديد أي مهلة تلقائيًا.
| المعلَمات | |
|---|---|
maxTimeToOutputResponse |
long: الحد الأقصى للمدة الزمنية التي يُسمح خلالها للأمر بعدم عرض أي استجابة. تعني القيمة 0 أنّ الطريقة ستنتظر إلى الأبد (إلى أن يلغي receiver التنفيذ) للحصول على ناتج الأمر ولن تعرض أي خطأ. |
maxTimeUnits |
TimeUnit: وحدات القيم غير الصفرية maxTimeToOutputResponse وmaxTimeout |
يُرجى الاطّلاع أيضًا على:
setMaxTimeout
public abstract void setMaxTimeout (long maxTimeout,
TimeUnit maxTimeUnits)تضبط هذه السمة الحد الأقصى للوقت المسموح به لإنهاء عملية القياس.
يتيح ذلك ضبط مهلة في حال تعذّر إكمال الاختبارات. ويختلف هذا الإعداد عن المهلة العادية للاتصال.
لن يتم تحديد أي مهلة تلقائيًا.
| المعلَمات | |
|---|---|
maxTimeout |
long: الحد الأقصى للمدة الزمنية التي يُسمح فيها للأمر بعدم عرض أي استجابة. تعني القيمة 0 أنّ الطريقة ستنتظر إلى الأبد (إلى أن يلغي receiver التنفيذ) للحصول على ناتج الأمر ولن تعرض أي خطأ. |
maxTimeUnits |
TimeUnit: وحدات القيم غير الصفرية maxTimeToOutputResponse وmaxTimeout |
يُرجى الاطّلاع أيضًا على:
setMaxtimeToOutputResponse
public abstract void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)
تم إيقاف هذا الإجراء نهائيًا.
استخدِم setMaxTimeToOutputResponse(long, java.util.concurrent.TimeUnit).
| المعلَمات | |
|---|---|
maxTimeToOutputResponse |
int |
setMethodName
public abstract void setMethodName (String className,
String testName)يتم ضبطها لتشغيل طريقة الاختبار المحدّدة فقط. يجب استدعاؤها قبل "التشغيل".
| المعلَمات | |
|---|---|
className |
String: اسم الفئة المؤهَّل بالكامل (مثل x.y.z) |
testName |
String: اسم الطريقة |
setRunName
public abstract void setRunName (String runName)
ضبط اسم تشغيل مخصّص ليتم إرساله إلى ITestRunListener في run(ITestRunListener)
في حال عدم تحديدها، سيتم استخدام اسم الحزمة
setTestCollection
public abstract void setTestCollection (boolean collection)
يضبط هذا التشغيل التجريبي على وضع جمع الاختبارات. إذا كانت القيمة صحيحة، سيتم تخطّي تنفيذ الاختبار وسيتم ضبط جميع وسيطات المشغّل المناسبة المطلوبة لجمع الاختبار بنجاح.
| المعلَمات | |
|---|---|
collection |
boolean |
setTestPackageName
public abstract void setTestPackageName (String packageName)
يجب استدعاء هذه الدالة قبل الدالة run، وهي تضبط جميع الاختبارات في الحزمة المحدّدة.
| المعلَمات | |
|---|---|
packageName |
String: اسم الحزمة المؤهَّل بالكامل (مثل x.y.z) |
setTestSize
public abstract void setTestSize (IRemoteAndroidTestRunner.TestSize size)
يتم ضبطها لتشغيل الاختبارات ذات الحجم المحدّد فقط. يجب استدعاء هذه الدالة قبل الدالة run.
| المعلَمات | |
|---|---|
size |
IRemoteAndroidTestRunner.TestSize: TestSize المطلوب تنفيذه |