REST Resource: projects.histories.executions

منبع: اجرا

یک Execution مجموعه ای از مراحل را نشان می دهد. به عنوان مثال، می تواند نشان دهنده موارد زیر باشد: - یک آزمایش موبایلی که در طیف وسیعی از تنظیمات دستگاه اجرا می شود - یک کار جنکینز با یک مرحله ساخت و سپس یک مرحله آزمایشی

حداکثر اندازه یک پیام اجرایی 1 مگابایت است.

یک Execution را می‌توان تا زمانی که حالت آن روی COMPLETE تنظیم شود، به‌روزرسانی کرد که در آن زمان تغییرناپذیر می‌شود.

نمایندگی 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

یک شناسه منحصر به فرد در یک History برای این اجرا.

اگر این فیلد توسط تماس‌گیرنده تنظیم یا بازنویسی شود، INVALID_ARGUMENT را برمی‌گرداند.

  • در پاسخ همیشه تنظیم شده است
  • در درخواست ایجاد/به‌روزرسانی: هرگز تنظیم نشود
state

enum ( State )

حالت اولیه IN_PROGRESS است.

تنها انتقال وضعیت قانونی از IN_PROGRESS به COMPLETE است.

در صورت درخواست انتقال نامعتبر، یک PRECONDITION_FAILED برگردانده خواهد شد.

حالت را فقط یک بار می توان روی COMPLETE تنظیم کرد. اگر حالت چند بار روی COMPLETE تنظیم شود، یک FAILED_PRECONDITION برگردانده می‌شود.

اگر حالت روی COMPLETE تنظیم شود، تمام مراحل در حال انجام اجرا به عنوان COMPLETE تنظیم می شود. اگر نتیجه مرحله تنظیم نشده باشد، نتیجه روی نامشخص تنظیم می شود.

  • در پاسخ همیشه تنظیم شده است
  • در درخواست ایجاد/به‌روزرسانی: اختیاری
creationTime

object ( Timestamp )

زمانی که Execution ایجاد شد.

هنگامی که executions.create فراخوانی شود، این مقدار به طور خودکار تنظیم می شود.

  • در پاسخ: همیشه تنظیم کنید
  • در درخواست ایجاد/به‌روزرسانی: هرگز تنظیم نشود
completionTime

object ( Timestamp )

زمانی که وضعیت Execution به COMPLETE تغییر کرد.

هنگامی که حالت به COMPLETE تغییر می کند، این مقدار به طور خودکار تنظیم می شود.

  • در پاسخ: اگر حالت اجرا کامل باشد تنظیم کنید.
  • در درخواست ایجاد/به‌روزرسانی: هرگز تنظیم نشود
outcome

object ( Outcome )

نتیجه را به عنوان مثال به SUCCESS یا FAILURE طبقه بندی کنید

  • در پاسخ: اگر با درخواست ایجاد/به‌روزرسانی تنظیم شده باشد، ارائه شود
  • در درخواست ایجاد/به‌روزرسانی: اختیاری
dimensionDefinitions[]

object ( MatrixDimensionDefinition )

ابعادی که در طول آن مراحل مختلف در این اجرا ممکن است متفاوت باشد. این باید در طول عمر اجرا ثابت بماند.

اگر این فیلد در یک درخواست به‌روزرسانی تنظیم شده باشد، INVALID_ARGUMENT را برمی‌گرداند.

اگر همان نام در بیش از یک dimension_definition وجود داشته باشد، INVALID_ARGUMENT را برمی‌گرداند.

اگر اندازه فهرست بیش از 100 باشد، INVALID_ARGUMENT را برمی‌گرداند.

  • در پاسخ: اگر با ایجاد تنظیم شود، ارائه شود
  • در ایجاد درخواست: اختیاری
  • در درخواست به روز رسانی: هرگز تنظیم نشده است
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

بسته جاوا برای آزمایش اجرا می شود. ضروری

testRunnerClass

string

کلاس InstrumentationTestRunner. ضروری

testTargets[]

string

هر هدف باید به طور کامل با نام بسته یا نام کلاس در یکی از این قالب‌ها واجد شرایط باشد: - "packagepackame" - "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

بسته جاوا برای بوت استرپ. اختیاری

bootstrapRunnerClass

string

کلاس رانر برای بوت استرپ. اختیاری

maxDepth

integer

حداکثر عمق پشته پیمایشی که Robo می تواند کاوش کند. اختیاری

maxSteps

integer

حداکثر تعداد مراحل/اقداماتی که Robo می تواند اجرا کند. پیش فرض بدون محدودیت (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 XCTest.

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

این نوع هیچ فیلدی ندارد.

تست Robo برای یک برنامه iOS.

مواد و روش ها

create

 یک Execution ایجاد می کند.

get

 اعدام می شود.

list

 اعدام ها را برای یک تاریخچه معین فهرست می کند.

patch

 یک Execution موجود را با موجودیت جزئی ارائه شده به روز می کند.
،

منبع: اجرا

یک Execution مجموعه ای از مراحل را نشان می دهد. به عنوان مثال، می تواند نشان دهنده موارد زیر باشد: - یک آزمایش موبایلی که در طیف وسیعی از تنظیمات دستگاه اجرا می شود - یک کار جنکینز با یک مرحله ساخت و سپس یک مرحله آزمایشی

حداکثر اندازه یک پیام اجرایی 1 مگابایت است.

یک Execution را می‌توان تا زمانی که حالت آن روی COMPLETE تنظیم شود، به‌روزرسانی کرد که در آن زمان تغییرناپذیر می‌شود.

نمایندگی 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

یک شناسه منحصر به فرد در یک History برای این اجرا.

اگر این فیلد توسط تماس‌گیرنده تنظیم یا بازنویسی شود، INVALID_ARGUMENT را برمی‌گرداند.

  • در پاسخ همیشه تنظیم شده است
  • در درخواست ایجاد/به‌روزرسانی: هرگز تنظیم نشود
state

enum ( State )

حالت اولیه IN_PROGRESS است.

تنها انتقال وضعیت قانونی از IN_PROGRESS به COMPLETE است.

در صورت درخواست انتقال نامعتبر، یک PRECONDITION_FAILED برگردانده خواهد شد.

حالت را فقط یک بار می توان روی COMPLETE تنظیم کرد. اگر حالت چند بار روی COMPLETE تنظیم شود، یک FAILED_PRECONDITION برگردانده می‌شود.

اگر حالت روی COMPLETE تنظیم شود، تمام مراحل در حال انجام اجرا به عنوان COMPLETE تنظیم می شود. اگر نتیجه مرحله تنظیم نشده باشد، نتیجه روی نامشخص تنظیم می شود.

  • در پاسخ همیشه تنظیم شده است
  • در درخواست ایجاد/به‌روزرسانی: اختیاری
creationTime

object ( Timestamp )

زمانی که Execution ایجاد شد.

هنگامی که executions.create فراخوانی شود، این مقدار به طور خودکار تنظیم می شود.

  • در پاسخ: همیشه تنظیم کنید
  • در درخواست ایجاد/به‌روزرسانی: هرگز تنظیم نشود
completionTime

object ( Timestamp )

زمانی که وضعیت Execution به COMPLETE تغییر کرد.

هنگامی که حالت به COMPLETE تغییر می کند، این مقدار به طور خودکار تنظیم می شود.

  • در پاسخ: اگر حالت اجرا کامل باشد تنظیم کنید.
  • در درخواست ایجاد/به‌روزرسانی: هرگز تنظیم نشود
outcome

object ( Outcome )

نتیجه را به عنوان مثال به SUCCESS یا FAILURE طبقه بندی کنید

  • در پاسخ: اگر با درخواست ایجاد/به‌روزرسانی تنظیم شده باشد، ارائه شود
  • در درخواست ایجاد/به‌روزرسانی: اختیاری
dimensionDefinitions[]

object ( MatrixDimensionDefinition )

ابعادی که در طول آن مراحل مختلف در این اجرا ممکن است متفاوت باشد. این باید در طول عمر اجرا ثابت بماند.

اگر این فیلد در یک درخواست به‌روزرسانی تنظیم شده باشد، INVALID_ARGUMENT را برمی‌گرداند.

اگر همان نام در بیش از یک dimension_definition وجود داشته باشد، INVALID_ARGUMENT را برمی‌گرداند.

اگر اندازه فهرست بیش از 100 باشد، INVALID_ARGUMENT را برمی‌گرداند.

  • در پاسخ: اگر با ایجاد تنظیم شود، ارائه شود
  • در ایجاد درخواست: اختیاری
  • در درخواست به روز رسانی: هرگز تنظیم نشده است
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

بسته جاوا برای آزمایش اجرا می شود. ضروری

testRunnerClass

string

کلاس InstrumentationTestRunner. ضروری

testTargets[]

string

هر هدف باید به طور کامل با نام بسته یا نام کلاس در یکی از این قالب‌ها واجد شرایط باشد: - "packagepackame" - "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

بسته جاوا برای بوت استرپ. اختیاری

bootstrapRunnerClass

string

کلاس رانر برای بوت استرپ. اختیاری

maxDepth

integer

حداکثر عمق پشته پیمایشی که Robo می تواند کاوش کند. اختیاری

maxSteps

integer

حداکثر تعداد مراحل/اقداماتی که Robo می تواند اجرا کند. پیش فرض بدون محدودیت (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 XCTest.

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

این نوع هیچ فیلدی ندارد.

تست Robo برای یک برنامه iOS.

مواد و روش ها

create

 یک Execution ایجاد می کند.

get

 اعدام می شود.

list

 اعدام‌ها را برای یک تاریخچه معین فهرست می‌کند.

patch

 یک Execution موجود را با موجودیت جزئی ارائه شده به روز می کند.