通訊協定
RealmProxy
在 fuchsia.testing.harness/realm_proxy.fidl 中定義
這個通訊協定會調解測試套件對於測試中元件的存取權。
RealmProxy 是測試控管工具，可讓部分測試套件建立執行個體 測試用的元件結構最重要的是 不必知道元件的建立和建立方式 只需要知道元件公開哪些功能即可。
舉例來說，Fchsia 檔案系統的通用測試套件可以使用 RealmProxy 進而產生提供 fuchsia.io FIDL 通訊協定的元件 資源庫。即使測試套件，不需要知道哪個檔案系統進行測試 以及檔案系統初始化的方式只需呼叫 [ConnectToNamedProtocol] 替換為 fuchsia.io 通訊協定的名稱，然後以 進行測試。使用初始化的不同 Proxy 執行這個測試套件 不同的檔案系統，我們也能使用相同的套件來驗證每個系統。
警告：RealmProxy 即將淘汰。如果想傳回 fuchsia.component.sandbox.DictionaryRef 安裝該物件，然後將其安裝到您的命名空間中。
ConnectToNamedProtocol
將 [server_end] 連線至這個 Proxy 命名空間的 [通訊協定]。
要求
| 名稱 | 類型 |
|---|---|
protocol |
string[255]
|
server_end |
handle<channel>
|
回應
| 名稱 | 類型 |
|---|---|
payload |
RealmProxy_ConnectToNamedProtocol_Result
|
ConnectToServiceInstance
從這個 Proxy 的命名空間連線至 [server_end] 至 [service]/[instance]。
要求
| 名稱 | 類型 |
|---|---|
service |
string[255]
|
instance |
string[255]
|
server_end |
handle<channel>
|
回應
| 名稱 | 類型 |
|---|---|
payload |
RealmProxy_ConnectToServiceInstance_Result
|
OpenService
連線至這個 Proxy 命名空間的 [server_end] 至 [service] 目錄。
要求
| 名稱 | 類型 |
|---|---|
service |
string[255]
|
server_end |
handle<channel>
|
回應
| 名稱 | 類型 |
|---|---|
payload |
RealmProxy_OpenService_Result
|
結構
RealmProxy_ConnectToNamedProtocol_Response
在 fuchsia.testing.harness/realm_proxy.fidl 中定義
<空白>
RealmProxy_ConnectToServiceInstance_Response
在 fuchsia.testing.harness/realm_proxy.fidl 中定義
<空白>
RealmProxy_OpenService_Response
在 fuchsia.testing.harness/realm_proxy.fidl 中定義
<空白>
ENUMS
OperationError 彈性
類型：uint32
定義於 fuchsia.testing.harness/errors.fidl
Fuchsia 測試控管工具作業錯誤類型。
控管工具負責維持特定測試執行作業的狀態。 當作業失敗時，就會傳回這個類型。
| 名稱 | 值 | 說明 |
|---|---|---|
無效 |
0 |
要求的作業無效。 當測試案例要求控管工具要執行時，就會傳回這個錯誤 與控管工具不相容」目前狀態這個 錯誤代表測試程式碼本身中的錯誤。 傳回這個值「必須」無法通過相應的測試。 範例：測試要求建立檔案之前的大小。 |
失敗 |
1 |
要求的作業失敗。 如果測試控管工具無法完成，就會傳回這個錯誤 執行作業，即使目前狀態應該允許 開始執行的作業這個錯誤代表 控管工具的依賴程度 傳回這個值「必須」無法通過相應的測試。 範例：測試要求取得檔案大小後 但查詢失敗 |
不支援 |
2 |
此控管工具不支援要求的作業。 如果測試控管工具不支援 所要求作業。這不一定是嚴重錯誤 象徵漁港對世界的觀念 但不會實作行為 傳回這個值「可能」未通過對應的測試，但 其實不需要這麼做這個傳回值有助於判斷 應用程式與不同功能集或版本的相容性 範例：測試要求取得檔案大小，但具有 用來檢查先前元件中的檔案大小 版本。 |
聯合國
RealmProxy_ConnectToNamedProtocol_Result 嚴格
在 fuchsia.testing.harness/realm_proxy.fidl 中定義
| Ordinal | Variant | 類型 | 說明 |
|---|---|---|---|
1 |
response |
RealmProxy_ConnectToNamedProtocol_Response
|
|
2 |
err |
OperationError
|
RealmProxy_ConnectToServiceInstance_Result 嚴格
在 fuchsia.testing.harness/realm_proxy.fidl 中定義
| Ordinal | Variant | 類型 | 說明 |
|---|---|---|---|
1 |
response |
RealmProxy_ConnectToServiceInstance_Response
|
|
2 |
err |
OperationError
|
RealmProxy_OpenService_Result 嚴格
在 fuchsia.testing.harness/realm_proxy.fidl 中定義
| Ordinal | Variant | 類型 | 說明 |
|---|---|---|---|
1 |
response |
RealmProxy_OpenService_Response
|
|
2 |
err |
OperationError
|
觀測站
| 名稱 | 值 | 類型 | 說明 |
|---|---|---|---|
| MAX_PROTOCOL_LEN |
fuchsia.io/MAX_NAME_LENGTH
|
uint64 |
FIDL 通訊協定名稱的字元數上限。 這個值已設為檔案系統節點名稱的上限，因為 我們一般使用檔案系統來找出通訊協定 新增日期：23
|