Struct Device

pub struct Device { /* private fields */ }

Wrapper around a single device returned by simctl.

Implementations

impl Device

pub fn simctl(&self) -> &Simctl

Returns an instance to the Simctl wrapper that was used to retrieve this device.

pub fn info(&self) -> &DeviceInfo

Returns information about this device. This is also accessible through Device::deref.

impl Device

pub fn boot(&self) -> Result<()>

Boots this device. If the device is already booted, this function will return an error (as does the underlying CLI).

NOTE: this does not automatically open the visual simulator interface. Use crate::Simctl::open() to open the visual interface.

pub fn boot_with_env<I, K, V>(&self, envs: I) -> Result<()>

where I: IntoIterator<Item = (K, V)>, K: Display, V: AsRef<OsStr>,

Boots this device with the given environment variables. Do not prepend SIMCTL_CHILD_ to the variable names: this is done automatically. If the device is already booted, this function will return an error (as does the underlying CLI).

NOTE: this does not automatically open the visual simulator interface. Use crate::Simctl::open() to open the visual interface.

impl Device

pub fn get_app_container( &self, bundle_id: &str, container: &Container, ) -> Result<PathBuf>

Returns a path to the given container of an application with the given bundle id.

impl Device

pub fn getenv(&self, name: &str) -> Result<String>

Returns a local environment variable with the given name. Do not prepend SIMCTL_CHILD_ to the variable name. If no variable with the given name exists, this function will return an empty string (and no error).

impl Device

pub fn install(&self, path: &Path) -> Result<()>

Installs an .app folder from the given path onto this device. If the app (or an earlier version) already existed on this device, its app container (see Device::get_app_container) will be overwritten while the other containers remain unchanged (i.e. data persists between upgrades).

impl Device

pub fn io(&self) -> IO

Returns a wrapper around the simctl io subcommand.

impl Device

pub fn keychain(&self) -> Keychain

Returns an instance of the keychain subcommand.

impl Device

pub fn launch<'a>(&self, bundle_id: &'a str) -> Launch<'a>

Returns a builder that can be used to customize the launch of an app with the given bundle ID on this device.

impl Device

pub fn open_url(&self, path: &str) -> Result<()>

Opens the given URL on this device.

impl Device

pub fn privacy(&self) -> Privacy

Returns a wrapper around the simctl privacy subcommand.

impl Device

pub fn push(&self, bundle_id: &str, push: &Push) -> Result<()>

Sends the given push message to this device for an app with the given bundle ID.

impl Device

pub fn shutdown(&self) -> Result<()>

Shuts down this device. Returns an error if it isn’t booted.

impl Device

pub fn status_bar(&self) -> StatusBar

Returns a wrapper around the simctl status_bar subcommand.

impl Device

pub fn terminate(&self, bundle_id: &str) -> Result<()>

Terminates a running application with the given bundle ID on this device.

impl Device

pub fn ui(&self) -> UI

Returns a wrapper around the simctl ui subcommand.

impl Device

pub fn uninstall(&self, bundle_id: &str) -> Result<()>

Uninstalls an app with the given bundle ID from this device.

Trait Implementations

impl Clone for Device

fn clone(&self) -> Device

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Device

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

Formats the value using the given formatter.

impl Deref for Device

type Target = DeviceInfo

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.