PROTOCOLS
Builder
Defined in fuchsia.component.test/realm_builder.fidl
Build
Assembles the realm being constructed and returns the URL for the root
component in the realm, which may then be used to create a new component
in any collection where fuchsia-test-component is properly set up. Once
this is called, any Realm channels for the realm will no longer be
usable. The runner
argument must be provided if the AddLocalChild
function has been used in this realm, as this runner channel will be
used to inform the client when to start and stop running any local
component implementations.
Errors:
INVALID_COMPONENT_DECL
: A component declaration failed validaiton.BUILD_ALREADY_CALLED
: TheBuild
function has been called multiple times on this channel.
Request
Name | Type |
---|---|
runner |
client_end:fuchsia.component.runner/ComponentRunner
|
Response
Name | Type |
---|---|
payload |
Builder_Build_Result
|
Realm
Defined in fuchsia.component.test/realm_builder.fidl
AddCapability
Add a capability to the realm.
Request
Name | Type |
---|---|
capability |
fuchsia.component.decl/Capability
|
Response
Name | Type |
---|---|
payload |
Realm_AddCapability_Result
|
AddChild
Adds a component to the realm.
The url
can be in one of the following formats:
- an absolute component URL (such as, "fuchsia-pkg://fuchsia.com/some-package#meta/some-component.cm")
- a relative path component URL to a subpackaged component (like, "some-subpackage#meta/subpackaged-component.cm"); or
- a relative fragment-only URL (like,
#meta/other-component.cm
; see https://fuchsia.dev/fuchsia-src/reference/components/url#relative-fragment-only) indicating the path to a component manifest in thepkg_dir
supplied toRealmBuilderFactory::Create*()
.
The realm builder client typically passes a handle to its own /pkg
directory, and bundles the other-component
into the same package.
Of the three URL types, only component declarations added via the
fragment-only URL can be modified, via
GetComponentDecl
/ReplaceComponentDecl
because realm builder actually
performs its own component resolution from the component's manifest and
files bundled in the provided pkg_dir
(typically from the package
shared by the realm builder client component and the components added
via fragment-only URL).
Errors:
CHILD_ALREADY_EXISTS
: this realm already contains a child with the given name.INVALID_MANIFEST_EXTENSION
:url
does not end with.cm
DECL_NOT_FOUND
: The test package does not contain the component declaration referenced by a fragment-only component URL.DECL_READ_ERROR
: Encountered an I/O error when attempting to read a component declaration referenced by a fragment-only component URL from the test package.BUILD_ALREADY_CALLED
: TheBuilder.Build
function has been called for this realm, and thus thisRealm
channel can no longer be used.
Request
Name | Type |
---|---|
name |
fuchsia.component/child_name
|
url |
fuchsia.url/Url
|
options |
ChildOptions
|
Response
Name | Type |
---|---|
payload |
Realm_AddChild_Result
|
AddChildFromDecl
Adds a component to this realm whose declaration is set to decl
. When
launched, the component will share the test package as its package
directory, and may access any resources from it.
Errors:
CHILD_ALREADY_EXISTS
: this realm already contains a child with the given name.INVALID_COMPONENT_DECL
:decl
failed validation.BUILD_ALREADY_CALLED
: TheBuilder.Build
function has been called for this realm, and thus thisRealm
channel can no longer be used.
Request
Name | Type |
---|---|
name |
fuchsia.component/child_name
|
decl |
fuchsia.component.decl/Component
|
options |
ChildOptions
|
Response
Name | Type |
---|---|
payload |
Realm_AddChildFromDecl_Result
|
AddChildRealm
Adds a child realm which can be built with the client end of
child_realm
.
Errors:
CHILD_ALREADY_EXISTS
: this realm already contains a child with the given name.BUILD_ALREADY_CALLED
: TheBuilder.Build
function has been called for this realm, and thus thisRealm
channel can no longer be used.
Request
Name | Type |
---|---|
name |
fuchsia.component/name
|
options |
ChildOptions
|
child_realm |
server_end:Realm
|
Response
Name | Type |
---|---|
payload |
Realm_AddChildRealm_Result
|
AddCollection
Adds a collection to the realm.
Request
Name | Type |
---|---|
collection |
fuchsia.component.decl/Collection
|
Response
Name | Type |
---|---|
payload |
Realm_AddCollection_Result
|
AddEnvironment
Adds an environment to the realm.
Request
Name | Type |
---|---|
environment |
fuchsia.component.decl/Environment
|
Response
Name | Type |
---|---|
payload |
Realm_AddEnvironment_Result
|
AddLocalChild
Adds a component to the realm whose implementation will be provided by
the client. When this component should be started, the runner channel
passed into Build
will receive a start request for a component whose
ProgramDecl
contains the moniker from the root of the
constructed realm for the child that is to be run under the program
key LOCAL_COMPONENT_NAME
.
Errors:
CHILD_ALREADY_EXISTS
: this realm already contains a child with the given name.BUILD_ALREADY_CALLED
: TheBuilder.Build
function has been called for this realm, and thus thisRealm
channel can no longer be used.
Request
Name | Type |
---|---|
name |
fuchsia.component/child_name
|
options |
ChildOptions
|
Response
Name | Type |
---|---|
payload |
Realm_AddLocalChild_Result
|
AddRoute
Mutates component manifests in the realm such that every component in
to
will have a valid capability route for each item in capabilities
provided by from
.
Errors:
NO_SUCH_SOURCE
:from
references a non-existent child.NO_SUCH_TARGET
:to
references a non-existent child.CAPABILITIES_EMPTY
:capabilities
is empty.TARGETS_EMPTY
:to
is empty.SOURCE_AND_TARGET_MATCH
:from
is equal to one of the elements into
.INVALID_COMPONENT_DECL
: The requested route caused one of the involved manifests to fail validation.BUILD_ALREADY_CALLED
: TheBuilder.Build
function has been called for this realm, and thus thisRealm
channel can no longer be used.
Request
Name | Type |
---|---|
capabilities |
vector<Capability>
|
from |
fuchsia.component.decl/Ref
|
to |
vector<fuchsia.component.decl/Ref>
|
Response
Name | Type |
---|---|
payload |
Realm_AddRoute_Result
|
GetComponentDecl
Returns the component decl for the given component. name
must refer to
a component that is one of the following:
- A component with a local implementation
- A legacy component
- A component added with a fragment-only URL (typically, components
bundled in the same package as the realm builder client, sharing the
same
/pkg
directory, for example,#meta/other-component.cm
; see https://fuchsia.dev/fuchsia-src/reference/components/url#relative-fragment-only) - An automatically generated realm (ex: the root)
Errors:
NO_SUCH_CHILD
: This realm does not contain a child with the given name.CHILD_DECL_NOT_VISIBLE
: The component decl cannot be fetched for the referenced child, because the child was added to the realm using a modern (not legacy) absolute URL or subpackaged component's relative path URL.BUILD_ALREADY_CALLED
: TheBuilder.Build
function has been called for this realm, and thus thisRealm
channel can no longer be used.
Request
Name | Type |
---|---|
name |
fuchsia.component/child_name
|
Response
Name | Type |
---|---|
payload |
Realm_GetComponentDecl_Result
|
GetRealmDecl
Returns the component decl for this realm.
Errors:
BUILD_ALREADY_CALLED
: TheBuilder.Build
function has been called for this realm, and thus thisRealm
channel can no longer be used.
Request
<EMPTY>
Response
Name | Type |
---|---|
payload |
Realm_GetRealmDecl_Result
|
InitMutableConfigFromPackage
Load any packaged configuration for name
before using values provided to
the builder.
Allows calling SetConfigValue
to override packaged configuration.
Request
Name | Type |
---|---|
name |
fuchsia.component/name
|
Response
Name | Type |
---|---|
payload |
Realm_InitMutableConfigFromPackage_Result
|
InitMutableConfigToEmpty
Use only values provided to the builder for name
's configuration.
Allows calling SetConfigValue
to provide configuration.
Request
Name | Type |
---|---|
name |
fuchsia.component/name
|
Response
Name | Type |
---|---|
payload |
Realm_InitMutableConfigToEmpty_Result
|
ReadOnlyDirectory
Offers a directory capability to a component in this realm. The
directory will be read-only (i.e. have r*
rights), and will have the
contents described in directory_contents
.
Errors:
NO_SUCH_TARGET
:offer-to
references a non-existent child.BUILD_ALREADY_CALLED
: TheBuilder.Build
function has been called for this realm, and thus thisRealm
channel can no longer be used.
Request
Name | Type |
---|---|
name |
fuchsia.component/name
|
to |
vector<fuchsia.component.decl/Ref>
|
directory_contents |
DirectoryContents
|
Response
Name | Type |
---|---|
payload |
Realm_ReadOnlyDirectory_Result
|
ReplaceComponentDecl
Replaces the component decl for the given component. name
must
refer to a component that is one of the following:
- A component with a local implementation
- A legacy component
- A component added with a fragment-only URL (typically, components
bundled in the same package as the realm builder client, sharing the
same
/pkg
directory, for example,#meta/other-component.cm
; see https://fuchsia.dev/fuchsia-src/reference/components/url#relative-fragment-only) - An automatically generated realm (ex: the root)
Errors:
NO_SUCH_CHILD
: This realm does not contain a child with the given name.CHILD_ALREADY_EXISTS
: The component whose decl is being replaced has had a child added to it through realm builder with the same name as an element incomponent_decl.children
.CHILD_DECL_NOT_VISIBLE
: The component decl cannot be manipulated for the referenced child, because the child was added to the realm using an absolute (not relative) and modern (not legacy) URL.INVALID_COMPONENT_DECL
:component_decl
failed validation.BUILD_ALREADY_CALLED
: TheBuilder.Build
function has been called for this realm, and thus thisRealm
channel can no longer be used.
Request
Name | Type |
---|---|
name |
fuchsia.component/child_name
|
component_decl |
fuchsia.component.decl/Component
|
Response
Name | Type |
---|---|
payload |
Realm_ReplaceComponentDecl_Result
|
ReplaceRealmDecl
Replaces the component decl for this realm.
Errors:
INVALID_COMPONENT_DECL
:component_decl
failed validation.BUILD_ALREADY_CALLED
: TheBuilder.Build
function has been called for this realm, and thus thisRealm
channel can no longer be used.
Request
Name | Type |
---|---|
component_decl |
fuchsia.component.decl/Component
|
Response
Name | Type |
---|---|
payload |
Realm_ReplaceRealmDecl_Result
|
SetConfigValue
Sets the configuration value for a field specified by key
.
The component specified must have a config schema with this field.
The value must conform to all constraints as defined by the schema.
This method must be called after either InitMutableConfigFromPackage
or
InitMutableConfigToEmpty
.
Errors:
NO_CONFIG_SCHEMA
: component does not have a config schemaNO_SUCH_CONFIG_FIELD
:key
could not be found in component's config schemaCONFIG_VALUE_INVALID
:value
does not meet config schema constraints
Request
Name | Type |
---|---|
name |
fuchsia.component/name
|
key |
fuchsia.component.decl/ConfigKey
|
value |
fuchsia.component.decl/ConfigValueSpec
|
Response
Name | Type |
---|---|
payload |
Realm_SetConfigValue_Result
|
RealmBuilderFactory
Defined in fuchsia.component.test/realm_builder.fidl
This protocol can be used to instruct the Realm Builder Server to begin creating a new realm.
Create
Creates a new RealmBuilder. The client end of realm_server_end
can be
used to mutate the realm that is being constructed, by doing things such
as adding new children to the realm or adding capability routes between
them. The client end of builder_server_end
is used to finalize the
realm, after which point it can be launched in a collection.
pkg_dir_handle
is a handle to the test package. The realm builder
client typically passes a handle to its own /pkg
directory, and
bundles the other-component
into the same package.
Request
Name | Type |
---|---|
pkg_dir_handle |
client_end:fuchsia.io/Directory
|
realm_server_end |
server_end:Realm
|
builder_server_end |
server_end:Builder
|
Response
Name | Type |
---|---|
payload |
RealmBuilderFactory_Create_Result
|
CreateFromRelativeUrl
Identical to Create
, but instead of the realm being empty by default
it contains the contents of the manifest located in the test package at
the path indicated by relative_url
, which must be a fragment-only URL
(for example, #meta/other-component.cm
; see
https://fuchsia.dev/fuchsia-src/reference/components/url#relative-fragment-only).
Request
Name | Type |
---|---|
pkg_dir_handle |
client_end:fuchsia.io/Directory
|
relative_url |
fuchsia.url/Url
|
realm_server_end |
server_end:Realm
|
builder_server_end |
server_end:Builder
|
Response
Name | Type |
---|---|
payload |
RealmBuilderFactory_CreateFromRelativeUrl_Result
|
STRUCTS
Builder_Build_Response
Defined in fuchsia.component.test/realm_builder.fidl
Field | Type | Description | Default |
---|---|---|---|
root_component_url |
string:4096
|
No default |
DirectoryContents resource
Defined in fuchsia.component.test/realm_builder.fidl
The contents of a directory that should be provided by the realm builder server.
Field | Type | Description | Default |
---|---|---|---|
entries |
vector<DirectoryEntry>:1024
|
No default |
DirectoryEntry resource
Defined in fuchsia.component.test/realm_builder.fidl
An entry in a directory.
Field | Type | Description | Default |
---|---|---|---|
file_path |
fuchsia.component/name
|
The path to the file. Valid examples include |
No default |
file_contents |
fuchsia.mem/Buffer
|
The contents of the file. |
No default |
RealmBuilderFactory_CreateFromRelativeUrl_Response
Defined in fuchsia.component.test/realm_builder.fidl
<EMPTY>
RealmBuilderFactory_Create_Response
Defined in fuchsia.component.test/realm_builder.fidl
<EMPTY>
Realm_AddCapability_Response
Defined in fuchsia.component.test/realm_builder.fidl
<EMPTY>
Realm_AddChildFromDecl_Response
Defined in fuchsia.component.test/realm_builder.fidl
<EMPTY>
Realm_AddChildRealm_Response
Defined in fuchsia.component.test/realm_builder.fidl
<EMPTY>
Realm_AddChild_Response
Defined in fuchsia.component.test/realm_builder.fidl
<EMPTY>
Realm_AddCollection_Response
Defined in fuchsia.component.test/realm_builder.fidl
<EMPTY>
Realm_AddEnvironment_Response
Defined in fuchsia.component.test/realm_builder.fidl
<EMPTY>
Realm_AddLocalChild_Response
Defined in fuchsia.component.test/realm_builder.fidl
<EMPTY>
Realm_AddRoute_Response
Defined in fuchsia.component.test/realm_builder.fidl
<EMPTY>
Realm_GetComponentDecl_Response
Defined in fuchsia.component.test/realm_builder.fidl
Field | Type | Description | Default |
---|---|---|---|
component_decl |
fuchsia.component.decl/Component
|
No default |
Realm_GetRealmDecl_Response
Defined in fuchsia.component.test/realm_builder.fidl
Field | Type | Description | Default |
---|---|---|---|
component_decl |
fuchsia.component.decl/Component
|
No default |
Realm_InitMutableConfigFromPackage_Response
Defined in fuchsia.component.test/realm_builder.fidl
<EMPTY>
Realm_InitMutableConfigToEmpty_Response
Defined in fuchsia.component.test/realm_builder.fidl
<EMPTY>
Realm_ReadOnlyDirectory_Response
Defined in fuchsia.component.test/realm_builder.fidl
<EMPTY>
Realm_ReplaceComponentDecl_Response
Defined in fuchsia.component.test/realm_builder.fidl
<EMPTY>
Realm_ReplaceRealmDecl_Response
Defined in fuchsia.component.test/realm_builder.fidl
<EMPTY>
Realm_SetConfigValue_Response
Defined in fuchsia.component.test/realm_builder.fidl
<EMPTY>
ENUMS
RealmBuilderError flexible
Type: uint32
Defined in fuchsia.component.test/realm_builder.fidl
Errors that may be returned by the Realm
and Builder
protocols.
Name | Value | Description |
---|---|---|
CHILD_ALREADY_EXISTS |
0 |
Child cannot be added to the realm, as there is already a child in the realm with that name. |
INVALID_MANIFEST_EXTENSION |
1 |
A legacy component URL was given to |
INVALID_COMPONENT_DECL |
2 |
A component declaration failed validation. |
NO_SUCH_CHILD |
3 |
The referenced child does not exist. |
CHILD_DECL_NOT_VISIBLE |
4 |
The component declaration for the referenced child cannot be viewed nor manipulated by RealmBuilder, because the child was added to the realm using an URL that was neither a fragment-only nor a legacy URL. |
NO_SUCH_SOURCE |
5 |
The source does not exist. |
NO_SUCH_TARGET |
6 |
A target does not exist. |
CAPABILITIES_EMPTY |
7 |
The |
TARGETS_EMPTY |
8 |
The |
SOURCE_AND_TARGET_MATCH |
9 |
The |
DECL_NOT_FOUND |
10 |
The test package does not contain the component declaration referenced by a fragment-only component URL. |
DECL_READ_ERROR |
11 |
Encountered an I/O error when attempting to read a component declaration referenced by a fragment-only component URL from the test package. |
BUILD_ALREADY_CALLED |
12 |
The |
CAPABILITY_INVALID |
13 |
A capability is invalid. This may occur if a required field is empty or if an unsupported type is received. |
INVALID_CHILD_REALM_HANDLE |
14 |
The handle the client provided for the child realm is not usable. |
IMMUTABLE_PROGRAM |
15 |
|
URL_IS_NOT_RELATIVE |
16 |
The URL provided to |
INVALID_PKG_DIR_HANDLE |
17 |
The handle the client provided for the test's pkg directory is not usable. |
NO_CONFIG_SCHEMA |
18 |
The component does not have a config schema defined. Attempting to set a config value is not allowed. |
NO_SUCH_CONFIG_FIELD |
19 |
The component's config schema does not have a field with that name. |
CONFIG_VALUE_INVALID |
20 |
A config value is invalid. This may mean a type mismatch or an issue with constraints like string/vector length. |
CONFIG_OVERRIDE_UNSUPPORTED |
21 |
A config value cannot be set because the realm has not chosen its override policy. Added: 9
|
TABLES
ChildOptions
Defined in fuchsia.component.test/realm_builder.fidl
Properties that may be set on a child when it is added to a realm.
Ordinal | Field | Type | Description |
---|---|---|---|
1 |
startup |
fuchsia.component.decl/StartupMode
|
For information on this type, see
https://fuchsia.dev/go/components/declaration#StartupMode.
Defaults to |
2 |
environment |
fuchsia.component/name
|
Specify a custom environment for the child to run under. |
3 |
on_terminate |
fuchsia.component.decl/OnTerminate
|
For information on this type, see
https://fuchsia.dev/go/components/declaration#OnTerminate.
Defaults to |
4 |
config_overrides |
vector<fuchsia.component.decl/ConfigOverride>
|
Structured Configuration overrides to be applied to the child. Only keys declared by the child component as overridable by parent may be provided. For information on overrides, see [fuchsia.component.decl/ConfigOverride]. Added: 13
|
Config
Defined in fuchsia.component.test/realm_builder.fidl
A configuration capability
Ordinal | Field | Type | Description |
---|---|---|---|
1 |
name |
fuchsia.component/name
|
The name of the capability. |
2 |
as |
fuchsia.component/name
|
A rename of the capability, which can be set when routing to another component. This field is optional. |
3 |
availability |
fuchsia.component.decl/Availability
|
Optional. Cannot be set to |
Dictionary
Defined in fuchsia.component.test/realm_builder.fidl
A dictionary capability
Ordinal | Field | Type | Description |
---|---|---|---|
1 |
name |
fuchsia.component/name
|
The name of the dictionary. |
2 |
as |
fuchsia.component/name
|
A rename of the dictionary, which can be set when routing to another component. This field is optional. |
3 |
type |
fuchsia.component.decl/DependencyType
|
For information on this type, see
https://fuchsia.dev/go/components/declaration#DependencyType.
This field is optional and defaults to |
4 |
availability |
fuchsia.component.decl/Availability
|
Optional. Cannot be set to |
5 |
from_dictionary |
string
|
Optional. If set, the path to the dictionary routed by |
Directory
Defined in fuchsia.component.test/realm_builder.fidl
A directory capability.
Ordinal | Field | Type | Description |
---|---|---|---|
1 |
name |
fuchsia.component/name
|
The name of the capability. This is not the path of the directory. Instead it is a name used for routing. |
2 |
as |
fuchsia.component/name
|
A rename of the capability, which can be set when routing to another component. This field is optional. |
3 |
type |
fuchsia.component.decl/DependencyType
|
For information on this type, see
https://fuchsia.dev/go/components/declaration#DependencyType.
This field is optional and defaults to |
4 |
subdir |
string:4095
|
The subdirectory of this directory to offer instead of the root. For
example, if you set |
5 |
rights |
fuchsia.io/Rights
|
The maximum rights that can be set by a component using this directory. This field is required if it is being routed to a local component, otherwise, it is optional. |
6 |
path |
string:4095
|
The path in which to install the directory. The path should have a
leading slash but no trailing slash, e.g. |
7 |
availability |
fuchsia.component.decl/Availability
|
Optional. Cannot be set to Added: 10
|
8 |
from_dictionary |
string
|
Optional. If set, the path to the dictionary routed by Added: 25
|
Event
Defined in fuchsia.component.test/realm_builder.fidl
An event capability
Ordinal | Field | Type | Description |
---|---|---|---|
1 |
name |
fuchsia.component/name
|
The name of the capability. |
2 |
as |
fuchsia.component/name
|
A rename of the capability, which can be set when routing to another component. This field is optional. |
3 |
filter |
fuchsia.data/Dictionary
|
A filter to apply on the event. |
4 |
availability |
fuchsia.component.decl/Availability
|
Optional. Cannot be set to Added: 10
|
EventStream
Defined in fuchsia.component.test/realm_builder.fidl
An event_stream capability
Ordinal | Field | Type | Description |
---|---|---|---|
1 |
name |
fuchsia.component/name
|
The name of the capability. |
2 |
as |
fuchsia.component/name
|
A rename of the capability, which can be set when routing to another |
3 |
path |
string:4095
|
Sets the path in which the event_stream is installed. |
4 |
filter |
fuchsia.data/Dictionary
|
A filter to apply on the event. |
5 |
scope |
vector<fuchsia.component.decl/Ref>
|
A list of objects underneath this component to downscope the event to. Example: #my_child_component, #my_child_collection. |
Protocol
Defined in fuchsia.component.test/realm_builder.fidl
A protocol capability
Ordinal | Field | Type | Description |
---|---|---|---|
1 |
name |
fuchsia.component/name
|
The name of the capability. This is usually the name of the FIDL
protocol, e.g. |
2 |
as |
fuchsia.component/name
|
A rename of the capability, which can be set when routing to another component. This field is optional. |
3 |
type |
fuchsia.component.decl/DependencyType
|
For information on this type, see
https://fuchsia.dev/go/components/declaration#DependencyType.
This field is optional and defaults to |
4 |
path |
string:4095
|
Override the path in which the protocol is installed. Instead of
|
5 |
availability |
fuchsia.component.decl/Availability
|
Optional. Cannot be set to Added: 10
|
6 |
from_dictionary |
string
|
Optional. If set, the path to the dictionary routed by Added: 25
|
Resolver
Defined in fuchsia.component.test/realm_builder.fidl
A resolver capability
Ordinal | Field | Type | Description |
---|---|---|---|
1 |
name |
fuchsia.component/name
|
The name of the resolver. |
2 |
as |
fuchsia.component/name
|
A rename of the resolver, which can be set when routing to another component. This field is optional. |
3 |
path |
string:4095
|
Override the path in which the resolver is installed. Instead of
|
4 |
from_dictionary |
string
|
Optional. If set, the path to the dictionary routed by Added: 25
|
Runner
Defined in fuchsia.component.test/realm_builder.fidl
A runner capability
Ordinal | Field | Type | Description |
---|---|---|---|
1 |
name |
fuchsia.component/name
|
The name of the runner. |
2 |
as |
fuchsia.component/name
|
A rename of the runner, which can be set when routing to another component. This field is optional. |
3 |
path |
string:4095
|
Override the path in which the runner is installed. Instead of
|
4 |
from_dictionary |
string
|
Optional. If set, the path to the dictionary routed by Added: 25
|
Service
Defined in fuchsia.component.test/realm_builder.fidl
A service capability
Ordinal | Field | Type | Description |
---|---|---|---|
1 |
name |
fuchsia.component/name
|
The name of the capability. This is usually the name of the FIDL
service, e.g. |
2 |
as |
fuchsia.component/name
|
A rename of the capability, which can be set when routing to another component. This field is optional. |
3 |
path |
string:4095
|
Override the path in which the service is installed. Instead of
|
4 |
availability |
fuchsia.component.decl/Availability
|
Optional. Cannot be set to Added: 10
|
5 |
from_dictionary |
string
|
Optional. If set, the path to the dictionary routed by Added: 25
|
Storage
Defined in fuchsia.component.test/realm_builder.fidl
A storage capability
Ordinal | Field | Type | Description |
---|---|---|---|
1 |
name |
fuchsia.component/name
|
The name of the capability. This is not the path of the directory. Instead it is a name used for routing. |
2 |
as |
fuchsia.component/name
|
A rename of the capability, which can be set when routing to another component. This field is optional. |
3 |
path |
fuchsia.component/name
|
The path in which to install the directory. The path should have a
leading slash but no trailing slash, e.g. |
4 |
availability |
fuchsia.component.decl/Availability
|
Optional. Cannot be set to Added: 10
|
UNIONS
Builder_Build_Result strict
Defined in fuchsia.component.test/realm_builder.fidl
Ordinal | Variant | Type | Description |
---|---|---|---|
1 |
response |
Builder_Build_Response
|
|
2 |
err |
RealmBuilderError
|
Capability flexible
Defined in fuchsia.component.test/realm_builder.fidl
A capability that can be routed around a realm using AddRoute
.
Will be renamed to Capability
once the other definition under this name
earlier in this file is removed.
Ordinal | Variant | Type | Description |
---|---|---|---|
1 |
protocol |
Protocol
|
|
2 |
directory |
Directory
|
|
3 |
storage |
Storage
|
|
4 |
service |
Service
|
|
6 |
event_stream |
EventStream
|
Added: 9
|
7 |
config |
Config
|
Added: 20
|
8 |
dictionary |
Dictionary
|
Added: 25
|
9 |
resolver |
Resolver
|
Added: 24
|
10 |
runner |
Runner
|
Added: 24
|
RealmBuilderFactory_CreateFromRelativeUrl_Result strict
Defined in fuchsia.component.test/realm_builder.fidl
Ordinal | Variant | Type | Description |
---|---|---|---|
1 |
response |
RealmBuilderFactory_CreateFromRelativeUrl_Response
|
|
2 |
err |
RealmBuilderError
|
RealmBuilderFactory_Create_Result strict
Defined in fuchsia.component.test/realm_builder.fidl
Ordinal | Variant | Type | Description |
---|---|---|---|
1 |
response |
RealmBuilderFactory_Create_Response
|
|
2 |
err |
RealmBuilderError
|
Realm_AddCapability_Result strict
Defined in fuchsia.component.test/realm_builder.fidl
Ordinal | Variant | Type | Description |
---|---|---|---|
1 |
response |
Realm_AddCapability_Response
|
|
2 |
err |
RealmBuilderError
|
Realm_AddChildFromDecl_Result strict
Defined in fuchsia.component.test/realm_builder.fidl
Ordinal | Variant | Type | Description |
---|---|---|---|
1 |
response |
Realm_AddChildFromDecl_Response
|
|
2 |
err |
RealmBuilderError
|
Realm_AddChildRealm_Result strict
Defined in fuchsia.component.test/realm_builder.fidl
Ordinal | Variant | Type | Description |
---|---|---|---|
1 |
response |
Realm_AddChildRealm_Response
|
|
2 |
err |
RealmBuilderError
|
Realm_AddChild_Result strict
Defined in fuchsia.component.test/realm_builder.fidl
Ordinal | Variant | Type | Description |
---|---|---|---|
1 |
response |
Realm_AddChild_Response
|
|
2 |
err |
RealmBuilderError
|
Realm_AddCollection_Result strict
Defined in fuchsia.component.test/realm_builder.fidl
Ordinal | Variant | Type | Description |
---|---|---|---|
1 |
response |
Realm_AddCollection_Response
|
|
2 |
err |
RealmBuilderError
|
Realm_AddEnvironment_Result strict
Defined in fuchsia.component.test/realm_builder.fidl
Ordinal | Variant | Type | Description |
---|---|---|---|
1 |
response |
Realm_AddEnvironment_Response
|
|
2 |
err |
RealmBuilderError
|
Realm_AddLocalChild_Result strict
Defined in fuchsia.component.test/realm_builder.fidl
Ordinal | Variant | Type | Description |
---|---|---|---|
1 |
response |
Realm_AddLocalChild_Response
|
|
2 |
err |
RealmBuilderError
|
Realm_AddRoute_Result strict
Defined in fuchsia.component.test/realm_builder.fidl
Ordinal | Variant | Type | Description |
---|---|---|---|
1 |
response |
Realm_AddRoute_Response
|
|
2 |
err |
RealmBuilderError
|
Realm_GetComponentDecl_Result strict
Defined in fuchsia.component.test/realm_builder.fidl
Ordinal | Variant | Type | Description |
---|---|---|---|
1 |
response |
Realm_GetComponentDecl_Response
|
|
2 |
err |
RealmBuilderError
|
Realm_GetRealmDecl_Result strict
Defined in fuchsia.component.test/realm_builder.fidl
Ordinal | Variant | Type | Description |
---|---|---|---|
1 |
response |
Realm_GetRealmDecl_Response
|
|
2 |
err |
RealmBuilderError
|
Realm_InitMutableConfigFromPackage_Result strict
Defined in fuchsia.component.test/realm_builder.fidl
Ordinal | Variant | Type | Description |
---|---|---|---|
1 |
response |
Realm_InitMutableConfigFromPackage_Response
|
|
2 |
err |
RealmBuilderError
|
Realm_InitMutableConfigToEmpty_Result strict
Defined in fuchsia.component.test/realm_builder.fidl
Ordinal | Variant | Type | Description |
---|---|---|---|
1 |
response |
Realm_InitMutableConfigToEmpty_Response
|
|
2 |
err |
RealmBuilderError
|
Realm_ReadOnlyDirectory_Result strict
Defined in fuchsia.component.test/realm_builder.fidl
Ordinal | Variant | Type | Description |
---|---|---|---|
1 |
response |
Realm_ReadOnlyDirectory_Response
|
|
2 |
err |
RealmBuilderError
|
Realm_ReplaceComponentDecl_Result strict
Defined in fuchsia.component.test/realm_builder.fidl
Ordinal | Variant | Type | Description |
---|---|---|---|
1 |
response |
Realm_ReplaceComponentDecl_Response
|
|
2 |
err |
RealmBuilderError
|
Realm_ReplaceRealmDecl_Result strict
Defined in fuchsia.component.test/realm_builder.fidl
Ordinal | Variant | Type | Description |
---|---|---|---|
1 |
response |
Realm_ReplaceRealmDecl_Response
|
|
2 |
err |
RealmBuilderError
|
Realm_SetConfigValue_Result strict
Defined in fuchsia.component.test/realm_builder.fidl
Ordinal | Variant | Type | Description |
---|---|---|---|
1 |
response |
Realm_SetConfigValue_Response
|
|
2 |
err |
RealmBuilderError
|
CONSTANTS
Name | Value | Type | Description |
---|---|---|---|
LOCAL_COMPONENT_NAME_KEY | LOCAL_COMPONENT_NAME |
String |
|
MAX_DIRECTORY_ENTRIES |
1024
|
uint32 |
Maximum number of entries allowed in one call of |