اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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()`
	`getExtraListeners()`
`String[]`	`getInstallArgs()` عرض خيارات إضافية لأمر التثبيت
	`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`	`isIsolatedStorageDisabled()`
`boolean`	`isRestartDisabled()`
`boolean`	`isTestApiCheckDisabled()`
`boolean`	`isWindowAnimationDisabled()`
`DeviceTestRunOptions`	`setApkFileName(String apkFileName)` تُستخدَم لضبط اسم ملف apk لتثبيته.
`DeviceTestRunOptions`	`setCheckResults(boolean checkResults)` لتحديد ما إذا كان يجب التحقّق من نتائج تشغيل الأدوات أم لا والتأكّد من عدم حدوث أخطاء.
`DeviceTestRunOptions`	`setDevice(ITestDevice device)`
`DeviceTestRunOptions`	`setDisableHiddenApiCheck(boolean disableHiddenApiCheck)` لتحديد ما إذا كان سيتم إضافة الخيار --no-hidden-api-checks إلى "أداة am" المستخدَمة من جانب العميل
`DeviceTestRunOptions`	`setDisableIsolatedStorage(boolean disableIsolatedStorage)` لتحديد ما إذا كان سيتم إضافة --no-isolated-storage إلى "أداة am" المستخدَمة من جانب المضيف أم لا.
`DeviceTestRunOptions`	`setDisableRestart(boolean disableRestart)` لتحديد ما إذا كان سيتم إضافة --no-restart إلى "أداة am" المستخدَمة من جانب المضيف أم لا.
`DeviceTestRunOptions`	`setDisableTestApiCheck(boolean disableTestApiCheck)` لتحديد ما إذا كان سيتم إضافة --no-test-api-access إلى "أداة am" المستخدَمة من جانب المضيف
`DeviceTestRunOptions`	`setDisableWindowAnimation(boolean disableWindowAnimation)` لتحديد ما إذا كان سيتم إضافة --no-window-animation إلى "أداة am" المستخدَمة من جانب المضيف أم لا.
`DeviceTestRunOptions`	`setForceQueryable(boolean forceQueryable)` تُستخدَم لضبط `false` إذا كان يجب عدم السماح بإجراء استعلامات عن حزمة apk التي سيتم تثبيتها.
`DeviceTestRunOptions`	`setGrantPermission(boolean grantPermission)` منح الأذونات لتثبيت حزمة APK
`DeviceTestRunOptions`	`setInstallArgs(String... installArgs)` لضبط خيارات إضافية لأمر التثبيت
`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  getExtraListeners ()

المرتجعات

getInstallArgs

public String[] getInstallArgs ()

عرض خيارات إضافية لأمر التثبيت

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

getInstrumentationArgs

public  getInstrumentationArgs ()

المرتجعات

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`

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 لتثبيته.

المعلمات
`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" المستخدَمة من جانب العميل

المعلمات
`disableHiddenApiCheck`	`boolean`

المرتجعات
`DeviceTestRunOptions`

setDisableIsolatedStorage

public DeviceTestRunOptions setDisableIsolatedStorage (boolean disableIsolatedStorage)

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

المعلمات
`disableIsolatedStorage`	`boolean`

المرتجعات
`DeviceTestRunOptions`

setDisableRestart

public DeviceTestRunOptions setDisableRestart (boolean disableRestart)

لتحديد ما إذا كان سيتم إضافة --no-restart إلى "أداة am" المستخدَمة من جانب المضيف أم لا.

المعلمات
`disableRestart`	`boolean`

المرتجعات
`DeviceTestRunOptions`

setDisableTestApiCheck

public DeviceTestRunOptions setDisableTestApiCheck (boolean disableTestApiCheck)

لتحديد ما إذا كان سيتم إضافة الخيار --no-test-api-access إلى "أداة am" المستخدَمة من جانب المضيف

المعلمات
`disableTestApiCheck`	`boolean`

المرتجعات
`DeviceTestRunOptions`

setDisableWindowAnimation

public DeviceTestRunOptions setDisableWindowAnimation (boolean disableWindowAnimation)

لتحديد ما إذا كان سيتم إضافة --no-window-animation إلى "أداة am" المستخدَمة من جانب المضيف أم لا.

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

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`