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

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

کلاینت ذخیره‌سازی ITest

public interface ITestStorageClient

com.google.android.tradefed.result.teststorage.ITestStorageClient

زیرکلاس‌های غیرمستقیم شناخته‌شده

مشتری

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

رابطی برای برقراری ارتباط با بک‌اند ذخیره‌سازی تست اندروید. این رابط شامل متدهایی برای ایجاد و به‌روزرسانی فراخوانی‌ها و واحدهای کاری و آپلود نتایج تست است. برای ایجاد یا به‌روزرسانی واحدهای کاری یا نتایج تست، آنها باید متعلق به فراخوانی باشند که یا توسط این کلاینت ایجاد شده است یا فراخوانی باید با استفاده از متد addInvocation اضافه شود.

خلاصه

روش‌های عمومی
`abstract Invocation`	`createInvocation (Invocation invocation)` با استفاده از داده‌های موجود در فراخوانی ارائه شده، یک فراخوانی در Test Storage ایجاد می‌کند.
`abstract Build`	`createLocalBuild (Build localBuild)` یک ساختار محلی در backend وارد کنید.
`abstract WorkUnit`	`createWorkUnit (WorkUnit workUnit)` یک واحد کاری در Test Storage ایجاد می‌کند.
`abstract ImmutableList<WorkUnit>`	`createWorkUnits ( workUnits)` تمام واحدهای کاری را در یک لیست ارائه شده در TestStorage ایجاد می‌کند.
`abstract File`	`fetchTestArtifact (String invocationId, String resourceId)` فایل مصنوع آزمایشی درخواست شده را دریافت و برمی‌گرداند.
`abstract void`	`finalizeTestResults ()` منتظر می‌ماند تا تمام نتایج آزمایش بارگذاری شود.
`abstract Invocation`	`getInvocation (String invocationId)` فراخوانی را برمی‌گرداند که شناسه‌ی فراخوانی ارائه شده را دارد.
`abstract BuildArtifactMetadata`	`getTestArtifact (String invocationId, String resourceId)` یک مصنوع آزمایشی را که با فراخوانی و شناسه منبع ارائه شده مطابقت دارد، برمی‌گرداند.
`abstract WorkUnit`	`getWorkUnit (String workUnitId)` یک واحد کاری مطابق با شناسه ارائه شده را برمی‌گرداند.
`abstract TestArtifactListResponse`	`listTestArtifact (String invocationId, String artifactType)` تمام مصنوعات آزمایشی مطابق با نوع ارائه شده را جستجو و فهرست می‌کند.
`abstract Invocation`	`updateInvocation (Invocation invocation)` با استفاده از داده‌های موجود در فراخوانی ارائه شده، یک فراخوانی را در Test Storage به‌روزرسانی می‌کند.
`abstract BuildArtifactMetadata`	`updateTestArtifact (String invocationId, String workUnitId, String testResultId, BuildArtifactMetadata artifact, long legacyId)` مصنوع ارائه شده را به‌روزرسانی می‌کند.
`abstract BuildArtifactMetadata`	`updateTestArtifact (BuildArtifactMetadata artifact, long legacyId, AbstractInputStreamContent content)` مصنوع ارائه شده را به‌روزرسانی کرده و محتوای ارائه شده را بارگذاری می‌کند.
`abstract WorkUnit`	`updateWorkUnit (WorkUnit workUnit)` یک واحد کاری ارائه شده در Test Storage را به‌روزرسانی می‌کند.
`abstract void`	`uploadAssociations ( associations, int poolSize)` ارتباط بین لاگ‌ها و واحدهای تست/کار را آپلود می‌کند.
`abstract void`	`uploadResult (TestResult result)` نتیجه آزمایش ارائه شده را در Test Storage بارگذاری کنید.

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

فراخوانی ایجاد

public abstract Invocation createInvocation (Invocation invocation)

با استفاده از داده‌های موجود در فراخوانی ارائه شده، یک فراخوانی در Test Storage ایجاد می‌کند.

پارامترها
`invocation`	`Invocation` : - فراخوانی که قرار است ایجاد شود را توصیف می‌کند.

بازگشت‌ها
`Invocation`	فراخوانی که در Test Storage ایجاد شده است.

پرتاب‌ها
	استثنای IO

ایجاد محلیساخت

public abstract Build createLocalBuild (Build localBuild)

یک ساختار محلی در backend وارد کنید.

پارامترها
`localBuild`	`Build` : شرح ساخت محلی

بازگشت‌ها
`Build`	یک `Build`

پرتاب‌ها
	استثنای IO

ایجاد واحد کار

public abstract WorkUnit createWorkUnit (WorkUnit workUnit)

یک واحد کاری در Test Storage ایجاد می‌کند.

پارامترها
`workUnit`	`WorkUnit` : - واحد کاری که باید ایجاد شود را توصیف می‌کند.

بازگشت‌ها
`WorkUnit`	یک واحد کاری جدید

پرتاب‌ها
	استثنای IO

ایجاد واحدهای کاری

public abstract ImmutableList<WorkUnit> createWorkUnits ( workUnits)

تمام واحدهای کاری را در یک لیست ارائه شده در TestStorage ایجاد می‌کند.

پارامترها
`workUnits`	: - فهرست واحدهای کاری برای ایجاد.

بازگشت‌ها
`ImmutableList<WorkUnit>`	فهرست واحدهای کاری ایجاد شده

پرتاب‌ها
	استثنای IO

fetchTestArtifact

public abstract File fetchTestArtifact (String invocationId, 
                String resourceId)

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

پارامترها
`invocationId`	`String`
`resourceId`	`String`

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

نهایی کردن نتایج آزمون

public abstract void finalizeTestResults ()

منتظر می‌ماند تا تمام نتایج آزمایش بارگذاری شود.

دریافت فراخوانی

public abstract Invocation getInvocation (String invocationId)

فراخوانی را برمی‌گرداند که شناسه‌ی فراخوانی ارائه شده را دارد.

پارامترها
`invocationId`	`String` : - شناسه فراخوانی که قرار است برگردانده شود.

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

پرتاب‌ها
	- اگر فراخوانی ارائه شده پیدا نشد یا اگر خطایی در برقراری ارتباط با backend وجود داشته باشد.

دریافت تست مصنوع

public abstract BuildArtifactMetadata getTestArtifact (String invocationId, 
                String resourceId)

یک مصنوع آزمایشی را که با فراخوانی و شناسه منبع ارائه شده مطابقت دارد، برمی‌گرداند.

پارامترها
`invocationId`	`String`
`resourceId`	`String`

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

واحد کار را دریافت کنید

public abstract WorkUnit getWorkUnit (String workUnitId)

یک واحد کاری مطابق با شناسه ارائه شده را برمی‌گرداند.

پارامترها
`workUnitId`	`String` : - شناسه واحد کاری.

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

پرتاب‌ها
	- اگر واحد کاری ارائه شده پیدا نشد یا خطایی در برقراری ارتباط با سرویس‌های backend وجود دارد.

listTestArtifact

public abstract TestArtifactListResponse listTestArtifact (String invocationId, 
                String artifactType)

تمام مصنوعات آزمایشی مطابق با نوع ارائه شده را جستجو و فهرست می‌کند.

پارامترها
`invocationId`	`String`
`artifactType`	`String`

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

فراخوانی به‌روزرسانی

public abstract Invocation updateInvocation (Invocation invocation)

با استفاده از داده‌های موجود در فراخوانی ارائه شده، یک فراخوانی را در Test Storage به‌روزرسانی می‌کند.

پارامترها
`invocation`	`Invocation` : - فراخوانی با داده‌های به‌روزرسانی‌شده.

بازگشت‌ها
`Invocation`	یک فراخوان به‌روزرسانی‌شده.

پرتاب‌ها
	استثنای IO

به‌روزرسانیTestArtifact

public abstract BuildArtifactMetadata updateTestArtifact (String invocationId, 
                String workUnitId, 
                String testResultId, 
                BuildArtifactMetadata artifact, 
                long legacyId)

مصنوع ارائه شده را به‌روزرسانی می‌کند. این متد فقط ارتباط را به‌روزرسانی می‌کند و محتوا را تغییر نمی‌دهد. هنگام فراخوانی این متد، شناسه فراخوانی اصلی، شناسه واحد کاری و شناسه نتیجه آزمایش را به عنوان آرگومان ارائه دهید. شناسه واحد کاری جدید و شناسه نتیجه آزمایش را در شیء BuildArtifactMetadata قرار دهید. هنگامی که شناسه واحد کاری و/یا نتیجه آزمایش در ارتباط استفاده نمی‌شوند، باید روی رشته خالی ("") تنظیم شوند.

پارامترها
`invocationId`	`String`
`workUnitId`	`String`
`testResultId`	`String`
`artifact`	`BuildArtifactMetadata`
`legacyId`	`long`

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

به‌روزرسانیTestArtifact

public abstract BuildArtifactMetadata updateTestArtifact (BuildArtifactMetadata artifact, 
                long legacyId, 
                AbstractInputStreamContent content)

مصنوع ارائه شده را به‌روزرسانی کرده و محتوای ارائه شده را بارگذاری می‌کند. هنگام بارگذاری محتوا، به‌روزرسانی داده‌های مرتبط امکان‌پذیر نیست. شناسه واحد کار و شناسه نتیجه آزمایش که قبلاً در آرگومان BuildArtifactMetadata تنظیم شده است را تغییر ندهید.

پارامترها
`artifact`	`BuildArtifactMetadata`
`legacyId`	`long`
`content`	`AbstractInputStreamContent`

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

به‌روزرسانی واحد کار

public abstract WorkUnit updateWorkUnit (WorkUnit workUnit)

یک واحد کاری ارائه شده در Test Storage را به‌روزرسانی می‌کند.

پارامترها
`workUnit`	`WorkUnit` : - واحد کاری که باید به‌روزرسانی شود.

بازگشت‌ها
`WorkUnit`	واحد کاری به‌روزرسانی‌شده

پرتاب‌ها
	استثنای IO

آپلود انجمن‌ها

public abstract void uploadAssociations ( associations, 
                int poolSize)

ارتباطات بین لاگ‌ها و تست‌ها/واحدهای کاری را آپلود می‌کند. ارتباطات به Android Test Storage اجازه می‌دهد تا پیگیری کند که کدام تست، لاگ تولید کرده است.

پارامترها
`associations`	: فهرستی از فایل‌های لاگ و ارتباط آنها.
`poolSize`	`int` : اندازه مخزن کارگران مورد استفاده برای آپلود موازی. 0 برای عدم آپلود موازی.

پرتاب‌ها
	استثنای IO

آپلودنتیجه

public abstract void uploadResult (TestResult result)

نتیجه آزمایش ارائه شده را در Test Storage بارگذاری کنید. نتیجه آزمایش باید بخشی از یک فراخوانی باشد که قبلاً ایجاد شده است.

پارامترها
`result`	`TestResult` : - نتیجه‌ای که باید آپلود شود.

پرتاب‌ها
	استثنای IO