ITestStorageClient

public interface ITestStorageClient

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

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

ملخّص

الطُرق العامة

abstract Invocation createInvocation(Invocation invocation)

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

abstract Build createLocalBuild(Build localBuild)

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

abstract WorkUnit createWorkUnit(WorkUnit workUnit)

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

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)

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

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)

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

الطُرق العامة

createInvocation

public abstract Invocation createInvocation (Invocation invocation)

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

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

createLocalBuild

public abstract Build createLocalBuild (Build localBuild)

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

المعلمات
localBuild ‫Build: وصف النسخة التجريبية المحلية
المرتجعات
Build Build
الرميات
IOException

createWorkUnit

public abstract WorkUnit createWorkUnit (WorkUnit workUnit)

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

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

createWorkUnits

public abstract ImmutableList<WorkUnit> createWorkUnits ( workUnits)

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

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

fetchTestArtifact

public abstract File fetchTestArtifact (String invocationId, 
                String resourceId)

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

المعلمات
invocationId String

resourceId String

المرتجعات
File

finalizeTestResults

public abstract void finalizeTestResults ()

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

getInvocation

public abstract Invocation getInvocation (String invocationId)

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

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

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

getTestArtifact

public abstract BuildArtifactMetadata getTestArtifact (String invocationId, 
                String resourceId)

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

المعلمات
invocationId String

resourceId String

المرتجعات
BuildArtifactMetadata

getWorkUnit

public abstract WorkUnit getWorkUnit (String workUnitId)

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

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

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

listTestArtifact

public abstract TestArtifactListResponse listTestArtifact (String invocationId, 
                String artifactType)

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

المعلمات
invocationId String

artifactType String

المرتجعات
TestArtifactListResponse

updateInvocation

public abstract Invocation updateInvocation (Invocation invocation)

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

المعلمات
invocation ‫Invocation: - استدعاء مع بيانات معدَّلة
المرتجعات
Invocation طلب معدَّل
الرميات
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

updateTestArtifact

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

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

المعلمات
artifact BuildArtifactMetadata

legacyId long

content AbstractInputStreamContent

المرتجعات
BuildArtifactMetadata

updateWorkUnit

public abstract WorkUnit updateWorkUnit (WorkUnit workUnit)

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

المعلمات
workUnit استبدِل WorkUnit بوحدة العمل المطلوب تعديلها.
المرتجعات
WorkUnit تم تعديل وحدة العمل.
الرميات
IOException

uploadAssociations

public abstract void uploadAssociations ( associations, 
                int poolSize)

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

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

uploadResult

public abstract void uploadResult (TestResult result)

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

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