Commandscheduler

public interface ICommandScheduler

com.android.tradefed.command.ICommandscheduler

أداة جدولة لتشغيل أوامر TradeFederation.

ملخّص

الصفوف المتداخلة

interface ICommandScheduler.IScheduledInvocationListener

أداة معالجة أحداث الاستدعاء عند اكتمال الاستدعاء 

الطرق العامة

abstract boolean addCommand(String[] args)

إضافة أمر إلى أداة الجدولة.

abstract void addCommandFile(String cmdFile, extraArgs)

إضافة جميع الأوامر من ملف معين إلى أداة الجدولة

abstract void await()

الانتظار حتى بدء تشغيل أداة الجدولة، بما في ذلك انتظار التسليم من فريق العمل القديم لإكمال إن أمكن.

abstract void completeHandover()

تخبر أداة جدولة الأوامر أن تسلسل التسليم الذي تم بدؤه مكتمل بالكامل، إعادة تهيئة مديره البعيد على المنفذ الافتراضي.

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 void execCommand(IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, String[] args)

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

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

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

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

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

abstract CommandFileWatcher getCommandFileWatcher()

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

abstract int getExecutingCommandCount()

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

abstract String getInvocationInfo(int invocationId)

عرض المعلومات على رمز bu للاستدعاء مع تحديد معرّف الاستدعاء

abstract CommandRunner.ExitCode getLastInvocationExitCode()

يعرض رمز الخطأ لآخر استدعاء تم تشغيله.

abstract Throwable getLastInvocationThrowable()

يمكنك عرض Throwable من آخر استدعاء تم تشغيله.

abstract int getReadyCommandCount()

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

abstract void handoverInitiationComplete()

تُعلم أداة جدولة الأوامر بأن التبادل الأولي للأجهزة والأوامر المستخدمة مكتملة، ويمكنه بدء عملية الجدولة.

abstract boolean handoverShutdown(int handoverPort)

لبدء عملية shutdown() وتسليمها إلى عملية تبادلية أخرى على هذا المضيف نفسه.

abstract void join()

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

abstract void join(long millis)

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

abstract void removeAllCommands()

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

abstract void setClearcutClient(ClearcutClient client)

ضبط العميل للإبلاغ عن بيانات مجموعة أدوات السلامة

abstract boolean shouldShutdownOnCmdfileError()

إرجاع true إذا احتجنا إلى إيقاف تشغيل أداة الجدولة في أخطاء الأوامر

abstract void shutdown()

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

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)

إيقاف استدعاء قيد التشغيل.

الطرق العامة

إضافة Command

public abstract boolean addCommand (String[] args)

إضافة أمر إلى أداة الجدولة.

الأمر في الأساس هو مثيل لعملية التهيئة التي سيتم تشغيلها والوسيطات المرتبطة بها.

إذا كانت الإجابة "--help" تم تحديد الوسيطة في نص المساعدة سيتم إخراج التهيئة إلى stdout. وبخلاف ذلك، ستتم إضافة الإعدادات إلى قائمة الانتظار إلى الجري.

المعلمات
args String: وسيطات الإعداد
المرتجعات
boolean true في حال إضافة الأمر بنجاح
الرميات
ConfigurationException إذا تعذر تحليل الأمر

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

إضافة ملف الأوامر

public abstract void addCommandFile (String cmdFile, 
                 extraArgs)

إضافة جميع الأوامر من ملف معين إلى أداة الجدولة

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

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

بانتظارك

public abstract void await ()

الانتظار حتى بدء تشغيل أداة الجدولة، بما في ذلك انتظار التسليم من فريق العمل القديم لإكمال إن أمكن.

إكمال عملية تمرير

public abstract void completeHandover ()

تخبر أداة جدولة الأوامر أن تسلسل التسليم الذي تم بدؤه مكتمل بالكامل، إعادة تهيئة مديره البعيد على المنفذ الافتراضي.

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 void execCommand (IInvocationContext context, 
                ICommandScheduler.IScheduledInvocationListener listener, 
                String[] args)

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

المعلمات
context IInvocationContext: عنصر IInvocationContext حالي
listener ICommandScheduler.IScheduledInvocationListener: ICommandScheduler.IScheduledInvocationListener التي سيتم إعلامك بها
args String: وسيطات الأوامر
الرميات
ConfigurationException إذا كان الأمر غير صالح
NoDeviceException إذا لم يكن هناك جهاز لاستخدامه

أمر execCommand

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

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

المعلمات
listener ICommandScheduler.IScheduledInvocationListener: ICommandScheduler.IScheduledInvocationListener التي سيتم إعلامك بها
args String: وسيطات الأوامر
الرميات
ConfigurationException إذا كان الأمر غير صالح
NoDeviceException إذا لم يكن هناك جهاز لاستخدامه

أمر execCommand

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

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

المعلمات
listener ICommandScheduler.IScheduledInvocationListener: ICommandScheduler.IScheduledInvocationListener التي سيتم إعلامك بها
device ITestDevice: السمة ITestDevice المطلوب استخدامها
args String: وسيطات الأوامر
الرميات
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

إكمال عملية تسليم

public abstract void handoverInitiationComplete ()

تُعلم أداة جدولة الأوامر بأن التبادل الأولي للأجهزة والأوامر المستخدمة مكتملة، ويمكنه بدء عملية الجدولة.

إيقاف التشغيل باليد

public abstract boolean handoverShutdown (int handoverPort)

لبدء عملية shutdown() وتسليمها إلى عملية تبادلية أخرى على هذا المضيف نفسه.

ستُعلِم أداة الجدولة العملية التي يتم تبادلها بالعمل عن بُعد والاستماع على هذا المنفذ من الأجهزة الخالية. عند توفرها.

المعلمات
handoverPort int

المرتجعات
boolean true إذا تم بدء التسليم بنجاح، false أو

انضمام

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 abstract void shutdown ()

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

يمحو الأوامر التي تنتظر اختبارها ويطلب أن تكون جميع الاستدعاءات قيد التقدم ويغلقه بشكل رشيق.

بعد استدعاء إيقاف التشغيل، ستنتظر الحلقة الرئيسية لأداة الجدولة (جدولة) جميع الاستدعاءات التي تكون قيد التقدم. إتمامها قبل الخروج تمامًا.

إيقاف صعب

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 إذا لم يكن التنفيذ يتيح ذلك