REST Resource: projects.histories.executions

משאב: ביצוע

ביצוע מייצג אוסף של שלבים. לדוגמה, זה יכול לייצג: - בדיקה ניידת שבוצעה על פני מגוון של תצורות מכשירים - עבודת ג'נקינס עם שלב בנייה ואחריו שלב בדיקה

הגודל המרבי של הודעת ביצוע הוא 1 MiB.

ניתן לעדכן ביצוע עד שהמצב שלו מוגדר ל-COMLETE ואז הוא הופך לבלתי ניתן לשינוי.

ייצוג JSON
{
  "executionId": string,
  "state": enum (State),
  "creationTime": {
    object (Timestamp)
  },
  "completionTime": {
    object (Timestamp)
  },
  "outcome": {
    object (Outcome)
  },
  "dimensionDefinitions": [
    {
      object (MatrixDimensionDefinition)
    }
  ],
  "specification": {
    object (Specification)
  },
  "testExecutionMatrixId": string
}
שדות
executionId

string

מזהה ייחודי בתוך היסטוריה עבור ביצוע זה.

מחזירה INVALID_ARGUMENT אם שדה זה מוגדר או מוחלף על ידי המתקשר.

  • בתגובה תמיד מוגדר
  • בבקשת יצירה/עדכון: לעולם לא הוגדר
state

enum ( State )

המצב ההתחלתי הוא IN_PROGRESS.

מעברי המדינה החוקיים היחידים הם מ-IN_PROGRESS ל-COMLETE.

PRECONDITION_FAILED יוחזר אם תתבקש מעבר לא חוקי.

ניתן להגדיר את המצב ל-COMLETE פעם אחת בלבד. FAILED_PRECONDITION יוחזר אם המצב מוגדר ל-COMLETE מספר פעמים.

אם המצב מוגדר ל-COMLETE, כל השלבים בתהליך הביצוע יוגדרו כ-COMLETE. אם התוצאה של הצעד לא נקבעה, התוצאה תוגדר ל-INCONCLUSIVE.

  • בתגובה תמיד מוגדר
  • בבקשת יצירה/עדכון: אופציונלי
creationTime

object ( Timestamp )

הזמן שבו נוצרה ההוצאה לפועל.

ערך זה יוגדר אוטומטית כאשר ייקרא executions.create.

  • בתגובה: תמיד מוגדר
  • בבקשת יצירה/עדכון: לעולם לא הוגדר
completionTime

object ( Timestamp )

הזמן שבו סטטוס הביצוע עבר ל-COMLETE.

ערך זה יוגדר אוטומטית כאשר המצב יעבור ל-COMLETE.

  • בתגובה: הגדר אם מצב הביצוע הוא COMPLETE.
  • בבקשת יצירה/עדכון: לעולם לא הוגדר
outcome

object ( Outcome )

סווגו את התוצאה, למשל ל-SUCCESS או FAILURE

  • בתגובה: קיים אם הוגדר על ידי בקשת יצירה/עדכון
  • בבקשת יצירה/עדכון: אופציונלי
dimensionDefinitions[]

object ( MatrixDimensionDefinition )

הממדים שלאורכם שלבים שונים בביצוע זה עשויים להשתנות. זה חייב להישאר קבוע לאורך חיי ההוצאה להורג.

מחזירה INVALID_ARGUMENT אם שדה זה מוגדר בבקשת עדכון.

מחזירה INVALID_ARGUMENT אם אותו שם מופיע ביותר מ-dimension_definition אחת.

מחזירה INVALID_ARGUMENT אם גודל הרשימה הוא מעל 100.

  • בתגובה: קיים אם הוגדר על ידי יצירה
  • בצור בקשה: אופציונלי
  • בבקשת עדכון: לעולם לא הוגדר
specification

object ( Specification )

מידע קל על בקשת ביצוע.

  • בתגובה: קיים אם הוגדר על ידי יצירה
  • ביצירה: אופציונלי
  • בעדכון: אופציונלי
testExecutionMatrixId

string

מזהה מטריצת TestExecution שבו משתמש TestExecutionService.

  • בתגובה: קיים אם הוגדר על ידי יצירה
  • ביצירה: אופציונלי
  • בעדכון: מעולם לא הוגדר

MatrixDimensionDefinition

לסוג זה אין שדות.

מימד אחד של המטריצה ​​של ריצות שונות של צעד.

מִפרָט

הפרטים על אופן הפעלת הביצוע.

ייצוג JSON
{

  // Union field specification can be only one of the following:
  "androidTest": {
    object (AndroidTest)
  },
  "iosTest": {
    object (IosTest)
  }
  // End of list of possible types for union field specification.
}
שדות

specification שדה האיחוד.

specification יכול להיות רק אחד מהבאים:

androidTest

object ( AndroidTest )

מפרט ביצוע בדיקה לנייד של אנדרואיד.

iosTest

object ( IosTest )

מפרט ביצוע בדיקה לנייד של iOS.

AndroidTest

מפרט בדיקה לנייד של אנדרואיד.

ייצוג JSON
{
  "androidAppInfo": {
    object (AndroidAppInfo)
  },
  "testTimeout": {
    object (Duration)
  },

  // Union field test can be only one of the following:
  "androidInstrumentationTest": {
    object (AndroidInstrumentationTest)
  },
  "androidRoboTest": {
    object (AndroidRoboTest)
  },
  "androidTestLoop": {
    object (AndroidTestLoop)
  }
  // End of list of possible types for union field test.
}
שדות
androidAppInfo

object ( AndroidAppInfo )

מידע על האפליקציה הנבדקת.

testTimeout

object ( Duration )

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

test שטח של האיחוד.

test יכולה להיות רק אחת מהאפשרויות הבאות:

androidInstrumentationTest

object ( AndroidInstrumentationTest )

מבחן מכשור אנדרואיד.

androidRoboTest

object ( AndroidRoboTest )

מבחן רובו לאנדרואיד.

androidTestLoop

object ( AndroidTestLoop )

לולאת בדיקה של אנדרואיד.

AndroidAppInfo

מידע על אפליקציית אנדרואיד.

ייצוג JSON
{
  "name": string,
  "packageName": string,
  "versionName": string,
  "versionCode": string
}
שדות
name

string

שם האפליקציה. אופציונאלי

packageName

string

שם החבילה של האפליקציה. נדרש.

versionName

string

שם הגרסה של האפליקציה. אופציונאלי.

versionCode

string

קוד הגרסה הפנימי של האפליקציה. אופציונאלי.

AndroidInstrumentationTest

בדיקה של אפליקציית אנדרואיד שיכולה לשלוט ברכיב אנדרואיד ללא תלות במחזור החיים הרגיל שלו.

ראה https://developer.android.com/training/testing/fundamentals למידע נוסף על סוגי מבחני אנדרואיד.

ייצוג JSON
{
  "testPackageId": string,
  "testRunnerClass": string,
  "testTargets": [
    string
  ],
  "useOrchestrator": boolean
}
שדות
testPackageId

string

חבילת ה-Java לביצוע הבדיקה. נדרש

testRunnerClass

string

כיתת InstrumentationTestRunner. נדרש

testTargets[]

string

כל יעד חייב להיות מוסמך במלואו עם שם החבילה או שם המחלקה, באחד מהפורמטים הבאים: - "package packageName" - "class packageName.class_name" - "class packageName.class_name#method_name"

אם ריק, כל היעדים במודול יופעלו.

useOrchestrator

boolean

הדגל מציין אם Android Test Orchestrator ישמש להפעלת בדיקה או לא.

AndroidRoboTest

בדיקה של אפליקציית אנדרואיד שחוקרת את האפליקציה במכשיר אנדרואיד וירטואלי או פיזי, מוצאת אשמים ומתרסקת תוך כדי.

ייצוג JSON
{
  "appInitialActivity": string,
  "bootstrapPackageId": string,
  "bootstrapRunnerClass": string,
  "maxDepth": integer,
  "maxSteps": integer
}
שדות
appInitialActivity

string

הפעילות הראשונית שבה יש להשתמש כדי להפעיל את האפליקציה. אופציונאלי

bootstrapPackageId

string

חבילת ה-Java עבור ה-bootstrap. אופציונאלי

bootstrapRunnerClass

string

כיתת הרצים עבור ה-bootstrap. אופציונאלי

maxDepth

integer

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

maxSteps

integer

המספר המרבי של שלבים/פעולות שרובו יכול לבצע. ברירת המחדל היא ללא הגבלה (0). אופציונאלי

AndroidTestLoop

לסוג זה אין שדות.

לולאות בדיקה הן בדיקות שניתן להפעיל על ידי האפליקציה עצמה, הקובעות מתי לרוץ על ידי האזנה למטרות.

IosTest

מפרט בדיקה לנייד של iOS

ייצוג JSON
{
  "iosAppInfo": {
    object (IosAppInfo)
  },
  "testTimeout": {
    object (Duration)
  },

  // Union field test can be only one of the following:
  "iosXcTest": {
    object (IosXcTest)
  },
  "iosTestLoop": {
    object (IosTestLoop)
  },
  "iosRoboTest": {
    object (IosRoboTest)
  }
  // End of list of possible types for union field test.
}
שדות
iosAppInfo

object ( IosAppInfo )

מידע על האפליקציה הנבדקת.

testTimeout

object ( Duration )

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

test שטח של האיחוד.

test יכולה להיות רק אחת מהאפשרויות הבאות:

iosXcTest

object ( IosXcTest )

בדיקת iOS XCT.

iosTestLoop

object ( IosTestLoop )

לולאת בדיקה של iOS.

iosRoboTest

object ( IosRoboTest )

מבחן iOS Robo.

IosAppInfo

מידע על אפליקציית iOS

ייצוג JSON
{
  "name": string
}
שדות
name

string

שם האפליקציה. נדרש

IosXcTest

בדיקה של אפליקציית iOS המשתמשת במסגרת XCTest.

ייצוג JSON
{
  "bundleId": string,
  "xcodeVersion": string
}
שדות
bundleId

string

מזהה חבילה של האפליקציה.

xcodeVersion

string

גרסת Xcode שאיתה בוצעה הבדיקה.

IosTestLoop

בדיקת לולאת משחק של אפליקציית iOS.

ייצוג JSON
{
  "bundleId": string
}
שדות
bundleId

string

מזהה חבילה של האפליקציה.

IosRoboTest

לסוג זה אין שדות.

מבחן רובו עבור אפליקציית iOS.

שיטות

create

 יוצר ביצוע.

get

 מקבל הוצאה להורג.

list

 מפרט ביצועים עבור היסטוריה נתונה.

patch

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