ITestStorageClient

public interface ITestStorageClient

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

ממשק לתקשורת עם הקצה העורפי של Android Test Storage. הממשק מכיל שיטות ליצירה ולעדכון של קריאות לפונקציות ויחידות עבודה, ולהעלאה של תוצאות בדיקות. כדי ליצור או לעדכן יחידות עבודה או תוצאות בדיקה, הן צריכות להיות שייכות לקריאה לפונקציה שנוצרה על ידי הלקוח הזה, או שהקריאה לפונקציה צריכה להתווסף באמצעות השיטה addInvocation.

סיכום

‫methods ציבוריים

abstract Invocation createInvocation(Invocation invocation)

יוצר הפעלה ב-Test Storage באמצעות הנתונים בהפעלה שסופקה.

abstract Build createLocalBuild(Build localBuild)

הוספת גרסת build מקומית בקצה העורפי.

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)

מעדכן קריאה לפונקציה ב-Test Storage באמצעות הנתונים בקריאה לפונקציה שסופקה.

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

מעדכן את פריט המידע שנוצר בתהליך פיתוח (Artifact) שצוין.

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

מעדכן את הארטיפקט שסופק ומעלה את התוכן שסופק.

abstract WorkUnit updateWorkUnit(WorkUnit workUnit)

מעדכן יחידת עבודה שסופקה באחסון לצורך בדיקה.

abstract void uploadAssociations( associations, int poolSize)

העלאת שיוכים בין יומנים לבין בדיקות או יחידות עבודה.

abstract void uploadResult(TestResult result)

מעלים את תוצאת הבדיקה שסופקה אל Test Storage.

‫methods ציבוריים

createInvocation

public abstract Invocation createInvocation (Invocation invocation)

יוצר הפעלה ב-Test Storage באמצעות הנתונים בהפעלה שסופקה.

פרמטרים
invocation ‫Invocation: – מתאר את הקריאה שרוצים ליצור.
החזרות
Invocation קריאה שהתבצעה ב-Test Storage.
זריקות
IOException

createLocalBuild

public abstract Build createLocalBuild (Build localBuild)

הוספת גרסת build מקומית בקצה העורפי.

פרמטרים
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)

מעדכן קריאה לפונקציה ב-Test Storage באמצעות הנתונים בקריאה לפונקציה שסופקה.

פרמטרים
invocation ‫Invocation: - הפעלה עם נתונים מעודכנים.
החזרות
Invocation קריאה מעודכנת.
זריקות
IOException

updateTestArtifact

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

מעדכן את פריט המידע שנוצר בתהליך פיתוח (Artifact) שצוין. השיטה הזו מעדכנת רק את הקישור ולא משנה את התוכן. כשמפעילים את השיטה הזו, צריך לספק את מזהה ההפעלה המקורי, מזהה יחידת העבודה ומזהה תוצאת הבדיקה כארגומנטים. מציבים את יחידת העבודה החדשה ואת מזהה תוצאת הבדיקה באובייקט 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)

מעדכן יחידת עבודה שסופקה באחסון לצורך בדיקה.

פרמטרים
workUnit ‫WorkUnit: - יחידת עבודה לעדכון.
החזרות
WorkUnit עדכון יחידת העבודה.
זריקות
IOException

uploadAssociations

public abstract void uploadAssociations ( associations, 
                int poolSize)

העלאת שיוכים בין יומנים לבין בדיקות או יחידות עבודה. השיוכים מאפשרים ל-Android Test Storage לעקוב אחרי הבדיקה שיצרה יומן.

פרמטרים
associations ‫: רשימה של קובצי יומן והשיוכים שלהם.
poolSize ‫int: גודל מאגר העובדים שמשמש להעלאה מקבילה. ‫0 אם לא רוצים להשתמש בהעלאה מקבילה.
זריקות
IOException

uploadResult

public abstract void uploadResult (TestResult result)

מעלים את תוצאת הבדיקה שסופקה אל Test Storage. תוצאת הבדיקה צריכה להיות חלק מקריאה לפונקציה שנוצרה בעבר.

פרמטרים
result ‫TestResult: – התוצאה להעלאה.
זריקות
IOException