Struct SessionAppLifecycleRequest 

pub struct SessionAppLifecycleRequest {
    pub session_id: String,
    pub args: Vec<String>,
    pub env: BTreeMap<String, String>,
    pub wait_for_foreground_ms: Option<u64>,
}

v1.0.8 §D1 — request body shared by POST /session/terminate-app and POST /session/launch-app. v1.0.11 §D2 — extended with launch- argument / launch-environment injection so consumers can bypass scaffolding like Expo dev-launcher server pickers that vanish on clearAppData (SDK 57 stops auto-navigating on URL scheme).

Fields

session_id: String

Session whose cached XCUIApplication binding will be acted on.

args: Vec<String>

v1.0.11 §D2 — launchArguments passed to XCUIApplication.launch(). Empty vec = pre-v1.0.11 behavior (whatever the runner already had cached on entry.app.launchArguments, which is empty by default). Ignored by /session/terminate-app.

env: BTreeMap<String, String>

v1.0.11 §D2 — launchEnvironment passed to XCUIApplication.launch(). Empty map = pre-v1.0.11 behavior. Ignored by /session/terminate-app.

wait_for_foreground_ms: Option<u64>

v1.0.11 §D3 — after .launch() dispatches, poll XCUIApplication.state at 250 ms cadence until .runningForeground (or timeout). Prevents callers from firing a subsequent terminateApp before the process has signalled launchd ready — the root cause of bug_type: 309 exec_terminated_before_ready .ips writes insight reported on v1.0.10. None = pre-v1.0.11 fire- and-return semantics; Some(0) = wait one iteration then return terminal state (useful for tests). Default: Some(15000) at the SDK layer.

Trait Implementations

impl Clone for SessionAppLifecycleRequest

fn clone(&self) -> SessionAppLifecycleRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SessionAppLifecycleRequest

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

Formats the value using the given formatter.

impl Default for SessionAppLifecycleRequest

fn default() -> SessionAppLifecycleRequest

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SessionAppLifecycleRequest

fn deserialize<__D>( __deserializer: __D, ) -> Result<SessionAppLifecycleRequest, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SessionAppLifecycleRequest

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.