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

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

ConfigurationDescriptor

public class ConfigurationDescriptor
extends Object implements Cloneable, Serializable

java.lang.Object
↳	com.android.tradefed.config.ConfigurationDescriptor

كائن الإعداد الذي يصف بعض جوانب الإعداد نفسه. مثل علامة مجموعة اختبارات العضوية. لا يمكن لهذه الفئة تلقّي قيم الخيارات من خلال سطر الأوامر. فقط مباشرةً في ملف xml.

ملخّص

الثوابت
`String`	`ACTIVE_PARAMETER_KEY` مفتاح البيانات الوصفية لتحديد مَعلمات الإعداد، وهو اختياري.
`String`	`LOCAL_SHARDED_KEY` مفتاح البيانات الوصفية للإعداد لتحديد أنّه تم تقسيمه.
`String`	`MODULE_DIR_PATH_KEY` مفتاح البيانات الوصفية لإعداد يحدّد مسار دليل الوحدة عندما يكون إعداد وحدة.
`String`	`PRIORITIZE_HOST_CONFIG_KEY` مفتاح البيانات الوصفية لإعداد يحدّد ما إذا كان سيتم إعطاء الأولوية لإعداد المضيف.

طُرق وضع التصميم العامة
`ConfigurationDescriptor()`

الإجراءات العامة
`void`	`addMetadata(String key, List<String> values)` إضافة المزيد من قيم مفتاح معيّن إلى إدخالات البيانات الوصفية
`void`	`addMetadata(String key, String value)` أضِف قيمة لمفتاح معيّن إلى إدخالات البيانات الوصفية.
`void`	`addRerunOption(OptionDef optionDef)` أضِف الخيار إلى قائمة الخيارات التي يمكن استخدامها لإعادة تشغيل الاختبار.
`ConfigurationDescriptor`	`clone()` لعرض نسخة طبق الأصل من العنصر `ConfigurationDescriptor`.
`static ConfigurationDescriptor`	`fromProto(ConfigurationDescription.Descriptor protoDescriptor)` العملية العكسية من `toProto()` لاستعادة العنصر
`IAbi`	`getAbi()` تعرِض هذه السمة واجهة التطبيق الثنائية (ABI) التي يتم تشغيل الإعدادات عليها إذا كانت معروفة، أو قيمة فارغة في حال عدم توفّرها.
`MultiMap<String, String>`	`getAllMetaData()` يستردّ جميع البيانات الوصفية التي تم ضبط إعداداتها ويعرض نسخة من الخريطة.
`List<String>`	`getMetaData(String name)` الحصول على إدخالات البيانات الوصفية المسماة
`String`	`getModuleName()` تعرض هذه السمة اسم وحدة إعدادات الوحدة.
`List<OptionDef>`	`getRerunOptions()` احصل على قائمة `OptionDef` التي يمكن استخدامها لإعادة التشغيل.
`Integer`	`getShardIndex()` الحصول على فهرس جزء الاستدعاء أثناء التقسيم المحلي
`List<String>`	`getSuiteTags()` تعرض هذه السمة قائمة بعلامات الحزمة التي يشكّل الاختبار جزءًا منها.
`boolean`	`isNotIRemoteTestShardable()` تعرض هذه السمة ما إذا كان يجب تقسيم IRemoteTest إلى وحدات مختلفة.
`boolean`	`isNotShardable()` تعرِض هذه السمة ما إذا كان الإعداد قابلاً للتجزئة أم لا كجزء من مجموعة
`boolean`	`isNotStrictShardable()` تعرِض هذه السمة ما إذا كان الإعداد قابلاً للتجزئة بشكل صارم أم لا كجزء من حزمة.
`List<String>`	`removeMetadata(String key)` أزِل عملية تتبُّع مفتاح البيانات الوصفية المحدّد.
`void`	`setAbi(IAbi abi)` تضبط هذه السمة واجهة التطبيق الثنائية (ABI) التي سيتم تشغيل الإعدادات عليها.
`void`	`setMetaData(MultiMap<String, String> metadata)`
`void`	`setModuleName(String name)` إذا كان هذا الإعداد يمثّل وحدة، يمكننا ضبط اسم الوحدة المرتبط به.
`void`	`setNotIRemoteTestShardable(boolean notIRemoteTestShardable)`
`void`	`setSandboxed(boolean useSandboxed)` تحدّد هذه السياسة ما إذا كان سيتم تشغيل الإعداد في وضع الحماية أو لا.
`void`	`setShardIndex(int index)` اضبط فهرس التقسيم للاستدعاء في التقسيم المحلي.
`void`	`setSuiteTags(List<String> suiteTags)` تضبط هذه السمة قائمة بعلامات المجموعة التي يشكّل الاختبار جزءًا منها.
`boolean`	`shouldUseSandbox()` تعرِض القيمة "صحيح" إذا كان من المفترض أن يتم تشغيل الاستدعاء في الوضع المحمي.
`ConfigurationDescription.Descriptor`	`toProto()` تحويل مثيل الواصف الحالي إلى تنسيق proto.

الثوابت

ACTIVE_PARAMETER_KEY

public static final String ACTIVE_PARAMETER_KEY

مفتاح البيانات الوصفية لتحديد مَعلمات الإعداد، وهو اختياري.

القيمة الثابتة: "active-parameter"

LOCAL_SHARDED_KEY

public static final String LOCAL_SHARDED_KEY

مفتاح البيانات الوصفية للإعداد لتحديد أنّه تم تقسيمه.

Constant Value: "sharded"

MODULE_DIR_PATH_KEY

public static final String MODULE_DIR_PATH_KEY

مفتاح البيانات الوصفية لإعداد يحدّد مسار دليل الوحدة عندما يكون إعداد وحدة.

القيمة الثابتة: "module-dir-path"

PRIORITIZE_HOST_CONFIG_KEY

public static final String PRIORITIZE_HOST_CONFIG_KEY

مفتاح البيانات الوصفية لإعداد يحدّد ما إذا كان سيتم إعطاء الأولوية لإعداد المضيف.

القيمة الثابتة: "prioritize-host-config"

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

ConfigurationDescriptor

public ConfigurationDescriptor ()

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

addMetadata

public void addMetadata (String key, 
                List<String> values)

إضافة المزيد من قيم مفتاح معيّن إلى إدخالات البيانات الوصفية

المعلَمات
`key`	`String`: `String` المفتاح الذي ستتم إضافة القيم إليه.
`values`	`List`: قائمة تضم `String` من القيم الإضافية.

addMetadata

public void addMetadata (String key, 
                String value)

أضِف قيمة لمفتاح معيّن إلى إدخالات البيانات الوصفية.

المعلَمات
`key`	`String`: `String` المفتاح الذي ستتم إضافة القيم إليه.
`value`	`String`: `String` من القيمة الإضافية.

addRerunOption

public void addRerunOption (OptionDef optionDef)

أضِف الخيار إلى قائمة الخيارات التي يمكن استخدامها لإعادة تشغيل الاختبار.

المعلَمات
`optionDef`	‫`OptionDef`: عنصر `OptionDef` يمثّل خيار الاختبار.

استنساخ

public ConfigurationDescriptor clone ()

لعرض نسخة طبق الأصل من العنصر ConfigurationDescriptor.

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

fromProto

public static ConfigurationDescriptor fromProto (ConfigurationDescription.Descriptor protoDescriptor)

العملية العكسية من toProto() لاستعادة العنصر

المعلَمات
`protoDescriptor`	`ConfigurationDescription.Descriptor`

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

getAbi

public IAbi getAbi ()

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

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

getAllMetaData

public MultiMap<String, String> getAllMetaData ()

يستردّ جميع البيانات الوصفية التي تم ضبط إعداداتها ويعرض نسخة من الخريطة.

المرتجعات
`MultiMap<String, String>`

getMetaData

public List<String> getMetaData (String name)

الحصول على إدخالات البيانات الوصفية المسماة

المعلَمات
`name`	`String`

المرتجعات
`List<String>`

getModuleName

public String getModuleName ()

تعرض هذه السمة اسم وحدة إعدادات الوحدة.

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

getRerunOptions

public List<OptionDef> getRerunOptions ()

احصل على قائمة OptionDef التي يمكن استخدامها لإعادة التشغيل.

المرتجعات
`List<OptionDef>`

getShardIndex

public Integer getShardIndex ()

الحصول على فهرس جزء الاستدعاء أثناء التقسيم المحلي تعرِض قيمة فارغة إذا لم يكن هناك تقسيم.

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

getSuiteTags

public List<String> getSuiteTags ()

تعرض هذه السمة قائمة بعلامات الحزمة التي يشكّل الاختبار جزءًا منها.

المرتجعات
`List<String>`

isNotIRemoteTestShardable

public boolean isNotIRemoteTestShardable ()

تعرض هذه السمة ما إذا كان يجب تقسيم IRemoteTest إلى وحدات مختلفة.

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

isNotShardable

public boolean isNotShardable ()

تعرِض هذه السمة ما إذا كان الإعداد قابلاً للتجزئة أم لا كجزء من مجموعة

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

isNotStrictShardable

public boolean isNotStrictShardable ()

تعرِض هذه السمة ما إذا كان الإعداد قابلاً للتجزئة بشكل صارم أم لا كجزء من حزمة.

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

removeMetadata

public List<String> removeMetadata (String key)

أزِل عملية تتبُّع مفتاح البيانات الوصفية المحدّد.

المعلَمات
`key`	`String`

المرتجعات
`List<String>`

setAbi

public void setAbi (IAbi abi)

تضبط هذه السمة واجهة التطبيق الثنائية (ABI) التي سيتم تشغيل الإعدادات عليها.

المعلَمات
`abi`	`IAbi`

setMetaData

public void setMetaData (MultiMap<String, String> metadata)

المعلَمات
`metadata`	`MultiMap`

setModuleName

public void setModuleName (String name)

إذا كان هذا الإعداد يمثّل وحدة، يمكننا ضبط اسم الوحدة المرتبط به.

المعلَمات
`name`	`String`

setNotIRemoteTestShardable

public void setNotIRemoteTestShardable (boolean notIRemoteTestShardable)

المعلَمات
`notIRemoteTestShardable`	`boolean`

setSandboxed

public void setSandboxed (boolean useSandboxed)

تحدّد هذه السياسة ما إذا كان سيتم تشغيل الإعداد في وضع الحماية أو لا.

المعلَمات
`useSandboxed`	`boolean`

setShardIndex

public void setShardIndex (int index)

اضبط فهرس التقسيم للاستدعاء في التقسيم المحلي.

المعلَمات
`index`	`int`

setSuiteTags

public void setSuiteTags (List<String> suiteTags)

تضبط هذه السمة قائمة بعلامات المجموعة التي يشكّل الاختبار جزءًا منها.

المعلَمات
`suiteTags`	`List`

shouldUseSandbox

public boolean shouldUseSandbox ()

تعرِض القيمة "صحيح" إذا كان من المفترض أن يتم تشغيل الاستدعاء في الوضع المحمي. ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.

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

toProto

public ConfigurationDescription.Descriptor toProto ()

تحويل مثيل الواصف الحالي إلى تنسيق proto.

المرتجعات
`ConfigurationDescription.Descriptor`