DeviceTestRunOptions

public class DeviceTestRunOptions
extends Object

java.lang.Object
   ↳ com.android.tradefed.testtype.junit4.DeviceTestRunOptions


فئة أداة إنشاء للخيارات المتعلّقة بتنفيذ اختبارات الأجهزة من خلال BaseHostJUnit4Test.

ملخّص

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

DeviceTestRunOptions(String packageName)

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

DeviceTestRunOptions addExtraListener(ITestLifeCycleReceiver listener)

إضافة مستمع إضافي إلى أداة القياس التي يتم تشغيلها

DeviceTestRunOptions addInstrumentationArg(String key, String value)

أضِف وسيطة سيتم تمريرها إلى أداة القياس.

void clearExtraListeners()
void clearInstrumentationArgs()

محو جميع وسيطات القياس التي تم ضبطها باستخدام addInstrumentationArg(String,String) سابقًا

String getApkFileName()

تعرض هذه السمة اسم ملف APK الخاص بتثبيت حزمة APK.

ITestDevice getDevice()
List<ITestLifeCycleReceiver> getExtraListeners()
String[] getInstallArgs()

تعرض هذه السمة خيارات إضافية للأمر install.

Map<String, String> getInstrumentationArgs()
Long getMaxInstrumentationTimeoutMs()
Long getMaxTimeToOutputMs()
String getPackageName()
String getRunner()
String getTestClassName()
String getTestMethodName()
Long getTestTimeoutMs()
Integer getUserId()
boolean isForceQueryable()

تحديد ما إذا كان يجب أن يكون ملف APK المراد تثبيته قابلاً للاستعلام أم لا

boolean isGrantPermission()

تحديد ما إذا كان سيتم منح أذونات لتثبيت حزمة apk.

boolean isHiddenApiCheckDisabled()
boolean isInstrumentInPcc()

تحديد ما إذا كان سيتم إضافة --instrument-in-pcc إلى "am instrument" المستخدَم من جهة المضيف أم لا

boolean isIsolatedStorageDisabled()
boolean isRestartDisabled()
boolean isTestApiCheckDisabled()
boolean isWindowAnimationDisabled()
DeviceTestRunOptions setApkFileName(String apkFileName)

تضبط هذه السمة اسم ملف APK لتثبيت حزمة APK.

DeviceTestRunOptions setCheckResults(boolean checkResults)

يضبط ما إذا كان يجب التحقّق من نتائج عملية تنفيذ أدوات القياس والتأكّد من عدم حدوث أي أخطاء.

DeviceTestRunOptions setDevice(ITestDevice device)
DeviceTestRunOptions setDisableHiddenApiCheck(boolean disableHiddenApiCheck)

تحدّد هذه السمة ما إذا كان سيتم إضافة الخيار --no-hidden-api-checks إلى "am instrument" المستخدَم من جهة المضيف أم لا.

DeviceTestRunOptions setDisableIsolatedStorage(boolean disableIsolatedStorage)

تحدّد هذه السمة ما إذا كان سيتم إضافة الخيار ‎--no-isolated-storage إلى الأمر "am instrument" المستخدَم من جهة المضيف أم لا.

DeviceTestRunOptions setDisableRestart(boolean disableRestart)

يحدّد هذا الخيار ما إذا كان سيتم إضافة ‎--no-restart إلى الأمر am instrument المستخدَم من جهة المضيف أم لا.

DeviceTestRunOptions setDisableTestApiCheck(boolean disableTestApiCheck)

تحدّد هذه السمة ما إذا كان سيتم إضافة الخيار ‎--no-test-api-access إلى الأمر am instrument المستخدَم من جهة المضيف.

DeviceTestRunOptions setDisableWindowAnimation(boolean disableWindowAnimation)

يحدّد ما إذا كان سيتم إضافة الخيار --no-window-animation إلى &quot;أداة am&quot; المستخدَمة من جهة المضيف أم لا.

DeviceTestRunOptions setForceQueryable(boolean forceQueryable)

تضبط هذه السمة القيمة false لتحديد ما إذا كان يجب ألا يكون ملف APK المراد تثبيته قابلاً للاستعلام.

DeviceTestRunOptions setGrantPermission(boolean grantPermission)

يمنح أذونات لتثبيت حزمة APK.

DeviceTestRunOptions setInstallArgs(String... installArgs)

تضبط هذه السمة خيارات إضافية لأمر التثبيت.

DeviceTestRunOptions setInstrumentInPcc(boolean instrumentInPcc)

تضبط هذه السمة ما إذا كان سيتم إضافة --instrument-in-pcc إلى الأمر am instrument المستخدَم من جهة المضيف أم لا.

DeviceTestRunOptions setMaxInstrumentationTimeoutMs(Long maxInstrumentationTimeoutMs)

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

DeviceTestRunOptions setMaxTimeToOutputMs(Long maxTimeToOutputMs)

تضبط هذه السمة الحد الأقصى للوقت (بالمللي ثانية) الذي يمكن أن تتوقف فيه أداة القياس عن إخراج البيانات قبل أن يتم إيقافها.

DeviceTestRunOptions setRunner(String runner)

تضبط هذه السمة أداة تشغيل أدوات القياس التي يجب استخدامها لتشغيل أدوات القياس.

DeviceTestRunOptions setTestClassName(String testClassName)

تضبط هذه السمة اسم الفئة التي يجب أن يتم تنفيذ أداة القياس بها.

DeviceTestRunOptions setTestMethodName(String testMethodName)

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

DeviceTestRunOptions setTestTimeoutMs(Long testTimeoutMs)

تضبط هذه السمة الحد الأقصى للمدة (بالمللي ثانية) التي يمكن أن تستغرقها التجربة قبل أن يتم إيقافها.

DeviceTestRunOptions setUserId(Integer userId)

تُحدّد رقم تعريف المستخدم الذي يجب تنفيذ القياسات عليه.

boolean shouldCheckResults()

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

DeviceTestRunOptions

public DeviceTestRunOptions (String packageName)

المعلَمات
packageName String

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

addExtraListener

public DeviceTestRunOptions addExtraListener (ITestLifeCycleReceiver listener)

إضافة مستمع إضافي إلى أداة القياس التي يتم تشغيلها

المعلَمات
listener ITestLifeCycleReceiver

المرتجعات
DeviceTestRunOptions

addInstrumentationArg

public DeviceTestRunOptions addInstrumentationArg (String key, 
                String value)

أضِف وسيطة سيتم تمريرها إلى أداة القياس.

المعلَمات
key String

value String

المرتجعات
DeviceTestRunOptions

clearExtraListeners

public void clearExtraListeners ()

clearInstrumentationArgs

public void clearInstrumentationArgs ()

محو جميع وسيطات القياس التي تم ضبطها باستخدام addInstrumentationArg(String,String) سابقًا

getApkFileName

public String getApkFileName ()

تعرض هذه السمة اسم ملف APK الخاص بتثبيت حزمة APK.

المرتجعات
String

getDevice

public ITestDevice getDevice ()

المرتجعات
ITestDevice

getExtraListeners

public List<ITestLifeCycleReceiver> getExtraListeners ()

المرتجعات
List<ITestLifeCycleReceiver>

getInstallArgs

public String[] getInstallArgs ()

تعرض هذه السمة خيارات إضافية للأمر install.

المرتجعات
String[]

getInstrumentationArgs

public Map<String, String> getInstrumentationArgs ()

المرتجعات
Map<String, String>

getMaxInstrumentationTimeoutMs

public Long getMaxInstrumentationTimeoutMs ()

المرتجعات
Long

getMaxTimeToOutputMs

public Long getMaxTimeToOutputMs ()

المرتجعات
Long

getPackageName

public String getPackageName ()

المرتجعات
String

getRunner

public String getRunner ()

المرتجعات
String

getTestClassName

public String getTestClassName ()

المرتجعات
String

getTestMethodName

public String getTestMethodName ()

المرتجعات
String

getTestTimeoutMs

public Long getTestTimeoutMs ()

المرتجعات
Long

getUserId

public Integer getUserId ()

المرتجعات
Integer

isForceQueryable

public boolean isForceQueryable ()

تحديد ما إذا كان يجب أن يكون ملف APK المراد تثبيته قابلاً للاستعلام أم لا القيمة التلقائية هي "صحيح".

المرتجعات
boolean

isGrantPermission

public boolean isGrantPermission ()

تحديد ما إذا كان سيتم منح أذونات لتثبيت حزمة apk.

المرتجعات
boolean

isHiddenApiCheckDisabled

public boolean isHiddenApiCheckDisabled ()

المرتجعات
boolean

isInstrumentInPcc

public boolean isInstrumentInPcc ()

تحديد ما إذا كان سيتم إضافة --instrument-in-pcc إلى "am instrument" المستخدَم من جهة المضيف أم لا

المرتجعات
boolean

isIsolatedStorageDisabled

public boolean isIsolatedStorageDisabled ()

المرتجعات
boolean

isRestartDisabled

public boolean isRestartDisabled ()

المرتجعات
boolean

isTestApiCheckDisabled

public boolean isTestApiCheckDisabled ()

المرتجعات
boolean

isWindowAnimationDisabled

public boolean isWindowAnimationDisabled ()

المرتجعات
boolean

setApkFileName

public DeviceTestRunOptions setApkFileName (String apkFileName)

تضبط هذه السمة اسم ملف APK لتثبيت حزمة APK.

المعلَمات
apkFileName String

المرتجعات
DeviceTestRunOptions

setCheckResults

public DeviceTestRunOptions setCheckResults (boolean checkResults)

يضبط ما إذا كان يجب التحقّق من نتائج عملية تنفيذ أدوات القياس والتأكّد من عدم حدوث أي أخطاء.

المعلَمات
checkResults boolean

المرتجعات
DeviceTestRunOptions

setDevice

public DeviceTestRunOptions setDevice (ITestDevice device)

المعلَمات
device ITestDevice

المرتجعات
DeviceTestRunOptions

setDisableHiddenApiCheck

public DeviceTestRunOptions setDisableHiddenApiCheck (boolean disableHiddenApiCheck)

تحدّد هذه السمة ما إذا كان سيتم إضافة الخيار --no-hidden-api-checks إلى "am instrument" المستخدَم من جهة المضيف أم لا.

المعلَمات
disableHiddenApiCheck boolean

المرتجعات
DeviceTestRunOptions

setDisableIsolatedStorage

public DeviceTestRunOptions setDisableIsolatedStorage (boolean disableIsolatedStorage)

تحدّد هذه السمة ما إذا كان سيتم إضافة الخيار ‎--no-isolated-storage إلى الأمر "am instrument" المستخدَم من جهة المضيف أم لا.

المعلَمات
disableIsolatedStorage boolean

المرتجعات
DeviceTestRunOptions

setDisableRestart

public DeviceTestRunOptions setDisableRestart (boolean disableRestart)

يحدّد هذا الخيار ما إذا كان سيتم إضافة ‎--no-restart إلى الأمر am instrument المستخدَم من جهة المضيف أم لا.

المعلَمات
disableRestart boolean

المرتجعات
DeviceTestRunOptions

setDisableTestApiCheck

public DeviceTestRunOptions setDisableTestApiCheck (boolean disableTestApiCheck)

تحدّد هذه السمة ما إذا كان سيتم إضافة الخيار ‎--no-test-api-access إلى الأمر ‎am instrument المستخدَم من جهة المضيف.

المعلَمات
disableTestApiCheck boolean

المرتجعات
DeviceTestRunOptions

setDisableWindowAnimation

public DeviceTestRunOptions setDisableWindowAnimation (boolean disableWindowAnimation)

يحدّد ما إذا كان سيتم إضافة الخيار --no-window-animation إلى &quot;أداة am&quot; المستخدَمة من جهة المضيف أم لا.

المعلَمات
disableWindowAnimation boolean

المرتجعات
DeviceTestRunOptions

setForceQueryable

public DeviceTestRunOptions setForceQueryable (boolean forceQueryable)

تضبط هذه السمة القيمة false لتحديد ما إذا كان يجب ألا يكون ملف APK المراد تثبيته قابلاً للاستعلام.

المعلَمات
forceQueryable boolean

المرتجعات
DeviceTestRunOptions

setGrantPermission

public DeviceTestRunOptions setGrantPermission (boolean grantPermission)

يمنح أذونات لتثبيت حزمة APK.

المعلَمات
grantPermission boolean

المرتجعات
DeviceTestRunOptions

setInstallArgs

public DeviceTestRunOptions setInstallArgs (String... installArgs)

تضبط هذه السمة خيارات إضافية لأمر التثبيت.

المعلَمات
installArgs String

المرتجعات
DeviceTestRunOptions

setInstrumentInPcc

public DeviceTestRunOptions setInstrumentInPcc (boolean instrumentInPcc)

تضبط هذه السمة ما إذا كان سيتم إضافة --instrument-in-pcc إلى الأمر am instrument المستخدَم من جهة المضيف أم لا.

المعلَمات
instrumentInPcc boolean

المرتجعات
DeviceTestRunOptions

setMaxInstrumentationTimeoutMs

public DeviceTestRunOptions setMaxInstrumentationTimeoutMs (Long maxInstrumentationTimeoutMs)

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

المعلَمات
maxInstrumentationTimeoutMs Long

المرتجعات
DeviceTestRunOptions

setMaxTimeToOutputMs

public DeviceTestRunOptions setMaxTimeToOutputMs (Long maxTimeToOutputMs)

تضبط هذه السمة الحد الأقصى للوقت (بالمللي ثانية) الذي يمكن أن تتوقف فيه أداة القياس عن إخراج البيانات قبل أن يتم إيقافها. اضبط القيمة على 0 لعدم تحديد مهلة. اختياريّ.

المعلَمات
maxTimeToOutputMs Long

المرتجعات
DeviceTestRunOptions

setRunner

public DeviceTestRunOptions setRunner (String runner)

تضبط هذه السمة أداة تشغيل أدوات القياس التي يجب استخدامها لتشغيل أدوات القياس. برنامج التشغيل التلقائي هو android.support.test.runner.AndroidJUnitRunner. اختياريّ.

المعلَمات
runner String

المرتجعات
DeviceTestRunOptions

setTestClassName

public DeviceTestRunOptions setTestClassName (String testClassName)

تضبط هذه السمة اسم الفئة التي يجب أن يتم تنفيذ أداة القياس بها. سيتم فلترة أدوات القياس لتشغيل الفئة فقط. يمكن استخدامها مع setTestMethodName(String). اختياريّ.

المعلَمات
testClassName String

المرتجعات
DeviceTestRunOptions

setTestMethodName

public DeviceTestRunOptions setTestMethodName (String testMethodName)

تضبط هذه السمة اسم الطريقة التي يجب أن يتم تنفيذ أداة القياس بها. يجب ضبط setTestClassName(String) لكي تعمل هذه الميزة بشكلٍ سليم. اختياريّ.

المعلَمات
testMethodName String

المرتجعات
DeviceTestRunOptions

setTestTimeoutMs

public DeviceTestRunOptions setTestTimeoutMs (Long testTimeoutMs)

تضبط هذه السمة الحد الأقصى للمدة (بالمللي ثانية) التي يمكن أن تستغرقها التجربة قبل أن يتم إيقافها. اضبط القيمة على 0 لعدم تحديد مهلة. اختياريّ.

المعلَمات
testTimeoutMs Long

المرتجعات
DeviceTestRunOptions

setUserId

public DeviceTestRunOptions setUserId (Integer userId)

تُحدّد رقم تعريف المستخدم الذي يجب تنفيذ القياسات عليه. اختياريّ.

المعلَمات
userId Integer

المرتجعات
DeviceTestRunOptions

shouldCheckResults

public boolean shouldCheckResults ()

المرتجعات
boolean