Commandscheduler

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

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

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, devices, 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 boolean isDeviceInInvocationThread(ITestDevice device)

تعرض القيمة true إذا كان الجهاز قيد الاستخدام بواسطة سلسلة استدعاء نشطة.

abstract void join()

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

abstract void join(long millis)

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

abstract void removeAllCommands()

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

abstract void setClearcutClient(ClearcutClient client)

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

abstract boolean shouldShutdownOnCmdfileError()

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

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

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

الطرق العامة

إضافة Command

public abstract Pair<Boolean, Integer> addCommand (String[] args)

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

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

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

المعلمات
args String: وسيطات الإعداد
المرتجعات
Pair<Boolean, Integer> زوج من القيم، تكون القيمة الأولى هي true المنطقية إذا تمت إضافة الأمر بنجاح. والقيمة الثانية هي معرّف متتبع الأوامر المعروف(قيمة غير سالبة) إذا كانت تمت إضافة الأمر بنجاح، يعرض 0 عند إضافة الأمر لجميع الأجهزة، وبخلاف ذلك 1-
الرميات
ConfigurationException إذا تعذر تحليل الأمر

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

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

public abstract void addCommandFile (String cmdFile, 
                 extraArgs)

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

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

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

بانتظارك

public abstract void await ()

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

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 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) المطلوب استخدامها
args String: وسيطات الأوامر
المرتجعات
long معرِّف الاستدعاء للأمر المُجدوَل.
الرميات
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

سلسلة استدعاءات isDeviceInvocationThread

public abstract boolean isDeviceInInvocationThread (ITestDevice device)

تعرض القيمة true إذا كان الجهاز قيد الاستخدام بواسطة سلسلة استدعاء نشطة.

المعلمات
device ITestDevice

المرتجعات
boolean

انضمام

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

حاول فرض إيقاف تشغيل أداة جدولة الأوامر. مثل 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 إذا لم يكن التنفيذ يتيح ذلك

إيقاف الجدولة

public void stopScheduling ()

يؤدي هذا الخيار إلى إيقاف جدولة وقبول الاختبارات الجديدة ولكن لا يؤدي إلى إيقاف مقايضة الجهاز. يهدف هذا إلى تفعيل إيقاف تشغيل مكون من خطوتين، حيث نقوم أولاً باستنزاف جميع الاختبارات الجارية، ثم ننهي تطبيق Tradefed الدفع.