Skip to main content

crate_plugin_kit/install/
mod.rs

1//! 安装:把 crates.io 上的一个插件 crate 变成磁盘上可 `dlopen` 的 cdylib + manifest。
2//!
3//! 两条路,由 [`crate::CratePluginKit::install`] 按 [`crate::KitConfig::prefer_prebuilt`] 选:
4//!
5//! ```text
6//! prefer_prebuilt = true
7//!   └─ prebuilt::try_install ──(没发 prebuilt / 下不到)──> build_host::install
8//! prefer_prebuilt = false
9//!   └─ build_host::install
10//! ```
11//!
12//! **build-host 是默认与兜底**:它走 `cargo build`,因此天然使用用户已经配好的
13//! registry / 镜像。prebuilt 从 GitHub 下载会绕开这些配置,所以只当加速项。
14
15pub mod build_host;
16pub mod prebuilt;
17
18use std::path::PathBuf;
19
20use crate::cache::InstallSource;
21
22/// 一次成功安装的产物。
23#[derive(Debug, Clone)]
24pub struct Installed {
25    /// 完整 crate 名,如 `bmux-plugin-cargo`。
26    pub crate_name: String,
27    /// 实际安装的版本。
28    pub version: String,
29    /// 安装目录。
30    pub dir: PathBuf,
31    /// 落地的 cdylib 路径。
32    pub library: PathBuf,
33    /// 怎么来的。
34    pub source: InstallSource,
35}
36
37/// 清理一个目录(不存在也算成功)。
38pub(crate) fn remove_dir_if_exists(dir: &std::path::Path) -> std::io::Result<()> {
39    match std::fs::remove_dir_all(dir) {
40        Ok(()) => Ok(()),
41        Err(e) if e.kind() == std::io::ErrorKind::NotFound => Ok(()),
42        Err(e) => Err(e),
43    }
44}