از سال ۲۰۲۶، برای همسو شدن با مدل توسعه پایدار ترانک و تضمین پایداری پلتفرم برای اکوسیستم، کد منبع را در سه‌ماهه دوم و چهارم در AOSP منتشر خواهیم کرد. برای ساخت و مشارکت در AOSP، android-latest-release استفاده کنید. شاخه مانیفست android-latest-release همیشه به جدیدترین نسخه منتشر شده در AOSP ارجاع می‌دهد. برای اطلاعات بیشتر، به تغییرات در AOSP مراجعه کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

فراخوانی فعلی

public class CurrentInvocation
extends Object

شیء جاوا
↳	com.android.tradefed.invoker.logger.CurrentInvocation

کلاسی که اطلاعات مفید فراخوانی فعلی را در هر کجای داخل فراخوانی ردیابی و ارائه می‌دهد.

خلاصه

روش‌های عمومی
`static void`	`addInvocationInfo ( CurrentInvocation.InvocationInfo key, File value)` یک کلید-مقدار اضافه کنید تا در سطح فراخوانی ردیابی شود.
`static void`	`clearInvocationInfos ()` اطلاعات فراخوانی یک فراخوانی را پاک کنید.
`static FailureDescription`	`createFailure (String errorMessage, ErrorIdentifier errorIdentifier)` یک خطای مرتبط با عمل فراخوانی در حال انجام ایجاد کنید.
`static ActionInProgress`	`getActionInProgress ()` مقدار `ActionInProgress` فعلی را برای فراخوانی برمی‌گرداند.
`static String`	`getCurrentRunner ()` در صورت مشخص بودن، اجراکننده‌ی آزمایشی فعلی را برمی‌گرداند.
`static File`	`getInfo ( CurrentInvocation.InvocationInfo key)` نقشه معیارهای فراخوانی را برای فراخوانی که در حال انجام است، برمی‌گرداند.
`static IInvocationContext`	`getInvocationContext ()` `IInvocationContext` فعلی را برای فراخوانی برمی‌گرداند.
`static ExecutionFiles`	`getInvocationFiles ()` `ExecutionFiles` مربوط به فراخوانی را برمی‌گرداند.
`static IInvocationContext`	`getModuleContext ()` ماژول `IInvocationContext` را برای ماژول فعلی برمی‌گرداند.
`static File`	`getWorkFolder ()` پوشه کاری فعلی برای فراخوانی را برمی‌گرداند یا اگر هنوز چیزی تنظیم نشده باشد، null است.
`static CurrentInvocation.IsolationGrade`	`moduleCurrentIsolation ()` برمی‌گرداند که آیا ماژول suite فعلی اجرا شده ایزوله بوده است یا خیر.
`static void`	`registerExecutionFiles ( ExecutionFiles invocFiles)` ثبت یکباره `ExecutionFiles` .
`static void`	`resetLocalGroup ()` زمینه محلی‌سازی شده را بازنشانی می‌کند.
`static CurrentInvocation.IsolationGrade`	`runCurrentIsolation ()` برمی‌گرداند که آیا اجرای آزمایشی فعلی که اجرا شده، ایزوله بوده است یا خیر.
`static void`	`setActionInProgress ( ActionInProgress action)` مقدار `ActionInProgress` برای فراخوانی تنظیم می‌کند.
`static void`	`setCurrentRunner (String runner)` ردیابی را برای اجراکننده‌ی آزمایشی فعلی تنظیم می‌کند.
`static void`	`setInvocationContext ( IInvocationContext context)` `IInvocationContext` را برای فراخوانی تنظیم می‌کند.
`static void`	`setLocalGroup (ThreadGroup tg)` هنگام استفاده از ویژگی‌های داخل سرور gRPC، یک زمینه محلی را ردیابی می‌کند.
`static void`	`setModuleContext ( IInvocationContext moduleContext)` ماژول `IInvocationContext` مربوط به ماژول در حال اجرا را تنظیم می‌کند.
`static void`	`setModuleIsolation ( CurrentInvocation.IsolationGrade isolation)` به‌روزرسانی کنید که آیا ماژول suite ایزوله است یا خیر.
`static void`	`setRunIsolation ( CurrentInvocation.IsolationGrade isolation)` به‌روزرسانی کنید که آیا اجرای آزمایشی ایزوله است یا خیر.

روش‌های عمومی

اطلاعات فراخوانی را اضافه کنید

public static void addInvocationInfo (CurrentInvocation.InvocationInfo key, 
                File value)

یک کلید-مقدار اضافه کنید تا در سطح فراخوانی ردیابی شود.

پارامترها
`key`	`CurrentInvocation.InvocationInfo` : کلیدی که اطلاعات فراخوانی تحت آن ردیابی خواهد شد.
`value`	`File` : مقدار معیار فراخوانی.

اطلاعات فراخوانی پاک‌شده

public static void clearInvocationInfos ()

اطلاعات فراخوانی یک فراخوانی را پاک کنید.

ایجادشکست

public static FailureDescription createFailure (String errorMessage, 
                ErrorIdentifier errorIdentifier)

یک خطای مرتبط با عمل فراخوانی در حال انجام ایجاد کنید. ابزار کمکی برای جلوگیری از فراخوانی FailureDescription.setActionInProgress(ActionInProgress) .

پارامترها
`errorMessage`	`String`
`errorIdentifier`	`ErrorIdentifier`

بازگشت‌ها
`FailureDescription`

دریافت اقدام در حال انجام

public static ActionInProgress getActionInProgress ()

مقدار فعلی ActionInProgress برای فراخوانی برمی‌گرداند. می‌تواند null باشد.

بازگشت‌ها
`ActionInProgress`

دریافت‌کننده‌ی فعلی

public static String getCurrentRunner ()

در صورت مشخص بودن، اجراکننده‌ی آزمایشی فعلی را برمی‌گرداند.

بازگشت‌ها
`String`

دریافت اطلاعات

public static File getInfo (CurrentInvocation.InvocationInfo key)

نقشه معیارهای فراخوانی را برای فراخوانی که در حال انجام است، برمی‌گرداند.

پارامترها
`key`	`CurrentInvocation.InvocationInfo`

بازگشت‌ها
`File`

دریافتInvocationContext

public static IInvocationContext getInvocationContext ()

IInvocationContext فعلی را برای فراخوانی برمی‌گرداند. می‌تواند null باشد.

بازگشت‌ها
`IInvocationContext`

دریافت فایل‌های فراخوانی

public static ExecutionFiles getInvocationFiles ()

ExecutionFiles مربوط به فراخوانی را برمی‌گرداند.

بازگشت‌ها
`ExecutionFiles`

دریافت ماژول‌ها

public static IInvocationContext getModuleContext ()

ماژول IInvocationContext را برای ماژول فعلی برمی‌گرداند. اگر خارج از محدوده‌ی اجرای ماژول باشد، می‌تواند null باشد.

بازگشت‌ها
`IInvocationContext`

پوشه‌ی کار را دریافت کنید

public static File getWorkFolder ()

پوشه کاری فعلی برای فراخوانی را برمی‌گرداند یا اگر هنوز چیزی تنظیم نشده باشد، null است.

بازگشت‌ها
`File`

ماژول جریان ایزولاسیون

public static CurrentInvocation.IsolationGrade moduleCurrentIsolation ()

برمی‌گرداند که آیا ماژول suite فعلی اجرا شده ایزوله بوده است یا خیر.

بازگشت‌ها
`CurrentInvocation.IsolationGrade`

فایل‌های اجرایی registerExecution

public static void registerExecutionFiles (ExecutionFiles invocFiles)

ثبت یکباره ExecutionFiles . این کار توسط Test Harness انجام می‌شود.

پارامترها
`invocFiles`	`ExecutionFiles` : `ExecutionFiles` ثبت‌شده.

تنظیم مجدد گروه محلی

public static void resetLocalGroup ()

زمینه محلی‌سازی شده را بازنشانی می‌کند.

جداسازی جریان جاری

public static CurrentInvocation.IsolationGrade runCurrentIsolation ()

برمی‌گرداند که آیا اجرای آزمایشی فعلی که اجرا شده، ایزوله بوده است یا خیر.

بازگشت‌ها
`CurrentInvocation.IsolationGrade`

تنظیم اقدام در حال انجام

public static void setActionInProgress (ActionInProgress action)

مقدار ActionInProgress برای فراخوانی تنظیم می‌کند.

پارامترها
`action`	`ActionInProgress`

تنظیم‌کننده جریان

public static void setCurrentRunner (String runner)

ردیابی را برای اجراکننده‌ی آزمایشی فعلی تنظیم می‌کند.

پارامترها
`runner`	`String`

setInvocationContext

public static void setInvocationContext (IInvocationContext context)

IInvocationContext را برای فراخوانی تنظیم می‌کند.

پارامترها
`context`	`IInvocationContext`

گروه محلی تنظیم‌شده

public static void setLocalGroup (ThreadGroup tg)

هنگام استفاده از ویژگی‌های داخل سرور gRPC، یک زمینه محلی را ردیابی می‌کند.

پارامترها
`tg`	`ThreadGroup`

setModuleContext

public static void setModuleContext (IInvocationContext moduleContext)

ماژول IInvocationContext مربوط به ماژول در حال اجرا را تنظیم می‌کند.

پارامترها
`moduleContext`	`IInvocationContext`

جداسازی ماژول setModule

public static void setModuleIsolation (CurrentInvocation.IsolationGrade isolation)

به‌روزرسانی کنید که آیا ماژول suite ایزوله است یا خیر.

پارامترها
`isolation`	`CurrentInvocation.IsolationGrade`

جداسازی اجرا تنظیم‌شده

public static void setRunIsolation (CurrentInvocation.IsolationGrade isolation)

به‌روزرسانی کنید که آیا اجرای آزمایشی ایزوله است یا خیر.

پارامترها
`isolation`	`CurrentInvocation.IsolationGrade`