اعتبارًا من عام 2026، ولضمان توافقنا مع نموذج التطوير الثابت الرئيسي وضمان استقرار المنصة في المنظومة المتكاملة، سننشر الرمز المصدري في "مشروع Android مفتوح المصدر" (AOSP) في الربع الثاني والربع الرابع. لإنشاء AOSP والمساهمة فيه، ننصحك باستخدام android-latest-release بدلاً من aosp-main. سيشير فرع البيان android-latest-release دائمًا إلى أحدث إصدار تم إرساله إلى AOSP. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android المفتوح المصدر (AOSP).

DeviceSelectionOptions

public class DeviceSelectionOptions
extends Object implements IDeviceSelection

java.lang.Object
↳	com.android.tradefed.device.DeviceSelectionOptions

حاوية لمعايير اختيار الجهاز

ملخّص

الإنشاءات العامة
`DeviceSelectionOptions()`

الطُرق العامة
`void`	`addExcludeSerial(String serialNumber)` أضِف رقمًا تسلسليًا إلى قائمة الاستبعاد.
`void`	`addProductType(String productType)` أضِف نوع منتج إلى خيارات اختيار الجهاز.
`void`	`addProperty(String propertyKey, String propValue)` إضافة معيار موقع إلى خيارات اختيار الجهاز
`void`	`addSerial(String serialNumber)` أضِف رقمًا تسلسليًا إلى خيارات اختيار الجهاز.
`static IDeviceSelection`	`createForSerial(String serial)` طريقة المصنع المساعدة لإنشاء `IDeviceSelection` التي ستطابق الجهاز فقط مع الرقم التسلسلي المحدّد
`boolean`	`deviceRequested()`
`boolean`	`emulatorRequested()`
`String`	`fetchEnvironmentVariable(String name)` دالة مساعدة تُستخدَم لجلب متغيّر البيئة.
`boolean`	`gceDeviceRequested()`
`IDeviceSelection.BaseDeviceType`	`getBaseDeviceTypeRequested()` تعرِض هذه السمة نوع الجهاز الذي يجب استخدامه.
`Integer`	`getBatteryLevel(IDevice device)` تعرض هذه الطريقة مستوى البطارية للجهاز المحدّد
`String`	`getDeviceProductType(IDevice device)` تعرض هذه الطريقة نوع منتج الأجهزة المحدّدة
`String`	`getDeviceProductVariant(IDevice device)` تعرض هذه الطريقة خيار المنتج للأجهزة المحدّدة
`DeviceSelectionOptions.DeviceRequestedType`	`getDeviceTypeRequested()`
	`getExcludeSerials()` الحصول على نسخة من قائمة استبعاد الأرقام التسلسلية
`Integer`	`getMaxBatteryLevel()` الحصول على الحد الأقصى المطلوب لمستوى البطارية
`Integer`	`getMaxBatteryTemperature()` الحصول على الحد الأقصى المطلوب لمستوى البطارية
`Integer`	`getMinBatteryLevel()` تعرض هذه السمة الحد الأدنى المطلوب لمستوى شحن البطارية
	`getNoMatchReason()` تعرِض هذه السمة سبب عدم تطابق الجهاز.
	`getProductTypes()` الحصول على نسخة من قائمة أنواع المنتجات
	`getProperties()` تعرض هذه الدالة خريطة لقائمة المواقع
`boolean`	`getRequireBatteryCheck()` تحديد ما إذا كان يجب التحقّق من البطارية للأجهزة التي يكون مستوى البطارية فيها غير معروف
`boolean`	`getRequireBatteryTemperatureCheck()` تحديد ما إذا كان يجب فحص درجة حرارة البطارية للأجهزة التي لا تتوفّر فيها معلومات عن درجة حرارة البطارية
	`getSerials(IDevice device)` الحصول على نسخة من الأرقام التسلسلية
	`getSerials()` تعرض هذه الطريقة قائمة بالمسلسلات المطلوبة.
`boolean`	`localVirtualDeviceRequested()`
`boolean`	`matches(IDevice device)`
`boolean`	`nullDeviceRequested()`
`boolean`	`remoteDeviceRequested()`
`void`	`setBaseDeviceTypeRequested(IDeviceSelection.BaseDeviceType type)` تضبط هذه السمة نوع الجهاز الذي يجب استخدامه.
`void`	`setDeviceRequested(boolean deviceRequested)` تضبط هذه السمة علامة تشير إلى طلب المحاكي
`void`	`setDeviceTypeRequested(DeviceSelectionOptions.DeviceRequestedType requestedType)`
`void`	`setEmulatorRequested(boolean emulatorRequested)` تضبط هذه السمة علامة تشير إلى طلب المحاكي
`void`	`setGceDeviceRequested(boolean gceDeviceRequested)`
`void`	`setMaxBatteryLevel(Integer maxBattery)` تضبط هذه السمة الحد الأقصى لمستوى البطارية.
`void`	`setMaxBatteryTemperature(Integer maxBatteryTemperature)` تضبط هذه السمة الحد الأقصى لمستوى البطارية.
`void`	`setMinBatteryLevel(Integer minBattery)` تضبط هذه السياسة الحد الأدنى لمستوى شحن البطارية.
`void`	`setNullDeviceRequested(boolean nullDeviceRequested)` تضبط هذه السمة علامة الجهاز المطلوب الذي لا يحتوي على بيانات
`void`	`setRequireBatteryCheck(boolean requireCheck)` يحدّد هذا الإعداد ما إذا كان يجب التحقّق من البطارية للأجهزة التي يكون مستوى البطارية فيها غير معروف
`void`	`setRequireBatteryTemperatureCheck(boolean requireCheckTemprature)` يحدّد هذا الإعداد ما إذا كان مطلوبًا فحص درجة حرارة البطارية للأجهزة التي لا تتوفّر فيها معلومات عن درجة حرارة البطارية.
`void`	`setSerial(String... serialNumber)` اضبط قائمة الأرقام التسلسلية التي سيتم تضمينها، مع استبدال أي قيم حالية.
`void`	`setStubEmulatorRequested(boolean stubEmulatorRequested)` تضبط هذه السمة علامة طلب المحاكي البديل.
`boolean`	`shouldCreateTemporarilyPlaceholder()` أنشئ عنصرًا نائبًا مؤقتًا من البيانات الوصفية.
`boolean`	`stubEmulatorRequested()`

الإنشاءات العامة

DeviceSelectionOptions

public DeviceSelectionOptions ()

الطُرق العامة

addExcludeSerial

public void addExcludeSerial (String serialNumber)

أضِف رقمًا تسلسليًا إلى قائمة الاستبعاد.

addProductType

public void addProductType (String productType)

أضِف نوع منتج إلى خيارات اختيار الجهاز.

addProperty

public void addProperty (String propertyKey, 
                String propValue)

إضافة معيار موقع إلى خيارات اختيار الجهاز

المعلمات
`propertyKey`	`String`
`propValue`	`String`

addSerial

public void addSerial (String serialNumber)

أضِف رقمًا تسلسليًا إلى خيارات اختيار الجهاز.

createForSerial

public static IDeviceSelection createForSerial (String serial)

طريقة المصنع المساعدة لإنشاء IDeviceSelection التي ستطابق الجهاز فقط مع الرقم التسلسلي المحدّد

المعلمات
`serial`	`String`

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

deviceRequested

public boolean deviceRequested ()

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

emulatorRequested

public boolean emulatorRequested ()

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

fetchEnvironmentVariable

public String fetchEnvironmentVariable (String name)

دالة مساعدة تُستخدَم لجلب متغيّر البيئة. وهي في الأساس برنامج تضمين حول System.getenv(String) ويتم ذلك لأغراض اختبار الوحدات.

المعلمات
`name`	‫`String`: متغيّر البيئة المطلوب استرجاعه

المرتجعات
`String`	قيمة `String` لمتغير البيئة أو قيمة فارغة إذا لم يكن متاحًا

gceDeviceRequested

public boolean gceDeviceRequested ()

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

getBaseDeviceTypeRequested

public IDeviceSelection.BaseDeviceType getBaseDeviceTypeRequested ()

تعرِض هذه السمة نوع الجهاز الذي يجب استخدامه.

المرتجعات
`IDeviceSelection.BaseDeviceType`

getBatteryLevel

public Integer getBatteryLevel (IDevice device)

تعرض هذه الطريقة مستوى البطارية للجهاز المحدّد

المعلمات
`device`	`IDevice`: `IDevice`

المرتجعات
`Integer`	مستوى بطارية الجهاز أو `null` إذا كان غير معروف

getDeviceProductType

public String getDeviceProductType (IDevice device)

تعرض هذه الطريقة نوع منتج الأجهزة المحدّدة

المعلمات
`device`	`IDevice`: `IDevice`

المرتجعات
`String`	نوع منتج الجهاز أو `null` إذا كان غير معروف

getDeviceProductVariant

public String getDeviceProductVariant (IDevice device)

تعرض هذه الطريقة خيار المنتج للأجهزة المحدّدة

المعلمات
`device`	`IDevice`: `IDevice`

المرتجعات
`String`	خيار المنتج للجهاز أو `null` إذا كان غير معروف

getDeviceTypeRequested

public DeviceSelectionOptions.DeviceRequestedType getDeviceTypeRequested ()

المرتجعات
`DeviceSelectionOptions.DeviceRequestedType`

getExcludeSerials

public  getExcludeSerials ()

الحصول على نسخة من قائمة استبعاد الأرقام التسلسلية

المرتجعات
	`ERROR(/Collection)` من الأرقام التسلسلية

getMaxBatteryLevel

public Integer getMaxBatteryLevel ()

الحصول على الحد الأقصى المطلوب لمستوى البطارية

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

getMaxBatteryTemperature

public Integer getMaxBatteryTemperature ()

الحصول على الحد الأقصى المطلوب لمستوى البطارية

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

getMinBatteryLevel

public Integer getMinBatteryLevel ()

تعرض هذه السمة الحد الأدنى المطلوب لمستوى شحن البطارية

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

getNoMatchReason

public  getNoMatchReason ()

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

المرتجعات
	خريطة للرقم التسلسلي وسبب عدم تخصيصه

getProductTypes

public  getProductTypes ()

الحصول على نسخة من قائمة أنواع المنتجات

المرتجعات
	`ERROR(/Collection)` من أنواع المنتجات

getProperties

public  getProperties ()

تعرض هذه الدالة خريطة لقائمة المواقع

المرتجعات
	`ERROR(/Map)` من أسماء خصائص الأجهزة إلى القيم

getRequireBatteryCheck

public boolean getRequireBatteryCheck ()

تحديد ما إذا كان يجب التحقّق من البطارية للأجهزة التي يكون مستوى البطارية فيها غير معروف

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

getRequireBatteryTemperatureCheck

public boolean getRequireBatteryTemperatureCheck ()

تحديد ما إذا كان يجب فحص درجة حرارة البطارية للأجهزة التي لا تتوفّر فيها معلومات عن درجة حرارة البطارية

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

getSerials

public  getSerials (IDevice device)

الحصول على نسخة من الأرقام التسلسلية

المعلمات
`device`	`IDevice`: `IDevice` الذي يمثّل الجهاز الذي تم أخذه في الاعتبار عند الاختيار

المرتجعات
	`ERROR(/Collection)` من الأرقام التسلسلية

getSerials

public  getSerials ()

تعرض هذه الطريقة قائمة بالمسلسلات المطلوبة.

المرتجعات

localVirtualDeviceRequested

public boolean localVirtualDeviceRequested ()

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

فلتر مطابق لـ

public boolean matches (IDevice device)

المعلمات
`device`	`IDevice`

المرتجعات
`boolean`	`true` إذا كانت قيمة `IDevice` المحدّدة تطابق الخيارات المقدَّمة. `false` خلاف ذلك

nullDeviceRequested

public boolean nullDeviceRequested ()

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

remoteDeviceRequested

public boolean remoteDeviceRequested ()

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

setBaseDeviceTypeRequested

public void setBaseDeviceTypeRequested (IDeviceSelection.BaseDeviceType type)

تضبط هذه السمة نوع الجهاز الذي يجب استخدامه.

المعلمات
`type`	`IDeviceSelection.BaseDeviceType`

setDeviceRequested

public void setDeviceRequested (boolean deviceRequested)

تضبط هذه السمة علامة تشير إلى طلب المحاكي

المعلمات
`deviceRequested`	`boolean`

setDeviceTypeRequested

public void setDeviceTypeRequested (DeviceSelectionOptions.DeviceRequestedType requestedType)

المعلمات
`requestedType`	`DeviceSelectionOptions.DeviceRequestedType`

setEmulatorRequested

public void setEmulatorRequested (boolean emulatorRequested)

تضبط هذه السمة علامة تشير إلى طلب المحاكي

المعلمات
`emulatorRequested`	`boolean`

setGceDeviceRequested

public void setGceDeviceRequested (boolean gceDeviceRequested)

المعلمات
`gceDeviceRequested`	`boolean`

setMaxBatteryLevel

public void setMaxBatteryLevel (Integer maxBattery)

تضبط هذه السمة الحد الأقصى لمستوى البطارية.

المعلمات
`maxBattery`	`Integer`

setMaxBatteryTemperature

public void setMaxBatteryTemperature (Integer maxBatteryTemperature)

تضبط هذه السمة الحد الأقصى لمستوى البطارية.

المعلمات
`maxBatteryTemperature`	`Integer`

setMinBatteryLevel

public void setMinBatteryLevel (Integer minBattery)

تضبط هذه السياسة الحد الأدنى لمستوى شحن البطارية.

المعلمات
`minBattery`	`Integer`

setNullDeviceRequested

public void setNullDeviceRequested (boolean nullDeviceRequested)

تضبط هذه السمة علامة الجهاز المطلوب الذي لا يحتوي على بيانات

المعلمات
`nullDeviceRequested`	`boolean`

setRequireBatteryCheck

public void setRequireBatteryCheck (boolean requireCheck)

يحدّد هذا الإعداد ما إذا كان يجب التحقّق من البطارية للأجهزة التي يكون مستوى البطارية فيها غير معروف

المعلمات
`requireCheck`	`boolean`

setRequireBatteryTemperatureCheck

public void setRequireBatteryTemperatureCheck (boolean requireCheckTemprature)

تحديد ما إذا كان يجب إجراء فحص درجة حرارة البطارية للأجهزة التي لا تتوفّر فيها معلومات عن درجة حرارة البطارية

المعلمات
`requireCheckTemprature`	`boolean`

setSerial

public void setSerial (String... serialNumber)

اضبط قائمة الأرقام التسلسلية التي سيتم تضمينها، مع استبدال أي قيم حالية.

المعلمات
`serialNumber`	`String`

setStubEmulatorRequested

public void setStubEmulatorRequested (boolean stubEmulatorRequested)

تضبط هذه السمة علامة طلب المحاكي البديل.

المعلمات
`stubEmulatorRequested`	`boolean`

shouldCreateTemporarilyPlaceholder

public boolean shouldCreateTemporarilyPlaceholder ()

أنشئ عنصرًا نائبًا مؤقتًا من البيانات الوصفية.

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

stubEmulatorRequested

public boolean stubEmulatorRequested ()

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