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, List<String> extraArgs)

يضيف هذا الإجراء جميع الأوامر من الملف المحدّد إلى أداة الجدولة

abstract void await()

ينتظر هذا الإجراء حتى يبدأ المجدول في العمل، بما في ذلك انتظار اكتمال عملية النقل من الإصدار القديم من TensorFlow، إذا كان ذلك منطبقًا.

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 الموسّع للأمر مع جميع قيم Option المحدّدة لجميع الأوامر الحالية

abstract long execCommand(IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, String[] args)

يخصّص الجهاز مباشرةً وينفّذ أمرًا بدون إضافته إلى قائمة انتظار الأوامر باستخدام IInvocationContext حالي.

abstract long execCommand(ICommandScheduler.IScheduledInvocationListener listener, String[] args)

يخصّص هذا الخيار جهازًا وينفّذ أمرًا مباشرةً بدون إضافته إلى قائمة انتظار الأوامر.

abstract long execCommand(ICommandScheduler.IScheduledInvocationListener listener, ITestDevice device, String[] args)

تنفيذ الأمر مباشرةً على الجهاز الذي تم تخصيصه مسبقًا

abstract long execCommand(ICommandScheduler.IScheduledInvocationListener listener, List<ITestDevice> devices, String[] args)

تنفيذ الأمر مباشرةً على الأجهزة التي تم تخصيصها مسبقًا

abstract CommandFileWatcher getCommandFileWatcher()

الحصول على CommandFileWatcher المناسب لهذا المجدول

abstract int getExecutingCommandCount()

تعرض هذه السمة عدد الأوامر في حالة التنفيذ.

abstract String getInvocationInfo(int invocationId)

لعرض معلومات عن عملية استدعاء من خلال تحديد معرّف عملية الاستدعاء.

abstract CommandRunner.ExitCode getLastInvocationExitCode()

عرض رمز الخطأ لآخر عملية استدعاء تم تنفيذها

abstract Throwable getLastInvocationThrowable()

عرض قيمة Throwable من آخر عملية استدعاء تم تنفيذها

abstract int getReadyCommandCount()

تعرض هذه الدالة عدد الأوامر في حالة "جاهز" في قائمة الانتظار.

abstract boolean isDeviceInInvocationThread(ITestDevice device)

تعرِض القيمة "صحيح" إذا كان الجهاز مستخدَمًا من خلال سلسلة استدعاء نشطة.

abstract void join()

ينتظر اكتمال عملية الجدولة.

abstract void join(long millis)

تنتظر هذه السمة اكتمال المجدول أو انتهاء المهلة بعد المدة المحدّدة بالملّي ثانية.

abstract void removeAllCommands()

إزالة جميع الأوامر من أداة الجدولة

abstract void setClearcutClient(ClearcutClient client)

ضبط العميل لإعداد تقارير عن بيانات أداة الاختبار

default void setMaxPollTime(long polling)
default void setPrintSchedulingWarning(boolean print)
abstract boolean shouldShutdownOnCmdfileError()

عرض القيمة "صحيح" إذا كنا بحاجة إلى إيقاف أداة الجدولة عند حدوث أخطاء في الأوامر

default void shutdown()

محاولة إيقاف أداة جدولة الأوامر بشكل سليم

abstract void shutdown(boolean notifyStop)

محاولة إيقاف أداة جدولة الأوامر بشكل سليم

abstract void shutdownHard(boolean killAdb)

محاولة إيقاف أداة جدولة الأوامر بالقوة

abstract void shutdownHard()

محاولة إيقاف أداة جدولة الأوامر بالقوة

abstract void shutdownOnEmpty()

هذه السمة مشابهة للسمة shutdown()، ولكنّها ستنتظر تنفيذ جميع الأوامر قبل الخروج.

abstract void start()

ابدأ ICommandScheduler.

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, 
                List<String> extraArgs)

يضيف هذا الإجراء جميع الأوامر من الملف المحدّد إلى أداة الجدولة

المعلَمات
cmdFile ‫String: مسار نظام الملفات لملف الأمر
extraArgs List: List من وسيطات String يتم إلحاقها بكل أمر تم تحليله من الملف. يمكن أن يكون فارغًا ولكن يجب ألا يكون قيمة فارغة.
عمليات الطرح
ConfigurationException إذا تعذّر تحليل ملف الأوامر

يُرجى الاطّلاع أيضًا على:

await

public abstract void await ()

ينتظر هذا الإجراء حتى يبدأ المجدول في العمل، بما في ذلك انتظار اكتمال عملية النقل من الإصدار القديم من TensorFlow، إذا كان ذلك منطبقًا.

عمليات الطرح
InterruptedException

displayCommandQueue

public abstract void displayCommandQueue (PrintWriter printWriter)

إخراج معلومات تصحيح الأخطاء المفصّلة بشأن حالة قائمة انتظار تنفيذ الأوامر

displayCommandsInfo

public abstract void displayCommandsInfo (PrintWriter printWriter, 
                String regex)

إخراج قائمة بالأوامر الحالية

المعلَمات
printWriter ‫PrintWriter: PrintWriter المطلوب إخراجه.
regex ‫String: التعبير العادي الذي يجب أن تتطابق معه الأوامر ليتم طباعتها. إذا كانت القيمة فارغة، سيتم عرض جميع الأوامر.

displayInvocationsInfo

public abstract void displayInvocationsInfo (PrintWriter printWriter)

تعرض هذه السمة قائمة بعمليات الاستدعاء الحالية.

المعلَمات
printWriter ‫PrintWriter: PrintWriter المطلوب إخراجه.

dumpCommandsXml

public abstract void dumpCommandsXml (PrintWriter printWriter, 
                String regex)

تفريغ ملف XML الموسّع للأمر مع جميع قيم Option المحدّدة لجميع الأوامر الحالية

المعلَمات
printWriter PrintWriter: 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, 
                ITestDevice device, 
                String[] args)

تنفيذ الأمر مباشرةً على الجهاز الذي تم تخصيصه مسبقًا

المعلَمات
listener استبدِل ICommandScheduler.IScheduledInvocationListener بـ ICommandScheduler.IScheduledInvocationListener المطلوب إعلامك به.
device ITestDevice: ITestDevice المطلوب استخدامه
args ‫String: وسيطات الأمر
المرتجعات
long المعرّف الخاص باستدعاء الأمر المجدوَل.
عمليات الطرح
ConfigurationException إذا كان الأمر غير صالح

execCommand

public abstract long execCommand (ICommandScheduler.IScheduledInvocationListener listener, 
                List<ITestDevice> devices, 
                String[] args)

تنفيذ الأمر مباشرةً على الأجهزة التي تم تخصيصها مسبقًا

المعلَمات
listener استبدِل ICommandScheduler.IScheduledInvocationListener بـ ICommandScheduler.IScheduledInvocationListener المطلوب إعلامك به.
devices 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 ()

ينتظر اكتمال عملية الجدولة.

عمليات الطرح
InterruptedException

يُرجى الاطّلاع أيضًا على:

انضمام

public abstract void join (long millis)

تنتظر هذه السمة اكتمال المجدول أو انتهاء المهلة بعد المدة المحدّدة بالملّي ثانية.

المعلَمات
millis long

عمليات الطرح
InterruptedException

يُرجى الاطّلاع أيضًا على:

removeAllCommands

public abstract void removeAllCommands ()

إزالة جميع الأوامر من أداة الجدولة

setClearcutClient

public abstract void setClearcutClient (ClearcutClient client)

ضبط العميل لإعداد تقارير عن بيانات أداة الاختبار

المعلَمات
client ClearcutClient

setMaxPollTime

public void setMaxPollTime (long polling)

المعلَمات
polling long

setPrintSchedulingWarning

public void setPrintSchedulingWarning (boolean print)

المعلَمات
print boolean

shouldShutdownOnCmdfileError

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(true).

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.