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(ITestRunListener... listeners)
نفِّذ عملية الاختبار هذه. |
abstract
void
|
run(
نفِّذ عملية الاختبار هذه. |
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 (ITestRunListener... listeners)
نفِّذ عملية الاختبار هذه.
طريقة ملائمة لـ ERROR(/#run(Collection)).
| المعلمات | |
|---|---|
listeners |
ITestRunListener: الاستماع إلى نتائج الاختبار |
| الرميات | |
|---|---|
TimeoutException |
في حال انتهاء مهلة الاتصال. |
AdbCommandRejectedException |
إذا رفضت أداة تصحيح أخطاء Android الأمر |
ShellCommandUnresponsiveException |
إذا لم يعرض الجهاز أي نتيجة اختبار لفترة أطول من الحد الأقصى لوقت العرض. |
|
في حال فقدان الاتصال بالجهاز |
يُرجى الاطّلاع أيضًا على:
ضربة طويلة
public abstract void run (listeners)
نفِّذ عملية الاختبار هذه.
| المعلمات | |
|---|---|
listeners |
|
| الرميات | |
|---|---|
TimeoutException |
في حال انتهاء مهلة الاتصال. |
AdbCommandRejectedException |
إذا رفضت أداة تصحيح أخطاء Android الأمر |
ShellCommandUnresponsiveException |
إذا لم يعرض الجهاز أي نتيجة اختبار لفترة أطول من الحد الأقصى لوقت العرض. |
|
في حال فقدان الاتصال بالجهاز |
يُرجى الاطّلاع أيضًا على:
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)
تم إيقاف استخدام هذه الطريقة نهائيًا.
استخدِم ERROR(/#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(
في حال عدم تحديدها، سيتم استخدام اسم الحزمة
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 المطلوب تنفيذه |