Struct Downloader

pub struct Downloader<R> {
    pub source: DownloadSource,
    pub game_independent: bool,
    pub verify_data: bool,
    pub java_path: String,
    pub reporter: Option<R>,
    /* private fields */
}

下载结构，用于存储下载所需的信息，并通过附带的扩展特质下载需要的东西

Fields

source: DownloadSource

使用的下载源

game_independent: bool

是否使用版本独立方式安装

这个会影响 Optifine 以模组形式的安装路径

（会被安装在 版本/mods 文件夹里还是 .minecraft/mods 文件夹里）

verify_data: bool

是否验证已存在的文件是否正确

java_path: String

任意的 Java 运行时执行文件目录

在安装 Forge 时会使用

reporter: Option<R>

下载的进度报告对象

Implementations

impl<R> Downloader<R>

pub fn set_minecraft_path(&mut self, dot_minecraft_path: impl AsRef<Path>)

设置安装的目录，传入一个 .minecraft 文件夹路径作为参数

游戏将会被安装到此处

pub fn with_minecraft_path(self, dot_minecraft_path: impl AsRef<Path>) -> Self

Builder 模式的 Downloader::set_minecraft_path

impl<R: Reporter> Downloader<R>

pub fn with_reporter(self, reporter: R) -> Self

设置一个进度报告对象，下载进度将会被上报给这个对象

pub fn with_source(self, source: DownloadSource) -> Self

设置一个下载源

pub fn with_java(self, java_path: String) -> Self

设置一个 Java 运行时，安装 Forge 和 Optifine 时需要用到

pub fn with_game_independent(self, game_independent: bool) -> Self

设置是否使用版本独立方式安装

这个会影响 Optifine 以模组形式的安装路径

（会被安装在 版本/mods 文件夹里还是 .minecraft/mods 文件夹里）

pub fn with_parallel_amount(self, limit: usize) -> Self

设置下载时的并发量，如果为 0 则不限制

pub fn with_verify_data(self) -> Self

是否强制校验已下载的文件以确认是否需要重新下载

如不强制则仅检测文件是否存在

Trait Implementations

impl<R: Reporter> AuthlibDownloadExt for Downloader<R>

fn download_authlib_injector<'life0, 'life1, 'async_trait>( &'life0 self, dest_path: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

下载最新版本的 Authlib Injector 并存放到指定路径，如果路径的文件夹不存在则会先创建它，如果文件已存在则会被覆盖

fn install_authlib_injector<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

安装最新版本的 Authlib Injector

impl<R: Reporter> Clone for Downloader<R>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<R: Debug> Debug for Downloader<R>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<R: Reporter> Default for Downloader<R>

fn default() -> Self

Returns the “default value” for a type.

impl<R: Reporter> FabricDownloadExt for Downloader<R>

fn get_avaliable_loaders<'life0, 'life1, 'async_trait>( &'life0 self, vanilla_version: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Vec<LoaderMetaItem>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

根据原版版本号获取该版本下可用的 Fabric 模组加载器

fn download_library<'life0, 'life1, 'async_trait>( &'life0 self, name: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

下载 Fabric 模组加载器所需的库文件

fn download_fabric_pre<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, version_name: &'life1 str, version_id: &'life2 str, loader_version: &'life3 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

下载 Fabric 模组加载器，安装时需要配合 download_fabric_post 来合并版本元数据

fn download_fabric_post<'life0, 'life1, 'async_trait>( &'life0 self, version_name: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

将 Fabric 模组加载器的版本元数据与原版版本元数据合并以完成最后安装步骤

impl<R: Reporter> ForgeDownloadExt for Downloader<R>

fn get_avaliable_installers<'life0, 'life1, 'async_trait>( &'life0 self, vanilla_version: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<ForgeVersionsData>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

根据纯净版本号获取当前可用的所有 Forge 版本

fn install_forge_pre<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, version_id: &'life1 str, vanilla_version: &'life2 str, forge_version: &'life3 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

运行安装 Forge 模组加载器的预安装步骤

fn install_forge_post<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, version_name: &'life1 str, version_id: &'life2 str, forge_version: &'life3 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

运行安装 Forge 模组加载器的后安装步骤

fn modify_forge_installer<'life0, 'life1, 'async_trait>( &'life0 self, from_reader: File, to_writer: File, name: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

将安装器的部分信息进行修改，如版本名称，下载源等

impl<R: Reporter> GameDownload<'_> for Downloader<R>

fn download_game<'life0, 'life1, 'life2, 'life3, 'life4, 'life5, 'async_trait>( &'life0 self, version_name: &'life1 str, vanilla: VersionInfo, fabric: &'life2 str, quiltmc: &'life3 str, forge: &'life4 str, optifine: &'life5 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, 'life4: 'async_trait, 'life5: 'async_trait,

根据参数安装一个游戏，允许安装模组加载器

impl<R: Reporter> OptifineDownloadExt for Downloader<R>

fn get_avaliable_installers<'life0, 'life1, 'async_trait>( &'life0 self, vanilla_version: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Vec<OptifineVersionMeta>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

根据纯净版本号获取当前可用的所有 Optifine 版本

fn download_optifine<'life0, 'life1, 'life2, 'life3, 'life4, 'async_trait>( &'life0 self, vanilla_version: &'life1 str, optifine_type: &'life2 str, optifine_patch: &'life3 str, dest_path: &'life4 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, 'life4: 'async_trait,

下载 Optifine 版本

fn install_optifine<'life0, 'life1, 'life2, 'life3, 'life4, 'async_trait>( &'life0 self, version_name: &'life1 str, vanilla_version: &'life2 str, optifine_type: &'life3 str, optifine_patch: &'life4 str, as_mod: bool, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, 'life4: 'async_trait,

安装 Optifine 版本

impl<R: Reporter> QuiltMCDownloadExt for Downloader<R>

fn get_avaliable_loaders<'life0, 'life1, 'async_trait>( &'life0 self, vanilla_version: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Vec<LoaderMetaItem>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

根据原版版本号获取该版本下可用的 QuiltMC 模组加载器

fn download_library<'life0, 'life1, 'async_trait>( &'life0 self, name: &'life1 str, url: String, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

下载 QuiltMC 模组加载器所需的库文件

fn download_quiltmc_pre<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, version_name: &'life1 str, version_id: &'life2 str, loader_version: &'life3 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

下载 QuiltMC 模组加载器，安装时需要配合 download_quiltmc_post 来合并版本元数据

fn download_quiltmc_post<'life0, 'life1, 'async_trait>( &'life0 self, version_name: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

将 QuiltMC 模组加载器的版本元数据与原版版本元数据合并以完成最后安装步骤

impl<R: Reporter> VanillaDownloadExt for Downloader<R>

fn get_avaliable_vanilla_versions<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<VersionManifest>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

获取现在所有可下载版本

fn download_vanilla_jar<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, path: &'life1 str, save_path: &'life2 str, _sha1: &'life3 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

下载原版客户端 JAR 文件

fn download_library<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, sha1: &'life1 str, path: &'life2 str, save_path: &'life3 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

下载一个依赖库，并存放到指定位置

fn download_asset_index<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, name: &'life1 str, url: &'life2 str, save_path: &'life3 str, ) -> Pin<Box<dyn Future<Output = Result<AssetIndexes>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

下载游戏资源索引

fn download_asset<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, sha1: &'life1 str, name: &'life2 str, save_path: &'life3 str, is_pre: bool, r: Option<impl 'async_trait + Reporter>, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

下载一个游戏素材，并存放到指定位置

fn download_libraries<'life0, 'life1, 'async_trait>( &'life0 self, libraries: &'life1 [Library], ) -> Pin<Box<dyn Future<Output = Result<Vec<String>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

下载一组依赖库，安装位置由特质实现而定

fn download_vanilla<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, version_name: &'life1 str, version_meta: &'life2 VersionMeta, is_repair: bool, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

下载一个游戏版本

fn install_vanilla<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, version_name: &'life1 str, version_info: &'life2 VersionInfo, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

安装一个游戏版本