العميل

public final class Client
extends Object implements ITestStorageClient

java.lang.Object
   ↳ com.google.android.tradefed.result.teststorage.Client

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

ملخّص

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

static ITestStorageClient create(String buildEnvironment, boolean useLegacyMigration, boolean enableUploadThread, boolean useBatchApi, int maxBatchSize, int insertBatchSize)
static ITestStorageClient create(Androidbuildinternal client)
static ITestStorageClient create(String buildEnvironment, boolean useLegacyMigration, boolean enableUploadThread, boolean useBatchApi)
static ITestStorageClient create(String buildEnvironment, boolean useLegacyMigration, boolean useBatchApi)
Invocation createInvocation(Invocation invocation)

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

Build createLocalBuild(Build localBuild)

راجِع go/local_build_guide للاطّلاع على التفاصيل.

WorkUnit createWorkUnit(WorkUnit workUnit)

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

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

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

File fetchTestArtifact(String invocationId, String resourceId)

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

void finalizeTestResults()

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

Invocation getInvocation(String invocationId)

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

BuildArtifactMetadata getTestArtifact(String invocationId, String resourceId)

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

WorkUnit getWorkUnit(String workUnitId)

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

TestArtifactListResponse listTestArtifact(String invocationId, String artifactType)

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

Invocation updateInvocation(Invocation invocation)

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

BuildArtifactMetadata updateTestArtifact(String invocationId, String workUnitId, String testResultId, BuildArtifactMetadata artifact, long unusedLegacyId)

تعدّل هذه الطريقة العنصر المقدَّم.

BuildArtifactMetadata updateTestArtifact(BuildArtifactMetadata artifact, long unusedLegacyId, AbstractInputStreamContent content)

تعدّل هذه الطريقة العنصر المقدَّم وتحمّل المحتوى المقدَّم.

WorkUnit updateWorkUnit(WorkUnit workUnit)

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

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

تحميل عمليات الربط بين السجلات ووحدات الاختبار/العمل

void uploadResult(TestResult result)

حمِّل نتيجة الاختبار المقدَّمة إلى "مساحة تخزين الاختبارات".

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

إنشاء

public static ITestStorageClient create (String buildEnvironment, 
                boolean useLegacyMigration, 
                boolean enableUploadThread, 
                boolean useBatchApi, 
                int maxBatchSize, 
                int insertBatchSize)

المعلَمات
buildEnvironment String

useLegacyMigration boolean

enableUploadThread boolean

useBatchApi boolean

maxBatchSize int

insertBatchSize int

القيم المُعادة
ITestStorageClient

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

إنشاء

public static ITestStorageClient create (Androidbuildinternal client)

المعلَمات
client Androidbuildinternal

المرتجعات
ITestStorageClient

إنشاء

public static ITestStorageClient create (String buildEnvironment, 
                boolean useLegacyMigration, 
                boolean enableUploadThread, 
                boolean useBatchApi)

المعلَمات
buildEnvironment String

useLegacyMigration boolean

enableUploadThread boolean

useBatchApi boolean

القيم المُعادة
ITestStorageClient

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

إنشاء

public static ITestStorageClient create (String buildEnvironment, 
                boolean useLegacyMigration, 
                boolean useBatchApi)

المعلَمات
buildEnvironment String

useLegacyMigration boolean

useBatchApi boolean

القيم المُعادة
ITestStorageClient

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

createInvocation

public Invocation createInvocation (Invocation invocation)

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

المعلَمات
invocation Invocation: - يصف عملية الاستدعاء التي سيتم إنشاؤها.
المرتجعات
Invocation طلب التنفيذ الذي تم إنشاؤه في "وحدة تخزين الاختبار"
عمليات الطرح
IOException

createLocalBuild

public Build createLocalBuild (Build localBuild)

راجِع go/local_build_guide للاطّلاع على التفاصيل.

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

createWorkUnit

public WorkUnit createWorkUnit (WorkUnit workUnit)

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

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

createWorkUnits

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

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

المعلَمات
workUnits ‫List: - قائمة بوحدات العمل المطلوب إنشاؤها.
المرتجعات
ImmutableList<WorkUnit> قائمة بوحدات العمل التي تم إنشاؤها
عمليات الطرح
IOException

fetchTestArtifact

public File fetchTestArtifact (String invocationId, 
                String resourceId)

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

المعلَمات
invocationId String

resourceId String

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

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

finalizeTestResults

public void finalizeTestResults ()

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

getInvocation

public Invocation getInvocation (String invocationId)

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

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

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

getTestArtifact

public BuildArtifactMetadata getTestArtifact (String invocationId, 
                String resourceId)

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

المعلَمات
invocationId String

resourceId String

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

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

getWorkUnit

public WorkUnit getWorkUnit (String workUnitId)

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

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

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

listTestArtifact

public TestArtifactListResponse listTestArtifact (String invocationId, 
                String artifactType)

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

المعلَمات
invocationId String

artifactType String

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

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

updateInvocation

public Invocation updateInvocation (Invocation invocation)

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

المعلَمات
invocation ‫Invocation: - استدعاء مع بيانات معدَّلة
المرتجعات
Invocation استدعاء معدَّل
عمليات الطرح
IOException

updateTestArtifact

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

تعدّل هذه الطريقة العنصر المقدَّم. لا تعدّل هذه الطريقة المحتوى، بل تعدّل فقط عملية الربط. عند استدعاء هذه الطريقة، يجب تقديم معرّف الاستدعاء الأصلي ومعرّف وحدة العمل ومعرّف نتيجة الاختبار كمعلمات. ضَع وحدة العمل الجديدة ومعرّف نتيجة الاختبار في عنصر BuildArtifactMetadata. عندما لا يتم استخدام معرّف وحدة العمل و/أو نتيجة الاختبار في الربط، يجب ضبطهما على سلسلة فارغة ("").

المعلَمات
invocationId String

workUnitId String

testResultId String

artifact BuildArtifactMetadata

unusedLegacyId long

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

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

updateTestArtifact

public BuildArtifactMetadata updateTestArtifact (BuildArtifactMetadata artifact, 
                long unusedLegacyId, 
                AbstractInputStreamContent content)

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

المعلَمات
artifact BuildArtifactMetadata

unusedLegacyId long

content AbstractInputStreamContent

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

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

updateWorkUnit

public WorkUnit updateWorkUnit (WorkUnit workUnit)

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

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

uploadAssociations

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

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

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

uploadResult

public void uploadResult (TestResult result)

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

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