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)

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

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

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

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

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

await

public abstract void await ()

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

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, 
                ITestDevice device, 
                String[] args)

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

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

execCommand

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

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

المعلمات
listener ‫ICommandScheduler.IScheduledInvocationListener: ICommandScheduler.IScheduledInvocationListener المطلوب إعلامه
devices : 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 ()

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

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

انضمام

public abstract void join (long millis)

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

المعلمات
millis long

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

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.