tauri/tooling/cli.rs/src/dev.rs

// Copyright 2019-2021 Tauri Programme within The Commons Conservancy
// SPDX-License-Identifier: Apache-2.0
// SPDX-License-Identifier: MIT

use crate::{
  helpers::{
    app_paths::{app_dir, tauri_dir},
    command_env,
    config::{get as get_config, reload as reload_config},
    manifest::{get_workspace_members, rewrite_manifest},
    Logger,
  },
  Result,
};
use clap::{AppSettings, Parser};

use anyhow::Context;
use notify::{watcher, DebouncedEvent, RecursiveMode, Watcher};
use once_cell::sync::OnceCell;
use shared_child::SharedChild;

use std::{
  env::set_current_dir,
  ffi::OsStr,
  process::{exit, Child, Command},
  sync::{
    mpsc::{channel, Receiver},
    Arc, Mutex,
  },
  time::Duration,
};

static BEFORE_DEV: OnceCell<Mutex<Child>> = OnceCell::new();

#[derive(Debug, Parser)]
#[clap(about = "Tauri dev")]
#[clap(setting(AppSettings::TrailingVarArg))]
pub struct Options {
  /// Binary to use to run the application
  #[clap(short, long)]
  runner: Option<String>,
  /// Target triple to build against
  #[clap(short, long)]
  target: Option<String>,
  /// List of cargo features to activate
  #[clap(short, long)]
  features: Option<Vec<String>>,
  /// Exit on panic
  #[clap(short, long)]
  exit_on_panic: bool,
  /// JSON string or path to JSON file to merge with tauri.conf.json
  #[clap(short, long)]
  config: Option<String>,
  /// Run the code in release mode
  #[clap(short, long)]
  release_mode: bool,
  /// Args passed to the binary
  args: Vec<String>,
}

pub fn command(options: Options) -> Result<()> {
  let logger = Logger::new("tauri:dev");

  let tauri_path = tauri_dir();
  set_current_dir(&tauri_path).with_context(|| "failed to change current working directory")?;
  let merge_config = if let Some(config) = &options.config {
    Some(if config.starts_with('{') {
      config.to_string()
    } else {
      std::fs::read_to_string(&config)?
    })
  } else {
    None
  };
  let config = get_config(merge_config.as_deref())?;

  let (settings, out_dir) = {
    let config_guard = config.lock().unwrap();
    let config_ = config_guard.as_ref().unwrap();
    let app_settings = crate::interface::rust::AppSettings::new(config_)?;
    let out_dir = app_settings
      .get_out_dir(options.target.clone(), true)
      .with_context(|| "failed to get project out directory")?;
    let settings = crate::interface::get_bundler_settings(
      app_settings,
      options.target.clone(),
      &Default::default(),
      config_,
      &out_dir,
      false,
      None,
    )
    .with_context(|| "failed to build bundler settings")?;
    (settings, out_dir)
  };
  settings.copy_resources(&out_dir)?;
  settings.copy_binaries(&out_dir)?;

  if let Some(before_dev) = &config
    .lock()
    .unwrap()
    .as_ref()
    .unwrap()
    .build
    .before_dev_command
  {
    if !before_dev.is_empty() {
      logger.log(format!("Running `{}`", before_dev));
      #[cfg(target_os = "windows")]
      let child = Command::new("cmd")
        .arg("/C")
        .arg(before_dev)
        .current_dir(app_dir())
        .envs(command_env(true)) // development build always includes debug information
        .spawn()
        .with_context(|| format!("failed to run `{}` with `cmd /C`", before_dev))?;
      #[cfg(not(target_os = "windows"))]
      let child = Command::new("sh")
        .arg("-c")
        .arg(before_dev)
        .current_dir(app_dir())
        .envs(command_env(true)) // development build always includes debug information
        .spawn()
        .with_context(|| format!("failed to run `{}` with `sh -c`", before_dev))?;
      BEFORE_DEV.set(Mutex::new(child)).unwrap();
    }
  }

  let runner_from_config = config
    .lock()
    .unwrap()
    .as_ref()
    .unwrap()
    .build
    .runner
    .clone();
  let runner = options
    .runner
    .clone()
    .or(runner_from_config)
    .unwrap_or_else(|| "cargo".to_string());

  {
    let (tx, rx) = channel();
    let mut watcher = watcher(tx, Duration::from_secs(1)).unwrap();
    watcher.watch(tauri_path.join("Cargo.toml"), RecursiveMode::Recursive)?;
    rewrite_manifest(config.clone())?;
    loop {
      if let Ok(DebouncedEvent::NoticeWrite(_)) = rx.recv() {
        break;
      }
    }
  }

  let mut cargo_features = config
    .lock()
    .unwrap()
    .as_ref()
    .unwrap()
    .build
    .features
    .clone()
    .unwrap_or_default();
  if let Some(features) = &options.features {
    cargo_features.extend(features.clone());
  }

  let (child_wait_tx, child_wait_rx) = channel();
  let child_wait_rx = Arc::new(Mutex::new(child_wait_rx));

  let mut process = start_app(&options, &runner, &cargo_features, child_wait_rx.clone());

  let (tx, rx) = channel();

  let mut watcher = watcher(tx, Duration::from_secs(1)).unwrap();
  watcher.watch(tauri_path.join("src"), RecursiveMode::Recursive)?;
  watcher.watch(tauri_path.join("Cargo.toml"), RecursiveMode::Recursive)?;
  watcher.watch(tauri_path.join("tauri.conf.json"), RecursiveMode::Recursive)?;

  for member in get_workspace_members()? {
    let workspace_path = tauri_path.join(member);
    watcher.watch(workspace_path.join("src"), RecursiveMode::Recursive)?;
    watcher.watch(workspace_path.join("Cargo.toml"), RecursiveMode::Recursive)?;
  }

  loop {
    if let Ok(event) = rx.recv() {
      let event_path = match event {
        DebouncedEvent::Create(path) => Some(path),
        DebouncedEvent::Remove(path) => Some(path),
        DebouncedEvent::Rename(_, dest) => Some(dest),
        DebouncedEvent::Write(path) => Some(path),
        _ => None,
      };

      if let Some(event_path) = event_path {
        if event_path.file_name() == Some(OsStr::new("tauri.conf.json")) {
          reload_config(merge_config.as_deref())?;
          rewrite_manifest(config.clone())?;
        } else {
          // When tauri.conf.json is changed, rewrite_manifest will be called
          // which will trigger the watcher again
          // So the app should only be started when a file other than tauri.conf.json is changed
          let _ = child_wait_tx.send(());
          process
            .kill()
            .with_context(|| "failed to kill app process")?;
          // wait for the process to exit
          loop {
            if let Ok(Some(_)) = process.try_wait() {
              break;
            }
          }
          process = start_app(&options, &runner, &cargo_features, child_wait_rx.clone());
        }
      }
    }
  }
}

fn kill_before_dev_process() {
  if let Some(child) = BEFORE_DEV.get() {
    let mut child = child.lock().unwrap();
    #[cfg(windows)]
      let _ = Command::new("powershell")
        .arg("-NoProfile")
        .arg("-Command")
        .arg(format!("function Kill-Tree {{ Param([int]$ppid); Get-CimInstance Win32_Process | Where-Object {{ $_.ParentProcessId -eq $ppid }} | ForEach-Object {{ Kill-Tree $_.ProcessId }}; Stop-Process -Id $ppid }}; Kill-Tree {}", child.id()))
        .status();
    #[cfg(not(windows))]
    let _ = Command::new("pkill")
      .args(&["-TERM", "-P"])
      .arg(child.id().to_string())
      .status();
    let _ = child.kill();
  }
}

fn start_app(
  options: &Options,
  runner: &str,
  features: &[String],
  child_wait_rx: Arc<Mutex<Receiver<()>>>,
) -> Arc<SharedChild> {
  let mut command = Command::new(runner);
  command.args(&["run", "--no-default-features"]);

  if options.release_mode {
    command.args(&["--release"]);
  }

  if let Some(target) = &options.target {
    command.args(&["--target", target]);
  }

  if !features.is_empty() {
    command.args(&["--features", &features.join(",")]);
  }

  if !options.args.is_empty() {
    command.arg("--").args(&options.args);
  }

  let child =
    SharedChild::spawn(&mut command).unwrap_or_else(|_| panic!("failed to run {}", runner));
  let child_arc = Arc::new(child);

  let child_clone = child_arc.clone();
  let exit_on_panic = options.exit_on_panic;
  std::thread::spawn(move || {
    let status = child_clone.wait().expect("failed to wait on child");
    if exit_on_panic {
      // we exit if the status is a success code (app closed) or code is 101 (compilation error)
      // if the process wasn't killed by the file watcher
      if (status.success() || status.code() == Some(101))
          // `child_wait_rx` indicates that the process was killed by the file watcher
          && child_wait_rx
          .lock()
          .expect("failed to get child_wait_rx lock")
          .try_recv()
          .is_err()
      {
        kill_before_dev_process();
        exit(0);
      }
    } else if status.success() {
      // if we're no exiting on panic, we only exit if the status is a success code (app closed)
      kill_before_dev_process();
      exit(0);
    }
  });

  child_arc
}