اعتبارًا من عام 2026، ولضمان اتّساق نموذج التطوير الثابت الأساسي واستقرار المنصة في النظام المتكامل، سننشر رمز المصدر في مشروع Android مفتوح المصدر (AOSP) في الربعَين الثاني والرابع. لبناء مشروع Android مفتوح المصدر والمساهمة فيه، استخدِم android-latest-release. سيشير فرع بيان android-latest-release دائمًا إلى أحدث إصدار تم نشره في مشروع Android مفتوح المصدر. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android مفتوح المصدر.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

TestInvocation

public class TestInvocation
extends Object implements ITestInvocation

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

التنفيذ التلقائي للعلامة ITestInvocation

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

ملخّص

الثوابت
`long`	`AVAILABILITY_CHECK_TIMEOUT`
`String`	`COMMAND_ARGS_KEY` مفتاح سمات وسيطات سطر الأوامر
`String`	`INVOCATION_EXTERNAL_DEPENDENCIES`
`String`	`TRADEFED_CONFIG_NAME`
`String`	`TRADEFED_END_HOST_LOG`
`String`	`TRADEFED_EVENT_LOG`
`String`	`TRADEFED_INVOC_COMPLETE_HOST_LOG`
`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)` أعِد توجيه عميل Clearcut لإعداد تقارير المقاييس.
`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`	`applyDeviceAutomatedSetup(IInvocationContext context, 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

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

القيمة الثابتة: "command_line_args"

INVOCATION_EXTERNAL_DEPENDENCIES

public static final String INVOCATION_EXTERNAL_DEPENDENCIES

Constant Value: "invocation-external-dependencies"

TRADEFED_CONFIG_NAME

public static final String TRADEFED_CONFIG_NAME

القيمة الثابتة: "tradefed-expanded-config"

TRADEFED_END_HOST_LOG

public static final String TRADEFED_END_HOST_LOG

القيمة الثابتة: "end_host_log"

TRADEFED_EVENT_LOG

public static final String TRADEFED_EVENT_LOG

القيمة الثابتة: "event-logs"

TRADEFED_INVOC_COMPLETE_HOST_LOG

public static final String TRADEFED_INVOC_COMPLETE_HOST_LOG

القيمة الثابتة: "invoc_complete_host_log"

TRADEFED_LOG_NAME

public static final String TRADEFED_LOG_NAME

القيمة الثابتة: "host_log"

طُرق وضع التصميم العامة

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`: عناوين البريد الإلكتروني التي سيتم إرسال الإشعارات إليها، بالإضافة إلى العناوين الواردة في `configITestInvocationListener`

عمليات الطرح
`DeviceNotAvailableException`
`Throwable`

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)

أعِد توجيه عميل Clearcut لإعداد تقارير المقاييس.

المعلَمات
`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`

applyDeviceAutomatedSetup

protected void applyDeviceAutomatedSetup (IInvocationContext context, 
                IConfiguration config)

المعلَمات
`context`	`IInvocationContext`
`config`	`IConfiguration`

setExitCode

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

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

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