اعتبارًا من عام 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.

ITestStorageClient

public interface ITestStorageClient

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

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

العميل

العميل عميل تخزين اختبار Android الذي يحمّل نتائج الاختبار إلى خدمة "تخزين الاختبار".

واجهة للتواصل مع الخلفية التخزينية لـ "مساحة تخزين اختبار Android". تحتوي الواجهة على طرق لإنشاء طلبات التنفيذ ووحدات العمل وتعديلها وتحميل نتائج الاختبارات. لإنشاء وحدات عمل أو نتائج اختبار أو تعديلها، يجب أن تنتمي إلى عملية استدعاء تم إنشاؤها بواسطة هذا العميل أو يجب إضافة عملية الاستدعاء باستخدام طريقة addInvocation.

ملخّص

الإجراءات العامة
`abstract Invocation`	`createInvocation(Invocation invocation)` تنشئ هذه السمة عملية استدعاء في "مساحة التخزين التجريبية" باستخدام البيانات الواردة في عملية الاستدعاء المقدَّمة.
`abstract Build`	`createLocalBuild(Build localBuild)` أدرِج إصدارًا محليًا في الخلفية.
`abstract WorkUnit`	`createWorkUnit(WorkUnit workUnit)` تنشئ هذه الطريقة وحدة عمل في "مساحة التخزين التجريبية".
`abstract ImmutableList<WorkUnit>`	`createWorkUnits(List<WorkUnit> 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)` تعدّل هذه الطريقة عملية استدعاء في "مساحة التخزين التجريبية" باستخدام البيانات الواردة في عملية الاستدعاء المقدَّمة.
`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(List<LogAssociation> associations, int poolSize)` تحميل عمليات الربط بين السجلات ووحدات الاختبار/العمل
`abstract void`	`uploadResult(TestResult result)` حمِّل نتيجة الاختبار المقدَّمة إلى "مساحة تخزين الاختبارات".

الإجراءات العامة

createInvocation

public abstract Invocation createInvocation (Invocation invocation)

تنشئ هذه السمة عملية استدعاء في "مساحة التخزين التجريبية" باستخدام البيانات الواردة في عملية الاستدعاء المقدَّمة.

المعلَمات
`invocation`	`Invocation`: - يصف عملية الاستدعاء التي سيتم إنشاؤها.

المرتجعات
`Invocation`	طلب التنفيذ الذي تم إنشاؤه في "وحدة تخزين الاختبار"

عمليات الطرح
	java.io.IOException
`IOException`

createLocalBuild

public abstract Build createLocalBuild (Build localBuild)

أدرِج إصدارًا محليًا في الخلفية.

المعلَمات
`localBuild`	‫`Build`: وصف للإصدار المحلي

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

عمليات الطرح
	java.io.IOException
`IOException`

createWorkUnit

public abstract WorkUnit createWorkUnit (WorkUnit workUnit)

تنشئ هذه الطريقة وحدة عمل في "مساحة التخزين التجريبية".

المعلَمات
`workUnit`	‫`WorkUnit`: - يصف وحدة العمل المطلوب إنشاؤها.

المرتجعات
`WorkUnit`	وحدة عمل جديدة

عمليات الطرح
	java.io.IOException
`IOException`

createWorkUnits

public abstract ImmutableList<WorkUnit> createWorkUnits (List<WorkUnit> workUnits)

تنشئ هذه السمة جميع وحدات العمل في قائمة مقدَّمة في TestStorage.

المعلَمات
`workUnits`	‫`List`: - قائمة بوحدات العمل المطلوب إنشاؤها.

المرتجعات
`ImmutableList<WorkUnit>`	قائمة بوحدات العمل التي تم إنشاؤها

عمليات الطرح
	java.io.IOException
`IOException`

fetchTestArtifact

public abstract File fetchTestArtifact (String invocationId, 
                String resourceId)

يجلب ملف عنصر الاختبار المطلوب ويعرضه.

المعلَمات
`invocationId`	`String`
`resourceId`	`String`

القيم المُعادة
`File`

عمليات الطرح
`IOException`

finalizeTestResults

public abstract void finalizeTestResults ()

تنتظر هذه السمة إلى أن يتم تحميل جميع نتائج الاختبار.

getInvocation

public abstract Invocation getInvocation (String invocationId)

تعرِض هذه الطريقة عملية استدعاء تتضمّن رقم تعريف عملية الاستدعاء المقدَّم.

المعلَمات
`invocationId`	‫`String`: رقم تعريف عملية الاستدعاء المطلوب إرجاعها.

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

عمليات الطرح
`IOException`	- إذا لم يتم العثور على طلب الاستدعاء المقدَّم أو إذا حدث خطأ أثناء التواصل مع الخلفية

getTestArtifact

public abstract BuildArtifactMetadata getTestArtifact (String invocationId, 
                String resourceId)

تعرض هذه الطريقة عنصر اختبار مطابقًا لمعرّف الاستدعاء والمورد المقدَّمَين.

المعلَمات
`invocationId`	`String`
`resourceId`	`String`

القيم المُعادة
`BuildArtifactMetadata`

عمليات الطرح
`IOException`

getWorkUnit

public abstract WorkUnit getWorkUnit (String workUnitId)

تعرض هذه الطريقة وحدة عمل تطابق رقم التعريف المقدَّم.

المعلَمات
`workUnitId`	‫`String`: - رقم تعريف وحدة العمل.

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

عمليات الطرح
`IOException`	- إذا لم يتم العثور على وحدة العمل المقدَّمة أو حدث خطأ أثناء الاتصال بالخدمات الخلفية.

listTestArtifact

public abstract TestArtifactListResponse listTestArtifact (String invocationId, 
                String artifactType)

يبحث عن جميع عناصر الاختبار التي تتطابق مع النوع المقدَّم ويدرجها.

المعلَمات
`invocationId`	`String`
`artifactType`	`String`

القيم المُعادة
`TestArtifactListResponse`

عمليات الطرح
`IOException`

updateInvocation

public abstract Invocation updateInvocation (Invocation invocation)

تعدّل هذه الطريقة عملية استدعاء في "مساحة التخزين التجريبية" باستخدام البيانات الواردة في عملية الاستدعاء المقدَّمة.

المعلَمات
`invocation`	‫`Invocation`: - استدعاء مع بيانات معدَّلة

المرتجعات
`Invocation`	استدعاء معدَّل

عمليات الطرح
	java.io.IOException
`IOException`

updateTestArtifact

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`

عمليات الطرح
`IOException`

updateTestArtifact

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

تعدّل هذه الطريقة العنصر المقدَّم وتحمّل المحتوى المقدَّم. عند تحميل المحتوى، لا يمكن تعديل بيانات الربط. لا تعدِّل رقم تعريف وحدة العمل ورقم تعريف نتيجة الاختبار اللذين تم ضبطهما مسبقًا في وسيطة BuildArtifactMetadata.

المعلَمات
`artifact`	`BuildArtifactMetadata`
`legacyId`	`long`
`content`	`AbstractInputStreamContent`

القيم المُعادة
`BuildArtifactMetadata`

عمليات الطرح
`IOException`

updateWorkUnit

public abstract WorkUnit updateWorkUnit (WorkUnit workUnit)

تعدّل هذه الطريقة وحدة عمل مقدَّمة في Test Storage.

المعلَمات
`workUnit`	‫`WorkUnit`: - وحدة العمل المطلوب تعديلها.

المرتجعات
`WorkUnit`	تم تعديل وحدة العمل.

عمليات الطرح
	java.io.IOException
`IOException`

uploadAssociations

public abstract void uploadAssociations (List<LogAssociation> associations, 
                int poolSize)

تحميل عمليات الربط بين السجلات ووحدات الاختبار/العمل تسمح عمليات الربط لميزة "مساحة تخزين اختبار Android" بتتبُّع الاختبار الذي أنشأ سجلّاً.

المعلَمات
`associations`	`List`: قائمة بملفات السجلّ وعمليات الربط الخاصة بها
`poolSize`	`int`: حجم مجموعة المنفّذين المستخدَمة للتحميل المتوازي. ‫0 لعدم إجراء تحميل متوازٍ

عمليات الطرح
	java.io.IOException
`IOException`

uploadResult

public abstract void uploadResult (TestResult result)

حمِّل نتيجة الاختبار المقدَّمة إلى "مساحة تخزين الاختبارات". يجب أن تكون نتيجة الاختبار جزءًا من عملية استدعاء تم إنشاؤها مسبقًا.

المعلَمات
`result`	‫`TestResult`: - نتيجة التحميل

عمليات الطرح
	java.io.IOException