تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

CommandScheduler

public class CommandScheduler
extends Object implements ICommandScheduler

java.lang.Object
↳	com.android.tradefed.command.CommandScheduler

الفئات الفرعية المباشرة المعروفة

ClusterCommandScheduler. الكتلة

ClusterCommandScheduler. الكتلة ICommandScheduler لدعم TFC (Tradefed Cluster).

برنامج جدولة لتشغيل أوامر TradeFederation عبر جميع الأجهزة المتاحة.

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

يعمل إلى الأبد في الخلفية حتى الإغلاق.

ملخص

المنشأت العامة
`CommandScheduler ()` ينشئ `CommandScheduler` .

الأساليب العامة
`Pair <Boolean, Integer>`	`addCommand (String[] args)` يضيف أمرًا إلى المجدول.
`void`	`addCommandFile (String cmdFilePath, extraArgs)` `addCommandFile (String cmdFilePath, extraArgs)` يضيف كل الأوامر من ملف معين إلى المجدول
`void`	`await ()` انتظار بدء تشغيل المجدول ، بما في ذلك انتظار التسليم من فريق العمل القديم حتى يكتمل إن أمكن.
`static TradefedDelegator`	`checkDelegation (String[] args)` قم بإنشاء مفوض بناءً على سطر الأوامر لمعرفة ما إذا كنا بحاجة إلى تفويض التشغيل.
`static`	`createReleaseMap ( IInvocationContext context, Throwable e)` قم بإنشاء خريطة لحالة الأجهزة حتى يمكن إصدارها بشكل مناسب.
`ISandbox`	`createSandbox ()` أنشئ `ISandbox` الذي سيستخدمه الاستدعاء للتشغيل.
`void`	`displayCommandQueue (PrintWriter printWriter)` إخراج معلومات تصحيح الأخطاء التفصيلية في قائمة انتظار تنفيذ الأوامر.
`void`	`displayCommandsInfo (PrintWriter printWriter, String regex)` قم بإخراج قائمة بالأوامر الحالية.
`void`	`displayInvocationsInfo (PrintWriter printWriter)` يعرض قائمة الدعوات الحالية.
`void`	`dumpCommandsXml (PrintWriter printWriter, String regex)` تفريغ ملف xml الموسع للأمر بكل قيم `Option` المحددة لكل الأوامر الحالية.
`long`	`execCommand ( ICommandScheduler.IScheduledInvocationListener listener, reservedDevices, String[] args)` `execCommand ( ICommandScheduler.IScheduledInvocationListener listener, reservedDevices, String[] args)` تنفيذ الأمر مباشرة على الأجهزة المخصصة بالفعل.
`long`	`execCommand ( IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, String[] args)` يخصص جهازًا بشكل مباشر وينفذ أمرًا دون إضافته إلى قائمة انتظار الأوامر باستخدام `IInvocationContext` الموجود بالفعل.
`long`	`execCommand ( ICommandScheduler.IScheduledInvocationListener listener, String[] args)` يخصص جهازًا بشكل مباشر وينفذ أمرًا دون إضافته إلى قائمة انتظار الأوامر.
`CommandFileWatcher`	`getCommandFileWatcher ()` احصل على `CommandFileWatcher` المناسب لهذا المجدول
`int`	`getExecutingCommandCount ()` إرجاع عدد الأوامر في حالة التنفيذ.
`CommandScheduler.HostState`	`getHostState ()`
`String`	`getInvocationInfo (int invocationId)` قم بإرجاع المعلومات على استدعاء bu يحدد معرّف الاستدعاء.
`CommandRunner.ExitCode`	`getLastInvocationExitCode ()` قم بإرجاع رمز الخطأ الخاص بآخر استدعاء تم تشغيله.
`Throwable`	`getLastInvocationThrowable ()` قم بإرجاع `ERROR(/Throwable)` من الاستدعاء الأخير الذي تم تشغيله.
`int`	`getReadyCommandCount ()` تُرجع عدد الأوامر في حالة الاستعداد في قائمة الانتظار.
`long`	`getShutdownTimeout ()`
`boolean`	`isDeviceInInvocationThread ( ITestDevice device)` يعود صحيحًا إذا تم استخدام الجهاز بواسطة سلسلة استدعاء نشطة.
`void`	`notifyFileChanged (File cmdFile, extraArgs)` `notifyFileChanged (File cmdFile, extraArgs)`
`void`	`removeAllCommands ()` قم بإزالة كافة الأوامر من المجدول
`void`	`run ()` كتلة التنفيذ الرئيسية لهذا الموضوع.
`void`	`setClearcutClient (ClearcutClient client)` اضبط العميل على الإبلاغ عن بيانات التسخير
`boolean`	`shouldShutdownOnCmdfileError ()` العودة صحيحًا إذا احتجنا إلى إيقاف تشغيل المجدول عند حدوث أخطاء في الأمر
`void`	`shutdown (boolean notifyStop)` محاولة إيقاف تشغيل برنامج جدولة الأوامر بأمان.
`void`	`shutdownHard (boolean killAdb)` محاولة إيقاف تشغيل برنامج جدولة الأوامر بالقوة.
`void`	`shutdownHard ()` محاولة إيقاف تشغيل برنامج جدولة الأوامر بالقوة.
`void`	`shutdownOnEmpty ()` على غرار `shutdown()` ، لكنه سينتظر بدلاً من ذلك تنفيذ جميع الأوامر قبل الخروج.
`void`	`start ()` يبدأ المجدول بما في ذلك إعداد التسجيل ، وبدء `DeviceManager` وما إلى ذلك
`boolean`	`stopInvocation ( ITestInvocation invocation)` وقف الدعاء الجاري.
`boolean`	`stopInvocation (int invocationId, String cause)` أوقف الاحتجاج الجاري بتحديد معرفه.

الطرق المحمية
`void`	`cleanUp ()` يغلق السجلات ويقوم بأي تنظيف ضروري آخر قبل الإنهاء.
`IConfiguration`	`createConfiguration (String[] args)`
`IInvocationContext`	`createInvocationContext ()`
`long`	`execCommand ( IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, reservedDevices, String[] args)` `execCommand ( IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, reservedDevices, String[] args)`
`IConfigurationFactory`	`getConfigFactory ()` طريقة المصنع للحصول على مرجع إلى `IConfigurationFactory`
`DeviceManagementGrpcServer`	`getDeviceManagementServer ()`
`IDeviceManager`	`getDeviceManager ()` طريقة المصنع للحصول على مرجع إلى `IDeviceManager`
`TradefedFeatureServer`	`getFeatureServer ()`
`IHostOptions`	`getHostOptions ()`
`IKeyStoreClient`	`getKeyStoreClient ()` يجلب `IKeyStoreClient` باستخدام `IKeyStoreFactory` المعلن في `IGlobalConfiguration` أو لاغٍ إذا لم يتم تعريف أي شيء.
`TestInvocationManagementServer`	`getTestInvocationManagementServer ()`
`void`	`initLogging ()` تهيئة سجل ddmlib.
`boolean`	`isShutdown ()`
`boolean`	`isShuttingDown ()`
`void`	`processReadyCommands ( IDeviceManager manager)`

المنشأت العامة

CommandScheduler

public CommandScheduler ()

ينشئ CommandScheduler .

ملاحظة: يجب استدعاء البداية قبل الاستخدام.

الأساليب العامة

addCommand

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

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

الأمر هو في الأساس مثيل للتكوين الذي سيتم تشغيله والوسيطات المرتبطة به.

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

حدود
`args`	`String` : وسيطات التكوين.

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

رميات
`ConfigurationException`

addCommandFile

public void addCommandFile (String cmdFilePath, 
                 extraArgs)

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

حدود
`cmdFilePath`	`String` : مسار نظام الملفات لملف comand
`extraArgs`	: `ERROR(/List)` وسيطات `ERROR(/String)` لإلحاقها بكل أمر تم تحليله من الملف. يمكن أن يكون فارغًا ولكن لا يجب أن يكون فارغًا.

رميات
`ConfigurationException`

انتظر

public void await ()

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

check التفويض

public static TradefedDelegator checkDelegation (String[] args)

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

حدود
`args`	`String`

عائدات
`TradefedDelegator`

رميات
	com.android.tradefed.config.ConfigurationException
`ConfigurationException`

إنشاءReleaseMap

public static  createReleaseMap (IInvocationContext context, 
                Throwable e)

قم بإنشاء خريطة لحالة الأجهزة حتى يمكن إصدارها بشكل مناسب.

حدود
`context`	`IInvocationContext`
`e`	`Throwable`

عائدات

إنشاء Sandbox

public ISandbox createSandbox ()

أنشئ ISandbox الذي سيستخدمه الاستدعاء للتشغيل.

عائدات
`ISandbox`

displayCommandQueue

public void displayCommandQueue (PrintWriter printWriter)

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

displayCommandsInfo

public void displayCommandsInfo (PrintWriter printWriter, 
                String regex)

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

حدود
`printWriter`	`PrintWriter` : `ERROR(/PrintWriter)` للإخراج إلى.
`regex`	`String` : التعبير العادي الذي يجب مطابقة الأوامر من أجل طباعتها. إذا كانت فارغة ، فستتم طباعة جميع الأوامر.

displayInvocationsInfo

public void displayInvocationsInfo (PrintWriter printWriter)

يعرض قائمة الدعوات الحالية.

حدود
`printWriter`	`PrintWriter` : `ERROR(/PrintWriter)` للإخراج إلى.

DumpCommandsXml

public void dumpCommandsXml (PrintWriter printWriter, 
                String regex)

تفريغ ملف xml الموسع للأمر بكل قيم Option المحددة لكل الأوامر الحالية.

حدود
`printWriter`	`PrintWriter` : `ERROR(/PrintWriter)` لإخراج الحالة إلى.
`regex`	`String` : التعبير النمطي الذي يجب أن تتطابق معه الأوامر من أجل تفريغ ملف xml. إذا كانت فارغة ، فسيتم التخلص من جميع الأوامر.

execCommand

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

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

حدود
`listener`	`ICommandScheduler.IScheduledInvocationListener` : `ICommandScheduler.IScheduledInvocationListener` .
`reservedDevices`	: `ERROR(/List )` `ERROR(/List )` للاستخدام
`args`	`String` : وسيطات الأمر

عائدات
`long`	معرّف الاستدعاء للأمر المجدول.

رميات
`ConfigurationException`

execCommand

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

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

حدود
`listener`	`ICommandScheduler.IScheduledInvocationListener` : `ICommandScheduler.IScheduledInvocationListener` .
`args`	`String` : وسيطات الأمر

عائدات
`long`	معرّف الاستدعاء للأمر المجدول.

رميات
`ConfigurationException`
`NoDeviceException`

getCommandFileWatcher

public CommandFileWatcher getCommandFileWatcher ()

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

عائدات
`CommandFileWatcher`

getExecutingCommandCount

public int getExecutingCommandCount ()

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

عائدات
`int`

getHostState

public CommandScheduler.HostState getHostState ()

عائدات
`CommandScheduler.HostState`

getInvocationInfo

public String getInvocationInfo (int invocationId)

قم بإرجاع المعلومات على استدعاء bu يحدد معرّف الاستدعاء.

حدود
`invocationId`	`int` : معرف تتبع الاحتجاج.

عائدات
`String`	`ERROR(/String)` يحتوي على معلومات حول الاستدعاء.

getLastInvocationExitCode

public CommandRunner.ExitCode getLastInvocationExitCode ()

قم بإرجاع رمز الخطأ الخاص بآخر استدعاء تم تشغيله. قم بإرجاع 0 (بدون خطأ) ، إذا لم يتم تنفيذ أي استدعاء بعد.

عائدات
`CommandRunner.ExitCode`

getLastInvocationThrowable

public Throwable getLastInvocationThrowable ()

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

عائدات
`Throwable`

getReadyCommandCount

public int getReadyCommandCount ()

تُرجع عدد الأوامر في حالة الاستعداد في قائمة الانتظار.

عائدات
`int`

getShutdownTimeout

public long getShutdownTimeout ()

عائدات
`long`

isDeviceInvocationThread

public boolean isDeviceInInvocationThread (ITestDevice device)

يعود صحيحًا إذا تم استخدام الجهاز بواسطة سلسلة استدعاء نشطة.

حدود
`device`	`ITestDevice`

عائدات
`boolean`

notifyFileChanged

public void notifyFileChanged (File cmdFile, 
                 extraArgs)

حدود
`cmdFile`	`File`
`extraArgs`

إزالة AllCommands

public void removeAllCommands ()

قم بإزالة كافة الأوامر من المجدول

يجري

public void run ()

كتلة التنفيذ الرئيسية لهذا الموضوع.

setClearcutClient

public void setClearcutClient (ClearcutClient client)

اضبط العميل على الإبلاغ عن بيانات التسخير

حدود
`client`	`ClearcutClient`

shouldShutdownOnCmdfileError

public boolean shouldShutdownOnCmdfileError ()

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

عائدات
`boolean`

اغلق

public void shutdown (boolean notifyStop)

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

حدود
`notifyStop`	`boolean` : إذا كان صحيحًا ، يخطر استدعاءات إيقاف تشغيل TF.

الاغلاق

public void shutdownHard (boolean killAdb)

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

على غرار shutdown() ، ولكنه سيؤدي أيضًا إلى إنهاء اتصال adb اختياريًا ، في محاولة "إلهام" الدعوات قيد التقدم لإكمالها بشكل أسرع.

حدود
`killAdb`	`boolean`

الاغلاق

public void shutdownHard ()

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

إيقاف التشغيل فارغة

public void shutdownOnEmpty ()

على غرار shutdown() ، لكنه سينتظر بدلاً من ذلك تنفيذ جميع الأوامر قبل الخروج.

لاحظ أنه إذا كانت هناك أية أوامر في وضع التكرار ، فلن يخرج المجدول أبدًا.

يبدأ

public void start ()

يبدأ المجدول بما في ذلك إعداد التسجيل ، وبدء DeviceManager وما إلى ذلك

وقف الدعوة

public boolean stopInvocation (ITestInvocation invocation)

وقف الدعاء الجاري.

حدود
`invocation`	`ITestInvocation`

عائدات
`boolean`	صحيح إذا تم إيقاف الاحتجاج ، وخلاف ذلك خطأ

وقف الدعوة

public boolean stopInvocation (int invocationId, 
                String cause)

أوقف الاحتجاج الجاري بتحديد معرفه.

حدود
`invocationId`	`int` : معرّف التعقب للاستدعاء.
`cause`	`String` : سبب وقف الدعاء.

عائدات
`boolean`	صحيح إذا تم إيقاف الاحتجاج ، وخلاف ذلك خطأ

الطرق المحمية

تنظيف

protected void cleanUp ()

يغلق السجلات ويقوم بأي تنظيف ضروري آخر قبل الإنهاء.

مكشوفة حتى يمكن لاختبارات الوحدة السخرية.

إنشاء التكوين

protected IConfiguration createConfiguration (String[] args)

حدود
`args`	`String`

عائدات
`IConfiguration`

رميات
`ConfigurationException`

createInvocationContext

protected IInvocationContext createInvocationContext ()

عائدات
`IInvocationContext`

execCommand

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

حدود
`context`	`IInvocationContext`
`listener`	`ICommandScheduler.IScheduledInvocationListener`
`reservedDevices`
`args`	`String`

عائدات
`long`

رميات
`ConfigurationException`

getConfigFactory

protected IConfigurationFactory getConfigFactory ()

طريقة المصنع للحصول على مرجع إلى IConfigurationFactory

عائدات
`IConfigurationFactory`	`IConfigurationFactory` للاستخدام

getDeviceManagementServer

protected DeviceManagementGrpcServer getDeviceManagementServer ()

عائدات
`DeviceManagementGrpcServer`

getDeviceManager

protected IDeviceManager getDeviceManager ()

طريقة المصنع للحصول على مرجع إلى IDeviceManager

عائدات
`IDeviceManager`	`IDeviceManager` المراد استخدامه

getFeatureServer

protected TradefedFeatureServer getFeatureServer ()

عائدات
`TradefedFeatureServer`

getHostOptions

protected IHostOptions getHostOptions ()

عائدات
`IHostOptions`

getKeyStoreClient

protected IKeyStoreClient getKeyStoreClient ()

يجلب IKeyStoreClient باستخدام IKeyStoreFactory المعلن في IGlobalConfiguration أو لاغٍ إذا لم يتم تعريف أي شيء.

عائدات
`IKeyStoreClient`	IKeyStoreClient

getTestInvocationManagementServer

protected TestInvocationManagementServer getTestInvocationManagementServer ()

عائدات
`TestInvocationManagementServer`

initLogging

protected void initLogging ()

تهيئة سجل ddmlib.

مكشوفة حتى يمكن لاختبارات الوحدة السخرية.

هو الاغلاق

protected boolean isShutdown ()

عائدات
`boolean`

هو إيقاف

protected boolean isShuttingDown ()

عائدات
`boolean`

processReadyCommands

protected void processReadyCommands (IDeviceManager manager)

حدود
`manager`	`IDeviceManager`