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

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

ConfigurationDescriptor

public class ConfigurationDescriptor
extends Object

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, values)` إضافة المزيد من قيم مفتاح معيّن إلى إدخالات البيانات الوصفية
`void`	`addRerunOption(OptionDef optionDef)` أضِف الخيار إلى قائمة الخيارات التي يمكن استخدامها لإعادة تشغيل الاختبار.
`ConfigurationDescriptor`	`clone()` إرجاع نسخة طبق الأصل من الكائن `ConfigurationDescriptor`
`static ConfigurationDescriptor`	`fromProto(ConfigurationDescription.Descriptor protoDescriptor)` العملية العكسية من `toProto()` لاستعادة العنصر
`IAbi`	`getAbi()` تعرِض هذه السمة واجهة التطبيق الثنائية (ABI) التي يتم تشغيل الإعدادات عليها إذا كانت معروفة، أو قيمة فارغة في حال عدم توفّرها.
`MultiMap<String, String>`	`getAllMetaData()` يستردّ هذا الإجراء جميع البيانات الوصفية التي تم ضبط إعداداتها ويعرض نسخة من الخريطة.
	`getMetaData(String name)` الحصول على إدخالات البيانات الوصفية المسماة
`String`	`getModuleName()` تعرض هذه السمة اسم وحدة إعدادات الوحدة.
	`getRerunOptions()` احصل على قائمة `OptionDef` التي يمكن استخدامها لإعادة التشغيل.
`Integer`	`getShardIndex()` احصل على فهرس التقسيم أثناء التقسيم المحلي.
	`getSuiteTags()` تعرض هذه السمة قائمة بعلامات الحزمة التي يشكّل الاختبار جزءًا منها.
`boolean`	`isNotIRemoteTestShardable()` تعرض هذه السمة ما إذا كان يجب أن يقسّم الإعداد IRemoteTest إلى وحدات مختلفة.
`boolean`	`isNotShardable()` تعرِض هذه السمة ما إذا كان الإعداد قابلاً للتجزئة أم لا كجزء من حزمة.
`boolean`	`isNotStrictShardable()` تعرِض هذه السمة ما إذا كان الإعداد قابلاً للتجزئة بشكل صارم أم لا كجزء من حزمة.
	`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( suiteTags)` تضبط هذه السمة قائمة بعلامات المجموعة التي يشكّل الاختبار جزءًا منها.
`boolean`	`shouldUseSandbox()` تعرِض القيمة "صحيح" إذا كان من المفترض أن يتم تشغيل الاستدعاء في الوضع المحمي.
`ConfigurationDescription.Descriptor`	`toProto()` تحويل مثيل الواصف الحالي إلى تنسيق البروتوكول.

الثوابت

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, 
                 values)

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

المعلمات
`key`	`String`: `String` المفتاح الذي ستتم إضافة القيم إليه.
`values`	: قائمة تضم `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  getMetaData (String name)

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

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

المرتجعات

getModuleName

public String getModuleName ()

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

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

getRerunOptions

public  getRerunOptions ()

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

المرتجعات

getShardIndex

public Integer getShardIndex ()

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

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

getSuiteTags

public  getSuiteTags ()

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

المرتجعات

isNotIRemoteTestShardable

public boolean isNotIRemoteTestShardable ()

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

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

isNotShardable

public boolean isNotShardable ()

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

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

isNotStrictShardable

public boolean isNotStrictShardable ()

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

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

removeMetadata

public  removeMetadata (String key)

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

المعلمات
`key`	`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 ( suiteTags)

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

المعلمات
`suiteTags`

shouldUseSandbox

public boolean shouldUseSandbox ()

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

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

toProto

public ConfigurationDescription.Descriptor toProto ()

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

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