Option
public
abstract
@interface
Option
implements
Annotation
| com.android.tradefed.config.Option |
تتم إضافة تعليق توضيحي إلى حقل للإشارة إلى أنّه يمثّل خيار IConfiguration.
ملخّص
الثوابت | |
|---|---|
char |
NO_SHORT_NAME
|
الطرق العامة | |
|---|---|
String
|
description()
وصف سهل الاستخدام للخيار. |
Option.Importance
|
importance()
أهمية الخيار. |
boolean
|
isTimeVal()
ما إذا كان الخيار يمثّل قيمة زمنية. |
boolean
|
mandatory()
ما إذا كان الخيار إلزاميًا أو اختياريًا. |
String
|
name()
الاسم الفريد الإلزامي لهذا الخيار. |
boolean
|
requiredForRerun()
ما إذا كان الخيار مطلوبًا لتجميع التعليمات لإعادة إجراء الاختبار |
char
|
shortName()
اسم مختصر اختياري للخيار |
OptionUpdateRule
|
updateRule()
تتحكّم هذه السياسة في السلوك عند تحديد خيار عدّة مرات. |
الثوابت
لا يوجد_SHORT_NAME
public static final char NO_SHORT_NAME
القيمة الثابتة: 48 (0x00000030)
الطرق العامة
الوصف
public String description ()
وصف سهل الاستخدام للخيار.
| المرتجعات | |
|---|---|
String |
|
الأهمية
public Option.Importance importance ()
أهمية الخيار.
خيار يُعد "مهمًا" في عنوان التعليمات المختصرة. المساعدة بشأن غير المهم فقط في نص المساعدة الكامل.
| المرتجعات | |
|---|---|
Option.Importance |
|
isTimeVal
public boolean isTimeVal ()
ما إذا كان الخيار يمثّل قيمة زمنية.
وإذا كانت هذه قيمة زمنية، سيتم تحليل اللاحقات الخاصة بالوقت. المجال
long أو Long حتى تكون هذه العلامة صالحة. سيتم طرح ConfigurationException في الحالات الأخرى.
الوحدة التلقائية هي بالمللي ثانية. سيقبل إطار عمل الضبط s لمدة ثوانٍ
(1000 مللي ثانية)، أو m للدقائق (60 ثانية)، أو h للساعات (60 دقيقة)، أو
d للأيام (24 ساعة).
يمكن مزج الوحدات ومطابقتها طالما أن كل وحدة تظهر مرة واحدة على الأكثر، وما دام
يتم سرد جميع الوحدات التي تظهر بترتيب تنازلي حسب المقياس. لذلك، على سبيل المثال، قد تظهر السمة h قبل m فقط وقد تظهر بعد d. على سبيل المثال،
مثال، "1d2h3m4s5ms" قيمة زمنية صالحة، كما هو الحال مع "4" أو "4 ملي ثانية". الكل مضمّن
إلغاء المسافة البيضاء.
| المرتجعات | |
|---|---|
boolean |
|
إلزامي
public boolean mandatory ()
ما إذا كان الخيار إلزاميًا أو اختياريًا.
سيعرض إطار عمل الضبط ConfigurationException إذا كان أيٌّ من
ينطبق ما يلي على الحقل الإلزامي بعد تحليل الخيارات من جميع المصادر:
- الحقل هو
null. - الحقل هو
ERROR(/Collection)فارغ.
| المرتجعات | |
|---|---|
boolean |
|
اسم
public String name ()
الاسم الفريد الإلزامي لهذا الخيار.
سيتم ربط هذا النص بوسيطة سطر أوامر مسبوقة بالرمزين "-". الأحرف.
على سبيل المثال، يمكن أن يحتوي Option بالاسم "help" سيتم تحديدها بـ "--help" في صفحة
سطر الأوامر.
لا يمكن أن تحتوي الأسماء على نقطتين مثل ':'.
| المرتجعات | |
|---|---|
String |
|
مطلوب لبرنامج إعادة التشغيل
public boolean requiredForRerun ()
ما إذا كان الخيار مطلوبًا لتجميع التعليمات لإعادة إجراء الاختبار
قد يحاول الشخص الذي أبلغ عن النتائج تجميع التعليمات حول كيفية إعادة إجراء الاختبار وتضمين رسالة في النتيجة. يجب أن تتضمّن التعليمات جميع الخيارات التي تنطبق على الاختبار. أُعيد عرضه. تُستخدم هذه السمة للإشارة إلى ما إذا كان الخيار سيتم تضمينه في تلك التعليمات.
| المرتجعات | |
|---|---|
boolean |
|
الاسم المختصر
public char shortName ()
اسم مختصر اختياري للخيار سيتم ربط هذا النص بوسيطة سطر أوامر تبدأ بعلامة "-" واحدة. مثلاً: "-h" حيث h = ShortName. "0" يعني أن الخيار لا يحتوي على اسم مختصر.
| المرتجعات | |
|---|---|
char |
|
أمر UpdateRule
public OptionUpdateRule updateRule ()
تتحكّم هذه السياسة في السلوك عند تحديد خيار عدّة مرات. لاحظ أن هذه القاعدة
سيتم تجاهلها تمامًا للخيارات التي تبلغ ERROR(/Collection) أو ERROR(/Map).
| المرتجعات | |
|---|---|
OptionUpdateRule |
|