DownloadOptions

下载操作的配置选项。

定义

pub struct DownloadOptions {
    /// 安装目标目录
    pub target_dir: PathBuf,
    
    /// 要下载的 MSVC 版本（None = 最新）
    pub msvc_version: Option<String>,
    
    /// 要下载的 SDK 版本（None = 最新）
    pub sdk_version: Option<String>,
    
    /// 目标架构
    pub arch: Architecture,
    
    /// 主机架构（None = 自动检测）
    pub host_arch: Option<Architecture>,
    
    /// 是否验证文件哈希
    pub verify_hashes: bool,
    
    /// 并行下载数量
    pub parallel_downloads: usize,
    
    /// 自定义 HTTP 客户端（None = 使用默认）
    pub http_client: Option<reqwest::Client>,
    
    /// 自定义进度处理器（None = 使用默认 indicatif）
    pub progress_handler: Option<BoxedProgressHandler>,
    
    /// 自定义缓存管理器（None = 使用默认文件系统缓存）
    pub cache_manager: Option<BoxedCacheManager>,
    
    /// 预览模式：不实际下载
    pub dry_run: bool,
}

默认值

impl Default for DownloadOptions {
    fn default() -> Self {
        Self {
            target_dir: default_install_dir(),
            msvc_version: None,      // 最新版本
            sdk_version: None,       // 最新版本
            arch: Architecture::X64,
            host_arch: None,         // 自动检测
            verify_hashes: true,
            parallel_downloads: 4,
        }
    }
}

使用示例

默认选项

use msvc_kit::{download_msvc, DownloadOptions};

let options = DownloadOptions::default();
let info = download_msvc(&options).await?;

自定义目录

use msvc_kit::{download_msvc, DownloadOptions};
use std::path::PathBuf;

let options = DownloadOptions {
    target_dir: PathBuf::from("C:/my-msvc"),
    ..Default::default()
};

指定版本

use msvc_kit::{download_msvc, download_sdk, DownloadOptions};

let options = DownloadOptions {
    msvc_version: Some("14.44".to_string()),
    sdk_version: Some("10.0.26100.0".to_string()),
    ..Default::default()
};

let msvc = download_msvc(&options).await?;
let sdk = download_sdk(&options).await?;

交叉编译

use msvc_kit::{download_msvc, DownloadOptions, Architecture};

// 在 x64 主机上构建 ARM64 二进制文件
let options = DownloadOptions {
    arch: Architecture::Arm64,
    host_arch: Some(Architecture::X64),
    ..Default::default()
};

性能调优

use msvc_kit::{download_msvc, DownloadOptions};

let options = DownloadOptions {
    parallel_downloads: 8,  // 更多并行下载
    verify_hashes: false,   // 跳过验证（不推荐）
    ..Default::default()
};

字段详情

target_dir

安装目录。默认为：

• Windows: %LOCALAPPDATA%\loonghao\msvc-kit

msvc_version

MSVC 版本字符串。示例：

• "14.44" - 主版本.次版本
• "14.44.34823" - 完整版本
• None - 使用最新可用版本

sdk_version

Windows SDK 版本。示例：

• "10.0.26100.0" - 完整版本
• None - 使用最新可用版本

arch

编译二进制文件的目标架构：

• Architecture::X64 - 64 位 x86
• Architecture::X86 - 32 位 x86
• Architecture::Arm64 - ARM 64 位
• Architecture::Arm - ARM 32 位

host_arch

主机架构。设置为 None 自动检测。

verify_hashes

设为 true 时，下载的文件会根据清单中的 SHA256 哈希进行验证。

parallel_downloads

并发下载数量。较高的值可能加快下载速度，但会使用更多带宽。

http_client

自定义 reqwest::Client，用于 HTTP 请求。可用于配置代理或自定义 TLS 设置。

progress_handler

自定义进度处理器，需实现 ProgressHandler trait。使用 NoopProgressHandler 可以抑制输出。

cache_manager

自定义缓存管理器，需实现 CacheManager trait。允许多个实例共享缓存。

use msvc_kit::{DownloadOptions, FileSystemCacheManager};
use std::path::PathBuf;
use std::sync::Arc;

let cache = Arc::new(FileSystemCacheManager::new(
    PathBuf::from("/shared/cache")
));

let options = DownloadOptions::builder()
    .target_dir("C:/msvc")
    .cache_manager(cache)
    .build();

dry_run

设为 true 时，显示将要下载的内容但不实际下载。

Builder 模式

推荐使用 Builder 模式创建 DownloadOptions：

use msvc_kit::{DownloadOptions, Architecture};

let options = DownloadOptions::builder()
    .msvc_version("14.44")
    .sdk_version("10.0.26100.0")
    .target_dir("C:/msvc-kit")
    .arch(Architecture::X64)
    .host_arch(Architecture::X64)
    .verify_hashes(true)
    .parallel_downloads(8)
    .dry_run(false)
    .build();

download_all

并行下载 MSVC 和 SDK：

use msvc_kit::{download_all, DownloadOptions};

let options = DownloadOptions::default();
let (msvc_info, sdk_info) = download_all(&options).await?;