Listing device images¶
| Tool | What it does | Platforms | Needs |
|---|---|---|---|
💿 listDeviceImages |
List device images | — | — |
listDeviceImages lists the configured emulators (Android) or simulators (iOS,
tvOS, visionOS) on this host, booted or not.
| Parameter | Values | Default |
|---|---|---|
platform |
android, ios, tvos, visionos |
required |
detail |
compact, full |
compact |
sessionUuid |
session used for admission | none |
Result¶
images: one entry per image, withidentity.stableId,name,platform,formFactorandruntime.lifecycle.count: the total number of images.configuredInventory: whether discovery completed for the platform. CheckconfiguredInventory.completebefore treating a short list as the whole inventory.
Compact (default)¶
Facts shared by many images are returned once:
capabilityProfiles: capability inventories keyed by name. An image’scapabilityProfilenames its entry.host.capabilities: host-scoped capabilities, such as the host’s default audio input and output. They apply to every image that has acapabilityProfile.- Fields whose value would be
nullare left out, as aredisplayandimagewhen every member isnull.
An image’s full capability list is its profile’s capabilities plus
host.capabilities.
Full¶
detail: "full" returns each image with its own capabilityInventory (host
capabilities included) and every field, null values included. Use it only if
you need that per-image shape; it is several times larger.
Large results¶
AutoMobile writes a result over 64 KiB to a tool-output file. The inline result
then has artifact (with resourceUri) and a resource_link content block. It
keeps count, platform, configuredInventory and host. capabilityProfiles
holds the profiles that the inline images name, so every inline
capabilityProfile resolves. It adds:
truncated:truewhenimagesholds fewer thancountentries.imagesReturned: the number of entries inline inimages.
When truncated is true, read artifact.resourceUri (or the resource_link)
for the full list. A result without truncated has every image inline, and
count equals the length of images.