fuchsia.test.manager

新增時間：16 天

通訊協定

CaseIterator

在 fuchsia.test.manager/test_manager.fidl 中定義

列出可用測試案例的疊代器。

已淘汰：20

GetNext

傳回下一批可用的測試案例 (如果有的話)。傳回空白向量，表示疊代已完成。

要求

<EMPTY>

回應

名稱類型
cases vector<Case>

DebugDataIterator

在 fuchsia.test.manager/test_manager.fidl 中定義

用戶端可擷取偵錯資料資訊的疊代器通訊協定。

GetNext

擷取下一批偵錯資料。這是指停滯；如果沒有立即可用的資料，呼叫會停止運作，直到資料可用為止。系統傳回所有資料後，呼叫會傳回空白向量。

要求

<EMPTY>

回應

名稱類型
data vector<DebugData>

EarlyBootProfile

在 fuchsia.test.manager/test_manager.fidl 中定義

管理早期啟動設定檔的通訊協定。此 API 應在執行所有測試後呼叫。

RegisterWatcher

註冊疊代器以監控早期啟動設定檔。

要求

名稱類型
iterator server_end<DebugDataIterator>

查詢

在 fuchsia.test.manager/test_manager.fidl 中定義

已淘汰：20

列舉

列舉測試案例。

要求

名稱類型
test_url fuchsia.url/Url
iterator server_end<CaseIterator>

回應

名稱類型
payload Query_Enumerate_Result

EnumerateInRealm

列舉非密封測試中的測試案例。

要求

名稱類型
test_url fuchsia.url/Url
realm fuchsia.component/Realm
offers vector<fuchsia.component.decl/Offer>
test_collection string
iterator server_end<CaseIterator>

回應

名稱類型
payload Query_EnumerateInRealm_Result

RunBuilder

在 fuchsia.test.manager/test_manager.fidl 中定義

這是執行測試套件的進入點。測試「執行」中包含多個測試「套件」，其中包含執行多個「測試案例」。

已淘汰：20

AddSuite

請為這項執行作業新增套件。套件是實作 fuchsia.test.Suite 的元件。這個 API 的實作者將使用「Suite」通訊協定與測試套件通訊，並使用 controller 傳回結果。這個控制器也可以用來控管測試套件的執行作業。

要求

名稱類型
test_url fuchsia.url/Url
options RunOptions
controller server_end<SuiteController>

AddSuiteInRealm

為這項執行作業新增套件，並以提供「領域」執行。套件是實作 fuchsia.test.Suite 的元件。這個 API 的實作者會使用「Suite」通訊協定與測試套件通訊，並使用 controller 傳回結果。這個控制器還可用來控制測試套件的執行作業。

要求

名稱類型
realm fuchsia.component/Realm
offers vector<fuchsia.component.decl/Offer>
test_collection string
test_url fuchsia.url/Url
options RunOptions
controller server_end<SuiteController>

建構

建構並安排執行作業。

這會執行以個別篩選器新增的所有套件，並在完成後關閉管道。

要求

名稱類型
controller server_end<RunController>

WithSchedulingOptions

指定這項執行作業使用的排程選項。

要求

名稱類型
options SchedulingOptions

RunController

在 fuchsia.test.manager/test_manager.fidl 中定義

所有套件執行作業都完成且事件已清空後，伺服器端會中斷連線。如果用戶端中斷連線，系統會立即終止測試，並捨棄所有結果。

已淘汰：20

GetEvents

執行作業的疊代器。這個方法為懸掛式作業；只有在沒有其他事件 (執行已完成) 時，才會傳回空白向量。

要求

<EMPTY>

回應

名稱類型
events vector<RunEvent>

刪除

立即終止執行作業。所有資源釋出後，RunController 就會中斷連線。即使測試正在執行，此方法也會終止測試。

要求

<EMPTY>

停止

妥善停止執行作業。所有資源都釋出且這個控制器中的所有事件均已清空後，RunController 就會中斷連線。這個方法可用來讓執行作業完成正在進行的測試，但會導致無法啟動新的測試。

要求

<EMPTY>

SuiteController

在 fuchsia.test.manager/test_manager.fidl 中定義

提供從 SuiteRunner.RunSuite 開始的執行中測試套件，提供控管與監控功能。

套件執行完畢，且所有事件都透過 WatchEvents 傳送後，伺服器會關閉管道的結尾。如果用戶端中斷連線，套件會立即終止，並捨棄所有結果。

GetEvents

執行作業的疊代器。這個方法為懸掛式作業；只有在沒有其他事件 (執行已完成) 時，才會傳回空白向量。

已淘汰：20

要求

<EMPTY>

回應

名稱類型
payload SuiteController_GetEvents_Result

刪除

立即終止執行作業。所有資源釋出後， SuiteController 就會中斷連線。即使測試正在執行，此方法也會終止測試。

要求

<EMPTY>

停止

正常停止套件執行。所有資源都釋出且這個控制器中的所有事件均已清空後， SuiteController 會中斷連線。

要求

<EMPTY>

WatchEvents

當事件可使用懸掛式取得模式時，會傳回事件。傳回空白向量，表示沒有其他事件。

新增日期：20 位

要求

<EMPTY>

回應

名稱類型
payload SuiteController_WatchEvents_Result

SuiteRunner

在 fuchsia.test.manager/test_manager.fidl 中定義

執行測試套件。

新增日期：20 位

執行

執行測試套件。套件是實作 fuchsia.test.Suite 的測試元件。

要求

名稱類型
test_suite_url fuchsia.url/Url
options RunSuiteOptions
controller server_end<SuiteController>

TestCaseEnumerator

在 fuchsia.test.manager/test_manager.fidl 中定義

列舉實作 fuchsia.test.Suite 通訊協定的測試套件中的案例。

新增日期：20 位

列舉

為測試案例建立疊代器。

要求

名稱類型
test_suite_url fuchsia.url/Url
options EnumerateTestCasesOptions
iterator server_end<TestCaseIterator>

回應

名稱類型
payload TestCaseEnumerator_Enumerate_Result

TestCaseIterator

在 fuchsia.test.manager/test_manager.fidl 中定義

列出可用測試案例的疊代器。

新增日期：20 位

GetNext

傳回下一批測試案例。傳回空白向量，表示疊代已完成。

要求

<EMPTY>

回應

名稱類型
test_cases vector<TestCase>[1024]

結構化

CaseArtifact 資源

在 fuchsia.test.manager/test_manager.fidl 中定義

已淘汰：20

廣闊類型說明預設
identifier TestCaseId 無預設
artifact Artifact 無預設

CaseFinished

在 fuchsia.test.manager/test_manager.fidl 中定義

已淘汰：20

廣闊類型說明預設
identifier TestCaseId 無預設

CaseFound

在 fuchsia.test.manager/test_manager.fidl 中定義

已淘汰：20

廣闊類型說明預設
test_case_name CaseName

此測試案例的名稱。

 無預設
identifier TestCaseId

用於在後續酬載中識別這個測試案例

 無預設

CaseStarted

在 fuchsia.test.manager/test_manager.fidl 中定義

已淘汰：20

廣闊類型說明預設
identifier TestCaseId 無預設

CaseStopped

在 fuchsia.test.manager/test_manager.fidl 中定義

已淘汰：20

廣闊類型說明預設
identifier TestCaseId 無預設
status CaseStatus 無預設

DirectoryAndToken 資源

在 fuchsia.test.manager/test_manager.fidl 中定義

目錄處理常式，以及用於指出用戶端完成目錄檢查時間的權杖。伺服器端會保留 |directory| 中的所有資源 (例如子目錄和檔案)，|release_fence| 會保持開啟狀態。使用 |release_fence| 而非直接觀察 |directory| 管道，因為您可以將新管道複製到同一個目錄。

廣闊類型說明預設
directory fuchsia.io/Directory

Directory 管道，提供目錄存取權。因此請勿在 release_fence 關閉後使用這個管道。

 無預設
token handle<eventpair>

用於控制目錄保留情況的事件配對控制代碼。這個控制代碼關閉後，就不再保留目錄。

 無預設

Query_EnumerateInRealm_Response

在 fuchsia.test.manager/test_manager.fidl 中定義

<EMPTY>

Query_Enumerate_Response

在 fuchsia.test.manager/test_manager.fidl 中定義

<EMPTY>

RunStarted

在 fuchsia.test.manager/test_manager.fidl 中定義

已淘汰：20

<EMPTY>

RunStopped

在 fuchsia.test.manager/test_manager.fidl 中定義

已淘汰：20

<EMPTY>

Stderr 資源

在 fuchsia.test.manager/test_manager.fidl 中定義

已淘汰：20

廣闊類型說明預設
socket handle<socket> 無預設

標準資源

在 fuchsia.test.manager/test_manager.fidl 中定義

已淘汰：20

廣闊類型說明預設
socket handle<socket> 無預設

SuiteArtifact 資源

在 fuchsia.test.manager/test_manager.fidl 中定義

已淘汰：20

廣闊類型說明預設
artifact Artifact 無預設

SuiteController_GetEvents_Response 資源

在 fuchsia.test.manager/test_manager.fidl 中定義

廣闊類型說明預設
events vector<SuiteEvent> 無預設

SuiteController_WatchEvents_Response 資源

在 fuchsia.test.manager/test_manager.fidl 中定義

廣闊類型說明預設
events vector<Event>[1024] 無預設

SuiteStarted

在 fuchsia.test.manager/test_manager.fidl 中定義

已淘汰：20

<EMPTY>

SuiteStopped

在 fuchsia.test.manager/test_manager.fidl 中定義

已淘汰：20

廣闊類型說明預設
status SuiteStatus 無預設

TestCaseEnumerator_Enumerate_Response

在 fuchsia.test.manager/test_manager.fidl 中定義

<EMPTY>

ENUMS

CaseStatus 彈性

類型：uint32

在 fuchsia.test.manager/test_manager.fidl 中定義

代表測試案例執行作業的狀態。

已淘汰：20

名稱物超所值說明
0

已通過測試案例。
1

測試案例失敗。
2

測試案例逾時。
3

已略過測試案例。
4

套件實作未傳回狀態。

LaunchError 彈性

類型：uint32

在 fuchsia.test.manager/test_manager.fidl 中定義

發生 LaunchSuite 呼叫錯誤。

名稱物超所值說明
1

資源不足，無法執行這項作業。
2

無法解析 test_suite_url。
3

傳送的引數無效。
4

無法連結測試應公開的 fuchsia.test.TestSuite。
5

無法列舉測試。
6

發生內部錯誤，測試管理員設定時發生錯誤。 查看記錄並回報錯誤。
7

沒有符合指定測試篩選條件的測試案例。只有指定測試篩選器時，才會傳回這個錯誤。如果測試套件沒有測試案例，套件就會通過。
8

測試資訊清單無效。

LogsIteratorOption 彈性

類型：uint32

在 fuchsia.test.manager/test_manager.fidl 中定義

這個選項可指定用戶端支援的疊代器種類

已淘汰：20

名稱物超所值說明
0
1
2

LogsIteratorType 彈性

類型：uint32

在 fuchsia.test.manager/test_manager.fidl 中定義

替代日誌疊代機制的列舉。

新增日期：20 位

名稱物超所值說明
1

表示使用 fuchsia.diagnostics.BatchIterator。這個疊代器類型採用 VMO，可以在本機產生最佳效能，但無法遠端使用 (例如從主機使用)。選取這個類型時，log 類型的構件會有使用 Syslog 聯集的 batch 變化版本的值。
2

指出如何使用 fuchsia.diagnostics.host.ArchiveAccessor 中所述的通訊端。可用於遠端 (例如透過主機使用)。如果選取這個類型，log 類型的構件就會有使用 Syslog 聯集的 stream 變體的值。

SuiteResult 彈性

類型：uint32

在 fuchsia.test.manager/test_manager.fidl 中定義

代表套件執行的結果。

新增日期：20 位

名稱物超所值說明
1

套件正常執行，所有測試案例結果均為 SKIPPED 或 PASSED。
2

套件正常執行，某些測試案例的結果不是 SKIPPED 或 PASSED。
3

套件實作異常終止、未傳送 Finish 事件，或未回報一或多個測試案例的測試結果結果。
4

整個套件已逾時。
5

套件已停止執行。
6

SuiteStatus 彈性

類型：uint32

在 fuchsia.test.manager/test_manager.fidl 中定義

代表套件執行作業的狀態。這個順序是偏好設定的明確排序，從最低優先順序到最高優先順序。舉例來說，如果除了「失敗」以外的所有案例「通過」，整個套件的狀態就會是「失敗」。

已淘汰：20

名稱物超所值說明
0

所有測試案例已通過/略過。
1

套件中至少有一個測試案例失敗。
3

套件實作異常終止、未傳送 Finish 事件，或未回報一或多個測試案例的測試案例狀態。
4

至少有一個測試案例逾時。
5

測試套件已停止，
6

TestCaseResult 彈性

類型：uint32

在 fuchsia.test.manager/test_manager.fidl 中定義

代表測試案例的執行結果。

新增日期：20 位

名稱物超所值說明
1

已略過測試案例。
2

已通過測試案例。
3

測試案例失敗。
4

測試案例逾時。
5

套件實作未傳回測試案例的結果。

資料表

充電盒

在 fuchsia.test.manager/test_manager.fidl 中定義

列舉測試案例的說明。

已淘汰：20

序數廣闊類型說明
name CaseName

測試案例的名稱。

CustomArtifact 資源

在 fuchsia.test.manager/test_manager.fidl 中定義

說明包含測試產生的「自訂」(未分類) 構件的目錄。

序數廣闊類型說明
component_moniker string[4096]

產生目錄的元件 (相對於測試領域的根路徑名稱)。
directory_and_token DirectoryAndToken

包含構件的目錄。

DebugData 資源

在 fuchsia.test.manager/test_manager.fidl 中定義

說明可用的偵錯資料。

序數廣闊類型說明
name string[512]

檔案名稱。不得與每個 DebugDataIterator 重複。
socket handle<socket>

檔案可能存取的通訊端。

EnumerateTestCasesOptions 資源

在 fuchsia.test.manager/test_manager.fidl 中定義

指定如何列舉測試案例的選項。

新增日期：20 位

序數廣闊類型說明
realm_options RealmOptions

指定要列舉測試案例的領域。如未提供這個欄位，系統會在測試管理員的密封領域中列舉測試案例。這個選項適用於需要非密封領域，或透過自訂執行器測試運作範圍的用戶端。

事件資源

在 fuchsia.test.manager/test_manager.fidl 中定義

透過 SuiteController.WatchEvents 傳送的事件。

新增日期：20 位

序數廣闊類型說明
timestamp zx/Time

事件發生的時間。
details EventDetails

事件的詳細資料。

RealmOptions 資源

在 fuchsia.test.manager/test_manager.fidl 中定義

用於指定執行測試套件運作領域的選項。這些選項適用於需要非密封領域，或透過自訂執行器測試運作範圍的用戶端。詳情請參閱 [https://fuchsia.dev/fuchsia-src/Development/testing/components/create_test_realm] 和 [https://fuchsia.dev/fuchsia-src/Development/testing/components/test_runner_framework#non-hermetic_tests]。

新增日期：20 位

序數廣闊類型說明
realm fuchsia.component/Realm

包含要啟動測試的集合的運作範圍。這是必填欄位。
offers vector<fuchsia.component.decl/Offer>[1024]

從領域到測試系列的所有提案。這是必填欄位。
test_collection string[255]

用來啟動測試的測試集合。這是必填欄位。

RunEvent 資源

在 fuchsia.test.manager/test_manager.fidl 中定義

已淘汰：20

序數廣闊類型說明
timestamp zx/Time
payload RunEventPayload

RunOptions

在 fuchsia.test.manager/test_manager.fidl 中定義

執行測試套件的其他選用操作說明。

已淘汰：20

序數廣闊類型說明
run_disabled_tests bool

如果設為 True，系統將不會執行測試作者已停用的測試案例。預設值為 false。
parallel uint16

定義同時執行的測試案例數量上限。如未指定，Suite 實作會選擇預設行為。
arguments vector<string>

要傳遞至測試的選用引數。測試執行器會決定如何將這些引數傳遞至測試。
timeout zx/Duration

整個套件的逾時時間 (以秒為單位)。
case_filters_to_run vector<string>

glob 個案的濾鏡。這個篩選器會根據 glob 模式 [https://en.wikipedia.org/wiki/Glob_(programming)] 進行比對。系統只會執行符合至少一個模式的測試案例。此外，您可以在前面加上「-」來指定排除篩選器。指定排除篩選器時，系統會排除與排除篩選器相符的測試案例。這些篩選器的組合行為如下：

  • 如未指定篩選條件，系統會執行所有測試案例。
  • 如果僅指定正數篩選器，則系統會執行符合至少一個篩選器的測試案例。
  • 如果只指定排除篩選器，則不會執行符合任何篩選條件的測試案例。
  • 同時指定正數與排除篩選器時，系統會執行符合至少一個正篩選器，但不符合任何排除篩選器的測試案例。

舉例來說，假設套件具有 Foo.Test1、Foo.Test2、Bar.Test1 和 Bar.Test2 測試案例：

  • ["Foo.*"] 篩選器會執行 Foo.Test1 和 Foo.Test2。
  • ["-Foo.*"] 篩選器會執行 Bar.Test1 和 Bar.Test2。
  • ["Foo.*", "-*.Test1"] 篩選器會執行 Foo.Test2。
log_iterator LogsIteratorOption

定義用戶端支援的記錄疊代器類型。預設值為批次疊代器。
log_interest vector<fuchsia.diagnostics/LogInterestSelector>[64]

設定受測試元件的最小嚴重性。
break_on_failure bool

如果為 true，測試執行元件在遇到錯誤時應暫停測試套件 (如果支援)，以防偵錯工具日後可能會附加到程序中。如果測試執行器不支援停止執行中的測試套件，即可放心忽略這則訊息。

新增日期：20 位

RunSuiteOptions 資源

在 fuchsia.test.manager/test_manager.fidl 中定義

指定測試套件的執行方式。

新增日期：20 位

序數廣闊類型說明
realm_options RealmOptions

指定要執行測試套件的運作領域。如未提供這個欄位，測試會在測試管理員內的密封領域中執行。這個選項適用於需要非密封領域，或透過自訂執行器測試運作範圍的用戶端。
run_disabled_tests bool

如果設為 True，系統不會執行測試作者已停用的測試案例。根據預設，此值為 false。
max_concurrent_test_case_runs uint16

定義並行執行的測試案例數量上限。如果未指定，測試套件元件會決定這個值。
arguments vector<string>[4095]

要傳遞至測試的指令列引數。測試執行器會決定如何將這些引數傳遞至測試。根據預設，這個值是空白向量 (無引數)。
timeout zx/Duration

整個套件執行作業逾時，如果未指定，就不會有逾時，且套件可能會無限期停止執行。
test_case_filters vector<string>[1024]

以 glob 模式測試案例篩選器 [https://en.wikipedia.org/wiki/Glob_(programming)]。 負篩選器可在前面加上「-」符號。根據預設，這個值是空白向量 (無篩選器)。

如果同時符合以下兩項條件，系統就會執行指定的測試案例：

  • 未指定任何陽性篩選條件，或是測試案例與其中一個陽性篩選條件相符。
  • 測試案例不符合任何指定的排除篩選器。

舉例來說，假設套件具有 Foo.Test1、Foo.Test2、Bar.Test1 和 Bar.Test2 測試案例：

  • ["Foo.*"] 篩選器會執行 Foo.Test1 和 Foo.Test2。
  • ["-Foo.*"] 篩選器會執行 Bar.Test1 和 Bar.Test2。
  • ["Foo.*", "-*.Test1"] 篩選器會執行 Foo.Test2。
logs_iterator_type LogsIteratorType

指定用戶端用來擷取記錄的疊代器種類。根據預設，此值為 BATCH。
log_interest vector<fuchsia.diagnostics/LogInterestSelector>[64]

設定篩選測試套件元件中的記錄時要套用的最小嚴重性等級。
accumulate_debug_data bool

如果設為 True，測試管理員的 tmp 資料夾中會累積這次執行作業收集到的偵錯資料，以及之前執行作業中收集到的偵錯資料 (此標記設為 true)。預設值為 false。

當多個測試以批次執行時，且提供累積的資料比一次傳送偵錯資料更具效能時，就可以使用此選項。

SchedulingOptions

在 fuchsia.test.manager/test_manager.fidl 中定義

如何在測試執行作業中執行及排定套件的選用操作說明。

已淘汰：20

序數廣闊類型說明
max_parallel_suites uint16

可同時執行的密封測試套件數量上限。如未指定，則由伺服器端選擇。
accumulate_debug_data bool

如果設為 True，系統會一併累積先前執行作業中收集到的偵錯資料，以及此標記設為 true 時收集到的偵錯資料。預設值為 false。

SuiteArtifactGeneratedEventDetails 資源

在 fuchsia.test.manager/test_manager.fidl 中定義

suite_artifact_generated 事件的詳細資料。

新增日期：20 位

序數廣闊類型說明
artifact Artifact

說明成果。系統一律提供這個欄位。

SuiteEvent 資源

在 fuchsia.test.manager/test_manager.fidl 中定義

已淘汰：20

序數廣闊類型說明
timestamp zx/Time
payload SuiteEventPayload

SuiteStartedEventDetails

在 fuchsia.test.manager/test_manager.fidl 中定義

suite_started 事件的詳細資料。

新增日期：20 位

序數廣闊類型說明

SuiteStoppedEventDetails

在 fuchsia.test.manager/test_manager.fidl 中定義

suite_stopped 事件的詳細資料。

新增日期：20 位

序數廣闊類型說明
result SuiteResult

套房結果。系統一律提供這個欄位。

TestCase

在 fuchsia.test.manager/test_manager.fidl 中定義

列舉測試案例的說明。

序數廣闊類型說明
name TestCaseName

測試案例的名稱。

TestCaseArtifactGeneratedEventDetails 資源

在 fuchsia.test.manager/test_manager.fidl 中定義

test_case_artifact_generated 事件的詳細資料。

新增日期：20 位

序數廣闊類型說明
test_case_id TestCaseId

這個事件的相關測試案例。這個事件會顯示在具有相符 ID 的「test_case found」事件之後。系統一律提供這個欄位。
artifact Artifact

說明成果。系統一律提供這個欄位。

TestCaseFinishedEventDetails

在 fuchsia.test.manager/test_manager.fidl 中定義

test_case_finished 事件的詳細資料。

新增日期：20 位

序數廣闊類型說明
test_case_id TestCaseId

這個事件的相關測試案例。這個事件會顯示在具有相符 ID 的「test_case found」事件之後。系統一律提供這個欄位。

TestCaseFoundEventDetails

在 fuchsia.test.manager/test_manager.fidl 中定義

test_case_found 事件的詳細資料。

新增日期：20 位

序數廣闊類型說明
test_case_name TestCaseName

發現的測試案例名稱。系統一律提供這個欄位。
test_case_id TestCaseId

在後續事件中識別這個測試案例。這個欄位一律會提供，且對於特定 SuiteController 來說不會重複。

TestCaseStartedEventDetails

在 fuchsia.test.manager/test_manager.fidl 中定義

test_case_started 事件的詳細資料。

新增日期：20 位

序數廣闊類型說明
test_case_id TestCaseId

這個事件的相關測試案例。這個事件會顯示在具有相符 ID 的「test_case found」事件之後。系統一律提供這個欄位。

TestCaseStoppedEventDetails

在 fuchsia.test.manager/test_manager.fidl 中定義

test_case_stopped 事件的詳細資料。

新增日期：20 位

序數廣闊類型說明
test_case_id TestCaseId

這個事件的相關測試案例。這個事件會顯示在具有相符 ID 的「test_case found」事件之後。系統一律提供這個欄位。
result TestCaseResult

測試案例結果。系統一律提供這個欄位。

聯合國

構件的彈性 資源

在 fuchsia.test.manager/test_manager.fidl 中定義

說明一或多個構件。

序數Variant類型說明
stdout handle<socket>

構件是套件或測試案例的「stdout」串流。成果會透過通訊端 (這裡提供的取用端) 提供。
stderr handle<socket>

構件是套件或測試案例的「stderr」串流。成果會透過通訊端 (這裡提供的取用端) 提供。
log Syslog

構件是套件或測試案例的系統記錄。成果會透過批次疊代器或通訊端傳送。
custom CustomArtifact

成果是目錄中的一或多個檔案，可使用 fuchsia.io 讀取。
debug_data DebugDataIterator

這些構件是使用 DebugDataIterator 管道提交的偵錯資料。

EventDetails彈性 資源

在 fuchsia.test.manager/test_manager.fidl 中定義

透過 SuiteController.GetEvents 傳遞的事件詳細資料。

suite_started 事件一律位於與測試案例相關的事件前面，suite_stopped 事件則一律位於測試案例事件之前。suite_artifact_generated 可能會在任何時間點發生，包括 suite_started 之前和 suite_stopped 之後。

系統會針對套件中的所有測試案例產生 test_case_found 事件。如果已啟用特定測試案例的執行作業 (根據 RunSuiteOptions.test_case_filters 和 RunSuiteOptions.run_disabled_tests)，無論測試案例是否確實執行、執行作業完成或是否成功，都會產生以下序列：

  • test_case_found
  • test_case_started
  • test_case_stopped
  • test_case_finished

測試案例的 test_case_artifact_generated 事件可能會在 test_case_found 事件之後，以及該測試案例的 test_case_finished 事件之前發生。請注意，多個事件的測試案例事件可以交錯。

如未啟用測試案例執行作業，系統只會為該測試案例產生 test_case_found 事件。

新增日期：20 位
序數Variant類型說明
suite_started SuiteStartedEventDetails

套件已開始執行。suite_artifact_generated事件可能會在這個事件開始前發生。
test_case_found TestCaseFoundEventDetails

找到 test_case。這一律是特定測試案例的第一個事件。
test_case_started TestCaseStartedEventDetails

已開始執行測試案例。系統只會為特定測試案例產生一個 test_case_started 事件，而且一律位於該測試案例的 test_case_stopped 事件之前。測試案例的 test_case_artifact_generated 事件可能會出現在這個事件之前。
test_case_artifact_generated TestCaseArtifactGeneratedEventDetails

測試案例的成果。請注意，特定測試案例的 test_case_artifact_generated 事件可能會在 test_case_started 之前和 test_case_stopped 之後發生。
test_case_stopped TestCaseStoppedEventDetails

已停止執行測試案例。這個事件包含測試案例產生的 TestCaseResult。適用於客服案件的 test_case_artifact_generated 事件可能會在這個事件過後發生。
test_case_finished TestCaseFinishedEventDetails

測試案例已完成，所有 Artifact 事件也已分派給用戶端。這一律是特定測試案例的最後一個事件。
suite_artifact_generated SuiteArtifactGeneratedEventDetails

與整個套件相關的構件。
suite_stopped SuiteStoppedEventDetails

套件已停止執行。這個事件包含套件產生的 SuiteResult。此事件之後可能會發生 suite_artifact_generated 事件。

LogsIterator 彈性 資源

在 fuchsia.test.manager/test_manager.fidl 中定義

將疊代器的伺服器端保留測試的獨立記錄檔。

序數Variant類型說明
batch server_end<fuchsia.diagnostics/BatchIterator>

疊代器的伺服器端 (如果 Fuchsia 用戶端使用這個通訊協定)。
stream handle<socket>

疊代器的伺服器端 (主機端用戶端使用這個通訊協定時)。這會使用 fuchsia.diagnostics.host.ArchiveReader 中指定的通訊協定。

Query_EnumerateInRealm_Result 嚴格

在 fuchsia.test.manager/test_manager.fidl 中定義

序數Variant類型說明
response Query_EnumerateInRealm_Response
err LaunchError

Query_Enumerate_Result 嚴格

在 fuchsia.test.manager/test_manager.fidl 中定義

序數Variant類型說明
response Query_Enumerate_Response
err LaunchError

RunEventPayload 彈性 資源

在 fuchsia.test.manager/test_manager.fidl 中定義

執行作業的各種事件。測試執行的第一個事件一律為 run_started。run_stopped 會在測試執行停止時觸發，並一律在 run_started 後觸發。

已淘汰：20
序數Variant類型說明
run_started RunStarted

測試執行作業已開始執行。
run_stopped RunStopped

測試執行作業已停止。
artifact Artifact

測試執行作業產生了構件。

SuiteController_GetEvents_Result 嚴格 資源

在 fuchsia.test.manager/test_manager.fidl 中定義

序數Variant類型說明
response SuiteController_GetEvents_Response
err LaunchError
framework_err internal

SuiteController_WatchEvents_Result 嚴格 資源

在 fuchsia.test.manager/test_manager.fidl 中定義

序數Variant類型說明
response SuiteController_WatchEvents_Response
err LaunchError

SuiteEventPayload 彈性 資源

在 fuchsia.test.manager/test_manager.fidl 中定義

測試執行的各種事件。

測試案例的第一個事件一律為 case_found，最後一個事件則是 case_finished。case_started 和 case_artifact 事件可以按照任何順序排列。case_stopped 和 case_finished 之間可能會有一些 case_artifact。在整個套件執行完畢後，一律會觸發 suite_stopped 事件。請注意，suite_artifact 可能隨時觸發。 如果用戶端完全清空套件中的所有事件，即使測試元件無法回報結果，系統仍會回報所有找到的測試案例 case_stopped 和 case_finished。如果測試停止運作，除非在 RunOptions 中指定了逾時，否則 GetEvents 會停止運作並無法完成。

已淘汰：20
序數Variant類型說明
case_found CaseFound

找到案件。
case_started CaseStarted

案件已開始執行
case_stopped CaseStopped

案件已停止執行，包括案例的通過/失敗/略過結果。在此事件之後，用戶端可能仍會取得與這項測試相關的構件。
case_finished CaseFinished

案件已完成，且所有成果事件都已分派給用戶端。
case_artifact CaseArtifact

案件成果
suite_artifact SuiteArtifact

來自套件的構件。
suite_started SuiteStarted

套件已開始執行
suite_stopped SuiteStopped

套件已停止執行，包括套件的結果。事件發生後，用戶端可能還是會收到與這個套件相關的構件。

系統記錄檔彈性 資源

在 fuchsia.test.manager/test_manager.fidl 中定義

Syslog 的傳送方法。

序數Variant類型說明
batch fuchsia.diagnostics/BatchIterator

Fuchsia 用戶端使用的疊代器端。
stream handle<socket>

主機端用戶端所用通訊端的用戶端端。

TestCaseEnumerator_Enumerate_Result 嚴格

在 fuchsia.test.manager/test_manager.fidl 中定義

序數Variant類型說明
response TestCaseEnumerator_Enumerate_Response
err LaunchError
framework_err internal

業者

名稱物超所值類型說明
MAX_ARGUMENTS fuchsia.io/MAX_PATH_LENGTH uint64
新增日期：20 位
MAX_ARGUMENT_LENGTH 1024 uint64
新增日期：20 位
MAX_DEBUG_DATAS_PER_GET 1024 uint64
新增日期：20 位
MAX_EVENTS_PER_WATCH 1024 uint64
新增日期：20 位
MAX_FILTERS 1024 uint64
新增日期：20 位
MAX_FILTER_LENGTH fuchsia.component/MAX_MONIKER_LENGTH uint64
新增日期：20 位
MAX_OFFERS 1024 uint64
新增日期：20 位
MAX_TEST_CASES_PER_GET 1024 uint64
新增日期：20 位
MAX_TEST_COLLECTION_NAME_LENGTH fuchsia.io/MAX_NAME_LENGTH uint64
新增日期：20 位

別名

名稱物超所值說明
CaseName string[fuchsia.test/MAX_TEST_NAME]

測試案例的人類可讀名稱。

已淘汰：20
TestCaseId uint32

測試案例 ID。獨特的套房運行。
TestCaseName string[fuchsia.test/MAX_TEST_NAME]

測試案例的人類可讀名稱。