Struct AppleSimulator 

pub struct AppleSimulator {
    pub data_path: PathBuf,
    pub data_path_size: Option<u64>,
    pub log_path: PathBuf,
    pub log_path_size: Option<u64>,
    pub udid: String,
    pub is_available: bool,
    pub device_type_identifier: String,
    pub state: String,
    pub name: String,
    pub last_booted_at: Option<String>,
    pub runtime_identifier: Option<String>,
    pub runtime_version: Option<Version>,
}

Represents an Apple Simulator device

Fields are deserialized from xcrun simctl list devices --json output

Fields

data_path: PathBuf

Path to the simulator data directory

data_path_size: Option<u64>

Size of the simulator data directory in bytes

log_path: PathBuf

Path to the simulator log directory

log_path_size: Option<u64>

Size of the simulator log directory in bytes

udid: String

Unique device identifier

Note: not uuid but udid!

is_available: bool

Indicates if the simulator is available

device_type_identifier: String

Device type identifier

state: String

Current state of the simulator (e.g., Shutdown, Booted)

name: String

Name of the simulator device

last_booted_at: Option<String>

Timestamp of the last boot time

runtime_identifier: Option<String>

Runtime identifier key from simctl (e.g. com.apple.CoreSimulator.SimRuntime.iOS-26-2).

This is not part of the simulator device object itself; it comes from the map key in xcrun simctl list --json.

runtime_version: Option<Version>

Version of the runtime this simulator runs (e.g. iOS 26.5 -> 26.5.0).

Like Self::runtime_identifier, this is attached by scan() from the runtimes list of xcrun simctl list --json, not deserialized from the device object. None when simctl reports no usable version for the runtime — such a simulator can never satisfy a deployment target.

Implementations

impl AppleSimulator

pub async fn scan_ios(host: &Host) -> Result<Vec<Self>>

Scan iOS simulators only.

Errors

Returns an error if simctl cannot be queried for available simulators.

pub fn supports_deployment_target(&self, deployment_target: &Version) -> bool

Whether this simulator’s runtime can run an app that requires deployment_target.

A simulator simctl reported no runtime version for is treated as incapable: selection must never pick a runtime it cannot prove satisfies the app’s deployment target.

pub async fn select_ios( host: &Host, project: &Project, device: Option<&str>, ) -> Result<Self>

Select the iOS simulator to run project’s app on.

Reads the app’s IPHONEOS_DEPLOYMENT_TARGET from the project and considers only simulators whose runtime satisfies it, so an app is never built for minutes only to be rejected by simctl install.

device is the --device query: a UDID, or a device name. A matched simulator whose runtime is below the target is rejected; a name matching several qualifying simulators is an error listing the candidates. With None, the first booted qualifying simulator wins, else the first qualifying one.

Errors

Returns an error when the deployment target cannot be read from the project, when simctl cannot be queried, when a device query matches nothing or only simulators below the target or several qualifying ones, or when no simulator satisfies the target.

Trait Implementations

impl Clone for AppleSimulator

fn clone(&self) -> AppleSimulator

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AppleSimulator

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AppleSimulator

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Device for AppleSimulator

async fn launch(&self, host: &Host) -> Result<()>

Launch the Apple simulator (boot it)

async fn run( &self, host: &Host, artifact: Artifact, options: RunOptions, ) -> Result<Running, FailToRun>

Run an artifact on the Apple simulator

Please launch the device before calling this method

fn name(&self) -> &str

Human-readable name for display purposes.

async fn scan(host: &Host) -> Result<Vec<Self>>

Scan for available devices of this type on host.