اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.

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

TestInvocation

public class TestInvocation
extends Object implements ITestInvocation

java.lang.Object
↳	com.android.tradefed.invoker.TestInvocation

التنفيذ التلقائي لـ ITestInvocation

تحميل العناصر الرئيسية استنادًا إلى IConfiguration - استرداد الإصدار - إعداد الهدف - إجراء الاختبارات - الإبلاغ عن النتائج

ملخّص

الثابتات
`long`	`AVAILABILITY_CHECK_TIMEOUT`

الحقول
`public static final String`	`COMMAND_ARGS_KEY` مفتاح سمات وسيطات سطر الأوامر
`public static final String`	`INVOCATION_EXTERNAL_DEPENDENCIES`
`public static final String`	`TRADEFED_CONFIG_NAME`
`public static final String`	`TRADEFED_END_HOST_LOG`
`public static final String`	`TRADEFED_INVOC_COMPLETE_HOST_LOG`
`public static final String`	`TRADEFED_LOG_NAME`

وظائف الإنشاء العامة
`TestInvocation()`

الطرق العامة
`static IBuildInfo`	`backFillBuildInfoForReporting(String commandLine)` مساعد يستخدم سطر الأوامر لإضافة بيانات سابقة إلى `IBuildInfo` لإعداد التقارير في حال تعطُّل تنزيل التقارير.
`static FailureDescription`	`createFailureFromException(Throwable exception, TestRecordProto.FailureStatus defaultStatus)` أنشئ `FailureDescription` من استثناء استدعاء.
`IInvocationExecution`	`createInvocationExec(TestInvocation.RunMode mode)` أنشئ مسار الاستدعاء الذي يجب اتّباعه.
`static String`	`getDeviceLogName(TestInvocation.Stage stage)`
`static String`	`getEmulatorLogName(TestInvocation.Stage stage)`
`ITestInvocation.ExitInformation`	`getExitInfo()` معلومات الخروج لطلب التنفيذ المحدّد
`void`	`invoke(IInvocationContext context, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener... extraListeners)` نفِّذ طلب اختبار.
`static boolean`	`isSubprocess(IConfiguration config)` تعرِض القيمة "صحيح" إذا كان الطلب حاليًا ضمن نطاق عملية فرعية.
`void`	`notifyInvocationForceStopped(String message, ErrorIdentifier errorId)` يُرجى إبلاغ `TestInvocation` بأنّه تم طلب إيقاف TradeFed.
`void`	`notifyInvocationStopped(String message)` أبلِغ `TestInvocation` بأنّه سيتم إيقاف TradeFed نهائيًا.
`static void`	`printStageDelimiter(TestInvocation.Stage phase, boolean end)` تُطبع فاصلًا لمرحلة معيّنة من الطلب.
`void`	`registerExecutionFiles(ExecutionFiles executionFiles)`
`void`	`setClearcutClient(ClearcutClient client)` إعادة توجيه العميل إلى صفحة إعداد التقارير
`static boolean`	`shouldSkipBugreportError(Throwable t)` طريقة مساعدة لتحديد الأخطاء التي يجب تخطّي تقرير الأخطاء عند حدوثها
`String`	`toString()`

الطرق المحمية
`void`	`addInvocationMetric(InvocationMetricLogger.InvocationMetricKey key, String value)`
`void`	`addInvocationMetric(InvocationMetricLogger.InvocationMetricKey key, long value)`
`void`	`applyAutomatedReporters(IConfiguration config)`
`void`	`setExitCode(CommandRunner.ExitCode code, Throwable stack)` مساعد لضبط رمز الخروج

الثابتات

AVAILABILITY_CHECK_TIMEOUT

public static final long AVAILABILITY_CHECK_TIMEOUT

القيمة الثابتة: 180000 (0x000000000002bf20)

الحقول

COMMAND_ARGS_KEY

public static final String COMMAND_ARGS_KEY

مفتاح سمات وسيطات سطر الأوامر

INVOCATION_EXTERNAL_DEPENDENCIES

public static final String INVOCATION_EXTERNAL_DEPENDENCIES

TRADEFED_CONFIG_NAME

public static final String TRADEFED_CONFIG_NAME

TRADEFED_END_HOST_LOG

public static final String TRADEFED_END_HOST_LOG

TRADEFED_INVOC_COMPLETE_HOST_LOG

public static final String TRADEFED_INVOC_COMPLETE_HOST_LOG

TRADEFED_LOG_NAME

public static final String TRADEFED_LOG_NAME

وظائف الإنشاء العامة

TestInvocation

public TestInvocation ()

الطرق العامة

backFillBuildInfoForReporting

public static IBuildInfo backFillBuildInfoForReporting (String commandLine)

مساعد يستخدم سطر الأوامر لإضافة بيانات سابقة إلى IBuildInfo لإعداد التقارير في حال تعطُّل تنزيل التقارير.

المعلمات
`commandLine`	`String`

المرتجعات
`IBuildInfo`

createFailureFromException

public static FailureDescription createFailureFromException (Throwable exception, 
                TestRecordProto.FailureStatus defaultStatus)

أنشئ FailureDescription من استثناء استدعاء.

المعلمات
`exception`	`Throwable`: استثناء التحويل
`defaultStatus`	`TestRecordProto.FailureStatus`: الحالة التي سيتم استخدامها تلقائيًا إذا لم يكن الاستثناء `IHarnessException`.

المرتجعات
`FailureDescription`

createInvocationExec

public IInvocationExecution createInvocationExec (TestInvocation.RunMode mode)

أنشئ مسار الاستدعاء الذي يجب اتّباعه.

المعلمات
`mode`	`TestInvocation.RunMode`: الوضع الذي نستخدمه حاليًا

المرتجعات
`IInvocationExecution`	`IInvocationExecution` التي تصف الطلب

getDeviceLogName

public static String getDeviceLogName (TestInvocation.Stage stage)

المعلمات
`stage`	`TestInvocation.Stage`

المرتجعات
`String`

getEmulatorLogName

public static String getEmulatorLogName (TestInvocation.Stage stage)

المعلمات
`stage`	`TestInvocation.Stage`

المرتجعات
`String`

getExitInfo

public ITestInvocation.ExitInformation getExitInfo ()

معلومات الخروج لطلب التنفيذ المحدّد

المرتجعات
`ITestInvocation.ExitInformation`

استدعاء

public void invoke (IInvocationContext context, 
                IConfiguration config, 
                IRescheduler rescheduler, 
                ITestInvocationListener... extraListeners)

نفِّذ طلب اختبار.

المعلمات
`context`	`IInvocationContext`: `IInvocationContext` لإجراء الاختبارات
`config`	`IConfiguration`: `IConfiguration` من عملية الاختبار هذه.
`rescheduler`	‫`IRescheduler`: `IRescheduler`، لإعادة جدولة أجزاء من الطلب بهدف تنفيذها على موارد أخرى
`extraListeners`	`ITestInvocationListener`: `ITestInvocationListener` المطلوب إرسال الإشعارات إليهم، بالإضافة إلى المستخدمين المدرَجين في `config`

عمليات الرمي
`DeviceNotAvailableException`

isSubprocess

public static boolean isSubprocess (IConfiguration config)

تعرِض القيمة "صحيح" إذا كان الطلب حاليًا ضمن نطاق عملية فرعية.

المعلمات
`config`	`IConfiguration`

المرتجعات
`boolean`

notifyInvocationForceStopped

public void notifyInvocationForceStopped (String message, 
                ErrorIdentifier errorId)

يُرجى إبلاغ TestInvocation بأنّه تم طلب إيقاف TradeFed.

المعلمات
`message`	`String`: الرسالة المرتبطة بإيقاف الطلب
`errorId`	`ErrorIdentifier`: المعرّف المرتبط بالإيقاف القسري

notifyInvocationStopped

public void notifyInvocationStopped (String message)

أبلِغ TestInvocation بأنّه سيتم إيقاف TradeFed نهائيًا.

المعلمات
`message`	`String`: الرسالة المرتبطة بإيقاف الطلب

printStageDelimiter

public static void printStageDelimiter (TestInvocation.Stage phase, 
                boolean end)

تُطبع فاصلًا لمرحلة معيّنة من الطلب.

المعلمات
`phase`	`TestInvocation.Stage`
`end`	`boolean`

registerExecutionFiles

public void registerExecutionFiles (ExecutionFiles executionFiles)

المعلمات
`executionFiles`	`ExecutionFiles`

setClearcutClient

public void setClearcutClient (ClearcutClient client)

إعادة توجيه العميل إلى صفحة إعداد التقارير

المعلمات
`client`	`ClearcutClient`

shouldSkipBugreportError

public static boolean shouldSkipBugreportError (Throwable t)

طريقة مساعدة لتحديد الأخطاء التي يجب تخطّي تقرير الأخطاء عند حدوثها

المعلمات
`t`	`Throwable`

المرتجعات
`boolean`

toString

public String toString ()

المرتجعات
`String`

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

addInvocationMetric

protected void addInvocationMetric (InvocationMetricLogger.InvocationMetricKey key, 
                String value)

المعلمات
`key`	`InvocationMetricLogger.InvocationMetricKey`
`value`	`String`

addInvocationMetric

protected void addInvocationMetric (InvocationMetricLogger.InvocationMetricKey key, 
                long value)

المعلمات
`key`	`InvocationMetricLogger.InvocationMetricKey`
`value`	`long`

applyAutomatedReporters

protected void applyAutomatedReporters (IConfiguration config)

المعلمات
`config`	`IConfiguration`

setExitCode

protected void setExitCode (CommandRunner.ExitCode code, 
                Throwable stack)

مساعد لضبط رمز الخروج تمّ عرضها للاختبار.

المعلمات
`code`	`CommandRunner.ExitCode`
`stack`	`Throwable`