crates/tauri-cli/src/mobile/android/mod.rs - dev - githubmirror/tauri

crates/tauri-cli/src/mobile/android/mod.rs
1 204 строки37 KB
Falihery
fix(cli): Honor a specified NDK version if set (#15344)
15 июн 2026, 09:51
15 июн 2026, 09:51be0cb0d
// Copyright 2019-2024 Tauri Programme within The Commons Conservancy
// SPDX-License-Identifier: Apache-2.0
// SPDX-License-Identifier: MIT

use cargo_mobile2::{
  android::{
    adb,
    config::{Config as AndroidConfig, Metadata as AndroidMetadata, Raw as RawAndroidConfig},
    device::{ConnectionStatus, Device},
    emulator,
    env::Env,
    target::Target,
  },
  config::app::{App, DEFAULT_ASSET_DIR},
  opts::{FilterLevel, NoiseLevel},
  os,
  target::TargetTrait,
  util::prompt,
};
use clap::{Parser, Subcommand};
use semver::Version;
use std::{
  env::set_var,
  fs::{create_dir, create_dir_all, read_dir, write},
  io::Cursor,
  path::{Path, PathBuf},
  process::{exit, Command},
  sync::OnceLock,
  thread::sleep,
  time::Duration,
};
use sublime_fuzzy::best_match;
use tauri_utils::resources::ResourcePaths;

use super::{
  ensure_init, get_app, init::command as init_command, log_finished, read_options, CliOptions,
  OptionsHandle, Target as MobileTarget, MIN_DEVICE_MATCH_SCORE,
};
use crate::{
  error::Context,
  helpers::config::{BundleResources, Config as TauriConfig},
  ConfigValue, Error, ErrorExt, Result,
};

mod android_studio_script;
mod build;
mod dev;
pub(crate) mod project;
mod run;

const NDK_VERSION: &str = "29.0.13846066";
const SDK_VERSION: u8 = 36;

#[cfg(target_os = "macos")]
const CMDLINE_TOOLS_URL: &str =
  "https://dl.google.com/android/repository/commandlinetools-mac-13114758_latest.zip";
#[cfg(target_os = "linux")]
const CMDLINE_TOOLS_URL: &str =
  "https://dl.google.com/android/repository/commandlinetools-linux-13114758_latest.zip";
#[cfg(windows)]
const CMDLINE_TOOLS_URL: &str =
  "https://dl.google.com/android/repository/commandlinetools-win-13114758_latest.zip";

#[derive(Parser)]
#[clap(
  author,
  version,
  about = "Android commands",
  subcommand_required(true),
  arg_required_else_help(true)
)]
pub struct Cli {
  #[clap(subcommand)]
  command: Commands,
}

#[derive(Debug, Parser)]
#[clap(about = "Initialize Android target in the project")]
pub struct InitOptions {
  /// Skip prompting for values
  #[clap(long, env = "CI")]
  ci: bool,
  /// Skips installing rust toolchains via rustup
  #[clap(long)]
  skip_targets_install: bool,
  /// JSON strings or paths to JSON, JSON5 or TOML files to merge with the default configuration file
  ///
  /// Configurations are merged in the order they are provided, which means a particular value overwrites previous values when a config key-value pair conflicts.
  ///
  /// Note that a platform-specific file is looked up and merged with the default file by default
  /// (tauri.macos.conf.json, tauri.linux.conf.json, tauri.windows.conf.json, tauri.android.conf.json and tauri.ios.conf.json)
  /// but you can use this for more specific use cases such as different build flavors.
  #[clap(short, long)]
  pub config: Vec<ConfigValue>,
}

#[derive(Subcommand)]
enum Commands {
  Init(InitOptions),
  Dev(dev::Options),
  Build(build::Options),
  Run(run::Options),
  #[clap(hide(true))]
  AndroidStudioScript(android_studio_script::Options),
}

pub fn command(cli: Cli, verbosity: u8) -> Result<()> {
  let noise_level = NoiseLevel::from_occurrences(verbosity as u64);
  match cli.command {
    Commands::Init(options) => init_command(
      MobileTarget::Android,
      options.ci,
      false,
      options.skip_targets_install,
      options.config,
    )?,
    Commands::Dev(options) => dev::command(options, noise_level)?,
    Commands::Build(options) => build::command(options, noise_level).map(|_| ())?,
    Commands::Run(options) => run::command(options, noise_level)?,
    Commands::AndroidStudioScript(options) => android_studio_script::command(options)?,
  }

  Ok(())
}

pub fn get_config(
  app: &App,
  config: &TauriConfig,
  features: &[String],
  cli_options: &CliOptions,
) -> (AndroidConfig, AndroidMetadata) {
  let mut android_options = cli_options.clone();
  android_options.features.extend_from_slice(features);

  let raw = RawAndroidConfig {
    features: Some(android_options.features.clone()),
    logcat_filter_specs: vec![
      "RustStdoutStderr".into(),
      format!(
        "*:{}",
        match cli_options.noise_level {
          NoiseLevel::Polite => FilterLevel::Info,
          NoiseLevel::LoudAndProud => FilterLevel::Debug,
          NoiseLevel::FranklyQuitePedantic => FilterLevel::Verbose,
        }
        .logcat()
      ),
    ],
    min_sdk_version: Some(config.bundle.android.min_sdk_version),
    ..Default::default()
  };
  let config = AndroidConfig::from_raw(app.clone(), Some(raw)).unwrap();

  let metadata = AndroidMetadata {
    supported: true,
    cargo_args: Some(android_options.args),
    features: Some(android_options.features),
    ..Default::default()
  };

  set_var(
    "WRY_ANDROID_PACKAGE",
    app.android_identifier_escape_kotlin_keyword(),
  );
  set_var("TAURI_ANDROID_PACKAGE_UNESCAPED", app.identifier());
  set_var("WRY_ANDROID_LIBRARY", app.lib_name());
  set_var("TAURI_ANDROID_PROJECT_PATH", config.project_dir());

  let src_main_dir = config
    .project_dir()
    .join("app/src/main")
    .join(format!("java/{}", app.identifier().replace('.', "/"),));
  if config.project_dir().exists() {
    if src_main_dir.exists() {
      let _ = create_dir(src_main_dir.join("generated"));
    } else {
      log::error!(
      "Project directory {} does not exist. Did you update the package name in `Cargo.toml` or the bundle identifier in `tauri.conf.json > identifier`? Save your changes, delete the `gen/android` folder and run `tauri android init` to recreate the Android project.",
      src_main_dir.display()
    );
      exit(1);
    }
  }
  set_var(
    "WRY_ANDROID_KOTLIN_FILES_OUT_DIR",
    src_main_dir.join("generated"),
  );

  (config, metadata)
}

fn sync_debug_application_id_suffix(
  config: &AndroidConfig,
  tauri_config: &TauriConfig,
) -> Result<()> {
  let build_gradle_path = config.project_dir().join("app").join("build.gradle.kts");
  let build_gradle = std::fs::read_to_string(&build_gradle_path).fs_context(
    "failed to read Android Gradle build file",
    build_gradle_path.clone(),
  )?;
  let Some(updated_build_gradle) = set_debug_application_id_suffix(
    &build_gradle,
    tauri_config
      .bundle
      .android
      .debug_application_id_suffix
      .as_deref(),
  ) else {
    crate::error::bail!(
      "Could not find the Android debug build type in {}. Add a `getByName(\"debug\")` build type or run `tauri android init` to regenerate the Android project.",
      build_gradle_path.display()
    );
  };

  if updated_build_gradle != build_gradle {
    write(&build_gradle_path, updated_build_gradle).fs_context(
      "failed to write Android Gradle build file",
      build_gradle_path,
    )?;
  }

  Ok(())
}

fn set_debug_application_id_suffix(build_gradle: &str, suffix: Option<&str>) -> Option<String> {
  static DEBUG_BUILD_TYPE_RE: OnceLock<regex::Regex> = OnceLock::new();

  let debug_build_type_re = DEBUG_BUILD_TYPE_RE.get_or_init(|| {
    regex::Regex::new(r#"(?m)(?:\bgetByName\(\s*"debug"\s*\)|\bdebug\b)\s*\{"#)
      .expect("valid debug build type regex")
  });

  for build_type_match in debug_build_type_re.find_iter(build_gradle) {
    let Some(opening_brace) = build_gradle[build_type_match.start()..]
      .find('{')
      .map(|index| build_type_match.start() + index)
    else {
      continue;
    };
    let Some(closing_brace) = find_matching_brace(build_gradle, opening_brace) else {
      continue;
    };

    let debug_block = &build_gradle[opening_brace..closing_brace];
    let updated_debug_block = set_application_id_suffix_in_block(debug_block, suffix);
    let mut updated_build_gradle =
      String::with_capacity(build_gradle.len() + updated_debug_block.len());
    updated_build_gradle.push_str(&build_gradle[..opening_brace]);
    updated_build_gradle.push_str(&updated_debug_block);
    updated_build_gradle.push_str(&build_gradle[closing_brace..]);
    return Some(updated_build_gradle);
  }

  None
}

fn set_application_id_suffix_in_block(debug_block: &str, suffix: Option<&str>) -> String {
  static APPLICATION_ID_SUFFIX_RE: OnceLock<regex::Regex> = OnceLock::new();

  let application_id_suffix_re = APPLICATION_ID_SUFFIX_RE.get_or_init(|| {
    regex::Regex::new(r#"(?m)^[ \t]*applicationIdSuffix\s*=.*(?:\r?\n)?"#)
      .expect("valid applicationIdSuffix regex")
  });

  if let Some(application_id_suffix_match) = application_id_suffix_re.find(debug_block) {
    let mut updated_debug_block = String::with_capacity(debug_block.len());
    updated_debug_block.push_str(&debug_block[..application_id_suffix_match.start()]);
    if let Some(suffix) = suffix {
      let indentation = debug_block
        [application_id_suffix_match.start()..application_id_suffix_match.end()]
        .chars()
        .take_while(|character| *character == ' ' || *character == '\t')
        .collect::<String>();
      updated_debug_block.push_str(&format!(
        "{indentation}applicationIdSuffix = \"{}\"\n",
        escape_kotlin_string(suffix)
      ));
    }
    updated_debug_block.push_str(&debug_block[application_id_suffix_match.end()..]);
    return updated_debug_block;
  }

  let Some(suffix) = suffix else {
    return debug_block.to_string();
  };

  let indentation = debug_block_indentation(debug_block);
  let application_id_suffix = format!(
    "{indentation}applicationIdSuffix = \"{}\"\n",
    escape_kotlin_string(suffix)
  );

  if let Some(first_newline) = debug_block.find('\n') {
    let mut updated_debug_block =
      String::with_capacity(debug_block.len() + application_id_suffix.len());
    updated_debug_block.push_str(&debug_block[..=first_newline]);
    updated_debug_block.push_str(&application_id_suffix);
    updated_debug_block.push_str(&debug_block[first_newline + 1..]);
    updated_debug_block
  } else {
    format!("{{\n{application_id_suffix}")
  }
}

fn debug_block_indentation(debug_block: &str) -> &str {
  debug_block
    .lines()
    .skip(1)
    .find_map(|line| {
      if line.trim().is_empty() {
        None
      } else {
        Some(line.trim_end().trim_end_matches(line.trim_start()))
      }
    })
    .unwrap_or("            ")
}

fn find_matching_brace(content: &str, opening_brace: usize) -> Option<usize> {
  let mut depth = 0u32;
  let mut in_line_comment = false;
  let mut in_block_comment = false;
  let mut in_string = false;
  let mut in_raw_string = false;
  let mut string_quote = '\0';
  let mut escaped = false;
  let mut previous = '\0';
  let mut chars = content[opening_brace..].char_indices().peekable();

  while let Some((relative_index, character)) = chars.next() {
    let index = opening_brace + relative_index;

    if in_line_comment {
      if character == '\n' {
        in_line_comment = false;
      }
      previous = character;
      continue;
    }

    if in_block_comment {
      if previous == '*' && character == '/' {
        in_block_comment = false;
      }
      previous = character;
      continue;
    }

    if in_raw_string {
      if content[index..].starts_with("\"\"\"") {
        // Consume the remaining two quotes in the Kotlin raw string delimiter.
        let _ = chars.next();
        let _ = chars.next();
        in_raw_string = false;
      }
      previous = character;
      continue;
    }

    if in_string {
      if escaped {
        escaped = false;
      } else if character == '\\' {
        escaped = true;
      } else if character == string_quote {
        in_string = false;
      }
      previous = character;
      continue;
    }

    if character == '/' && chars.peek().is_some_and(|(_, next)| *next == '/') {
      in_line_comment = true;
      previous = character;
      continue;
    }

    if character == '/' && chars.peek().is_some_and(|(_, next)| *next == '*') {
      in_block_comment = true;
      previous = character;
      continue;
    }

    if content[index..].starts_with("\"\"\"") {
      // Consume the remaining two quotes in the Kotlin raw string delimiter.
      let _ = chars.next();
      let _ = chars.next();
      in_raw_string = true;
      previous = character;
      continue;
    }

    if character == '"' || character == '\'' {
      in_string = true;
      string_quote = character;
      previous = character;
      continue;
    }

    if character == '{' {
      depth = depth.saturating_add(1);
    } else if character == '}' {
      depth = depth.saturating_sub(1);
      if depth == 0 {
        return Some(index);
      }
    }

    previous = character;
  }

  None
}

fn escape_kotlin_string(value: &str) -> String {
  let mut output = String::with_capacity(value.len());

  for character in value.chars() {
    match character {
      '"' => output.push_str("\\\""),
      '\\' => output.push_str("\\\\"),
      '$' => output.push_str("\\$"),
      '\n' => output.push_str("\\n"),
      '\r' => output.push_str("\\r"),
      '\t' => output.push_str("\\t"),
      other => output.push(other),
    }
  }

  output
}

pub fn env(non_interactive: bool) -> Result<Env> {
  let env = super::env().context("failed to setup Android environment")?;
  ensure_env(non_interactive).context("failed to ensure Android environment")?;
  cargo_mobile2::android::env::Env::from_env(env).context("failed to load Android environment")
}

fn download_cmdline_tools(extract_path: &Path) -> Result<()> {
  log::info!("Downloading Android command line tools...");

  let mut response = crate::helpers::http::get(CMDLINE_TOOLS_URL)
    .context("failed to download Android command line tools")?;
  let body = response
    .body_mut()
    .with_config()
    .limit(200 * 1024 * 1024 /* 200MB */)
    .read_to_vec()
    .context("failed to read Android command line tools download response")?;

  let mut zip = zip::ZipArchive::new(Cursor::new(body))
    .context("failed to create zip archive from Android command line tools download response")?;

  log::info!(
    "Extracting Android command line tools to {}",
    extract_path.display()
  );
  zip
    .extract(extract_path)
    .context("failed to extract Android command line tools")?;

  Ok(())
}

fn ensure_env(non_interactive: bool) -> Result<()> {
  ensure_java()?;
  ensure_sdk(non_interactive)?;
  ensure_ndk(non_interactive)?;
  Ok(())
}

fn ensure_java() -> Result<()> {
  if std::env::var_os("JAVA_HOME").is_none() {
    #[cfg(windows)]
    let default_java_home = "C:\\Program Files\\Android\\Android Studio\\jbr";
    #[cfg(target_os = "macos")]
    let default_java_home = "/Applications/Android Studio.app/Contents/jbr/Contents/Home";
    #[cfg(target_os = "linux")]
    let default_java_home = "/opt/android-studio/jbr";

    if Path::new(default_java_home).exists() {
      log::info!("Using Android Studio's default Java installation: {default_java_home}");
      std::env::set_var("JAVA_HOME", default_java_home);
    } else if which::which("java").is_err() {
      crate::error::bail!("Java not found in PATH, default Android Studio Java installation not found at {default_java_home} and JAVA_HOME environment variable not set. Please install Java before proceeding");
    }
  }

  Ok(())
}

fn ensure_sdk(non_interactive: bool) -> Result<()> {
  let android_home = std::env::var_os("ANDROID_HOME")
    .or_else(|| std::env::var_os("ANDROID_SDK_ROOT"))
    .map(PathBuf::from);
  if !android_home.as_ref().is_some_and(|v| v.exists()) {
    log::info!(
      "ANDROID_HOME {}, trying to locate Android SDK...",
      if let Some(v) = &android_home {
        format!("not found at {}", v.display())
      } else {
        "not set".into()
      }
    );

    #[cfg(target_os = "macos")]
    let default_android_home = dirs::home_dir().unwrap().join("Library/Android/sdk");
    #[cfg(target_os = "linux")]
    let default_android_home = dirs::home_dir().unwrap().join("Android/Sdk");
    #[cfg(windows)]
    let default_android_home = dirs::data_local_dir().unwrap().join("Android/Sdk");

    if default_android_home.exists() {
      log::info!(
        "Using installed Android SDK: {}",
        default_android_home.display()
      );
    } else if non_interactive {
      crate::error::bail!("Android SDK not found. Make sure the SDK and NDK are installed and the ANDROID_HOME and NDK_HOME environment variables are set.");
    } else {
      log::error!(
        "Android SDK not found at {}",
        default_android_home.display()
      );

      let extract_path = if create_dir_all(&default_android_home).is_ok() {
        default_android_home.clone()
      } else {
        std::env::current_dir().context("failed to get current directory")?
      };

      let sdk_manager_path = extract_path
        .join("cmdline-tools/bin/sdkmanager")
        .with_extension(if cfg!(windows) { "bat" } else { "" });

      let mut granted_permission_to_install = false;

      if !sdk_manager_path.exists() {
        granted_permission_to_install = crate::helpers::prompts::confirm(
          "Do you want to install the Android Studio command line tools to setup the Android SDK?",
          Some(false),
        )
        .unwrap_or_default();

        if !granted_permission_to_install {
          crate::error::bail!("Skipping Android Studio command line tools installation. Please go through the manual setup process described in the documentation: https://tauri.app/start/prerequisites/#android");
        }

        download_cmdline_tools(&extract_path)?;
      }

      if !granted_permission_to_install {
        granted_permission_to_install = crate::helpers::prompts::confirm(
          "Do you want to install the Android SDK using the command line tools?",
          Some(false),
        )
        .unwrap_or_default();

        if !granted_permission_to_install {
          crate::error::bail!("Skipping Android Studio SDK installation. Please go through the manual setup process described in the documentation: https://tauri.app/start/prerequisites/#android");
        }
      }

      log::info!("Running sdkmanager to install platform-tools, android-{SDK_VERSION} and ndk-{NDK_VERSION} on {}...", default_android_home.display());
      let status = Command::new(&sdk_manager_path)
        .arg(format!("--sdk_root={}", default_android_home.display()))
        .arg("--install")
        .arg("platform-tools")
        .arg(format!("platforms;android-{SDK_VERSION}"))
        .arg(format!("ndk;{NDK_VERSION}"))
        .status()
        .map_err(|error| Error::CommandFailed {
          command: format!("{} --sdk_root={} --install platform-tools platforms;android-{SDK_VERSION} ndk;{NDK_VERSION}", sdk_manager_path.display(), default_android_home.display()),
          error,
        })?;

      if !status.success() {
        crate::error::bail!("Failed to install Android SDK");
      }
    }

    std::env::set_var("ANDROID_HOME", default_android_home);
  }

  Ok(())
}

fn ensure_ndk(non_interactive: bool) -> Result<()> {
  // re-evaluate ANDROID_HOME
  let android_home = std::env::var_os("ANDROID_HOME")
    .or_else(|| std::env::var_os("ANDROID_SDK_ROOT"))
    .map(PathBuf::from)
    .context("Failed to locate Android SDK")?;

  // check NDK_HOME
  let mut installed_ndks = if let Some(ndk_home) = std::env::var_os("NDK_HOME") {
    let ndk_path = PathBuf::from(ndk_home);
    if ndk_path.is_dir() {
      vec![ndk_path]
    } else {
      crate::error::bail!(
        "Android NDK invalid. Make sure the NDK_HOME environment variable has correct value."
      );
    }
  } else {
    read_dir(android_home.join("ndk"))
      .map(|dir| {
        dir
          .into_iter()
          .flat_map(|e| e.ok().map(|e| e.path()))
          .collect::<Vec<_>>()
      })
      .unwrap_or_default()
  };
  installed_ndks.sort();

  if let Some(ndk) = installed_ndks.last() {
    log::info!("Using installed NDK: {}", ndk.display());
    std::env::set_var("NDK_HOME", ndk);
  } else if non_interactive {
    crate::error::bail!("Android NDK not found. Make sure the NDK is installed and the NDK_HOME environment variable is set.");
  } else {
    let sdk_manager_path = android_home
      .join("cmdline-tools/bin/sdkmanager")
      .with_extension(if cfg!(windows) { "bat" } else { "" });

    let mut granted_permission_to_install = false;

    if !sdk_manager_path.exists() {
      granted_permission_to_install = crate::helpers::prompts::confirm(
        "Do you want to install the Android Studio command line tools to setup the Android NDK?",
        Some(false),
      )
      .unwrap_or_default();

      if !granted_permission_to_install {
        crate::error::bail!("Skipping Android Studio command line tools installation. Please go through the manual setup process described in the documentation: https://tauri.app/start/prerequisites/#android");
      }

      download_cmdline_tools(&android_home)?;
    }

    if !granted_permission_to_install {
      granted_permission_to_install = crate::helpers::prompts::confirm(
        "Do you want to install the Android NDK using the command line tools?",
        Some(false),
      )
      .unwrap_or_default();

      if !granted_permission_to_install {
        crate::error::bail!("Skipping Android Studio NDK installation. Please go through the manual setup process described in the documentation: https://tauri.app/start/prerequisites/#android");
      }
    }

    log::info!(
      "Running sdkmanager to install ndk-{NDK_VERSION} on {}...",
      android_home.display()
    );
    let status = Command::new(&sdk_manager_path)
      .arg(format!("--sdk_root={}", android_home.display()))
      .arg("--install")
      .arg(format!("ndk;{NDK_VERSION}"))
      .status()
      .map_err(|error| Error::CommandFailed {
        command: format!(
          "{} --sdk_root={} --install ndk;{NDK_VERSION}",
          sdk_manager_path.display(),
          android_home.display()
        ),
        error,
      })?;

    if !status.success() {
      crate::error::bail!("Failed to install Android NDK");
    }

    let ndk_path = android_home.join("ndk").join(NDK_VERSION);
    log::info!("Installed NDK: {}", ndk_path.display());
    std::env::set_var("NDK_HOME", ndk_path);
  }

  Ok(())
}

fn delete_codegen_vars() {
  for (k, _) in std::env::vars() {
    if k.starts_with("WRY_") && (k.ends_with("CLASS_EXTENSION") || k.ends_with("CLASS_INIT")) {
      std::env::remove_var(k);
    }
  }
}

fn adb_device_prompt<'a>(env: &'_ Env, target: Option<&str>) -> Result<Device<'a>> {
  let device_list = adb::device_list(env)
    .context("failed to detect connected Android devices")?
    .into_iter()
    .filter(|d| d.status() == ConnectionStatus::Connected)
    .collect::<Vec<_>>();
  if !device_list.is_empty() {
    let device = if let Some(t) = target {
      let (device, score) = device_list
        .into_iter()
        .rev()
        .map(|d| {
          let score = best_match(t, d.name()).map_or(0, |m| m.score());
          (d, score)
        })
        .max_by_key(|(_, score)| *score)
        // we already checked the list is not empty
        .unwrap();
      if score > MIN_DEVICE_MATCH_SCORE {
        device
      } else {
        crate::error::bail!("Could not find an Android device matching {t}")
      }
    } else if device_list.len() > 1 {
      let index = prompt::list(
        concat!("Detected ", "Android", " devices"),
        device_list.iter(),
        "device",
        None,
        "Device",
      )
      .context("failed to prompt for device")?;
      device_list.into_iter().nth(index).unwrap()
    } else {
      device_list.into_iter().next().unwrap()
    };

    log::info!(
      "Detected connected device: {} with target {:?}",
      device,
      device.target().triple,
    );
    Ok(device)
  } else {
    Err(Error::GenericError(
      "No connected Android devices detected".to_string(),
    ))
  }
}

fn emulator_prompt(env: &'_ Env, target: Option<&str>) -> Result<emulator::Emulator> {
  let emulator_list = emulator::avd_list(env).unwrap_or_default();
  if !emulator_list.is_empty() {
    let emulator = if let Some(t) = target {
      let (device, score) = emulator_list
        .into_iter()
        .rev()
        .map(|d| {
          let score = best_match(t, d.name()).map_or(0, |m| m.score());
          (d, score)
        })
        .max_by_key(|(_, score)| *score)
        // we already checked the list is not empty
        .unwrap();
      if score > MIN_DEVICE_MATCH_SCORE {
        device
      } else {
        crate::error::bail!("Could not find an Android Emulator matching {t}")
      }
    } else if emulator_list.len() > 1 {
      let index = prompt::list(
        concat!("Detected ", "Android", " emulators"),
        emulator_list.iter(),
        "emulator",
        None,
        "Emulator",
      )
      .context("failed to prompt for emulator")?;
      emulator_list.into_iter().nth(index).unwrap()
    } else {
      emulator_list.into_iter().next().unwrap()
    };

    Ok(emulator)
  } else {
    Err(Error::GenericError(
      "No available Android Emulator detected".to_string(),
    ))
  }
}

enum EmulatorStatus {
  Offline { serial_no: String },
  Connected,
}

fn device_prompt<'a>(env: &'_ Env, target: Option<&str>) -> Result<Device<'a>> {
  if let Ok(device) = adb_device_prompt(env, target) {
    Ok(device)
  } else {
    let emulator = emulator_prompt(env, target)?;
    let emulator_status = match adb::device_list(env) {
      Ok(devices) => {
        // emulator might be running but disconnected from adb
        devices
          .iter()
          .find(|d| d.name() == emulator.name())
          .and_then(|d| match d.status() {
            ConnectionStatus::Offline | ConnectionStatus::Unauthorized => {
              Some(EmulatorStatus::Offline {
                serial_no: d.serial_no().to_string(),
              })
            }
            ConnectionStatus::Connected => Some(EmulatorStatus::Connected),
            _ => None,
          })
      }
      // failed to get device information, check if the device name matches the emulator name
      Err(
        adb::device_list::Error::ModelFailed {
          serial_no,
          error: adb::get_prop::Error::CommandFailed { command: _, error },
        }
        | adb::device_list::Error::AbiFailed {
          serial_no,
          error: adb::get_prop::Error::CommandFailed { command: _, error },
        },
      ) => {
        if error.kind() == std::io::ErrorKind::TimedOut {
          // if the device name matches the emulator name, the emulator is already running and marked as connected
          // but we cannot connect to it
          adb::device_name(env, &serial_no).map_or(None, |device_name| {
            if device_name == emulator.name() {
              Some(EmulatorStatus::Offline { serial_no })
            } else {
              None
            }
          })
        } else {
          None
        }
      }
      Err(_) => None,
    };

    let emulator_already_running = emulator_status.is_some();
    match emulator_status {
      Some(EmulatorStatus::Offline { serial_no }) => {
        // emulator is available but not connected to adb, we must restart it
        log::info!("Emulator is not connected, we need to restart it");
        restart_emulator(env, &serial_no, &emulator)?;
      }
      Some(EmulatorStatus::Connected) => {
        // emulator is already connected to adb
        // this is technically unreachable because we queried the device list with adb_device_prompt
      }
      None => {
        log::info!("Starting emulator {}", emulator.name());
        emulator
          .start_detached(env)
          .context("failed to start emulator")?;
      }
    }

    let mut tries = 0;
    loop {
      sleep(Duration::from_secs(2));
      // we do not filter for connected devices to detect emulators that are not connected to our adb anymore
      match adb::device_list(env) {
        Ok(devices) => {
          if let Some(device) = devices.into_iter().find(|d| d.name() == emulator.name()) {
            if device.status() == ConnectionStatus::Connected {
              return Ok(device);
            }
          }

          if tries >= 3 {
            log::info!("Waiting for emulator to start... (maybe the emulator is unauthorized or offline, run `adb devices` to check)");
          } else {
            log::info!("Waiting for emulator to start...");
          }
          tries += 1;
        }
        Err(
          adb::device_list::Error::ModelFailed {
            serial_no,
            error: adb::get_prop::Error::CommandFailed { command: _, error },
          }
          | adb::device_list::Error::AbiFailed {
            serial_no,
            error: adb::get_prop::Error::CommandFailed { command: _, error },
          },
        ) => {
          if emulator_already_running && error.kind() == std::io::ErrorKind::TimedOut {
            log::info!("Emulator is not responding, we need to restart it");
            restart_emulator(env, &serial_no, &emulator)?;
            tries = 0;
          } else {
            log::error!("failed to get properties for device {serial_no}: {error}");
          }
        }
        Err(e) => {
          log::error!("failed to list devices with adb: {e}");
          tries += 1;
        }
      }
    }
  }
}

fn restart_emulator(env: &Env, serial_no: &str, emulator: &emulator::Emulator) -> Result<()> {
  let granted_permission_to_restart =
    crate::helpers::prompts::confirm("Do you want to restart the emulator?", Some(true))
      .unwrap_or_default();
  if !granted_permission_to_restart {
    crate::error::bail!(
      "Cannot connect to the emulator, please restart it manually (a full boot might be required)"
    );
  }

  adb::adb(env, &["-s", serial_no, "emu", "kill"])
    .run()
    .context("failed to reboot emulator")?;

  log::info!("Waiting for emulator to exit...");
  loop {
    let devices = adb::device_list(env).unwrap_or_default();
    if devices
      .into_iter()
      .find(|d| d.serial_no() == serial_no)
      .is_none()
    {
      break;
    }
    sleep(Duration::from_secs(1));
  }

  log::info!("Restarting emulator with full boot");
  let mut tries = 0;
  loop {
    // wait a bit to make sure we can restart the emulator
    sleep(Duration::from_secs(2));

    match emulator.start_detached_with_options(env, emulator::StartOptions::new().full_boot()) {
      Ok(_) => break,
      Err(e) => {
        tries += 1;
        if tries >= 3 {
          return Err(e).context("failed to start emulator");
        } else {
          log::error!("failed to start emulator, retrying...");
        }
      }
    }
  }

  Ok(())
}

fn detect_target_ok<'a>(env: &Env) -> Option<&'a Target<'a>> {
  device_prompt(env, None).map(|device| device.target()).ok()
}

fn open_and_wait(config: &AndroidConfig, env: &Env) -> ! {
  log::info!("Opening Android Studio");
  if let Err(e) = os::open_file_with("Android Studio", config.project_dir(), &env.base) {
    log::error!("{e}");
  }
  loop {
    sleep(Duration::from_secs(24 * 60 * 60));
  }
}

fn inject_resources(config: &AndroidConfig, tauri_config: &TauriConfig) -> Result<()> {
  let asset_dir = config
    .project_dir()
    .join("app/src/main")
    .join(DEFAULT_ASSET_DIR);
  create_dir_all(&asset_dir).fs_context("failed to create asset directory", asset_dir.clone())?;

  write(
    asset_dir.join("tauri.conf.json"),
    serde_json::to_string(&tauri_config).with_context(|| "failed to serialize tauri config")?,
  )
  .fs_context(
    "failed to write tauri config",
    asset_dir.join("tauri.conf.json"),
  )?;

  let resources = match &tauri_config.bundle.resources {
    Some(BundleResources::List(paths)) => Some(ResourcePaths::new(paths.as_slice(), true)),
    Some(BundleResources::Map(map)) => Some(ResourcePaths::from_map(map, true)),
    None => None,
  };
  if let Some(resources) = resources {
    for resource in resources.iter() {
      let resource = resource.context("failed to get resource")?;
      let dest = asset_dir.join(resource.target());
      crate::helpers::fs::copy_file(resource.path(), dest).context("failed to copy resource")?;
    }
  }

  Ok(())
}

fn configure_cargo(env: &mut Env, config: &AndroidConfig) -> Result<()> {
  for target in Target::all().values() {
    let config = target
      .generate_cargo_config(config, env)
      .context("failed to find Android tool")?;
    let target_var_name = target.triple.replace('-', "_").to_uppercase();
    if let Some(linker) = config.linker {
      env.base.insert_env_var(
        format!("CARGO_TARGET_{target_var_name}_LINKER"),
        linker.into(),
      );
    }
    env.base.insert_env_var(
      format!("CARGO_TARGET_{target_var_name}_RUSTFLAGS"),
      config.rustflags.join(" ").into(),
    );
  }

  Ok(())
}

fn generate_tauri_properties(
  config: &AndroidConfig,
  tauri_config: &TauriConfig,
  dev: bool,
) -> Result<()> {
  let app_tauri_properties_path = config.project_dir().join("app").join("tauri.properties");

  let mut app_tauri_properties = Vec::new();
  if let Some(version) = tauri_config.version.as_ref() {
    app_tauri_properties.push(format!("tauri.android.versionName={version}"));
    if tauri_config.bundle.android.auto_increment_version_code && !dev {
      let last_version_code = std::fs::read_to_string(&app_tauri_properties_path)
        .ok()
        .and_then(|content| {
          content
            .lines()
            .find(|line| line.starts_with("tauri.android.versionCode="))
            .and_then(|line| line.split('=').nth(1))
            .and_then(|s| s.trim().parse::<u32>().ok())
        });
      let new_version_code = last_version_code.map(|v| v.saturating_add(1)).unwrap_or(1);
      app_tauri_properties.push(format!("tauri.android.versionCode={new_version_code}"));
    } else if let Some(version_code) = tauri_config.bundle.android.version_code.as_ref() {
      app_tauri_properties.push(format!("tauri.android.versionCode={version_code}"));
    } else if let Ok(version) = Version::parse(version) {
      let mut version_code = version.major * 1000000 + version.minor * 1000 + version.patch;

      if dev {
        version_code = version_code.clamp(1, 2100000000);
      }

      if version_code == 0 {
        crate::error::bail!(
          "You must change the `version` in `tauri.conf.json`. The default value `0.0.0` is not allowed for Android package and must be at least `0.0.1`."
        );
      } else if version_code > 2100000000 {
        crate::error::bail!(
          "Invalid version code {}. Version code must be between 1 and 2100000000. You must change the `version` in `tauri.conf.json`.",
          version_code
        );
      }

      app_tauri_properties.push(format!("tauri.android.versionCode={version_code}"));
    }
  }

  if !app_tauri_properties.is_empty() {
    let app_tauri_properties_content = format!(
      "// THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.\n{}",
      app_tauri_properties.join("\n")
    );
    if std::fs::read_to_string(&app_tauri_properties_path)
      .map(|o| o != app_tauri_properties_content)
      .unwrap_or(true)
    {
      write(&app_tauri_properties_path, app_tauri_properties_content)
        .context("failed to write tauri.properties")?;
    }
  }

  Ok(())
}

#[cfg(test)]
mod tests {
  use super::{find_matching_brace, set_debug_application_id_suffix};

  #[test]
  fn writes_debug_application_id_suffix() {
    let build_gradle = r#"
android {
    buildTypes {
        getByName("debug") {
            manifestPlaceholders["usesCleartextTraffic"] = "true"
        }
    }
}
"#;

    let updated = set_debug_application_id_suffix(build_gradle, Some(".debug")).unwrap();

    assert!(updated.contains(
      r#"        getByName("debug") {
            applicationIdSuffix = ".debug"
            manifestPlaceholders["usesCleartextTraffic"] = "true""#
    ));
  }

  #[test]
  fn replaces_debug_application_id_suffix() {
    let build_gradle = r#"
android {
    buildTypes {
        getByName("debug") {
            applicationIdSuffix = ".old"
            manifestPlaceholders["usesCleartextTraffic"] = "true"
        }
    }
}
"#;

    let updated = set_debug_application_id_suffix(build_gradle, Some(".internal")).unwrap();

    assert!(updated.contains(r#"            applicationIdSuffix = ".internal""#));
    assert!(!updated.contains(r#".old"#));
  }

  #[test]
  fn removes_debug_application_id_suffix() {
    let build_gradle = r#"
android {
    buildTypes {
        getByName("debug") {
            applicationIdSuffix = ".debug"
        }
        getByName("release") {
            applicationIdSuffix = ".release"
        }
    }
}
"#;

    let updated = set_debug_application_id_suffix(build_gradle, None).unwrap();

    assert!(!updated.contains(r#"applicationIdSuffix = ".debug""#));
    assert!(updated.contains(r#"applicationIdSuffix = ".release""#));
  }

  #[test]
  fn writes_debug_suffix_before_nested_blocks() {
    let build_gradle = r#"
android {
    buildTypes {
        debug {
            packaging {
                jniLibs.keepDebugSymbols.add("*/arm64-v8a/*.so")
            }
        }
    }
}
"#;

    let updated = set_debug_application_id_suffix(build_gradle, Some(".internal")).unwrap();

    assert!(updated.contains(
      r#"        debug {
            applicationIdSuffix = ".internal"
            packaging {"#
    ));
  }

  #[test]
  fn ignores_braces_inside_kotlin_raw_strings() {
    let build_gradle = r#"
android {
    buildTypes {
        debug {
            val proguardRules = """
                -if class ** {
                  public *;
                }
            """
            manifestPlaceholders["usesCleartextTraffic"] = "true"
        }
    }
}
"#;

    let opening_brace = build_gradle
      .find("debug {")
      .and_then(|index| build_gradle[index..].find('{').map(|brace| index + brace))
      .unwrap();
    let closing_brace = find_matching_brace(build_gradle, opening_brace).unwrap();

    assert!(build_gradle[opening_brace..closing_brace]
      .contains(r#"manifestPlaceholders["usesCleartextTraffic"] = "true""#));

    let updated = set_debug_application_id_suffix(build_gradle, Some(".debug")).unwrap();

    assert!(updated.contains(
      r#"        debug {
            applicationIdSuffix = ".debug"
            val proguardRules = """"#
    ));
  }
}