feat(rmp-cli): add devices start command (#154)

Author: justinmoon

crates/rmp-cli/src/cli.rs

@@ -86,6 +86,45 @@ pub struct InitArgs {
 pub enum DevicesCmd {
     /// List devices/simulators/emulators.
     List,
+
+    /// Start a simulator/emulator target and wait until ready.
+    Start(DevicesStartArgs),
+}
+
+#[derive(clap::Args, Debug)]
+pub struct DevicesStartArgs {
+    #[arg(value_enum)]
+    pub platform: DeviceStartPlatform,
+
+    #[command(flatten)]
+    pub ios: DevicesStartIosArgs,
+
+    #[command(flatten)]
+    pub android: DevicesStartAndroidArgs,
+}
+
+#[derive(ValueEnum, Debug, Clone, Copy)]
+pub enum DeviceStartPlatform {
+    Ios,
+    Android,
+}
+
+#[derive(clap::Args, Debug, Default)]
+pub struct DevicesStartIosArgs {
+    /// iOS simulator UDID to target.
+    #[arg(long)]
+    pub udid: Option<String>,
+}
+
+#[derive(clap::Args, Debug, Default)]
+pub struct DevicesStartAndroidArgs {
+    /// Android emulator serial to target.
+    #[arg(long)]
+    pub serial: Option<String>,
+
+    /// Android AVD name to start if no emulator is running.
+    #[arg(long)]
+    pub avd: Option<String>,
 }
 
 #[derive(clap::Args, Debug)]

crates/rmp-cli/src/devices.rs

@@ -3,8 +3,9 @@ use std::process::Command;
 
 use serde::Serialize;
 
-use crate::cli::{human_log, json_print, CliError, JsonOk};
+use crate::cli::{human_log, json_print, CliError, DeviceStartPlatform, DevicesStartArgs, JsonOk};
 use crate::config::load_rmp_toml;
+use crate::run::{ensure_android_emulator, ensure_ios_simulator};
 use crate::util::{discover_xcode_dev_dir, run_capture};
 
 #[derive(Serialize)]
@@ -23,6 +24,15 @@ struct DeviceItem {
     connection_state: Option<String>, // connected|... (devices)
 }
 
+#[derive(Serialize)]
+struct DeviceStartJson {
+    platform: String,
+    kind: String,
+    id: String,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    avd: Option<String>,
+}
+
 #[derive(Debug)]
 struct IosDev {
     udid: String,
@@ -320,3 +330,67 @@ pub fn devices_list(root: &Path, json: bool, verbose: bool) -> Result<(), CliErr
 
     Ok(())
 }
+
+pub fn devices_start(
+    root: &Path,
+    json: bool,
+    verbose: bool,
+    args: DevicesStartArgs,
+) -> Result<(), CliError> {
+    let cfg = load_rmp_toml(root)?;
+    match args.platform {
+        DeviceStartPlatform::Android => {
+            let android = cfg
+                .android
+                .ok_or_else(|| CliError::user("rmp.toml missing [android] section"))?;
+            let avd = args
+                .android
+                .avd
+                .or(android.avd_name)
+                .unwrap_or_else(|| "pika_api35".into());
+            let serial =
+                ensure_android_emulator(root, &avd, args.android.serial.as_deref(), verbose)?;
+
+            if json {
+                json_print(&JsonOk {
+                    ok: true,
+                    data: DeviceStartJson {
+                        platform: "android".into(),
+                        kind: if serial.starts_with("emulator-") {
+                            "emulator".into()
+                        } else {
+                            "device".into()
+                        },
+                        id: serial,
+                        avd: Some(avd),
+                    },
+                });
+            } else {
+                eprintln!("ok: android target ready");
+            }
+        }
+        DeviceStartPlatform::Ios => {
+            let _ios = cfg
+                .ios
+                .ok_or_else(|| CliError::user("rmp.toml missing [ios] section"))?;
+            let dev_dir = discover_xcode_dev_dir()?;
+            let udid = ensure_ios_simulator(&dev_dir, args.ios.udid.as_deref(), verbose)?;
+            let _ = Command::new("open").arg("-a").arg("Simulator").status();
+
+            if json {
+                json_print(&JsonOk {
+                    ok: true,
+                    data: DeviceStartJson {
+                        platform: "ios".into(),
+                        kind: "simulator".into(),
+                        id: udid,
+                        avd: None,
+                    },
+                });
+            } else {
+                eprintln!("ok: ios simulator ready");
+            }
+        }
+    }
+    Ok(())
+}

crates/rmp-cli/src/main.rs

@@ -28,6 +28,9 @@ fn main() -> ExitCode {
                 cli::Cmd::Devices {
                     cmd: cli::DevicesCmd::List,
                 } => devices::devices_list(&root, args.json, args.verbose),
+                cli::Cmd::Devices {
+                    cmd: cli::DevicesCmd::Start(s),
+                } => devices::devices_start(&root, args.json, args.verbose, s),
                 cli::Cmd::Bindings(b) => bindings::bindings(&root, args.json, args.verbose, b),
                 cli::Cmd::Run(r) => run::run(&root, args.json, args.verbose, r),
                 cli::Cmd::Init(_) => unreachable!(),

crates/rmp-cli/src/run.rs

@@ -174,7 +174,7 @@ fn run_ios(
     Ok(())
 }
 
-fn ensure_ios_simulator(
+pub(crate) fn ensure_ios_simulator(
     dev_dir: &Path,
     explicit_udid: Option<&str>,
     verbose: bool,
@@ -557,7 +557,7 @@ fn run_android(
     Ok(())
 }
 
-fn ensure_android_emulator(
+pub(crate) fn ensure_android_emulator(
     root: &Path,
     avd: &str,
     explicit_serial: Option<&str>,