گزینه
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 () هنگامی که یک گزینه چندین بار مشخص می شود، رفتار را کنترل می کند. |
ثابت ها
NO_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" یا "4ms". تمام فضای خالی تعبیه شده کنار گذاشته می شود.
برمی گرداند | |
---|---|
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 = نام کوتاه. '0' به این معناست که گزینه shortName ندارد.
برمی گرداند | |
---|---|
char |
updateRule
public OptionUpdateRule updateRule ()
هنگامی که یک گزینه چندین بار مشخص می شود، رفتار را کنترل می کند. توجه داشته باشید که این قانون برای گزینه هایی که ERROR(/Collection)
s یا ERROR(/Map)
s هستند، به طور کامل نادیده گرفته می شود.
برمی گرداند | |
---|---|
OptionUpdateRule |