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) قم بإرجاع المعلومات الموجودة على الاستدعاء مع تحديد معرف الاستدعاء. |
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) إيقاف استدعاء قيد التشغيل. |
default void | stopScheduling () يتوقف عن جدولة وقبول الاختبارات الجديدة ولكنه لا يوقف Tradefed. |
الأساليب العامة
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) الذي سيتم الإخراج إليه. |
تفريغCommandsXml
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)
قم بإرجاع المعلومات الموجودة على الاستدعاء مع تحديد معرف الاستدعاء.
حدود | |
---|---|
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 |
isDeviceInInvocationThread
public abstract boolean isDeviceInInvocationThread (ITestDevice device)
يُرجع صحيحًا إذا تم استخدام الجهاز بواسطة سلسلة استدعاء نشطة.
حدود | |
---|---|
device | ITestDevice |
عائدات | |
---|---|
boolean |
ينضم
public abstract void join (long millis)
ينتظر اكتمال الجدولة أو انتهاء المهلة بعد المدة المحددة بالمللي ثانية.
حدود | |
---|---|
millis | long |
أنظر أيضا:
RemoveAllCommands
public abstract void removeAllCommands ()
إزالة جميع الأوامر من المجدول
setClearcutClient
public abstract void setClearcutClient (ClearcutClient client)
قم بتعيين العميل للإبلاغ عن بيانات الحزام
حدود | |
---|---|
client | ClearcutClient |
يجب أن تكون ShutdownOnCmdfileError
public abstract boolean shouldShutdownOnCmdfileError ()
يُرجع صحيحًا إذا كنا بحاجة إلى إيقاف تشغيل المجدول بسبب أخطاء الأمر
عائدات | |
---|---|
boolean |
اغلق
public void shutdown ()
محاولة إيقاف تشغيل برنامج جدولة الأوامر بأمان.
يمسح الأوامر التي تنتظر الاختبار، ويطلب إغلاق جميع الاستدعاءات الجارية بأمان.
بعد استدعاء إيقاف التشغيل، ستنتظر الحلقة الرئيسية للمجدول حتى تكتمل جميع الاستدعاءات الجارية قبل الخروج تمامًا.
اغلق
public abstract void shutdown (boolean notifyStop)
محاولة إيقاف تشغيل برنامج جدولة الأوامر بأمان.
حدود | |
---|---|
notifyStop | boolean : إذا كان صحيحًا، يُعلم باستدعاءات إيقاف تشغيل TF. |
ShutdownHard
public abstract void shutdownHard (boolean killAdb)
محاولة إيقاف تشغيل برنامج جدولة الأوامر بالقوة.
يشبه الأمر shutdown()
، ولكنه سيؤدي أيضًا إلى إنهاء اتصال adb بشكل اختياري، في محاولة "لإلهام" الاستدعاءات الجارية لإكمالها بشكل أسرع.
حدود | |
---|---|
killAdb | boolean |
ShutdownHard
public abstract void shutdownHard ()
محاولة إيقاف تشغيل برنامج جدولة الأوامر بالقوة. نفس ShutdownHard (صحيح).
ShutdownOnEmpty
public abstract void shutdownOnEmpty ()
يشبه الأمر shutdown()
، ولكنه بدلاً من ذلك سينتظر تنفيذ جميع الأوامر قبل الخروج.
لاحظ أنه في حالة وجود أي أوامر في وضع الحلقة، فلن يخرج المجدول أبدًا.
يبدأ
public abstract void start ()
ابدأ برنامج ICommandScheduler
.
يجب الاتصال به قبل الاتصال بالطرق الأخرى.
سيتم تشغيله حتى يتم استدعاء shutdown()
. راجع Thread.start()
.
stopInvocation
public abstract boolean stopInvocation (int invocationId, String cause)
قم بإيقاف استدعاء قيد التشغيل عن طريق تحديد معرفه.
حدود | |
---|---|
invocationId | int : معرف التتبع للاستدعاء. |
cause | String : سبب إيقاف الاستدعاء. |
عائدات | |
---|---|
boolean | صحيح إذا تم إيقاف الاستدعاء، وباطل فيما عدا ذلك |
رميات | |
---|---|
UnsupportedOperationException | إذا كان التنفيذ لا يدعم هذا |
stopInvocation
public boolean stopInvocation (int invocationId)
قم بإيقاف استدعاء قيد التشغيل عن طريق تحديد معرفه.
حدود | |
---|---|
invocationId | int |
عائدات | |
---|---|
boolean | صحيح إذا تم إيقاف الاستدعاء، وباطل فيما عدا ذلك |
رميات | |
---|---|
UnsupportedOperationException | إذا كان التنفيذ لا يدعم هذا |
stopInvocation
public abstract boolean stopInvocation (ITestInvocation invocation)
إيقاف استدعاء قيد التشغيل.
حدود | |
---|---|
invocation | ITestInvocation |
عائدات | |
---|---|
boolean | صحيح إذا تم إيقاف الاستدعاء، وباطل فيما عدا ذلك |
رميات | |
---|---|
UnsupportedOperationException | إذا كان التنفيذ لا يدعم هذا |
stopScheduling
public void stopScheduling ()
يتوقف عن جدولة وقبول الاختبارات الجديدة ولكنه لا يوقف Tradefed. ويهدف هذا إلى تمكين إيقاف التشغيل على خطوتين حيث نقوم أولاً باستنزاف كافة الاختبارات الجارية، ثم إنهاء عملية Tradefed.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2023-12-01 (حسب التوقيت العالمي المتفَّق عليه)