Commandscheduler
public
interface
ICommandScheduler
com.android.tradefed.command.ICommandscheduler |
أداة جدولة لتشغيل أوامر TradeFederation.
ملخّص
الصفوف المتداخلة | |
---|---|
interface |
ICommandScheduler.IScheduledInvocationListener
أداة معالجة أحداث الاستدعاء عند اكتمال الاستدعاء |
الطرق العامة | |
---|---|
abstract
Pair<Boolean, Integer>
|
addCommand(String[] args)
إضافة أمر إلى أداة الجدولة. |
abstract
void
|
addCommandFile(String cmdFile,
إضافة جميع الأوامر من ملف معين إلى أداة الجدولة |
abstract
void
|
await()
الانتظار حتى بدء تشغيل أداة الجدولة، بما في ذلك انتظار التسليم من فريق العمل القديم لإكمال إن أمكن. |
abstract
void
|
displayCommandQueue(PrintWriter printWriter)
الحصول على معلومات تصحيح الأخطاء التفصيلية حول حالة قائمة انتظار تنفيذ الأمر |
abstract
void
|
displayCommandsInfo(PrintWriter printWriter, String regex)
إخراج قائمة بالأوامر الحالية |
abstract
void
|
displayInvocationsInfo(PrintWriter printWriter)
لعرض قائمة بالاستدعاءات الحالية. |
abstract
void
|
dumpCommandsXml(PrintWriter printWriter, String regex)
عليك تفريغ ملف xml الموسَّع للأمر مع تضمين جميع
تم تحديد قيم |
abstract
long
|
execCommand(IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, String[] args)
يؤدي هذا الخيار إلى تخصيص جهاز وتنفيذ الأمر بشكل مباشر بدون إضافته إلى قائمة انتظار الأوامر
باستخدام |
abstract
long
|
execCommand(ICommandScheduler.IScheduledInvocationListener listener, String[] args)
يؤدي هذا الإعداد إلى تخصيص جهاز وتنفيذ الأمر بشكل مباشر بدون إضافته إلى قائمة انتظار الأوامر. |
abstract
long
|
execCommand(ICommandScheduler.IScheduledInvocationListener listener,
تنفيذ الأمر مباشرةً على الأجهزة المخصّصة |
abstract
CommandFileWatcher
|
getCommandFileWatcher()
احصل على CommandFileWatcher المناسب لأداة الجدولة هذه |
abstract
int
|
getExecutingCommandCount()
تعرض عدد الأوامر في حالة التنفيذ. |
abstract
String
|
getInvocationInfo(int invocationId)
عرض المعلومات على رمز bu للاستدعاء مع تحديد معرّف الاستدعاء |
abstract
CommandRunner.ExitCode
|
getLastInvocationExitCode()
يعرض رمز الخطأ لآخر استدعاء تم تشغيله. |
abstract
Throwable
|
getLastInvocationThrowable()
يمكنك عرض |
abstract
int
|
getReadyCommandCount()
تعرض عدد الأوامر في حالة جاهزة في قائمة الانتظار. |
abstract
boolean
|
isDeviceInInvocationThread(ITestDevice device)
تعرض القيمة true إذا كان الجهاز قيد الاستخدام بواسطة سلسلة استدعاء نشطة. |
abstract
void
|
join()
في انتظار اكتمال أداة الجدولة. |
abstract
void
|
join(long millis)
بانتظار اكتمال أداة الجدولة أو انتهاء المهلة بعد انتهاء المدة المحددة بالمللي ثانية. |
abstract
void
|
removeAllCommands()
إزالة جميع الأوامر من أداة الجدولة |
abstract
void
|
setClearcutClient(ClearcutClient client)
ضبط العميل للإبلاغ عن بيانات مجموعة أدوات السلامة |
abstract
boolean
|
shouldShutdownOnCmdfileError()
إرجاع true إذا احتجنا إلى إيقاف تشغيل أداة الجدولة في أخطاء الأوامر |
default
void
|
shutdown()
حاول إيقاف تشغيل أداة جدولة الأوامر بسلاسة. |
abstract
void
|
shutdown(boolean notifyStop)
حاول إيقاف تشغيل أداة جدولة الأوامر بسلاسة. |
abstract
void
|
shutdownHard(boolean killAdb)
حاول فرض إيقاف تشغيل أداة جدولة الأوامر. |
abstract
void
|
shutdownHard()
حاول فرض إيقاف تشغيل أداة جدولة الأوامر. |
abstract
void
|
shutdownOnEmpty()
يشبه الأمر |
abstract
void
|
start()
ابدأ تشغيل " |
abstract
boolean
|
stopInvocation(int invocationId, String cause)
يمكنك إيقاف استدعاء حالي من خلال تحديد معرّفه. |
default
boolean
|
stopInvocation(int invocationId)
يمكنك إيقاف استدعاء حالي من خلال تحديد معرّفه. |
abstract
boolean
|
stopInvocation(ITestInvocation invocation)
إيقاف استدعاء قيد التشغيل. |
default
void
|
stopScheduling()
يؤدي هذا الخيار إلى إيقاف جدولة وقبول الاختبارات الجديدة ولكن لا يؤدي إلى إيقاف مقايضة الجهاز. |
الطرق العامة
إضافة Command
public abstract Pair<Boolean, Integer> addCommand (String[] args)
إضافة أمر إلى أداة الجدولة.
الأمر في الأساس هو مثيل لعملية التهيئة التي يتم تشغيلها وما يرتبط بها الوسيطة.
إذا كانت الإجابة "--help" يتم تحديد وسيطة سيتم إخراج نص المساعدة للتهيئة إلى stdout. وإذا لم تفعل ذلك، ستتم إضافة الإعدادات إلى قائمة الانتظار لتنفيذها.
المعلمات | |
---|---|
args |
String : وسيطات الإعداد |
المرتجعات | |
---|---|
Pair<Boolean, Integer> |
زوج من القيم، تكون القيمة الأولى هي true المنطقية إذا تمت إضافة الأمر
بنجاح. والقيمة الثانية هي معرّف متتبع الأوامر المعروف(قيمة غير سالبة) إذا كانت
تمت إضافة الأمر بنجاح، يعرض 0 عند إضافة الأمر لجميع الأجهزة، وبخلاف ذلك
1- |
الرميات | |
---|---|
ConfigurationException |
إذا تعذر تحليل الأمر |
يُرجى الاطّلاع أيضًا على:
إضافة ملف الأوامر
public abstract void addCommandFile (String cmdFile,extraArgs)
إضافة جميع الأوامر من ملف معين إلى أداة الجدولة
المعلمات | |
---|---|
cmdFile |
String : مسار نظام الملفات الخاص بملف comand |
extraArgs |
: ERROR(/List) من String وسيطة لإلحاقها بكل أمر تم تحليله
من ملف. يمكن أن تكون فارغة ولكن يجب ألا تكون فارغة. |
الرميات | |
---|---|
ConfigurationException |
إذا تعذّر تحليل ملف الأوامر |
يُرجى الاطّلاع أيضًا على:
بانتظارك
public abstract void await ()
الانتظار حتى بدء تشغيل أداة الجدولة، بما في ذلك انتظار التسليم من فريق العمل القديم لإكمال إن أمكن.
displayCommandقائمة الانتظار
public abstract void displayCommandQueue (PrintWriter printWriter)
الحصول على معلومات تصحيح الأخطاء التفصيلية حول حالة قائمة انتظار تنفيذ الأمر
displayCommandsInfo
public abstract void displayCommandsInfo (PrintWriter printWriter, String regex)
إخراج قائمة بالأوامر الحالية
المعلمات | |
---|---|
printWriter |
PrintWriter : السمة ERROR(/PrintWriter) المطلوب إخراجها إليها |
regex |
String : التعبير العادي الذي يجب مطابقة الأوامر معه لكي تتم مطابقته
طبعًا. إذا كانت القيمة فارغة، فستتم طباعة جميع الأوامر. |
معلومات DisplayInvocationsInfo
public abstract void displayInvocationsInfo (PrintWriter printWriter)
لعرض قائمة بالاستدعاءات الحالية.
المعلمات | |
---|---|
printWriter |
PrintWriter : السمة ERROR(/PrintWriter) المطلوب إخراجها إليها |
dumpCommandsXml
public abstract void dumpCommandsXml (PrintWriter printWriter, String regex)
عليك تفريغ ملف xml الموسَّع للأمر مع تضمين جميع
تم تحديد قيم Option
لكل الأوامر الحالية.
المعلمات | |
---|---|
printWriter |
PrintWriter : ERROR(/PrintWriter) المطلوب إخراج الحالة إليه. |
regex |
String : التعبير العادي الذي يجب مطابقته مع الأوامر من أجل
ملف xml. إذا كانت القيمة خالية، سيتم تنفيذ كل الأوامر. |
أمر execCommand
public abstract long execCommand (IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, String[] args)
يؤدي هذا الخيار إلى تخصيص جهاز وتنفيذ الأمر بشكل مباشر بدون إضافته إلى قائمة انتظار الأوامر
باستخدام IInvocationContext
حالية.
المعلمات | |
---|---|
context |
IInvocationContext : عنصر IInvocationContext حالي |
listener |
ICommandScheduler.IScheduledInvocationListener : ICommandScheduler.IScheduledInvocationListener التي سيتم إعلامك بها |
args |
String : وسيطات الأوامر |
المرتجعات | |
---|---|
long |
الرميات | |
---|---|
ConfigurationException |
إذا كان الأمر غير صالح |
NoDeviceException |
إذا لم يكن هناك جهاز لاستخدامه |
أمر execCommand
public abstract long execCommand (ICommandScheduler.IScheduledInvocationListener listener, String[] args)
يؤدي هذا الإعداد إلى تخصيص جهاز وتنفيذ الأمر بشكل مباشر بدون إضافته إلى قائمة انتظار الأوامر.
المعلمات | |
---|---|
listener |
ICommandScheduler.IScheduledInvocationListener : ICommandScheduler.IScheduledInvocationListener التي سيتم إعلامك بها |
args |
String : وسيطات الأوامر |
المرتجعات | |
---|---|
long |
معرِّف الاستدعاء للأمر المُجدوَل. |
الرميات | |
---|---|
ConfigurationException |
إذا كان الأمر غير صالح |
NoDeviceException |
إذا لم يكن هناك جهاز لاستخدامه |
أمر execCommand
public abstract long execCommand (ICommandScheduler.IScheduledInvocationListener listener,devices, String[] args)
تنفيذ الأمر مباشرةً على الأجهزة المخصّصة
المعلمات | |
---|---|
listener |
ICommandScheduler.IScheduledInvocationListener : ICommandScheduler.IScheduledInvocationListener التي سيتم إعلامك بها |
devices |
: السمة ERROR(/List المطلوب استخدامها |
args |
String : وسيطات الأوامر |
المرتجعات | |
---|---|
long |
معرِّف الاستدعاء للأمر المُجدوَل. |
الرميات | |
---|---|
ConfigurationException |
إذا كان الأمر غير صالح |
الحصول على CommandFileWatcher
public abstract CommandFileWatcher getCommandFileWatcher ()
احصل على CommandFileWatcher المناسب لأداة الجدولة هذه
المرتجعات | |
---|---|
CommandFileWatcher |
getExecutingCommandCount
public abstract int getExecutingCommandCount ()
تعرض عدد الأوامر في حالة التنفيذ.
المرتجعات | |
---|---|
int |
الحصول على معلومات الاستدعاء
public abstract String getInvocationInfo (int invocationId)
عرض المعلومات على رمز bu للاستدعاء مع تحديد معرّف الاستدعاء
المعلمات | |
---|---|
invocationId |
int : رقم تعريف تتبّع الاستدعاء |
المرتجعات | |
---|---|
String |
تمثّل هذه السمة String تحتوي على معلومات عن الاستدعاء. |
getLastInvocationExitCode
public abstract CommandRunner.ExitCode getLastInvocationExitCode ()
يعرض رمز الخطأ لآخر استدعاء تم تشغيله. يعرض 0 (بدون خطأ)، إذا لم يتم استدعاء بعد.
المرتجعات | |
---|---|
CommandRunner.ExitCode |
getLastInvocationThrowable
public abstract Throwable getLastInvocationThrowable ()
يمكنك عرض Throwable
من آخر استدعاء تم تشغيله.
إرجاع "فارغ" (فارغ)، في حال عدم توفر أي قابل للرمي.
المرتجعات | |
---|---|
Throwable |
getREADCommandCount
public abstract int getReadyCommandCount ()
تعرض عدد الأوامر في حالة جاهزة في قائمة الانتظار.
المرتجعات | |
---|---|
int |
سلسلة استدعاءات isDeviceInvocationThread
public abstract boolean isDeviceInInvocationThread (ITestDevice device)
تعرض القيمة true إذا كان الجهاز قيد الاستخدام بواسطة سلسلة استدعاء نشطة.
المعلمات | |
---|---|
device |
ITestDevice |
المرتجعات | |
---|---|
boolean |
انضمام
public abstract void join ()
في انتظار اكتمال أداة الجدولة.
يُرجى الاطّلاع أيضًا على:
انضمام
public abstract void join (long millis)
بانتظار اكتمال أداة الجدولة أو انتهاء المهلة بعد انتهاء المدة المحددة بالمللي ثانية.
المعلمات | |
---|---|
millis |
long |
يُرجى الاطّلاع أيضًا على:
أوامر إزالة كل الأوامر
public abstract void removeAllCommands ()
إزالة جميع الأوامر من أداة الجدولة
setClearcutClient
public abstract void setClearcutClient (ClearcutClient client)
ضبط العميل للإبلاغ عن بيانات مجموعة أدوات السلامة
المعلمات | |
---|---|
client |
ClearcutClient |
يجب إيقاف تشغيلCmdfileError
public abstract boolean shouldShutdownOnCmdfileError ()
إرجاع true إذا احتجنا إلى إيقاف تشغيل أداة الجدولة في أخطاء الأوامر
المرتجعات | |
---|---|
boolean |
إيقاف التشغيل
public void shutdown ()
حاول إيقاف تشغيل أداة جدولة الأوامر بسلاسة.
يمحو الأوامر التي تنتظر اختبارها ويطلب إيقاف جميع الاستدعاءات الجارية بشكل رشيق.
بعد استدعاء إيقاف التشغيل، ستنتظر الحلقة الرئيسية لأداة الجدولة جميع الاستدعاءات في التقدم الذي يتم إنجازه قبل الخروج تمامًا.
إيقاف التشغيل
public abstract void shutdown (boolean notifyStop)
حاول إيقاف تشغيل أداة جدولة الأوامر بسلاسة.
المعلمات | |
---|---|
notifyStop |
boolean : إذا كانت القيمة صحيحة، سيتم إرسال إشعار إلى إيقاف تشغيل TF. |
إيقاف صعب
public abstract void shutdownHard (boolean killAdb)
حاول فرض إيقاف تشغيل أداة جدولة الأوامر.
على غرار shutdown()
، ولكنها أيضًا سوف تؤدي اختياريًا إلى إنهاء اتصال adb، في
محاولة "إلهام" الاستدعاءات قيد التقدم حتى تكتمل بشكل أسرع.
المعلمات | |
---|---|
killAdb |
boolean |
إيقاف صعب
public abstract void shutdownHard ()
حاول فرض إيقاف تشغيل أداة جدولة الأوامر. مثل offHard(true).
إيقاف التشغيل على الجهاز الفارغة
public abstract void shutdownOnEmpty ()
يشبه الأمر shutdown()
، ولكن بدلاً من ذلك سينتظر تنفيذ جميع الأوامر
قبل الخروج.
لاحظ أنه إذا كانت أي أوامر في وضع التكرار، فلن يتم إنهاء أداة الجدولة أبدًا.
بدء
public abstract void start ()
ابدأ تشغيل "ICommandScheduler
".
يجب طلبها قبل استدعاء طرق أخرى.
سيتم التنفيذ حتى يتم استدعاء "shutdown()
".
يمكنك الاطّلاع على Thread.start()
.
إيقاف الاستدعاء
public abstract boolean stopInvocation (int invocationId, String cause)
يمكنك إيقاف استدعاء حالي من خلال تحديد معرّفه.
المعلمات | |
---|---|
invocationId |
int : رقم تعريف تتبّع الاستدعاء |
cause |
String : سبب إيقاف الاستدعاء |
المرتجعات | |
---|---|
boolean |
true إذا تم إيقاف الاستدعاء، وخطأ في الحالات الأخرى |
الرميات | |
---|---|
UnsupportedOperationException |
إذا لم يكن التنفيذ يتيح ذلك |
إيقاف الاستدعاء
public boolean stopInvocation (int invocationId)
يمكنك إيقاف استدعاء حالي من خلال تحديد معرّفه.
المعلمات | |
---|---|
invocationId |
int |
المرتجعات | |
---|---|
boolean |
true إذا تم إيقاف الاستدعاء، وخطأ في الحالات الأخرى |
الرميات | |
---|---|
UnsupportedOperationException |
إذا لم يكن التنفيذ يتيح ذلك |
إيقاف الاستدعاء
public abstract boolean stopInvocation (ITestInvocation invocation)
إيقاف استدعاء قيد التشغيل.
المعلمات | |
---|---|
invocation |
ITestInvocation |
المرتجعات | |
---|---|
boolean |
true إذا تم إيقاف الاستدعاء، وخطأ في الحالات الأخرى |
الرميات | |
---|---|
UnsupportedOperationException |
إذا لم يكن التنفيذ يتيح ذلك |
إيقاف الجدولة
public void stopScheduling ()
يؤدي هذا الخيار إلى إيقاف جدولة وقبول الاختبارات الجديدة ولكن لا يؤدي إلى إيقاف مقايضة الجهاز. يهدف هذا إلى تفعيل إيقاف تشغيل مكون من خطوتين، حيث نقوم أولاً باستنزاف جميع الاختبارات الجارية، ثم ننهي تطبيق Tradefed الدفع.