ICommandScheduler
public interface ICommandScheduler
com.android.tradefed.command.ICommandScheduler |
جدولة لتشغيل أوامر TradeFederation.
ملخص
فئات متداخلة | |
---|---|
interface | ICommandScheduler.IScheduledInvocationListener مستمع لأحداث الاحتجاج عند اكتمال الاستدعاء. |
الأساليب العامة | |
---|---|
abstract Pair <Boolean, Integer> | addCommand (String[] args) يضيف أمرًا إلى المجدول. |
abstract void | addCommandFile (String cmdFile, extraArgs) addCommandFile (String cmdFile, extraArgs) يضيف كل الأوامر من ملف معين إلى المجدول |
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, devices, String[] args) execCommand ( ICommandScheduler.IScheduledInvocationListener listener, devices, String[] args) تنفيذ الأمر مباشرة على الأجهزة المخصصة بالفعل. |
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) يعود صحيحًا إذا تم استخدام الجهاز بواسطة سلسلة استدعاء نشطة. |
abstract void | join () ينتظر حتى يكتمل المجدول. |
abstract void | join (long millis) ينتظر اكتمال المجدول أو انتهاء المهلة بعد المدة المحددة بالمللي ثانية. |
abstract void | removeAllCommands () قم بإزالة كافة الأوامر من المجدول |
abstract void | setClearcutClient (ClearcutClient client) اضبط العميل على الإبلاغ عن بيانات التسخير |
abstract boolean | shouldShutdownOnCmdfileError () العودة صحيحًا إذا احتجنا إلى إيقاف تشغيل المجدول عند حدوث أخطاء في الأمر |
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) وقف الدعاء الجاري. |
الأساليب العامة
addCommand
public abstract Pair<Boolean, Integer> addCommand (String[] args)
يضيف أمرًا إلى المجدول.
الأمر هو في الأساس مثيل للتكوين الذي سيتم تشغيله والوسيطات المرتبطة به.
إذا تم تحديد الوسيطة "--help" ، فسيتم إخراج نص التعليمات الخاص بالتكوين إلى stdout. خلاف ذلك ، ستتم إضافة التكوين إلى قائمة الانتظار للتشغيل.
حدود | |
---|---|
args | String : وسيطات التكوين. |
عائدات | |
---|---|
Pair <Boolean, Integer> | زوج من القيم ، القيمة الأولى هي قيمة منطقية true إذا تم إضافة الأمر بنجاح. القيمة الثانية هي معرف تعقب الأمر المعروف (قيمة غير سالبة) إذا تمت إضافة الأمر بنجاح ، فقم بإرجاع 0 عند إضافة الأمر لجميع الأجهزة ، وإلا -1. |
رميات | |
---|---|
ConfigurationException | إذا تعذر تحليل الأمر |
addCommandFile
public abstract void addCommandFile (String cmdFile,extraArgs)
يضيف كل الأوامر من ملف معين إلى المجدول
حدود | |
---|---|
cmdFile | String : مسار نظام الملفات لملف comand |
extraArgs | ERROR(/List) من وسيطات String لإلحاقها بكل أمر تم تحليله من الملف. يمكن أن يكون فارغًا ولكن لا يجب أن يكون فارغًا. |
رميات | |
---|---|
ConfigurationException | إذا تعذر تحليل ملف الأوامر |
أنظر أيضا:
انتظر
public abstract void await ()
انتظار بدء تشغيل المجدول ، بما في ذلك انتظار التسليم من فريق العمل القديم حتى يكتمل إن أمكن.
displayCommandQueue
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 ) ERROR(/List ) للاستخدام |
args | String : وسيطات الأمر |
عائدات | |
---|---|
long | معرّف الاستدعاء للأمر المجدول. |
رميات | |
---|---|
ConfigurationException | إذا كان الأمر غير صالح |
getCommandFileWatcher
public abstract CommandFileWatcher getCommandFileWatcher ()
احصل على CommandFileWatcher المناسب لهذا المجدول
عائدات | |
---|---|
CommandFileWatcher |
getExecutingCommandCount
public abstract int getExecutingCommandCount ()
إرجاع عدد الأوامر في حالة التنفيذ.
عائدات | |
---|---|
int |
getInvocationInfo
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 |
getReadyCommandCount
public abstract int getReadyCommandCount ()
تُرجع عدد الأوامر في حالة الاستعداد في قائمة الانتظار.
عائدات | |
---|---|
int |
isDeviceInvocationThread
public abstract boolean isDeviceInInvocationThread (ITestDevice device)
يعود صحيحًا إذا تم استخدام الجهاز بواسطة سلسلة استدعاء نشطة.
حدود | |
---|---|
device | ITestDevice |
عائدات | |
---|---|
boolean |
ينضم
public abstract void join (long millis)
ينتظر اكتمال المجدول أو انتهاء المهلة بعد المدة المحددة بالمللي ثانية.
حدود | |
---|---|
millis | long |
أنظر أيضا:
إزالة AllCommands
public abstract void removeAllCommands ()
قم بإزالة كافة الأوامر من المجدول
setClearcutClient
public abstract void setClearcutClient (ClearcutClient client)
اضبط العميل على الإبلاغ عن بيانات التسخير
حدود | |
---|---|
client | ClearcutClient |
shouldShutdownOnCmdfileError
public abstract boolean shouldShutdownOnCmdfileError ()
العودة صحيحًا إذا احتجنا إلى إيقاف تشغيل المجدول عند حدوث أخطاء في الأمر
عائدات | |
---|---|
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 ()
محاولة إيقاف تشغيل برنامج جدولة الأوامر بالقوة. نفس الاغلاق صعب (صحيح).
إيقاف التشغيل فارغة
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 | صحيح إذا تم إيقاف الاحتجاج ، وخلاف ذلك خطأ |
رميات | |
---|---|
UnsupportedOperationException | إذا كان التنفيذ لا يدعم هذا |
وقف الدعوة
public boolean stopInvocation (int invocationId)
أوقف الاحتجاج الجاري بتحديد معرفه.
حدود | |
---|---|
invocationId | int |
عائدات | |
---|---|
boolean | صحيح إذا تم إيقاف الاحتجاج ، وخلاف ذلك خطأ |
رميات | |
---|---|
UnsupportedOperationException | إذا كان التنفيذ لا يدعم هذا |
وقف الدعوة
public abstract boolean stopInvocation (ITestInvocation invocation)
وقف الدعاء الجاري.
حدود | |
---|---|
invocation | ITestInvocation |
عائدات | |
---|---|
boolean | صحيح إذا تم إيقاف الاحتجاج ، وخلاف ذلك خطأ |
رميات | |
---|---|
UnsupportedOperationException | إذا كان التنفيذ لا يدعم هذا |
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2023-07-19 (حسب التوقيت العالمي المتفَّق عليه)