feat(core): LiteLoader 安装路线（官方版本表 + 从零合成 launchwrapper 清单）
按 M218 SURVEY-p1 §4.1 的清单接上 LiteLoader 的安装路线，不动 OptiFine。
- core: 新增 addon::loader::liteloader（官方 versions.json 解析 + 合成清单）与
addon::loader::parent（父版本链读盘定位原版版本）；LoaderKind 加 LiteLoader；
LoaderRelease 加 parent_version_id、LoaderPlanInput::vanilla_installed → parent_installed；
LoaderInstallPlan::build 改返回 Result（父版本缺失具名报错）；LoaderSource::resolve_on
支持指定父版本（仅 LiteLoader，其它组合具名 unsupported）。
- 继承边界（本 mission 第一步核实）：arguments.game 父在前子在后追加，minecraftArguments
子覆盖父，启动顺序 legacy(24) → arguments.game(25)。所以 tweakClass 只写 arguments.game，
绝不写 minecraftArguments（会顶掉 Forge 1.12.2 的 FMLTweaker）。
- maven/fabric 的 `_ =>` 通配改成穷尽分支：非 maven 族不再静默回落 Forge 的仓库；
maven::{metadata_url,installer_url} 改返回 Option<String>。
- presenter: supported() 收 LiteLoader、wizard_choices 六选、dto::instances 按关注点拆成
instances/{loader,runtime,create,tests}.rs（原文件 395 行，动手前先拆）。
- cli: --loader 区分「认不出」(loader_unknown) 与「认得但装不了」(loader_unsupported)；
<version> 位写加载器版本 id 时按父版本处理（只有 liteloader 接受）；help 只改 install 段。
- app-iced: 下载页加载器 chip 加 LiteLoader（1.5.2~1.12.2，两头按官方没有构建拒），
chip 清单改为委派 Loader::ALL。
- 测试: 真实响应的裁剪夹具（dl.liteloader.com 与 repo.mumfrey.com 的 maven-metadata）
驱动「解析→计划→落盘→继承→启动参数顺序」全链；Forge 父链有回归（FMLTweaker 必须还在
且排在 LiteLoader 之前）；父版本缺失/组合不支持/取消/坏表各自具名错误。
This commit is contained in:
AskaEth committed
1 parent
307d29239a
commit
944b1610c8
37 files changed
+2426
-517
No files matched your search
@@ -22,7 +22,10 @@
|
||||
//! 规则来源（不猜：都是 core 安装管线自己的判据）：
|
||||
//! - Fabric/Quilt 的 loader 列表从 `1.14` 起才有（core 走 fabric meta，1.13 及以前没有）；
|
||||
//! - NeoForge 的第一个版本是 `1.20.1`（`maven::NEOFORGE_FORGE_LAYOUT_MC`）；
|
||||
//! - Forge 从 `1.1` 起有正式构建；远古版（`rd-*` / `a*` / `b*`）与预览版在 maven 表里没有条目。
|
||||
//! - Forge 从 `1.1` 起有正式构建；远古版（`rd-*` / `a*` / `b*`）与预览版在 maven 表里没有条目；
|
||||
//! - LiteLoader 的官方版本表**实测只有 16 个原版版本**（`1.5.2` ~ `1.12.2`，2026-11 取
|
||||
//! `dl.liteloader.com/versions/versions.json`），1.13 起它就不再发版，所以这两头都按
|
||||
//! 「官方没有构建」拒掉（不去查列表）。
|
||||
|
||||
use unlucky_i18n::{Catalog, Key};
|
||||
use unlucky_presenter::dto::{LoaderKind, VersionKind};
|
||||
@@ -41,7 +44,7 @@ pub enum LoaderVersionsView {
|
||||
Failed(String),
|
||||
}
|
||||
|
||||
/// 页面侧的加载器词表：只列 GUI 真能装的五家（与 `dto::LoaderKind::wizard_choices` 同集）。
|
||||
/// 页面侧的加载器词表：只列 GUI 真能装的六家（与 `dto::LoaderKind::wizard_choices` 同集）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
|
||||
pub enum Loader {
|
||||
/// 原版（不装加载器）
|
||||
@@ -55,16 +58,19 @@ pub enum Loader {
|
||||
Fabric,
|
||||
/// Quilt
|
||||
Quilt,
|
||||
/// LiteLoader
|
||||
LiteLoader,
|
||||
}
|
||||
|
||||
impl Loader {
|
||||
/// 展示顺序（任务书的口径：原版 / Forge / NeoForge / Fabric / Quilt）。
|
||||
pub const ALL: [Loader; 5] = [
|
||||
/// 展示顺序（任务书的口径：原版 / Forge / NeoForge / Fabric / Quilt，LiteLoader 追加在末尾）。
|
||||
pub const ALL: [Loader; 6] = [
|
||||
Loader::Vanilla,
|
||||
Loader::Forge,
|
||||
Loader::NeoForge,
|
||||
Loader::Fabric,
|
||||
Loader::Quilt,
|
||||
Loader::LiteLoader,
|
||||
];
|
||||
|
||||
/// 对应的 presenter 词表（派 `AppCommand` 时用）。
|
||||
@@ -75,10 +81,11 @@ impl Loader {
|
||||
Loader::NeoForge => LoaderKind::NeoForge,
|
||||
Loader::Fabric => LoaderKind::Fabric,
|
||||
Loader::Quilt => LoaderKind::Quilt,
|
||||
Loader::LiteLoader => LoaderKind::LiteLoader,
|
||||
}
|
||||
}
|
||||
|
||||
/// 从 presenter 词表回来（`OptiFine` / `LiteLoader` 不是本页选项）。
|
||||
/// 从 presenter 词表回来（`OptiFine` 不是本页选项：它没有安装管线）。
|
||||
pub const fn of(kind: LoaderKind) -> Option<Self> {
|
||||
match kind {
|
||||
LoaderKind::Vanilla => Some(Loader::Vanilla),
|
||||
@@ -86,7 +93,8 @@ impl Loader {
|
||||
LoaderKind::NeoForge => Some(Loader::NeoForge),
|
||||
LoaderKind::Fabric => Some(Loader::Fabric),
|
||||
LoaderKind::Quilt => Some(Loader::Quilt),
|
||||
LoaderKind::OptiFine | LoaderKind::LiteLoader => None,
|
||||
LoaderKind::LiteLoader => Some(Loader::LiteLoader),
|
||||
LoaderKind::OptiFine => None,
|
||||
}
|
||||
}
|
||||
|
||||
@@ -102,6 +110,7 @@ impl Loader {
|
||||
Loader::NeoForge => "NeoForge",
|
||||
Loader::Fabric => "Fabric",
|
||||
Loader::Quilt => "Quilt",
|
||||
Loader::LiteLoader => "LiteLoader",
|
||||
}
|
||||
}
|
||||
|
||||
@@ -137,6 +146,12 @@ impl Loader {
|
||||
Some(_) => Err(Incompat::NeedsAtLeast("1.20.1")),
|
||||
None => Err(Incompat::Unsupported),
|
||||
},
|
||||
// LiteLoader 官方版本表只到 1.12.2（最老 1.5.2），两头都是「官方没有构建」。
|
||||
// 预览版/快照同样没有（那 16 个原版版本全是正式版）。
|
||||
Loader::LiteLoader => match rank {
|
||||
Some(version) if version >= (1, 5, 2) && version <= (1, 12, 2) => Ok(()),
|
||||
_ => Err(Incompat::Unsupported),
|
||||
},
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -108,13 +108,33 @@ fn loader_support_matrix_is_explicit() {
|
||||
Loader::Forge.supports("24w14a", VersionKind::Snapshot),
|
||||
Err(Incompat::Unsupported)
|
||||
);
|
||||
// 远古版：四家全都不支持
|
||||
// LiteLoader 的官方版本表只有 1.5.2 ~ 1.12.2（16 个原版版本），两头都按「没有构建」拒。
|
||||
for id in ["1.5.2", "1.7.10", "1.12.2"] {
|
||||
assert_eq!(
|
||||
Loader::LiteLoader.supports(id, VersionKind::Release),
|
||||
Ok(()),
|
||||
"{id} 官方的确有 LiteLoader"
|
||||
);
|
||||
}
|
||||
for id in ["1.4.7", "1.13", "1.20.1"] {
|
||||
assert_eq!(
|
||||
Loader::LiteLoader.supports(id, VersionKind::Release),
|
||||
Err(Incompat::Unsupported),
|
||||
"{id} 上游没有 LiteLoader 构建"
|
||||
);
|
||||
}
|
||||
assert_eq!(
|
||||
Loader::LiteLoader.supports("24w14a", VersionKind::Snapshot),
|
||||
Err(Incompat::Unsupported)
|
||||
);
|
||||
// 远古版：五家全都不支持
|
||||
let ancient = ("a1.2.6", VersionKind::Ancient(AncientKind::OldAlpha));
|
||||
for loader in [
|
||||
Loader::Fabric,
|
||||
Loader::Quilt,
|
||||
Loader::Forge,
|
||||
Loader::NeoForge,
|
||||
Loader::LiteLoader,
|
||||
] {
|
||||
assert_eq!(
|
||||
loader.supports(ancient.0, ancient.1),
|
||||
|
||||
@@ -47,14 +47,13 @@ use super::super::frame;
|
||||
use super::super::Message;
|
||||
use super::model::{Loader, LoaderVersionsView, OptionsView};
|
||||
|
||||
/// 五家加载器（一行放得下：实测五枚 chip 合计约 311 dp，正文列 424）。
|
||||
const LOADERS: [Loader; 5] = [
|
||||
Loader::Vanilla,
|
||||
Loader::Forge,
|
||||
Loader::NeoForge,
|
||||
Loader::Fabric,
|
||||
Loader::Quilt,
|
||||
];
|
||||
/// 加载器 chip 的顺序与集合**委派**给 [`Loader::ALL`]（原版 / Forge / NeoForge / Fabric /
|
||||
/// Quilt / LiteLoader）。
|
||||
///
|
||||
/// 这里原先是手写的五枚常量——那是同一份清单的第三处副本（`dto::wizard_choices`、
|
||||
/// `Loader::ALL`、这里），M222 加 LiteLoader 时三处都要改，索性改成委派。
|
||||
/// ⚠️ **宽度需 D30 视觉复验**：五枚 chip 实测合计约 311 dp（正文列 424），第六枚（LiteLoader）
|
||||
/// 估算约 +50 dp，理论仍在一行内，但这是估算不是实测——本轮无构建槽位，未出浅/深色截图。
|
||||
|
||||
/// 菜单项高度 = 48（`MenuGeometry` 的项高）×2 行 + 上下留白 8×2 = 112。
|
||||
/// 这么算是为了避免「列表被截掉半行」——滚动区高度必须覆盖整行。
|
||||
@@ -146,7 +145,7 @@ fn loader_row<'a>(ui: &'a Ui, catalog: Catalog, options: &'a OptionsView) -> Ele
|
||||
let mut line = row![]
|
||||
.spacing(ui.space(Space::X1))
|
||||
.align_y(Alignment::Center);
|
||||
for loader in LOADERS.iter() {
|
||||
for loader in Loader::ALL.iter() {
|
||||
line = line.push(chip(
|
||||
ui,
|
||||
Chip::filter(
|
||||
|
||||
@@ -22,8 +22,8 @@ pub const fn general() -> &'static str {
|
||||
[--dry-run] 把已铺好的版本登记成实例（只读外部、不搬文件；缺省运行目录
|
||||
落 ULL 数据区的独立目录；--dry-run 只检查不写盘）
|
||||
install <version> [--loader X] [--loader-version V] [--name N] [--dry-run]
|
||||
下载并安装版本本体（--loader fabric|quilt|neoforge|forge
|
||||
时再叠一层加载器）→ 登记实例；--dry-run 只出计划
|
||||
下载并安装版本本体（--loader fabric|quilt|neoforge|forge|
|
||||
liteloader 时再叠一层加载器）→ 登记实例；--dry-run 只出计划
|
||||
launch <instance> [--dry-run] [--account <name>] [--java <path>] [--username <name>]
|
||||
[--max-memory <MB>] 启动实例；--dry-run 只打印组装后的命令行
|
||||
pack import <file> [--target <dir>] [--name N] [--overwrite] [--no-register]
|
||||
@@ -184,10 +184,18 @@ pub fn topic(name: &str) -> Option<&'static str> {
|
||||
（profiles.json + config/instances/<id>.json）。已存在且校验通过的文件会跳过，
|
||||
重复装同一版本不重复下载、不重复建实例。
|
||||
--dry-run：只输出计划（文件清单 + 总大小 + 每类资源的源选择），不下载、不登记。
|
||||
--loader：vanilla（缺省）/ fabric / quilt / neoforge / forge。装加载器时先生成
|
||||
versions/<原版>-<加载器>-<版本>/<…>.json（inheritsFrom 原版 + 主类 + loader 库），
|
||||
--loader：vanilla（缺省）/ fabric / quilt / neoforge / forge / liteloader。装加载器时先生成
|
||||
versions/<原版>-<加载器>-<版本>/<…>.json（inheritsFrom 父版本 + 主类 + loader 库），
|
||||
原版没装会先装原版，实例的 versionId 指向 loader 版本。
|
||||
--loader-version：加载器版本；缺省取官方默认（Fabric 系首个稳定版，maven 系最新）。
|
||||
optifine 认得出但**没接入安装管线**（要跑外部 Patcher 并原地改 zip），报 loader_unsupported；
|
||||
其余认不出的拼法报 loader_unknown —— 两者不是一回事。
|
||||
liteloader 的特殊之处：清单是从官方版本表**从零合成**的（mainClass = launchwrapper，
|
||||
--tweakClass 追加在父链参数之后），不跑任何外部进程；不叠加载器时只占一个 loader 库。
|
||||
<version> 位还可以写**已装的加载器版本 id**（`1.12.2-forge-14.23.5.2860 --loader liteloader`）
|
||||
表示「叠在它上面」：原版版本从盘上的继承链读出来，父版本没装会具名报错（不会猜一个原版版本号）。
|
||||
只有 liteloader 接受这种叠法，别家给 usage 错误说清「只能叠在原版上」。
|
||||
--loader-version：加载器版本；缺省取官方默认（Fabric 系首个稳定版，maven 系最新，
|
||||
LiteLoader 优先 release 分支、没有则最新快照）。
|
||||
Forge 可写 47.2.0 或 1.20.1-47.2.0 两种形态。
|
||||
NeoForge/Forge 里需要跑官方 installer processors 的版本会真跑一遍（M35 已实装）：
|
||||
缺 Java 时按 D23 的回退链自动装一个托管 JDK；--dry-run 只列出要跑的 processor 与依赖库。
|
||||
|
||||
@@ -1,7 +1,8 @@
|
||||
//! `ull install <version> --loader <kind> [--loader-version <v>]`：加载器层的编排。
|
||||
//!
|
||||
//! ```text
|
||||
//! LoaderSource::resolve（官方 meta：版本列表 → profile JSON / installer profile）
|
||||
//! 目标解析：<version> 位是原版版本 → 叠原版；是已装的加载器版本 id → 叠在它上面（仅 LiteLoader）
|
||||
//! → LoaderSource::resolve（官方 meta：版本列表 → profile JSON / installer profile / LiteLoader 版本表）
|
||||
//! → LoaderInstallPlan::build（纯计算：库清单 + loader 版本 JSON 落点）
|
||||
//! → [--dry-run 到此为止，但多带一段 processors 计划]
|
||||
//! → 原版已装？否 → vanilla::plan_and_install（先装原版）
|
||||
@@ -13,16 +14,22 @@
|
||||
//! 「先装原版」是**硬前置**：loader 版本 JSON 只声明 `inheritsFrom`，jar 与资源都在原版那层，
|
||||
//! 原版缺失时启动链必然断裂。已装则跳过（`is_version_installed` 判据 = 版本 JSON 在盘上）。
|
||||
//!
|
||||
//! **父版本**：`<version>` 位写成加载器版本 id（`1.12.2-forge-14.23.5.2860`）时，它就是父版本，
|
||||
//! 原版版本从盘上的继承链读出来（`addon::loader::parent`）。只有 LiteLoader 接受这种叠法
|
||||
//! （它靠 `--tweakClass` 追加生效）；别家**具名拒绝**，不会默默改成叠原版。
|
||||
//!
|
||||
//! processors 段的顺序也是硬约束：**先跑 processors，再写版本 JSON**。版本清单存在是
|
||||
//! "这版装完了"的判据，抢在 processors 前写会留下一个启动必崩却被报成已安装的实例。
|
||||
|
||||
use unlucky_core::addon::loader::{
|
||||
LoaderError, LoaderInstallPlan, LoaderKind, LoaderPlanInput, LoaderSource,
|
||||
parent, LoaderError, LoaderInstallPlan, LoaderKind, LoaderPlanInput, LoaderSource,
|
||||
};
|
||||
use unlucky_core::download::blocking::block_on;
|
||||
use unlucky_core::download::cache::now_ms;
|
||||
use unlucky_core::game::arguments::Environment;
|
||||
use unlucky_core::game::install::execute;
|
||||
use unlucky_core::game::loader::{InstanceLoader, LoaderKind as WideLoaderKind};
|
||||
use unlucky_core::game::GameLayout;
|
||||
|
||||
use super::report_loader::ProcessorSection;
|
||||
use super::{
|
||||
@@ -38,11 +45,11 @@ use crate::output::Report;
|
||||
///
|
||||
/// # Errors
|
||||
///
|
||||
/// 用法错误、加载器未知/不支持、元数据读取失败、原版装不上、库下载失败、
|
||||
/// installer processors 失败、实例登记失败。
|
||||
/// 用法错误、加载器未知/不支持、父版本缺失或组合不支持、元数据读取失败、原版装不上、
|
||||
/// 库下载失败、installer processors 失败、实例登记失败。
|
||||
pub(super) fn run(ctx: &Ctx, args: &InstallArgs, kind: LoaderKind) -> Result<Report, CliError> {
|
||||
let version = args.version.trim().to_string();
|
||||
if version.is_empty() {
|
||||
let requested = args.version.trim().to_string();
|
||||
if requested.is_empty() {
|
||||
return Err(CliError::usage(
|
||||
"install 需要版本 id：%prog% install <version> --loader fabric",
|
||||
));
|
||||
@@ -54,10 +61,17 @@ pub(super) fn run(ctx: &Ctx, args: &InstallArgs, kind: LoaderKind) -> Result<Rep
|
||||
let meta_cache = layout.meta_cache();
|
||||
let now = now_ms();
|
||||
|
||||
let (version, parent) = resolve_target(ctx, &game, &requested, kind)?;
|
||||
|
||||
let release = block_on(async {
|
||||
let source = LoaderSource::new(&engine, &meta_cache);
|
||||
source
|
||||
.resolve(kind, &version, args.loader_version.as_deref())
|
||||
.resolve_on(
|
||||
kind,
|
||||
&version,
|
||||
args.loader_version.as_deref(),
|
||||
parent.as_deref(),
|
||||
)
|
||||
.await
|
||||
})
|
||||
.map_err(|error: LoaderError| map_loader_error(&error, ctx))?;
|
||||
@@ -73,8 +87,9 @@ pub(super) fn run(ctx: &Ctx, args: &InstallArgs, kind: LoaderKind) -> Result<Rep
|
||||
layout: &game,
|
||||
release: &release,
|
||||
environment: &Environment::host(),
|
||||
vanilla_installed: game.is_version_installed(&version),
|
||||
});
|
||||
parent_installed: game.is_version_installed(&release.parent_version_id),
|
||||
})
|
||||
.map_err(|error| map_loader_error(&error, ctx))?;
|
||||
let processor_plan = loader_processors::plan(ctx, &release)?;
|
||||
|
||||
if args.dry_run {
|
||||
@@ -162,3 +177,32 @@ fn map_loader_error(error: &LoaderError, ctx: &Ctx) -> CliError {
|
||||
};
|
||||
CliError::user(error.kind().as_str(), error.message().to_string()).with_hint(hint)
|
||||
}
|
||||
|
||||
/// `<version>` 位 → （原版版本, 父版本 id）。
|
||||
///
|
||||
/// 两种写法（`InstallArgs.version` 的文档口径允许版本 id）：
|
||||
/// - 原版版本（`1.12.2`）→ 叠原版，父版本 = 原版；
|
||||
/// - **已装的加载器版本 id**（`1.12.2-forge-14.23.5.2860`）→ 叠在它上面，原版版本从盘上的
|
||||
/// 继承链读出来。只有 LiteLoader 接受这种叠法；别家给具名错误，不静默改成叠原版。
|
||||
fn resolve_target(
|
||||
ctx: &Ctx,
|
||||
game: &GameLayout,
|
||||
requested: &str,
|
||||
kind: LoaderKind,
|
||||
) -> Result<(String, Option<String>), CliError> {
|
||||
if InstanceLoader::parse(requested).kind == WideLoaderKind::Vanilla {
|
||||
return Ok((requested.to_string(), None));
|
||||
}
|
||||
if kind != LoaderKind::LiteLoader {
|
||||
return Err(CliError::usage(format!(
|
||||
"`{requested}` 是一个已装加载器版本 id：只有 LiteLoader 支持叠在别的加载器层上，{} 只能叠在原版上",
|
||||
kind.label()
|
||||
))
|
||||
.with_hint(
|
||||
"换成原版版本号：`%prog% install 1.20.1 --loader forge`；或先 `%prog% instances list` 看已装版本",
|
||||
));
|
||||
}
|
||||
let mc_version =
|
||||
parent::root_version_id(game, requested).map_err(|error| map_loader_error(&error, ctx))?;
|
||||
Ok((mc_version, Some(requested.to_string())))
|
||||
}
|
||||
@@ -4,6 +4,7 @@
|
||||
//! --loader 缺省 → vanilla：M27 原版安装（resolve → plan → execute → register）
|
||||
//! --loader fabric|quilt → addon::loader：原版（已装则跳）→ loader 版本 JSON → 补 loader 库 → register
|
||||
//! --loader neoforge|forge → 同上；需要 installer processors 的版本再跑 M35 执行器（依赖库 → java → 版本 JSON）
|
||||
//! --loader liteloader → 官方版本表 → 从零合成 launchwrapper 清单（不跑任何外部进程）
|
||||
//! ```
|
||||
//!
|
||||
//! CLI 只做四件事：建下载引擎、把计划/结果排版成人读与 `--json` 两种形态
|
||||
@@ -22,6 +23,7 @@ use std::sync::Arc;
|
||||
use unlucky_core::addon::loader::LoaderKind;
|
||||
use unlucky_core::download::{DownloadEngine, DownloadErrorKind};
|
||||
use unlucky_core::game::install::{InstallError, InstallReport, Registration};
|
||||
use unlucky_core::game::LoaderKind as WideLoaderKind;
|
||||
|
||||
use crate::cli::InstallArgs;
|
||||
use crate::context::Ctx;
|
||||
@@ -33,9 +35,14 @@ pub(super) const CONCURRENCY: usize = 16;
|
||||
|
||||
/// 执行 `install`：按 `--loader` 分发。
|
||||
///
|
||||
/// "认不出" 与 "认得但装不了" 是两件事，错误码也分开（`loader_unknown` / `loader_unsupported`）：
|
||||
/// `optifine` 属于后者——core 的识别词表里有它（`ull help instances` 也这么写），只是安装管线
|
||||
/// 没接（要跑外部 `optifine.Patcher` + 原地改 zip）。两者混成一句"未知加载器"会让用户以为
|
||||
/// 是自己的版本 id 写错了。
|
||||
///
|
||||
/// # Errors
|
||||
///
|
||||
/// 用法错误、加载器未知、版本不存在、网络失败、校验不符、写盘失败、实例清单损坏。
|
||||
/// 用法错误、加载器未知/认得但装不了、版本不存在、网络失败、校验不符、写盘失败、实例清单损坏。
|
||||
pub fn run(ctx: &Ctx, args: &InstallArgs) -> Result<Report, CliError> {
|
||||
match args
|
||||
.loader
|
||||
@@ -46,10 +53,18 @@ pub fn run(ctx: &Ctx, args: &InstallArgs) -> Result<Report, CliError> {
|
||||
None | Some("vanilla") | Some("none") => vanilla::run(ctx, args),
|
||||
Some(raw) => match LoaderKind::parse(raw) {
|
||||
Some(kind) => loader::run(ctx, args, kind),
|
||||
None => Err(
|
||||
CliError::user("loader_unknown", format!("未知加载器 `{raw}`"))
|
||||
.with_hint("--loader 取值：vanilla / fabric / quilt / neoforge / forge"),
|
||||
None => Err(match WideLoaderKind::parse(raw) {
|
||||
Some(WideLoaderKind::OptiFine) => CliError::user(
|
||||
"loader_unsupported",
|
||||
"optifine 认得出但还没接入安装管线（要跑外部 Patcher 并原地改 zip）",
|
||||
)
|
||||
.with_hint(
|
||||
"先用官方安装器装好，再 `%prog% instances list` 确认它已在；或用 fabric / quilt / neoforge / forge / liteloader",
|
||||
),
|
||||
_ => CliError::user("loader_unknown", format!("未知加载器 `{raw}`")).with_hint(
|
||||
"--loader 取值：vanilla / fabric / quilt / neoforge / forge / liteloader（optifine 认得出但装不了）",
|
||||
),
|
||||
}),
|
||||
},
|
||||
}
|
||||
}
|
||||
|
||||
@@ -334,6 +334,7 @@ mod tests {
|
||||
let release = LoaderRelease {
|
||||
kind: LoaderKind::Fabric,
|
||||
mc_version: "1.20.1".to_string(),
|
||||
parent_version_id: "1.20.1".to_string(),
|
||||
loader_version: "0.15.11".to_string(),
|
||||
version_id: "1.20.1-fabric-0.15.11".to_string(),
|
||||
version_json: VersionJson::from_json_str(
|
||||
@@ -349,8 +350,9 @@ mod tests {
|
||||
layout: &layout,
|
||||
release: &release,
|
||||
environment: &Environment::host(),
|
||||
vanilla_installed: true,
|
||||
parent_installed: true,
|
||||
})
|
||||
.expect("计划应可组")
|
||||
}
|
||||
|
||||
/// **M216 r2 P2-2**：装加载器时「先装原版」那一步替换了共享 `.minecraft` 里的原版清单，
|
||||
@@ -372,7 +374,6 @@ mod tests {
|
||||
}),
|
||||
warnings: vec!["已替换版本清单 /g/.minecraft/versions/1.20.1/1.20.1.json".to_string()],
|
||||
};
|
||||
|
||||
let text = human_lines(false, &plan, None, Some(&vanilla), None, &[], "n", None).join("\n");
|
||||
assert!(
|
||||
text.contains("已替换版本清单"),
|
||||
|
||||
@@ -0,0 +1,140 @@
|
||||
//! `ull install --loader liteloader` 的**离线**可验面：词表分流、父版本缺失、help 文案。
|
||||
//!
|
||||
//! 这里刻意不联网：LiteLoader 的版本表在 `dl.liteloader.com`，把「拉到表之后」的链路放在
|
||||
//! `crates/core/tests/liteloader/**`（真实响应夹具 + 合成 + 计划 + 落盘 + 启动参数）。
|
||||
//! 本文件守的是「进门那一步」：`optifine` 与随机拼法的错误码必须分开、父版本没装必须具名报错、
|
||||
//! 非 LiteLoader 不许叠在别的加载器层上。
|
||||
|
||||
#[path = "support/mod.rs"]
|
||||
mod support;
|
||||
|
||||
use support::{parse_json, run_cli, TempDir};
|
||||
|
||||
#[test]
|
||||
fn optifine_is_recognized_but_not_supported() {
|
||||
let dir = TempDir::new("liteloader-optifine");
|
||||
let (code, stdout, _) = run_cli(&[
|
||||
"install",
|
||||
"1.20.1",
|
||||
"--loader",
|
||||
"optifine",
|
||||
"--json",
|
||||
"--data-dir",
|
||||
&dir.arg(),
|
||||
]);
|
||||
assert_eq!(code, 1);
|
||||
let value = parse_json(&stdout);
|
||||
assert_eq!(
|
||||
value["error"]["code"], "loader_unsupported",
|
||||
"optifine 是「认得但装不了」，不是未知加载器：{stdout}"
|
||||
);
|
||||
assert!(
|
||||
value["error"]["message"]
|
||||
.as_str()
|
||||
.unwrap_or_default()
|
||||
.contains("optifine"),
|
||||
"{stdout}"
|
||||
);
|
||||
}
|
||||
|
||||
/// `optifine` 之外，真正不认识的拼法仍是 `loader_unknown`（样本用**明显无效**的名字，
|
||||
/// 不拿任何真实加载器名当「未知」前提）。
|
||||
#[test]
|
||||
fn genuinely_unknown_loader_stays_unknown() {
|
||||
let dir = TempDir::new("liteloader-unknown");
|
||||
let (code, stdout, _) = run_cli(&[
|
||||
"install",
|
||||
"1.20.1",
|
||||
"--loader",
|
||||
"ull-invalid-loader-test",
|
||||
"--json",
|
||||
"--data-dir",
|
||||
&dir.arg(),
|
||||
]);
|
||||
assert_eq!(code, 1);
|
||||
let value = parse_json(&stdout);
|
||||
assert_eq!(value["error"]["code"], "loader_unknown", "{stdout}");
|
||||
let hint = value["error"]["hint"].as_str().unwrap_or_default();
|
||||
assert!(hint.contains("liteloader"), "提示要列全六家：{hint}");
|
||||
}
|
||||
|
||||
/// 父版本（`1.12.2-forge-…`）没装时：具名报缺哪个父版本，且**不发网络请求**。
|
||||
#[test]
|
||||
fn liteloader_on_a_missing_forge_parent_names_the_parent() {
|
||||
let dir = TempDir::new("liteloader-missing-parent");
|
||||
let (code, stdout, _) = run_cli(&[
|
||||
"install",
|
||||
"1.12.2-forge-14.23.5.2860",
|
||||
"--loader",
|
||||
"liteloader",
|
||||
"--json",
|
||||
"--data-dir",
|
||||
&dir.arg(),
|
||||
]);
|
||||
assert_eq!(code, 1);
|
||||
let value = parse_json(&stdout);
|
||||
assert_eq!(value["error"]["code"], "loader_not_found", "{stdout}");
|
||||
let message = value["error"]["message"].as_str().unwrap_or_default();
|
||||
assert!(
|
||||
message.contains("1.12.2-forge-14.23.5.2860"),
|
||||
"要点名缺哪个父版本：{message}"
|
||||
);
|
||||
}
|
||||
|
||||
/// 只有 LiteLoader 接受「叠在别的加载器层上」；别家在进门处就说清（不静默改成叠原版）。
|
||||
#[test]
|
||||
fn only_liteloader_accepts_stacking_on_another_loader_layer() {
|
||||
let dir = TempDir::new("liteloader-stack-guard");
|
||||
let (code, stdout, _) = run_cli(&[
|
||||
"install",
|
||||
"1.12.2-forge-14.23.5.2860",
|
||||
"--loader",
|
||||
"fabric",
|
||||
"--json",
|
||||
"--data-dir",
|
||||
&dir.arg(),
|
||||
]);
|
||||
assert_eq!(code, 1);
|
||||
let value = parse_json(&stdout);
|
||||
assert_eq!(value["error"]["code"], "usage", "{stdout}");
|
||||
let message = value["error"]["message"].as_str().unwrap_or_default();
|
||||
assert!(
|
||||
message.contains("LiteLoader") && message.contains("Fabric"),
|
||||
"{message}"
|
||||
);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn install_help_names_the_liteloader_route() {
|
||||
let (code, stdout, _) = run_cli(&["help", "install"]);
|
||||
assert_eq!(code, 0);
|
||||
for needle in [
|
||||
"liteloader",
|
||||
"optifine",
|
||||
"launchwrapper",
|
||||
"tweakClass",
|
||||
"loader_unsupported",
|
||||
"loader_unknown",
|
||||
] {
|
||||
assert!(
|
||||
stdout.contains(needle),
|
||||
"`ull help install` 少了 `{needle}`：\n{stdout}"
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn general_help_lists_liteloader_under_install() {
|
||||
let (code, stdout, _) = run_cli(&["--help"]);
|
||||
assert_eq!(code, 0);
|
||||
let install_block = stdout
|
||||
.lines()
|
||||
.skip_while(|line| !line.trim_start().starts_with("install <version>"))
|
||||
.take(3)
|
||||
.collect::<Vec<_>>()
|
||||
.join("\n");
|
||||
assert!(
|
||||
install_block.contains("liteloader"),
|
||||
"总帮助的 install 段要提到 liteloader：\n{install_block}"
|
||||
);
|
||||
}
|
||||
@@ -69,11 +69,13 @@ fn instances_list_json_shape() {
|
||||
#[test]
|
||||
fn install_rejects_unknown_loader_before_touching_network() {
|
||||
let dir = TempDir::new("install-loader");
|
||||
// 样本必须是一个**任何词表里都没有**的拼法：`liteloader` 自 M222 起是受支持加载器，
|
||||
// 拿它当「未知」会让这条用例变成真去拉 dl.liteloader.com 的联网测试。
|
||||
let (code, stdout, _) = run_cli(&[
|
||||
"install",
|
||||
"1.20.1",
|
||||
"--loader",
|
||||
"liteloader",
|
||||
"ull-invalid-loader-test",
|
||||
"--json",
|
||||
"--data-dir",
|
||||
&dir.arg(),
|
||||
|
||||
@@ -31,12 +31,14 @@ pub const FABRIC_META: &str = "https://meta.fabricmc.net/v2";
|
||||
/// Quilt 官方 meta 根（同上，`bmclapi-quilt-meta`）。
|
||||
pub const QUILT_META: &str = "https://meta.quiltmc.org/v3";
|
||||
|
||||
/// meta 根地址（按加载器）。
|
||||
/// meta 根地址（按加载器；非 fabric 系给空串，调用方已按 [`LoaderKind::is_fabric_family`] 分流）。
|
||||
#[must_use]
|
||||
pub fn meta_base(kind: LoaderKind) -> &'static str {
|
||||
match kind {
|
||||
LoaderKind::Fabric => FABRIC_META,
|
||||
LoaderKind::Quilt => QUILT_META,
|
||||
_ => FABRIC_META,
|
||||
// Forge / NeoForge 走 maven，LiteLoader 走官方版本表——都不能回落到 fabric meta。
|
||||
LoaderKind::NeoForge | LoaderKind::Forge | LoaderKind::LiteLoader => "",
|
||||
}
|
||||
}
|
||||
|
||||
@@ -159,6 +161,7 @@ pub fn build_release(
|
||||
Ok(LoaderRelease {
|
||||
kind,
|
||||
mc_version: mc_version.to_string(),
|
||||
parent_version_id: mc_version.to_string(),
|
||||
loader_version: loader_version.to_string(),
|
||||
version_id,
|
||||
version_json,
|
||||
|
||||
@@ -195,6 +195,7 @@ pub fn build_release(
|
||||
Ok(LoaderRelease {
|
||||
kind,
|
||||
mc_version: mc_version.to_string(),
|
||||
parent_version_id: mc_version.to_string(),
|
||||
loader_version,
|
||||
version_id,
|
||||
version_json,
|
||||
|
||||
@@ -0,0 +1,214 @@
|
||||
//! LiteLoader：官方 `versions.json` → **从零合成**一份 launchwrapper 版本 JSON。
|
||||
//!
|
||||
//! 依据（A 级：官方数据 + 官方构建脚本，不查二手转述）：
|
||||
//! - 数据源 `https://dl.liteloader.com/versions/versions.json`（2026-11 实测 200 / 49 KB，
|
||||
//! 16 个原版版本）；
|
||||
//! - HMCL 的同类实现只做一件事（`HMCLCore/.../liteloader/LiteLoaderInstallTask.java`）：
|
||||
//! `mainClass = launchwrapper` + `--tweakClass <record.tweakClass>` + 「记录自带库 + 本体 jar」，
|
||||
//! **不跑任何外部进程**；本模块按同样的协议独立实现，没有抄它的代码。
|
||||
//!
|
||||
//! # 四条与上游形状有关的硬事实（都实测过，别按直觉改）
|
||||
//!
|
||||
//! 1. **分支键是 md5，不是版本号**：`artefacts."com.mumfrey:liteloader"` 下的键是 md5，
|
||||
//! 真正的版本号在记录的 `version` 字段（`1.7.10_04`）。按 `version` 去重（同一版本会挂
|
||||
//! 两个 md5 键），`latest` 分支要跳过。
|
||||
//! 2. **目录名是原版版本，不是 loader 版本**：release 直链形如
|
||||
//! `<repo>/com/mumfrey/liteloader/1.7.10/liteloader-1.7.10_04.jar`（`1.7.10` 是原版）。
|
||||
//! 3. **1.12.2 这类版本只有 `snapshots` 分支**（上游 16 个版本里 8 个如此，含最常用的 1.12.2）。
|
||||
//! 记录的 `file`（`liteloader-1.12.2-SNAPSHOT.jar`）**下不动**，仓库里只有带时间戳的
|
||||
//! `liteloader-1.12.2-<timestamp>-<build>-release.jar`；要拼出直链必须再读一次
|
||||
//! `maven-metadata.xml`（`<timestamp>` + `<buildNumber>`）。见 [`snapshot_artifact_url`]。
|
||||
//! 4. **分支级 `libraries` 不是要装的库**：那是 ForgeGradle 开发环境用的（1.12.2 的
|
||||
//! `snapshots.libraries` 里挂着 `org.spongepowered:mixin`）。要进游戏 classpath 的是
|
||||
//! **记录级** `libraries`（`launchwrapper` + `asm-all`），与 HMCL 的取法一致。
|
||||
//!
|
||||
//! # 库基址为什么按 group 分流
|
||||
//!
|
||||
//! 记录里的库大多不写 `url`，上游默认（Mojang 库仓）**实测 404**：`org.ow2.asm:asm-all:5.2`
|
||||
//! 在 `libraries.minecraft.net` 上不存在（5.0.3 存在），而 `net.minecraft:launchwrapper:*`
|
||||
//! 只在 Mojang 库仓有（Central / Forge maven 都 404）。所以 `net.minecraft` 走 Mojang 默认基址、
|
||||
//! 其余走 Maven Central（实测 206）。这条分流有单测钉住，别把两侧弄反。
|
||||
|
||||
use super::plan::{LoaderRelease, LoaderSupport};
|
||||
use super::{LoaderError, LoaderKind};
|
||||
use crate::game::arguments::{Argument, Arguments};
|
||||
use crate::game::library::{Library, LibraryDownloads};
|
||||
use crate::game::manifest::{DownloadInfo, VersionJson};
|
||||
use crate::game::version::ReleaseType;
|
||||
|
||||
/// 官方版本表。
|
||||
pub const VERSION_LIST_URL: &str = "https://dl.liteloader.com/versions/versions.json";
|
||||
|
||||
/// 本体 jar 与 release 分支的仓库根（BMCLAPI 有 `bmclapi-liteloader` 改写规则）。
|
||||
pub const DEFAULT_REPO: &str = "https://dl.liteloader.com/versions/";
|
||||
|
||||
/// 非 Mojang 库的基址：Mojang 库仓里没有 `asm-all:5.2`（实测 404），Central 有（实测 206）。
|
||||
pub const CENTRAL_REPO: &str = "https://repo1.maven.org/maven2/";
|
||||
|
||||
/// launchwrapper 主类（LiteLoader 靠它做 tweak 注入）。
|
||||
pub const LAUNCHWRAPPER_MAIN: &str = "net.minecraft.launchwrapper.Launch";
|
||||
|
||||
/// 记录没带 launchwrapper 时的兜底版本（1.12.2 的记录带的是 1.12）。
|
||||
const LAUNCHWRAPPER_FALLBACK: &str = "1.12";
|
||||
|
||||
/// 本体库坐标的 group / artifact。
|
||||
const LOADER_GROUP: &str = "com.mumfrey";
|
||||
/// 本体库坐标的 artifact 名。
|
||||
const LOADER_ARTIFACT: &str = "liteloader";
|
||||
|
||||
mod versions;
|
||||
|
||||
pub use versions::{parse_versions, snapshot_artifact_url};
|
||||
|
||||
/// 一条可安装的 LiteLoader 版本（已归一化，不含 `latest` 别名分支）。
|
||||
#[derive(Debug, Clone, PartialEq, Eq)]
|
||||
pub struct LiteLoaderEntry {
|
||||
/// 版本号（`1.7.10_04` / `1.12.2-SNAPSHOT`）
|
||||
pub version: String,
|
||||
/// 记录所属的原版版本（拼目录与文件名用）
|
||||
pub mc_version: String,
|
||||
/// 是否快照分支（只有快照时要再读 maven-metadata 才拼得出直链）
|
||||
pub snapshot: bool,
|
||||
/// tweak 类（`com.mumfrey.liteloader.launch.LiteLoaderTweaker`）
|
||||
pub tweak_class: String,
|
||||
/// 记录级库（**不含**本体 jar，本体由 [`build_release`] 补）
|
||||
pub libraries: Vec<Library>,
|
||||
/// release 分支的直链（快照分支为 `None`）
|
||||
pub url: Option<String>,
|
||||
/// 快照分支的 maven 目录（`…/com/mumfrey/liteloader/1.12.2-SNAPSHOT/`）
|
||||
pub snapshot_dir: Option<String>,
|
||||
}
|
||||
|
||||
/// 默认版本：优先非快照（稳定），没有则取最新的那条。
|
||||
#[must_use]
|
||||
pub fn default_entry(entries: &[LiteLoaderEntry]) -> Option<&LiteLoaderEntry> {
|
||||
entries
|
||||
.iter()
|
||||
.find(|entry| !entry.snapshot)
|
||||
.or_else(|| entries.first())
|
||||
}
|
||||
|
||||
/// 按版本号找一条（大小写不敏感）。
|
||||
#[must_use]
|
||||
pub fn find_entry<'a>(
|
||||
entries: &'a [LiteLoaderEntry],
|
||||
version: &str,
|
||||
) -> Option<&'a LiteLoaderEntry> {
|
||||
entries
|
||||
.iter()
|
||||
.find(|entry| entry.version.eq_ignore_ascii_case(version.trim()))
|
||||
}
|
||||
|
||||
/// 合成 loader 版本 JSON（**纯函数**：直链由调用方给，快照的直链要先去查 maven-metadata）。
|
||||
///
|
||||
/// 拼出来的清单只有四件事：主类 = launchwrapper、`--tweakClass` 进 `arguments.game`、
|
||||
/// 库 = 记录库 + 本体 jar、`inheritsFrom` = 父版本（缺省原版）。
|
||||
///
|
||||
/// **`arguments.game` 而不是 `minecraftArguments`**：继承合并里 `minecraftArguments` 是
|
||||
/// **子覆盖父**（[`crate::game::inherit::merge`]），写它会把父链（Forge 1.12.2 的
|
||||
/// `--tweakClass FMLTweaker`）整串顶掉，Forge 当场不加载；`arguments.game` 才是父在前、子在后
|
||||
/// **追加**，且启动时排在 legacy 参数之后（[`crate::launch::game_args`] 第 24/25 项）。
|
||||
///
|
||||
/// # Errors
|
||||
///
|
||||
/// 记录缺 `tweakClass`、或没有本体直链时返回 metadata 错误（没有它这份清单装上也起不来）。
|
||||
pub fn build_release(
|
||||
mc_version: &str,
|
||||
parent_version_id: &str,
|
||||
entry: &LiteLoaderEntry,
|
||||
artifact_url: &str,
|
||||
) -> Result<LoaderRelease, LoaderError> {
|
||||
if entry.tweak_class.trim().is_empty() {
|
||||
return Err(LoaderError::metadata(format!(
|
||||
"LiteLoader {} 的记录没有 tweakClass：这份清单装上也起不来",
|
||||
entry.version
|
||||
))
|
||||
.with_hint("换一个 LiteLoader 版本，或核对 dl.liteloader.com 的版本表"));
|
||||
}
|
||||
if artifact_url.trim().is_empty() {
|
||||
return Err(LoaderError::metadata(format!(
|
||||
"LiteLoader {} 没有可下载的本体 jar 地址",
|
||||
entry.version
|
||||
)));
|
||||
}
|
||||
|
||||
let version_id = LoaderKind::LiteLoader.version_id(mc_version, &entry.version);
|
||||
let mut libraries = entry.libraries.clone();
|
||||
libraries.push(loader_library(entry, artifact_url));
|
||||
|
||||
let mut warnings = Vec::new();
|
||||
if parent_version_id != mc_version {
|
||||
warnings.push(format!(
|
||||
"LiteLoader {} 叠在 {parent_version_id} 上（父链不是原版 {mc_version}）：tweakClass 追加在父链参数之后，父链自己的 tweakClass 不动",
|
||||
entry.version
|
||||
));
|
||||
}
|
||||
if !libraries
|
||||
.iter()
|
||||
.any(|library| library.name.starts_with("net.minecraft:launchwrapper:"))
|
||||
{
|
||||
libraries.push(Library {
|
||||
name: format!("net.minecraft:launchwrapper:{LAUNCHWRAPPER_FALLBACK}"),
|
||||
..Library::default()
|
||||
});
|
||||
warnings.push(
|
||||
"LiteLoader 的记录没带 launchwrapper：已补 1.12（Launch 主类就靠它）".to_string(),
|
||||
);
|
||||
}
|
||||
|
||||
let version_json = VersionJson {
|
||||
id: Some(version_id.clone()),
|
||||
name: Some(format!("{mc_version} · LiteLoader {}", entry.version)),
|
||||
inherits_from: Some(parent_version_id.to_string()),
|
||||
// 客户端 jar 恒在原版那层（父链与 loader 层都不带 jar）。
|
||||
jar: Some(mc_version.to_string()),
|
||||
main_class: Some(LAUNCHWRAPPER_MAIN.to_string()),
|
||||
minecraft_arguments: None,
|
||||
arguments: Some(Arguments {
|
||||
game: vec![
|
||||
Argument::Plain("--tweakClass".to_string()),
|
||||
Argument::Plain(entry.tweak_class.clone()),
|
||||
],
|
||||
jvm: Vec::new(),
|
||||
}),
|
||||
version_type: Some(if entry.snapshot {
|
||||
ReleaseType::Snapshot
|
||||
} else {
|
||||
ReleaseType::Release
|
||||
}),
|
||||
libraries: Some(libraries),
|
||||
..VersionJson::default()
|
||||
};
|
||||
|
||||
Ok(LoaderRelease {
|
||||
kind: LoaderKind::LiteLoader,
|
||||
mc_version: mc_version.to_string(),
|
||||
parent_version_id: parent_version_id.to_string(),
|
||||
loader_version: entry.version.clone(),
|
||||
version_id,
|
||||
version_json,
|
||||
support: LoaderSupport::JsonRoute,
|
||||
installer: None,
|
||||
install_profile: None,
|
||||
warnings,
|
||||
})
|
||||
}
|
||||
|
||||
/// 本体 jar 的那一条库：直链绝对地址（快照的路径与 maven 坐标不一致，不能靠坐标推导）。
|
||||
fn loader_library(entry: &LiteLoaderEntry, artifact_url: &str) -> Library {
|
||||
Library {
|
||||
name: format!("{LOADER_GROUP}:{LOADER_ARTIFACT}:{}", entry.version),
|
||||
url: Some(DEFAULT_REPO.to_string()),
|
||||
downloads: Some(LibraryDownloads {
|
||||
artifact: Some(DownloadInfo {
|
||||
id: None,
|
||||
sha1: None,
|
||||
size: None,
|
||||
url: Some(artifact_url.to_string()),
|
||||
path: None,
|
||||
}),
|
||||
classifiers: BTreeMap::new(),
|
||||
}),
|
||||
..Library::default()
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,218 @@
|
||||
//! 官方版本表（`dl.liteloader.com/versions/versions.json`）的解析：原版版本 → 条目列表。
|
||||
//!
|
||||
//! 上游形状的四条硬事实写在父模块的文档里（[`super`]）；这里只放解析与 URL 拼装。
|
||||
//! 单独一个文件的理由是行数：父模块要装「解析」与「合成清单」两件事，一起写会破 400 行硬线。
|
||||
|
||||
use std::collections::{BTreeMap, BTreeSet};
|
||||
|
||||
use serde::Deserialize;
|
||||
|
||||
use super::{LiteLoaderEntry, LoaderError, CENTRAL_REPO, DEFAULT_REPO, VERSION_LIST_URL};
|
||||
use crate::game::library::Library;
|
||||
|
||||
#[derive(Debug, Deserialize)]
|
||||
struct Root {
|
||||
#[serde(default)]
|
||||
versions: BTreeMap<String, GameVersions>,
|
||||
}
|
||||
|
||||
#[derive(Debug, Deserialize)]
|
||||
struct GameVersions {
|
||||
#[serde(default)]
|
||||
repo: Option<Repo>,
|
||||
#[serde(default)]
|
||||
artefacts: Option<Branch>,
|
||||
#[serde(default)]
|
||||
snapshots: Option<Branch>,
|
||||
}
|
||||
|
||||
#[derive(Debug, Deserialize)]
|
||||
struct Repo {
|
||||
#[serde(default)]
|
||||
url: String,
|
||||
}
|
||||
|
||||
#[derive(Debug, Deserialize)]
|
||||
struct Branch {
|
||||
#[serde(rename = "com.mumfrey:liteloader", default)]
|
||||
liteloader: BTreeMap<String, Record>,
|
||||
}
|
||||
|
||||
#[derive(Debug, Deserialize)]
|
||||
struct Record {
|
||||
#[serde(default, rename = "tweakClass")]
|
||||
tweak_class: String,
|
||||
#[serde(default)]
|
||||
libraries: Vec<Library>,
|
||||
#[serde(default)]
|
||||
file: String,
|
||||
#[serde(default)]
|
||||
version: String,
|
||||
#[serde(default)]
|
||||
stream: String,
|
||||
}
|
||||
|
||||
/// 解析官方版本表：原版版本 → 该原版下的 LiteLoader 版本（**新在前**）。
|
||||
///
|
||||
/// # Errors
|
||||
///
|
||||
/// 顶层不是 `{"versions": {…}}`、或一个版本都认不出时返回 metadata 错误。
|
||||
pub fn parse_versions(json: &str) -> Result<BTreeMap<String, Vec<LiteLoaderEntry>>, LoaderError> {
|
||||
let root: Root = serde_json::from_str(json)
|
||||
.map_err(|error| LoaderError::metadata(format!("LiteLoader 版本表解析失败：{error}")))?;
|
||||
let mut out: BTreeMap<String, Vec<LiteLoaderEntry>> = BTreeMap::new();
|
||||
for (mc_version, game) in &root.versions {
|
||||
let repo = game
|
||||
.repo
|
||||
.as_ref()
|
||||
.map(|repo| https_repo(&repo.url))
|
||||
.filter(|url| !url.is_empty())
|
||||
.unwrap_or_else(|| DEFAULT_REPO.to_string());
|
||||
let mut entries: Vec<LiteLoaderEntry> = Vec::new();
|
||||
let mut seen: BTreeSet<String> = BTreeSet::new();
|
||||
if let Some(branch) = &game.artefacts {
|
||||
collect(branch, mc_version, &repo, false, &mut entries, &mut seen);
|
||||
}
|
||||
if let Some(branch) = &game.snapshots {
|
||||
collect(branch, mc_version, &repo, true, &mut entries, &mut seen);
|
||||
}
|
||||
if entries.is_empty() {
|
||||
continue;
|
||||
}
|
||||
entries.sort_by(|left, right| cmp_versions(&right.version, &left.version));
|
||||
out.insert(mc_version.clone(), entries);
|
||||
}
|
||||
if out.is_empty() {
|
||||
return Err(LoaderError::not_found(
|
||||
"LiteLoader 版本表里没有任何可用版本（数据源形状变了？）",
|
||||
));
|
||||
}
|
||||
Ok(out)
|
||||
}
|
||||
|
||||
/// 收一个分支的记录（`latest` 别名与重复版本跳过）。
|
||||
fn collect(
|
||||
branch: &Branch,
|
||||
mc_version: &str,
|
||||
repo: &str,
|
||||
snapshot_branch: bool,
|
||||
out: &mut Vec<LiteLoaderEntry>,
|
||||
seen: &mut BTreeSet<String>,
|
||||
) {
|
||||
for (key, record) in &branch.liteloader {
|
||||
if key.eq_ignore_ascii_case("latest") || record.version.is_empty() {
|
||||
continue;
|
||||
}
|
||||
if !seen.insert(record.version.clone()) {
|
||||
continue;
|
||||
}
|
||||
// 记录自己标 SNAPSHOT 的也走快照路线（release 分支里出现过混编）。
|
||||
let snapshot = snapshot_branch || record.stream.eq_ignore_ascii_case("SNAPSHOT");
|
||||
let dir = format!("{repo}com/mumfrey/liteloader/{mc_version}/");
|
||||
let (url, snapshot_dir) = if snapshot {
|
||||
let snap_dir = format!("{repo}com/mumfrey/liteloader/{mc_version}-SNAPSHOT/");
|
||||
(None, Some(snap_dir))
|
||||
} else {
|
||||
(
|
||||
(!record.file.is_empty()).then(|| format!("{dir}{}", record.file)),
|
||||
None,
|
||||
)
|
||||
};
|
||||
out.push(LiteLoaderEntry {
|
||||
version: record.version.clone(),
|
||||
mc_version: mc_version.to_string(),
|
||||
snapshot,
|
||||
tweak_class: record.tweak_class.clone(),
|
||||
libraries: record.libraries.iter().map(rebased).collect(),
|
||||
url,
|
||||
snapshot_dir,
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
/// `http://…` → `https://…`（上游表里混着 http；HMCL 同样改写）。
|
||||
fn https_repo(url: &str) -> String {
|
||||
if let Some(rest) = url.strip_prefix("http://") {
|
||||
return format!("https://{rest}");
|
||||
}
|
||||
url.to_string()
|
||||
}
|
||||
|
||||
/// 记录级库：保留上游字段（`http` → `https`），只给「没写 url」的库补基址（见模块文档的 group 分流）。
|
||||
fn rebased(library: &Library) -> Library {
|
||||
let mut out = library.clone();
|
||||
match out
|
||||
.url
|
||||
.as_deref()
|
||||
.map(str::trim)
|
||||
.filter(|url| !url.is_empty())
|
||||
{
|
||||
Some(url) => out.url = Some(https_repo(url)),
|
||||
None => {
|
||||
let group = out.name.split(':').next().unwrap_or_default();
|
||||
if group != "net.minecraft" {
|
||||
out.url = Some(CENTRAL_REPO.to_string());
|
||||
}
|
||||
}
|
||||
}
|
||||
out
|
||||
}
|
||||
|
||||
/// 版本号比较：按 `.`/`-`/`_` 切段，纯数字段按数值比，其余按字面量比。
|
||||
fn cmp_versions(left: &str, right: &str) -> std::cmp::Ordering {
|
||||
let lhs: Vec<&str> = left.split(['.', '-', '_']).collect();
|
||||
let rhs: Vec<&str> = right.split(['.', '-', '_']).collect();
|
||||
for (a, b) in lhs.iter().zip(rhs.iter()) {
|
||||
let order = match (a.parse::<u64>(), b.parse::<u64>()) {
|
||||
(Ok(a), Ok(b)) => a.cmp(&b),
|
||||
_ => a.cmp(b),
|
||||
};
|
||||
if order != std::cmp::Ordering::Equal {
|
||||
return order;
|
||||
}
|
||||
}
|
||||
lhs.len().cmp(&rhs.len())
|
||||
}
|
||||
|
||||
/// 从 `maven-metadata.xml` 拼出快照产物的直链（`<dir>liteloader-<mc>-<ts>-<build>-release.jar`）。
|
||||
///
|
||||
/// # Errors
|
||||
///
|
||||
/// 缺 `<timestamp>`/`<buildNumber>` 时返回 metadata 错误（宁可报错，也不猜一个 404 直链）。
|
||||
pub fn snapshot_artifact_url(
|
||||
entry: &LiteLoaderEntry,
|
||||
metadata_xml: &str,
|
||||
) -> Result<String, LoaderError> {
|
||||
let dir = entry.snapshot_dir.as_deref().ok_or_else(|| {
|
||||
LoaderError::metadata(format!(
|
||||
"LiteLoader {} 不是快照版本，没有 maven 目录",
|
||||
entry.version
|
||||
))
|
||||
})?;
|
||||
let timestamp = tag_value(metadata_xml, "timestamp").ok_or_else(|| {
|
||||
LoaderError::metadata(format!(
|
||||
"{} 的 maven-metadata.xml 里没有 <timestamp>：拿不到快照直链",
|
||||
entry.version
|
||||
))
|
||||
})?;
|
||||
let build = tag_value(metadata_xml, "buildNumber").ok_or_else(|| {
|
||||
LoaderError::metadata(format!(
|
||||
"{} 的 maven-metadata.xml 里没有 <buildNumber>",
|
||||
entry.version
|
||||
))
|
||||
})?;
|
||||
Ok(format!(
|
||||
"{dir}liteloader-{}-{timestamp}-{build}-release.jar",
|
||||
entry.mc_version
|
||||
))
|
||||
}
|
||||
|
||||
/// 取 `<tag>…</tag>` 里的文本（maven 元数据只有一层，不引 XML 库，与 [`super::maven`] 同口径）。
|
||||
fn tag_value(xml: &str, tag: &str) -> Option<String> {
|
||||
let open = format!("<{tag}>");
|
||||
let close = format!("</{tag}>");
|
||||
let start = xml.find(&open)? + open.len();
|
||||
let end = xml[start..].find(&close)? + start;
|
||||
let value = xml[start..end].trim();
|
||||
(!value.is_empty()).then(|| value.to_string())
|
||||
}
|
||||
@@ -6,6 +6,18 @@
|
||||
//! 镜像：两家 maven 都在 D7 镜像表里有 BMCLAPI 规则（`bmclapi-neoforge` /
|
||||
//! `bmclapi-forge-maven-net`），所以这里一律**写官方地址**，重写交给 `core::download`
|
||||
//! 的镜像展开（与 M27 的"不拼镜像 URL"纪律一致）。
|
||||
//!
|
||||
//! # 非 maven 族一律「没有答案」，不再回落 Forge
|
||||
//!
|
||||
//! 这里每个函数过去都用 `_ =>` 把「不是 NeoForge」的全当 Forge。加了第三个数据源
|
||||
//! （LiteLoader：官方版本表 + 从零合成，不是 maven）之后，那个通配会**静默拼出 Forge 的
|
||||
//! URL**：请求 404 或被当成 Forge 装成一个"像模像样"的错实例。现在：
|
||||
//!
|
||||
//! - 地址类函数返回 `Option`，非 maven 族给 `None`；
|
||||
//! - 版本判定类函数对非 maven 族给「不匹配 / 放行原样」，语义上本就如此。
|
||||
//!
|
||||
//! 真正的入口分流在 [`super::meta::LoaderSource`]（按
|
||||
//! [`LoaderKind::is_fabric_family`] / [`LoaderKind::is_maven_family`] 三路派发）。
|
||||
|
||||
use super::LoaderKind;
|
||||
|
||||
@@ -16,49 +28,50 @@ pub const FORGE_MAVEN: &str = "https://maven.minecraftforge.net";
|
||||
/// NeoForge 唯一走 Forge 布局的原版版本（1.20.1 是"NeoForge 还叫 forge 的时候"）。
|
||||
pub const NEOFORGE_FORGE_LAYOUT_MC: &str = "1.20.1";
|
||||
|
||||
/// maven 根地址。
|
||||
/// maven 根地址（非 maven 族给空串；调用方已按 [`LoaderKind::is_maven_family`] 分流）。
|
||||
#[must_use]
|
||||
pub fn base(kind: LoaderKind) -> &'static str {
|
||||
match kind {
|
||||
LoaderKind::NeoForge => NEOFORGE_MAVEN,
|
||||
_ => FORGE_MAVEN,
|
||||
LoaderKind::Forge => FORGE_MAVEN,
|
||||
// fabric 系与 LiteLoader 都不是 maven 族——绝不能回落到 Forge 的仓库。
|
||||
LoaderKind::Fabric | LoaderKind::Quilt | LoaderKind::LiteLoader => "",
|
||||
}
|
||||
}
|
||||
|
||||
/// 该原版版本对应的 `maven-metadata.xml` 地址。
|
||||
#[must_use]
|
||||
pub fn metadata_url(kind: LoaderKind, mc_version: &str) -> String {
|
||||
let (root, path) = match kind {
|
||||
/// maven 路径段（`group/artifact`）与该原版版本的匹配规则。
|
||||
fn layout(kind: LoaderKind, mc_version: &str) -> Option<(&'static str, &'static str)> {
|
||||
match kind {
|
||||
LoaderKind::NeoForge if mc_version == NEOFORGE_FORGE_LAYOUT_MC => {
|
||||
(NEOFORGE_MAVEN, "net/neoforged/forge")
|
||||
Some((NEOFORGE_MAVEN, "net/neoforged/forge"))
|
||||
}
|
||||
LoaderKind::NeoForge => Some((NEOFORGE_MAVEN, "net/neoforged/neoforge")),
|
||||
LoaderKind::Forge => Some((FORGE_MAVEN, "net/minecraftforge/forge")),
|
||||
LoaderKind::Fabric | LoaderKind::Quilt | LoaderKind::LiteLoader => None,
|
||||
}
|
||||
LoaderKind::NeoForge => (NEOFORGE_MAVEN, "net/neoforged/neoforge"),
|
||||
_ => (FORGE_MAVEN, "net/minecraftforge/forge"),
|
||||
};
|
||||
format!("{root}/{path}/maven-metadata.xml")
|
||||
}
|
||||
|
||||
/// installer jar 地址。
|
||||
/// 该原版版本对应的 `maven-metadata.xml` 地址；非 maven 族给 `None`。
|
||||
#[must_use]
|
||||
pub fn installer_url(kind: LoaderKind, mc_version: &str, maven_version: &str) -> String {
|
||||
let (root, path, file) = match kind {
|
||||
LoaderKind::NeoForge if mc_version == NEOFORGE_FORGE_LAYOUT_MC => (
|
||||
NEOFORGE_MAVEN,
|
||||
"net/neoforged/forge",
|
||||
format!("forge-{maven_version}-installer.jar"),
|
||||
),
|
||||
LoaderKind::NeoForge => (
|
||||
NEOFORGE_MAVEN,
|
||||
"net/neoforged/neoforge",
|
||||
format!("neoforge-{maven_version}-installer.jar"),
|
||||
),
|
||||
_ => (
|
||||
FORGE_MAVEN,
|
||||
"net/minecraftforge/forge",
|
||||
format!("forge-{maven_version}-installer.jar"),
|
||||
),
|
||||
pub fn metadata_url(kind: LoaderKind, mc_version: &str) -> Option<String> {
|
||||
let (root, path) = layout(kind, mc_version)?;
|
||||
Some(format!("{root}/{path}/maven-metadata.xml"))
|
||||
}
|
||||
|
||||
/// installer jar 地址；非 maven 族给 `None`。
|
||||
#[must_use]
|
||||
pub fn installer_url(kind: LoaderKind, mc_version: &str, maven_version: &str) -> Option<String> {
|
||||
let (root, path) = layout(kind, mc_version)?;
|
||||
let file = match kind {
|
||||
LoaderKind::NeoForge if mc_version != NEOFORGE_FORGE_LAYOUT_MC => {
|
||||
format!("neoforge-{maven_version}-installer.jar")
|
||||
}
|
||||
LoaderKind::NeoForge | LoaderKind::Forge => {
|
||||
format!("forge-{maven_version}-installer.jar")
|
||||
}
|
||||
LoaderKind::Fabric | LoaderKind::Quilt | LoaderKind::LiteLoader => return None,
|
||||
};
|
||||
format!("{root}/{path}/{maven_version}/{file}")
|
||||
Some(format!("{root}/{path}/{maven_version}/{file}"))
|
||||
}
|
||||
|
||||
/// 扫 maven-metadata.xml 里的 `<version>` 值。
|
||||
@@ -106,7 +119,7 @@ pub fn neoforge_mc_version(version: &str) -> Option<String> {
|
||||
}
|
||||
}
|
||||
|
||||
/// maven 版本是否属于该原版版本。
|
||||
/// maven 版本是否属于该原版版本（非 maven 族恒 `false`：它们的版本号不是 maven 口径）。
|
||||
#[must_use]
|
||||
pub fn matches_mc(kind: LoaderKind, mc_version: &str, version: &str) -> bool {
|
||||
match kind {
|
||||
@@ -114,7 +127,8 @@ pub fn matches_mc(kind: LoaderKind, mc_version: &str, version: &str) -> bool {
|
||||
version.starts_with(&format!("{mc_version}-"))
|
||||
}
|
||||
LoaderKind::NeoForge => neoforge_mc_version(version).as_deref() == Some(mc_version),
|
||||
_ => version.starts_with(&format!("{mc_version}-")),
|
||||
LoaderKind::Forge => version.starts_with(&format!("{mc_version}-")),
|
||||
LoaderKind::Fabric | LoaderKind::Quilt | LoaderKind::LiteLoader => false,
|
||||
}
|
||||
}
|
||||
|
||||
@@ -137,13 +151,15 @@ pub fn select_versions(kind: LoaderKind, mc_version: &str, versions: &[String])
|
||||
/// 用户给的版本号归一成 maven 版本号（Forge 的 maven 版本带原版前缀）。
|
||||
///
|
||||
/// `--loader-version 47.2.0` 与 `--loader-version 1.20.1-47.2.0` 都接受；
|
||||
/// NeoForge（非 1.20.1 布局）本身就是完整 maven 版本，原样返回。
|
||||
/// NeoForge（非 1.20.1 布局）本身就是完整 maven 版本，原样返回；
|
||||
/// 非 maven 族（fabric 系 / LiteLoader）的版本号原样返回——它们的版本号本就自带原版口径。
|
||||
#[must_use]
|
||||
pub fn normalize_maven_version(kind: LoaderKind, mc_version: &str, raw: &str) -> String {
|
||||
let raw = raw.trim();
|
||||
let needs_prefix = match kind {
|
||||
LoaderKind::Forge => true,
|
||||
LoaderKind::NeoForge => mc_version == NEOFORGE_FORGE_LAYOUT_MC,
|
||||
_ => true,
|
||||
LoaderKind::Fabric | LoaderKind::Quilt | LoaderKind::LiteLoader => false,
|
||||
};
|
||||
if needs_prefix && !raw.starts_with(&format!("{mc_version}-")) {
|
||||
format!("{mc_version}-{raw}")
|
||||
@@ -152,15 +168,17 @@ pub fn normalize_maven_version(kind: LoaderKind, mc_version: &str, raw: &str) ->
|
||||
}
|
||||
}
|
||||
|
||||
/// 用户视角的加载器版本号（Forge 去掉原版前缀，NeoForge 原样）。
|
||||
/// 用户视角的加载器版本号（Forge 去掉原版前缀，NeoForge 与非 maven 族原样）。
|
||||
#[must_use]
|
||||
pub fn display_loader_version(kind: LoaderKind, mc_version: &str, maven_version: &str) -> String {
|
||||
match kind {
|
||||
LoaderKind::NeoForge if mc_version != NEOFORGE_FORGE_LAYOUT_MC => maven_version.to_string(),
|
||||
_ => maven_version
|
||||
LoaderKind::Forge => maven_version
|
||||
.strip_prefix(&format!("{mc_version}-"))
|
||||
.unwrap_or(maven_version)
|
||||
.to_string(),
|
||||
LoaderKind::NeoForge | LoaderKind::Fabric | LoaderKind::Quilt | LoaderKind::LiteLoader => {
|
||||
maven_version.to_string()
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@@ -4,11 +4,12 @@
|
||||
//! 不写游戏目录（installer jar 落 `.ULL/cache/meta/` 作离线复用），镜像/退避/health 全在
|
||||
//! `core::download` 的引擎里（我们一律递**官方地址**，重写由镜像表负责）。
|
||||
//!
|
||||
//! 两族的取数路径完全不同：
|
||||
//! 三个数据源的取数路径完全不同（**三路显式派发**，不许再有「不是 fabric 就是 maven」）：
|
||||
//!
|
||||
//! ```text
|
||||
//! Fabric / Quilt : meta API → profile/json（官方直出可用版本 JSON）
|
||||
//! NeoForge/Forge : maven-metadata.xml → installer jar → 读 install_profile.json + version.json
|
||||
//! LiteLoader : dl.liteloader.com/versions.json →（快照再读 maven-metadata.xml）→ 从零合成
|
||||
//! ```
|
||||
|
||||
use std::fs::File;
|
||||
@@ -18,6 +19,7 @@ use zip::ZipArchive;
|
||||
|
||||
use super::fabric;
|
||||
use super::forge::{self, InstallProfile};
|
||||
use super::liteloader;
|
||||
use super::maven;
|
||||
use super::plan::LoaderRelease;
|
||||
use super::{LoaderError, LoaderKind};
|
||||
@@ -27,6 +29,9 @@ use crate::game::manifest::VersionJson;
|
||||
/// installer jar 的缓存文件名前缀（超长/含 `+` 的版本串会被规整成安全文件名）。
|
||||
const INSTALLER_TAG: &str = "installer";
|
||||
|
||||
/// LiteLoader 官方版本表的缓存文件名（整表 49 KB，一次取全量再本地筛）。
|
||||
const LITELOADER_LIST_TAG: &str = "liteloader-versions.json";
|
||||
|
||||
/// 远端加载器元数据来源。
|
||||
pub struct LoaderSource<'a> {
|
||||
engine: &'a DownloadEngine,
|
||||
@@ -56,7 +61,17 @@ impl<'a> LoaderSource<'a> {
|
||||
let entries = fabric::parse_loader_list(kind, &body)?;
|
||||
return Ok(entries.into_iter().map(|entry| entry.version).collect());
|
||||
}
|
||||
let url = maven::metadata_url(kind, mc_version);
|
||||
if kind == LoaderKind::LiteLoader {
|
||||
let table = self.liteloader_table().await?;
|
||||
let entries = table.get(mc_version.trim()).ok_or_else(|| {
|
||||
LoaderError::not_found(format!(
|
||||
"LiteLoader 没有适配原版 {mc_version} 的版本（官方版本表 {} 条原版版本）",
|
||||
table.len()
|
||||
))
|
||||
})?;
|
||||
return Ok(entries.iter().map(|entry| entry.version.clone()).collect());
|
||||
}
|
||||
let url = maven::metadata_url(kind, mc_version).ok_or_else(|| non_maven(kind))?;
|
||||
let body = self.fetch_text(&url).await?;
|
||||
let all = maven::parse_metadata_versions(&body);
|
||||
// maven 表是升序的，统一成"最新在前"。
|
||||
@@ -74,7 +89,9 @@ impl<'a> LoaderSource<'a> {
|
||||
}
|
||||
|
||||
/// 解析一个加载器版本（`loader_version` 为 `None` 时取官方默认：Fabric 系取首个稳定版，
|
||||
/// maven 系取该原版版本下最新的一版）。
|
||||
/// maven 系取该原版版本下最新的一版，LiteLoader 取首个 release / 否则最新）。
|
||||
///
|
||||
/// 等价于 [`Self::resolve_on`]，父版本 = 原版本身。
|
||||
///
|
||||
/// # Errors
|
||||
///
|
||||
@@ -84,10 +101,41 @@ impl<'a> LoaderSource<'a> {
|
||||
kind: LoaderKind,
|
||||
mc_version: &str,
|
||||
loader_version: Option<&str>,
|
||||
) -> Result<LoaderRelease, LoaderError> {
|
||||
self.resolve_on(kind, mc_version, loader_version, None)
|
||||
.await
|
||||
}
|
||||
|
||||
/// 解析一个加载器版本，并**指定父版本**（`parent` 为 `None` 时等于 `mc_version`）。
|
||||
///
|
||||
/// 目前只有 LiteLoader 接受「父版本不是原版」：它靠 `--tweakClass` 追加生效，叠在
|
||||
/// Forge 1.12.2 上是官方主推组合。其它加载器声明自己的主类/启动目标，叠在别人的 loader
|
||||
/// 层上没有装配路径，因此**具名拒绝**，而不是默默装成「叠在原版上」。
|
||||
///
|
||||
/// # Errors
|
||||
///
|
||||
/// 同上；另外「非 LiteLoader 却指定了非原版父版本」返回 `unsupported`。
|
||||
pub async fn resolve_on(
|
||||
&self,
|
||||
kind: LoaderKind,
|
||||
mc_version: &str,
|
||||
loader_version: Option<&str>,
|
||||
parent: Option<&str>,
|
||||
) -> Result<LoaderRelease, LoaderError> {
|
||||
let requested = loader_version
|
||||
.map(str::trim)
|
||||
.filter(|value| !value.is_empty());
|
||||
let parent_version_id = parent
|
||||
.map(str::trim)
|
||||
.filter(|value| !value.is_empty())
|
||||
.unwrap_or(mc_version);
|
||||
if parent_version_id != mc_version && kind != LoaderKind::LiteLoader {
|
||||
return Err(LoaderError::unsupported(format!(
|
||||
"{} 没有「叠在 {parent_version_id} 上」的装配路线：它自己声明主类与启动目标，只能叠在原版 {mc_version} 上",
|
||||
kind.label()
|
||||
))
|
||||
.with_hint("先装原版，再在其上安装这一家加载器"));
|
||||
}
|
||||
if kind.is_fabric_family() {
|
||||
let version = match requested {
|
||||
Some(version) => version.to_string(),
|
||||
@@ -106,6 +154,11 @@ impl<'a> LoaderSource<'a> {
|
||||
let body = self.fetch_text(&url).await?;
|
||||
return fabric::build_release(kind, mc_version, &version, &body);
|
||||
}
|
||||
if kind == LoaderKind::LiteLoader {
|
||||
return self
|
||||
.resolve_liteloader(mc_version, requested, parent_version_id)
|
||||
.await;
|
||||
}
|
||||
|
||||
let maven_version = match requested {
|
||||
Some(raw) => maven::normalize_maven_version(kind, mc_version, raw),
|
||||
@@ -118,7 +171,8 @@ impl<'a> LoaderSource<'a> {
|
||||
LoaderError::not_found(format!("{} 没有可用的加载器版本", kind.label()))
|
||||
})?,
|
||||
};
|
||||
let url = maven::installer_url(kind, mc_version, &maven_version);
|
||||
let url = maven::installer_url(kind, mc_version, &maven_version)
|
||||
.ok_or_else(|| non_maven(kind))?;
|
||||
let path = self.installer_path(kind, &maven_version);
|
||||
let jar = self.fetch_installer(&url, &path).await?;
|
||||
let (profile, embedded) = read_installer(&jar)?;
|
||||
@@ -131,9 +185,68 @@ impl<'a> LoaderSource<'a> {
|
||||
)?;
|
||||
// M35 执行器要的两样东西：installer 本体（跑 processor 与解包）与它声明的 profile。
|
||||
release.installer = Some(jar);
|
||||
release.parent_version_id = parent_version_id.to_string();
|
||||
Ok(release)
|
||||
}
|
||||
|
||||
/// LiteLoader：整表 → 选条 →（快照再查 maven-metadata）→ 合成清单。
|
||||
async fn resolve_liteloader(
|
||||
&self,
|
||||
mc_version: &str,
|
||||
requested: Option<&str>,
|
||||
parent_version_id: &str,
|
||||
) -> Result<LoaderRelease, LoaderError> {
|
||||
let table = self.liteloader_table().await?;
|
||||
let entries = table.get(mc_version.trim()).ok_or_else(|| {
|
||||
LoaderError::not_found(format!(
|
||||
"LiteLoader 没有适配原版 {mc_version} 的版本（官方版本表 {} 条原版版本）",
|
||||
table.len()
|
||||
))
|
||||
})?;
|
||||
let entry = match requested {
|
||||
Some(raw) => liteloader::find_entry(entries, raw).ok_or_else(|| {
|
||||
LoaderError::not_found(format!(
|
||||
"LiteLoader {} 没有版本 `{raw}`（该原版下有：{}）",
|
||||
mc_version,
|
||||
entries
|
||||
.iter()
|
||||
.map(|entry| entry.version.as_str())
|
||||
.collect::<Vec<_>>()
|
||||
.join(" / ")
|
||||
))
|
||||
})?,
|
||||
None => liteloader::default_entry(entries).ok_or_else(|| {
|
||||
LoaderError::not_found(format!("LiteLoader 没有适配原版 {mc_version} 的版本"))
|
||||
})?,
|
||||
};
|
||||
// 直链：release 分支记录里就有；快照分支必须再读一次 maven-metadata.xml。
|
||||
let artifact_url = match (&entry.url, &entry.snapshot_dir) {
|
||||
(Some(url), _) => url.clone(),
|
||||
(None, Some(dir)) => {
|
||||
let metadata = self.fetch_text(&format!("{dir}maven-metadata.xml")).await?;
|
||||
liteloader::snapshot_artifact_url(entry, &metadata)?
|
||||
}
|
||||
(None, None) => {
|
||||
return Err(LoaderError::metadata(format!(
|
||||
"LiteLoader {} 的记录既没有直链也没有快照目录",
|
||||
entry.version
|
||||
)))
|
||||
}
|
||||
};
|
||||
liteloader::build_release(mc_version, parent_version_id, entry, &artifact_url)
|
||||
}
|
||||
|
||||
/// 取 LiteLoader 整张官方版本表（按原版版本分组）。
|
||||
async fn liteloader_table(
|
||||
&self,
|
||||
) -> Result<std::collections::BTreeMap<String, Vec<liteloader::LiteLoaderEntry>>, LoaderError>
|
||||
{
|
||||
let body = self
|
||||
.fetch_text_named(liteloader::VERSION_LIST_URL, LITELOADER_LIST_TAG)
|
||||
.await?;
|
||||
liteloader::parse_versions(&body)
|
||||
}
|
||||
|
||||
/// installer jar 的本地缓存路径（`+`/非法字符规整成 `_`）。
|
||||
fn installer_path(&self, kind: LoaderKind, maven_version: &str) -> PathBuf {
|
||||
let safe: String = maven_version
|
||||
@@ -162,7 +275,12 @@ impl<'a> LoaderSource<'a> {
|
||||
|
||||
/// 取一小段文本元数据（版本列表 / profile JSON / maven metadata）。
|
||||
async fn fetch_text(&self, url: &str) -> Result<String, LoaderError> {
|
||||
let dest = self.meta_cache.join("loader-meta.bin");
|
||||
self.fetch_text_named(url, "loader-meta.bin").await
|
||||
}
|
||||
|
||||
/// 同上，缓存文件名按调用方给（LiteLoader 整表单独一档，别把小响应和 49 KB 的表混存）。
|
||||
async fn fetch_text_named(&self, url: &str, tag: &str) -> Result<String, LoaderError> {
|
||||
let dest = self.meta_cache.join(tag);
|
||||
let bytes = self
|
||||
.engine
|
||||
.download_bytes(DownloadRequest::new(
|
||||
@@ -176,6 +294,14 @@ impl<'a> LoaderSource<'a> {
|
||||
}
|
||||
}
|
||||
|
||||
/// 非 maven 族被送进 maven 分支时的统一报错（入口已分流，走到这里说明调用链有 bug）。
|
||||
fn non_maven(kind: LoaderKind) -> LoaderError {
|
||||
LoaderError::unsupported(format!(
|
||||
"{} 不是 maven 族加载器，没有 maven 元数据/installer 地址",
|
||||
kind.label()
|
||||
))
|
||||
}
|
||||
|
||||
/// 读 installer jar 里的 `install_profile.json` 与内嵌的版本 JSON。
|
||||
///
|
||||
/// 内嵌版本 JSON 的路径来自 profile 的 `json` 字段（通常 `/version.json`）；
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
//! 加载器安装（Fabric / Quilt / NeoForge / Forge）：官方元数据 → loader 版本 JSON → 补库清单。
|
||||
//! 加载器安装（Fabric / Quilt / NeoForge / Forge / LiteLoader）：官方元数据 → loader 版本 JSON → 补库清单。
|
||||
//!
|
||||
//! 设计输入：`DevDocs/PlanDoc/08-mod-and-recommend.md` §1（D10 加载器安装）、
|
||||
//! `DevDocs/analyse/05-modloader-modpack.md` §1（五加载器安装协议、`patch + priority` 主线）。
|
||||
@@ -22,17 +22,23 @@
|
||||
//! | 路线 | 加载器 | 做法 |
|
||||
//! |------|--------|------|
|
||||
//! | [`LoaderSupport::JsonRoute`] | Fabric / Quilt | 官方 meta 直接给 launcher 用的 profile JSON |
|
||||
//! | [`LoaderSupport::JsonRoute`] | LiteLoader | 官方版本表 → **从零合成**清单（见 [`liteloader`]） |
|
||||
//! | [`LoaderSupport::JsonRoute`] | Forge spec-0（如 1.12.2 重建版） | installer 里的 `version.json` + 库清单，universal jar 走 maven 直取 |
|
||||
//! | [`LoaderSupport::RequiresInstaller`] | Forge spec≥1 / NeoForge | installer 声明了 client 侧 processors（拆包/映射），**必须外调 java** |
|
||||
//!
|
||||
//! 第三类本期只出**明确 unsupported**：版本 JSON 与库清单仍照常生成（`--dry-run` 可看），
|
||||
//! 第四类本期只出**明确 unsupported**：版本 JSON 与库清单仍照常生成（`--dry-run` 可看），
|
||||
//! 但真装会被拒——半成品实例比明确报错更糟（沿 M27 §7「如实告知」的纪律）。
|
||||
//! 老协议 installer（内联 `versionInfo` + universal jar 解包，≈1.12.2 之前的重建版）同样归 unsupported。
|
||||
//!
|
||||
//! OptiFine 仍**认得出但装不了**（[`LoaderKind::from_core`] 返回 `None`）：它要跑外部
|
||||
//! `optifine.Patcher` 并原地改 zip，不在本期（见 `DevDocs/artifacts/m218/SURVEY-p1.md` §3）。
|
||||
|
||||
pub mod fabric;
|
||||
pub mod forge;
|
||||
pub mod liteloader;
|
||||
pub mod maven;
|
||||
pub mod meta;
|
||||
pub mod parent;
|
||||
pub mod plan;
|
||||
pub mod processors;
|
||||
|
||||
@@ -49,6 +55,7 @@ use crate::download::{DownloadError, DownloadErrorKind};
|
||||
/// 支持的加载器种类。
|
||||
///
|
||||
/// `vanilla` / `none` **不在这里**：那是"不装加载器"，由 CLI 走 M27 的原版路径。
|
||||
/// OptiFine 也**不在**这里：它要跑外部 `optifine.Patcher` + 原地改 zip，本启动器仍只识别不安装。
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
|
||||
pub enum LoaderKind {
|
||||
/// Fabric（`meta.fabricmc.net`，纯 meta，无 installer）。
|
||||
@@ -59,6 +66,8 @@ pub enum LoaderKind {
|
||||
NeoForge,
|
||||
/// Forge（`maven.minecraftforge.net`，两代 installer 协议）。
|
||||
Forge,
|
||||
/// LiteLoader（`dl.liteloader.com`，官方版本表 + 从零合成 launchwrapper 清单，无 installer）。
|
||||
LiteLoader,
|
||||
}
|
||||
|
||||
impl LoaderKind {
|
||||
@@ -67,7 +76,7 @@ impl LoaderKind {
|
||||
/// 七个 id 的匹配**委派**给 [`crate::game::LoaderKind::parse`]（词表的源头，M126），
|
||||
/// 本方法只多收一个**输入别名** `neo-forge`：那是 Modrinth 的拼法（mrpack
|
||||
/// `dependencies` 的键、CF 包里也有这种写法），**只进不出**——[`Self::as_str`] 绝不产出
|
||||
/// 它。识别得出但本启动器装不了的几家（原版 / OptiFine / LiteLoader）返回 `None`。
|
||||
/// 它。识别得出但本启动器装不了的（原版 / OptiFine）返回 `None`。
|
||||
#[must_use]
|
||||
pub fn parse(raw: &str) -> Option<Self> {
|
||||
let wanted = raw.trim();
|
||||
@@ -77,7 +86,7 @@ impl LoaderKind {
|
||||
Self::from_core(crate::game::LoaderKind::parse(wanted)?)
|
||||
}
|
||||
|
||||
/// core 的宽种类 → 本模块的四家（`None` = 识别得出但本启动器装不了）。
|
||||
/// core 的宽种类 → 本模块能装的五家（`None` = 识别得出但本启动器装不了）。
|
||||
///
|
||||
/// 穷尽 match：core 加一支就编不过，逼作者决定「它能不能装」。
|
||||
const fn from_core(kind: crate::game::LoaderKind) -> Option<Self> {
|
||||
@@ -86,9 +95,8 @@ impl LoaderKind {
|
||||
crate::game::LoaderKind::Quilt => Some(Self::Quilt),
|
||||
crate::game::LoaderKind::NeoForge => Some(Self::NeoForge),
|
||||
crate::game::LoaderKind::Forge => Some(Self::Forge),
|
||||
crate::game::LoaderKind::Vanilla
|
||||
| crate::game::LoaderKind::OptiFine
|
||||
| crate::game::LoaderKind::LiteLoader => None,
|
||||
crate::game::LoaderKind::LiteLoader => Some(Self::LiteLoader),
|
||||
crate::game::LoaderKind::Vanilla | crate::game::LoaderKind::OptiFine => None,
|
||||
}
|
||||
}
|
||||
|
||||
@@ -105,6 +113,7 @@ impl LoaderKind {
|
||||
Self::Quilt => crate::game::LoaderKind::Quilt.as_str(),
|
||||
Self::NeoForge => crate::game::LoaderKind::NeoForge.as_str(),
|
||||
Self::Forge => crate::game::LoaderKind::Forge.as_str(),
|
||||
Self::LiteLoader => crate::game::LoaderKind::LiteLoader.as_str(),
|
||||
}
|
||||
}
|
||||
|
||||
@@ -116,6 +125,7 @@ impl LoaderKind {
|
||||
Self::Quilt => "Quilt",
|
||||
Self::NeoForge => "NeoForge",
|
||||
Self::Forge => "Forge",
|
||||
Self::LiteLoader => "LiteLoader",
|
||||
}
|
||||
}
|
||||
|
||||
@@ -125,10 +135,25 @@ impl LoaderKind {
|
||||
matches!(self, Self::Fabric | Self::Quilt)
|
||||
}
|
||||
|
||||
/// 是否走 maven 族（installer jar + install profile）。
|
||||
///
|
||||
/// 第三个数据源（LiteLoader）既不是 fabric 系也不是 maven 族，所以这条路**必须显式问**，
|
||||
/// 不能再用「不是 fabric 就是 maven」的二分——那会把 LiteLoader 静默送进 Forge 的 URL 拼装。
|
||||
#[must_use]
|
||||
pub const fn is_maven_family(self) -> bool {
|
||||
matches!(self, Self::NeoForge | Self::Forge)
|
||||
}
|
||||
|
||||
/// 全部加载器（CLI 的 `--loader` 枚举提示用）。
|
||||
#[must_use]
|
||||
pub const fn all() -> &'static [Self] {
|
||||
&[Self::Fabric, Self::Quilt, Self::NeoForge, Self::Forge]
|
||||
&[
|
||||
Self::Fabric,
|
||||
Self::Quilt,
|
||||
Self::NeoForge,
|
||||
Self::Forge,
|
||||
Self::LiteLoader,
|
||||
]
|
||||
}
|
||||
|
||||
/// loader 版本 id 的词根：`<mc>-<kind>-<loader>`（`versions/<id>/` 与实例 `versionId` 都用它）。
|
||||
|
||||
@@ -0,0 +1,64 @@
|
||||
//! 父版本链：把「叠在哪一层上」翻译成原版版本 id（LiteLoader 叠在 Forge 上时要用）。
|
||||
//!
|
||||
//! 加载器层只声明 `inheritsFrom`，客户端 jar、资源索引都在**根**那一层（原版）。所以当用户
|
||||
//! 指定的父版本不是原版（`1.12.2-forge-14.23.5.2860`）时，我们既要记住父版本 id（写进
|
||||
//! 合成清单的 `inheritsFrom`），又要知道根的原版 id（拼 loader 版本 id、定位 jar）。
|
||||
//!
|
||||
//! 判据只有一条：**读盘**。父版本在盘上就必须读得出它的 `inheritsFrom`；读不出来说明父版本
|
||||
//! 压根没装好，这时报错比猜一个原版版本号强（猜错会装出 `inheritsFrom` 指向不存在版本、
|
||||
//! 启动必崩的实例）。沿链走最多 [`MAX_DEPTH`] 跳，成环即报错（与
|
||||
//! [`crate::game::inherit::resolve`] 同口径）。
|
||||
|
||||
use crate::game::layout::GameLayout;
|
||||
use crate::game::manifest::VersionJson;
|
||||
|
||||
use super::LoaderError;
|
||||
|
||||
/// 继承链深度上限（现实里 loader + patch 不超过 5 层）。
|
||||
pub const MAX_DEPTH: usize = 32;
|
||||
|
||||
/// 从盘上的版本 JSON 沿 `inheritsFrom` 走到根，返回根版本 id（原版）。
|
||||
///
|
||||
/// # Errors
|
||||
///
|
||||
/// 版本 JSON 不存在 → `not_found`（父版本还没装）；读不出来 / 成环 → `metadata`。
|
||||
pub fn root_version_id(layout: &GameLayout, version_id: &str) -> Result<String, LoaderError> {
|
||||
let mut chain = vec![version_id.to_string()];
|
||||
let mut current = version_id.to_string();
|
||||
for _ in 0..MAX_DEPTH {
|
||||
let manifest = read_manifest(layout, ¤t)?;
|
||||
match manifest.inherits_from.as_deref().map(str::trim) {
|
||||
Some(parent) if !parent.is_empty() => {
|
||||
if chain.iter().any(|id| id == parent) {
|
||||
chain.push(parent.to_string());
|
||||
return Err(LoaderError::metadata(format!(
|
||||
"父版本链成环：{}",
|
||||
chain.join(" → ")
|
||||
)));
|
||||
}
|
||||
chain.push(parent.to_string());
|
||||
current = parent.to_string();
|
||||
}
|
||||
_ => return Ok(current),
|
||||
}
|
||||
}
|
||||
Err(LoaderError::metadata(format!(
|
||||
"父版本链超过 {MAX_DEPTH} 层，拒绝继续解析：{}",
|
||||
chain.join(" → ")
|
||||
)))
|
||||
}
|
||||
|
||||
/// 读一份版本 JSON；文件不存在时给出「先装父版本」的可执行提示。
|
||||
fn read_manifest(layout: &GameLayout, version_id: &str) -> Result<VersionJson, LoaderError> {
|
||||
let path = layout.version_json(version_id);
|
||||
let text = std::fs::read_to_string(&path).map_err(|error| {
|
||||
LoaderError::not_found(format!(
|
||||
"父版本 {version_id} 还没装好（读不到 {}：{error}）",
|
||||
path.display()
|
||||
))
|
||||
.with_hint("先用同一个父版本装一次它自己的加载器（例如 `install <原版> --loader forge`），再在它上面叠")
|
||||
})?;
|
||||
VersionJson::from_json_str(&text).map_err(|error| {
|
||||
LoaderError::metadata(format!("父版本 {version_id} 的清单解析失败：{error}"))
|
||||
})
|
||||
}
|
||||
@@ -13,7 +13,7 @@ use std::path::PathBuf;
|
||||
use serde_json::{json, Value};
|
||||
|
||||
use super::forge::InstallProfile;
|
||||
use super::LoaderKind;
|
||||
use super::{LoaderError, LoaderKind};
|
||||
use crate::game::arguments::Environment;
|
||||
use crate::game::install::libraries;
|
||||
use crate::game::install::{InstallPlan, PlanFile};
|
||||
@@ -71,17 +71,20 @@ impl LoaderSupport {
|
||||
pub struct LoaderRelease {
|
||||
/// 加载器种类。
|
||||
pub kind: LoaderKind,
|
||||
/// 目标原版版本（`inheritsFrom` 的父版本 id）。
|
||||
/// 目标原版版本（客户端 jar 与资源都在这一层）。
|
||||
pub mc_version: String,
|
||||
/// 加载器自身版本号（`0.15.11` / `47.2.0` / `21.1.80`）。
|
||||
/// **父版本 id**：合成清单的 `inheritsFrom`。默认等于 [`Self::mc_version`]（叠在原版上），
|
||||
/// 叠在别的加载器层上时是那一层的版本 id（`1.12.2-forge-14.23.5.2860`）。
|
||||
pub parent_version_id: String,
|
||||
/// 加载器自身版本号（`0.15.11` / `47.2.0` / `21.1.80` / `1.12.2-SNAPSHOT`）。
|
||||
pub loader_version: String,
|
||||
/// 生成的 loader 版本 id（`1.20.1-fabric-0.15.11`，即 `versions/<id>/` 的目录名）。
|
||||
pub version_id: String,
|
||||
/// loader 版本 JSON（`inheritsFrom` 指向原版）。
|
||||
/// loader 版本 JSON（`inheritsFrom` 指向父版本）。
|
||||
pub version_json: VersionJson,
|
||||
/// 可走哪条路线。
|
||||
pub support: LoaderSupport,
|
||||
/// installer jar 的磁盘路径（M35 执行器的输入；Fabric 系为 `None`）。
|
||||
/// installer jar 的磁盘路径（M35 执行器的输入；Fabric 系与 LiteLoader 为 `None`）。
|
||||
pub installer: Option<PathBuf>,
|
||||
/// installer 里读出来的 install profile（执行器要 `processors` / `data` / `libraries`）。
|
||||
pub install_profile: Option<InstallProfile>,
|
||||
@@ -96,6 +99,12 @@ impl LoaderRelease {
|
||||
self.support.is_installable()
|
||||
}
|
||||
|
||||
/// 父版本是不是原版本身（`false` = 叠在别的加载器层上）。
|
||||
#[must_use]
|
||||
pub fn parent_is_vanilla(&self) -> bool {
|
||||
self.parent_version_id == self.mc_version
|
||||
}
|
||||
|
||||
/// 是否要外调 java 跑 installer processors。
|
||||
#[must_use]
|
||||
pub const fn requires_installer(&self) -> bool {
|
||||
@@ -118,6 +127,7 @@ impl LoaderRelease {
|
||||
"kind": self.kind.as_str(),
|
||||
"label": self.kind.label(),
|
||||
"mc_version": self.mc_version,
|
||||
"parent_version_id": self.parent_version_id,
|
||||
"loader_version": self.loader_version,
|
||||
"version_id": self.version_id,
|
||||
"inherits_from": self.version_json.inherits_from,
|
||||
@@ -138,8 +148,11 @@ pub struct LoaderPlanInput<'a> {
|
||||
pub release: &'a LoaderRelease,
|
||||
/// 规则求值环境（OS / 架构 / 特性开关）。
|
||||
pub environment: &'a Environment,
|
||||
/// 原版的 `versions/<mc>/<mc>.json` 是否已在盘上。
|
||||
pub vanilla_installed: bool,
|
||||
/// **父版本**（[`LoaderRelease::parent_version_id`]）的清单是否已在盘上。
|
||||
///
|
||||
/// 父版本是原版时缺了能自动补装（[`LoaderInstallPlan::vanilla_install_needed`]）；
|
||||
/// 父版本是别的加载器层（Forge）时缺了**直接报错**——我们不能替用户决定装哪一版 Forge。
|
||||
pub parent_installed: bool,
|
||||
}
|
||||
|
||||
/// 加载器安装计划：M27 的 [`InstallPlan`] + 加载器自己的上下文。
|
||||
@@ -162,9 +175,25 @@ impl LoaderInstallPlan {
|
||||
///
|
||||
/// 缺下载地址的库降级成告警（见 [`Self::summary_json`] 的 `warnings`），不硬失败——
|
||||
/// 与 M27「宁可给出可修复的骨架，也不静默假装成功」一致。
|
||||
#[must_use]
|
||||
pub fn build(input: LoaderPlanInput<'_>) -> Self {
|
||||
///
|
||||
/// # Errors
|
||||
///
|
||||
/// 父版本不是原版、而它又没装在盘上时返回 [`LoaderError::not_found`]（具名说清是哪个
|
||||
/// 父版本缺了）。**不能默默回落成叠原版**：那会装出一份和用户意图不同的实例。
|
||||
pub fn build(input: LoaderPlanInput<'_>) -> Result<Self, LoaderError> {
|
||||
let release = input.release;
|
||||
if !input.parent_installed && !release.parent_is_vanilla() {
|
||||
return Err(LoaderError::not_found(format!(
|
||||
"父版本 {} 还没装好：{} {} 要叠在它上面",
|
||||
release.parent_version_id,
|
||||
release.kind.label(),
|
||||
release.loader_version
|
||||
))
|
||||
.with_hint(format!(
|
||||
"先把父版本装上（同一个原版版本先装一次它自己的加载器），再重跑；本次不会替你猜一个 {} 的版本",
|
||||
release.parent_version_id
|
||||
)));
|
||||
}
|
||||
let (files, library_warnings) = libraries::plan(
|
||||
input.layout,
|
||||
&release.version_id,
|
||||
@@ -181,7 +210,7 @@ impl LoaderInstallPlan {
|
||||
if let Some(reason) = release.installer_reason() {
|
||||
warnings.push(format!("需要外调 java 跑 installer processors：{reason}"));
|
||||
}
|
||||
if !input.vanilla_installed {
|
||||
if !input.parent_installed {
|
||||
warnings.push(format!(
|
||||
"原版 {} 尚未安装：执行时会先装原版再叠加载器",
|
||||
release.mc_version
|
||||
@@ -200,11 +229,11 @@ impl LoaderInstallPlan {
|
||||
warnings,
|
||||
};
|
||||
|
||||
Self {
|
||||
Ok(Self {
|
||||
release: release.clone(),
|
||||
install,
|
||||
vanilla_install_needed: !input.vanilla_installed,
|
||||
}
|
||||
vanilla_install_needed: !input.parent_installed && release.parent_is_vanilla(),
|
||||
})
|
||||
}
|
||||
|
||||
/// 计划里的待下载文件。
|
||||
|
||||
@@ -0,0 +1,276 @@
|
||||
//! LiteLoader 数据源与合成：官方版本表（**真实响应的裁剪版**）→ 版本条目 → 合成清单。
|
||||
//!
|
||||
//! 夹具 `LITELOADER_VERSIONS` 是 2026-11 从 `https://dl.liteloader.com/versions/versions.json`
|
||||
//! 真取的一份响应（200 / 49129 字节 / 16 个原版版本）里挑两个原版版本原样留下：
|
||||
//! `1.7.10`（release 分支）+ `1.12.2`（只有 snapshots 分支）。删掉的是另外 14 个原版版本与
|
||||
//! 每个版本下的多余分支；**字段名与结构一个没改**（键仍是 md5、`latest` 别名也留着，用来
|
||||
//! 钉「跳过别名 + 按 version 去重」）。`LITELOADER_METADATA` 是同一次探测里取的
|
||||
//! `repo.mumfrey.com/…/liteloader/1.12.2-SNAPSHOT/maven-metadata.xml`（200 / 358 字节）。
|
||||
|
||||
use crate::addon::loader::liteloader::{
|
||||
build_release, default_entry, find_entry, parse_versions, snapshot_artifact_url, CENTRAL_REPO,
|
||||
};
|
||||
use crate::addon::loader::{LoaderErrorKind, LoaderKind};
|
||||
use crate::game::loader::{InstanceLoader, LoaderKind as Wide};
|
||||
use crate::game::version::ReleaseType;
|
||||
|
||||
/// 真实响应的裁剪版（见文件头）。
|
||||
const LITELOADER_VERSIONS: &str = r#"{
|
||||
"meta": {
|
||||
"description": "LiteLoader is a lightweight mod bootstrap designed to provide basic loader functionality for mods which don't need to modify game mechanics.",
|
||||
"authors": "Mumfrey",
|
||||
"url": "http://dl.liteloader.com",
|
||||
"updated": "2017-11-29T16:31:41+00:00",
|
||||
"updatedTime": 1511973101
|
||||
},
|
||||
"versions": {
|
||||
"1.7.10": {
|
||||
"repo": {"stream": "RELEASE", "type": "ivy", "url": "http://dl.liteloader.com/versions/", "classifier": "mcpnames"},
|
||||
"artefacts": {"com.mumfrey:liteloader": {
|
||||
"63ada46e033d0cb6782bada09ad5ca4e": {
|
||||
"tweakClass": "com.mumfrey.liteloader.launch.LiteLoaderTweaker",
|
||||
"libraries": [{"name": "net.minecraft:launchwrapper:1.11"}, {"name": "org.ow2.asm:asm-all:5.0.3"}],
|
||||
"srcJar": "liteloader-1.7.10_04-mcpnames-sources.jar",
|
||||
"mcpJar": "liteloader-1.7.10_04-mcpnames.jar",
|
||||
"stream": "RELEASE",
|
||||
"file": "liteloader-1.7.10_04.jar",
|
||||
"version": "1.7.10_04",
|
||||
"md5": "63ada46e033d0cb6782bada09ad5ca4e",
|
||||
"timestamp": "1414368553"
|
||||
},
|
||||
"db7235aefd407ac1fde09a7baba50839": {
|
||||
"tweakClass": "com.mumfrey.liteloader.launch.LiteLoaderTweaker",
|
||||
"libraries": [
|
||||
{"name": "net.minecraft:launchwrapper:1.9"},
|
||||
{"name": "org.ow2.asm:asm-all:5.0.3", "url": "http://repo.maven.apache.org/maven2/"}
|
||||
],
|
||||
"stream": "RELEASE",
|
||||
"file": "liteloader-1.7.10_00.jar",
|
||||
"version": "1.7.10_00",
|
||||
"md5": "db7235aefd407ac1fde09a7baba50839",
|
||||
"timestamp": "1404330030"
|
||||
}
|
||||
}}
|
||||
},
|
||||
"1.12.2": {
|
||||
"repo": {"stream": "SNAPSHOT", "type": "m2", "url": "http://repo.mumfrey.com/content/repositories/snapshots/", "classifier": ""},
|
||||
"snapshots": {
|
||||
"libraries": [
|
||||
{"name": "net.minecraft:launchwrapper:1.12"},
|
||||
{"name": "org.spongepowered:mixin:0.7.4-SNAPSHOT", "url": "https://repo.spongepowered.org/maven/"}
|
||||
],
|
||||
"com.mumfrey:liteloader": {
|
||||
"1420785ecbfed5aff4a586c5c9dd97eb": {
|
||||
"tweakClass": "com.mumfrey.liteloader.launch.LiteLoaderTweaker",
|
||||
"libraries": [{"name": "net.minecraft:launchwrapper:1.12"}, {"name": "org.ow2.asm:asm-all:5.2"}],
|
||||
"stream": "SNAPSHOT",
|
||||
"file": "liteloader-1.12.2-SNAPSHOT.jar",
|
||||
"version": "1.12.2-SNAPSHOT",
|
||||
"build": "1.12.2-SNAPSHOT-r4CC2BB0-b4-4",
|
||||
"md5": "1420785ecbfed5aff4a586c5c9dd97eb",
|
||||
"timestamp": "1511880271",
|
||||
"lastSuccessfulBuild": 4
|
||||
},
|
||||
"latest": {
|
||||
"tweakClass": "com.mumfrey.liteloader.launch.LiteLoaderTweaker",
|
||||
"libraries": [{"name": "net.minecraft:launchwrapper:1.12"}, {"name": "org.ow2.asm:asm-all:5.2"}],
|
||||
"stream": "SNAPSHOT",
|
||||
"file": "liteloader-1.12.2-SNAPSHOT.jar",
|
||||
"version": "1.12.2-SNAPSHOT",
|
||||
"md5": "1420785ecbfed5aff4a586c5c9dd97eb",
|
||||
"timestamp": "1511880271",
|
||||
"lastSuccessfulBuild": 4
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}"#;
|
||||
|
||||
/// 同一次探测取的 maven-metadata（真实 358 字节响应的原样）。
|
||||
const LITELOADER_METADATA: &str = r#"<?xml version="1.0" encoding="UTF-8"?>
|
||||
<metadata>
|
||||
<groupId>com.mumfrey</groupId>
|
||||
<artifactId>liteloader</artifactId>
|
||||
<version>1.12.2-SNAPSHOT</version>
|
||||
<versioning>
|
||||
<snapshot>
|
||||
<timestamp>20171128.144431</timestamp>
|
||||
<buildNumber>4</buildNumber>
|
||||
</snapshot>
|
||||
<lastUpdated>20171128144431</lastUpdated>
|
||||
</versioning>
|
||||
</metadata>"#;
|
||||
|
||||
#[test]
|
||||
fn parses_the_real_version_table() {
|
||||
let table = parse_versions(LITELOADER_VERSIONS).expect("真实响应必须能解析");
|
||||
assert_eq!(table.len(), 2, "只留了两个原版版本");
|
||||
|
||||
// release 分支：按 version 去重、新的排前面。
|
||||
let releases = &table["1.7.10"];
|
||||
assert_eq!(
|
||||
releases
|
||||
.iter()
|
||||
.map(|e| e.version.as_str())
|
||||
.collect::<Vec<_>>(),
|
||||
["1.7.10_04", "1.7.10_00"]
|
||||
);
|
||||
// 目录名是**原版**版本（1.7.10），不是 loader 版本（1.7.10_04）。
|
||||
assert_eq!(
|
||||
releases[0].url.as_deref(),
|
||||
Some("https://dl.liteloader.com/versions/com/mumfrey/liteloader/1.7.10/liteloader-1.7.10_04.jar")
|
||||
);
|
||||
assert!(!releases[0].snapshot);
|
||||
|
||||
// 记录级库：没 url 的非 Mojang 库补 Central，Mojang 的库保持默认基址。
|
||||
let names: Vec<&str> = releases[0]
|
||||
.libraries
|
||||
.iter()
|
||||
.map(|library| library.name.as_str())
|
||||
.collect();
|
||||
assert_eq!(
|
||||
names,
|
||||
[
|
||||
"net.minecraft:launchwrapper:1.11",
|
||||
"org.ow2.asm:asm-all:5.0.3"
|
||||
]
|
||||
);
|
||||
assert_eq!(
|
||||
releases[0].libraries[0].url, None,
|
||||
"Mojang 库仓才有 launchwrapper"
|
||||
);
|
||||
assert_eq!(releases[0].libraries[1].url.as_deref(), Some(CENTRAL_REPO));
|
||||
|
||||
// 记录自己写了 url 的，保留但 http → https。
|
||||
assert_eq!(
|
||||
releases[1].libraries[1].url.as_deref(),
|
||||
Some("https://repo.maven.apache.org/maven2/")
|
||||
);
|
||||
|
||||
// snapshot 分支：`latest` 别名跳过，直链留给 maven-metadata 现拼。
|
||||
let snapshots = &table["1.12.2"];
|
||||
assert_eq!(snapshots.len(), 1, "latest 别名不算一个版本");
|
||||
assert!(snapshots[0].snapshot);
|
||||
assert!(snapshots[0].url.is_none());
|
||||
assert_eq!(
|
||||
snapshots[0].snapshot_dir.as_deref(),
|
||||
Some("https://repo.mumfrey.com/content/repositories/snapshots/com/mumfrey/liteloader/1.12.2-SNAPSHOT/")
|
||||
);
|
||||
// 分支级 libraries 里那条 mixin 不该混进记录（那是 ForgeGradle 开发环境用的）。
|
||||
assert!(!snapshots[0]
|
||||
.libraries
|
||||
.iter()
|
||||
.any(|library| library.name.contains("mixin")));
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn snapshot_url_comes_from_maven_metadata() {
|
||||
let table = parse_versions(LITELOADER_VERSIONS).expect("解析");
|
||||
let entry = &table["1.12.2"][0];
|
||||
assert_eq!(
|
||||
snapshot_artifact_url(entry, LITELOADER_METADATA).expect("应拼得出直链"),
|
||||
"https://repo.mumfrey.com/content/repositories/snapshots/com/mumfrey/liteloader/1.12.2-SNAPSHOT/liteloader-1.12.2-20171128.144431-4-release.jar"
|
||||
);
|
||||
|
||||
// 缺 <buildNumber>：报错，不猜一个指向 404 的直链。
|
||||
let broken = LITELOADER_METADATA.replace("<buildNumber>4</buildNumber>", "");
|
||||
let error = snapshot_artifact_url(entry, &broken).expect_err("缺字段必须报错");
|
||||
assert_eq!(error.kind(), LoaderErrorKind::Metadata);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn build_release_synthesizes_launchwrapper_manifest() {
|
||||
let table = parse_versions(LITELOADER_VERSIONS).expect("解析");
|
||||
let entry = find_entry(&table["1.12.2"], "1.12.2-snapshot").expect("版本号大小写不敏感");
|
||||
let url = snapshot_artifact_url(entry, LITELOADER_METADATA).expect("直链");
|
||||
let release = build_release("1.12.2", "1.12.2", entry, &url).expect("合成");
|
||||
|
||||
assert_eq!(release.version_id, "1.12.2-liteloader-1.12.2-SNAPSHOT");
|
||||
let json = &release.version_json;
|
||||
assert_eq!(
|
||||
json.main_class.as_deref(),
|
||||
Some("net.minecraft.launchwrapper.Launch")
|
||||
);
|
||||
// 父子链靠 arguments.game 追加，不写 minecraftArguments（写了会顶掉 Forge 的 tweakClass）。
|
||||
assert!(json.minecraft_arguments.is_none());
|
||||
let game: Vec<&str> = json
|
||||
.arguments
|
||||
.as_ref()
|
||||
.expect("arguments 必须有")
|
||||
.expand(&Default::default())
|
||||
.game;
|
||||
assert_eq!(
|
||||
game,
|
||||
[
|
||||
"--tweakClass",
|
||||
"com.mumfrey.liteloader.launch.LiteLoaderTweaker"
|
||||
]
|
||||
);
|
||||
assert_eq!(json.inherits_from.as_deref(), Some("1.12.2"));
|
||||
assert_eq!(json.jar.as_deref(), Some("1.12.2"), "jar 恒在原版那层");
|
||||
assert_eq!(json.version_type, Some(ReleaseType::Snapshot));
|
||||
|
||||
// 本体 jar 那一条：绝对直链 + maven 坐标（快照路径与坐标不一致，所以必须给 url）。
|
||||
let loader = json
|
||||
.libraries
|
||||
.as_ref()
|
||||
.expect("libraries")
|
||||
.iter()
|
||||
.find(|library| library.name == "com.mumfrey:liteloader:1.12.2-SNAPSHOT")
|
||||
.expect("缺本体库");
|
||||
assert_eq!(
|
||||
loader
|
||||
.downloads
|
||||
.as_ref()
|
||||
.and_then(|downloads| downloads.artifact.as_ref())
|
||||
.and_then(|artifact| artifact.url.as_deref()),
|
||||
Some(url.as_str())
|
||||
);
|
||||
assert!(!release.requires_installer(), "LiteLoader 不跑任何外部进程");
|
||||
assert!(release.warnings.is_empty(), "{:?}", release.warnings);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn synthesized_version_id_parses_back_to_liteloader() {
|
||||
for (mc, loader_version) in [("1.12.2", "1.12.2-SNAPSHOT"), ("1.7.10", "1.7.10_04")] {
|
||||
let id = LoaderKind::LiteLoader.version_id(mc, loader_version);
|
||||
let parsed = InstanceLoader::parse(&id);
|
||||
assert_eq!(parsed.kind, Wide::LiteLoader, "`{id}` 认错了家");
|
||||
assert_eq!(parsed.version, loader_version, "`{id}` 的版本段");
|
||||
}
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn missing_tweak_class_is_a_metadata_error() {
|
||||
let table = parse_versions(LITELOADER_VERSIONS).expect("解析");
|
||||
let mut entry = table["1.7.10"][0].clone();
|
||||
entry.tweak_class = " ".to_string();
|
||||
let error = build_release("1.7.10", "1.7.10", &entry, "https://example.invalid/x.jar")
|
||||
.expect_err("缺 tweakClass 必须报错");
|
||||
assert_eq!(error.kind(), LoaderErrorKind::Metadata);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn default_entry_prefers_release_builds() {
|
||||
let table = parse_versions(LITELOADER_VERSIONS).expect("解析");
|
||||
// 1.7.10 只有 release：取最新那条。
|
||||
assert_eq!(
|
||||
default_entry(&table["1.7.10"]).map(|entry| entry.version.as_str()),
|
||||
Some("1.7.10_04")
|
||||
);
|
||||
// 1.12.2 只有快照：没有 release 可选时退回最新。
|
||||
assert_eq!(
|
||||
default_entry(&table["1.12.2"]).map(|entry| entry.version.as_str()),
|
||||
Some("1.12.2-SNAPSHOT")
|
||||
);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn unknown_version_does_not_fall_back() {
|
||||
let table = parse_versions(LITELOADER_VERSIONS).expect("解析");
|
||||
assert!(find_entry(&table["1.7.10"], "1.7.10_99").is_none());
|
||||
// 形状不符的表（顶层不是 versions）也要报 metadata，而不是当空表。
|
||||
let error = parse_versions(r#"{"versions": []}"#).expect_err("形状不符必须报错");
|
||||
assert_eq!(error.kind(), LoaderErrorKind::Metadata);
|
||||
}
|
||||
@@ -75,10 +75,13 @@ fn forge_versions_carry_the_minecraft_prefix() {
|
||||
fn neoforge_1201_uses_forge_layout() {
|
||||
// 1.20.1 的 NeoForge 早产版挂在 net/neoforged/forge 下，版本串带原版前缀。
|
||||
assert!(metadata_url(LoaderKind::NeoForge, "1.20.1")
|
||||
.expect("maven 族应有地址")
|
||||
.ends_with("net/neoforged/forge/maven-metadata.xml"));
|
||||
assert!(metadata_url(LoaderKind::NeoForge, "1.21.1")
|
||||
.expect("maven 族应有地址")
|
||||
.ends_with("net/neoforged/neoforge/maven-metadata.xml"));
|
||||
assert!(metadata_url(LoaderKind::Forge, "1.20.1")
|
||||
.expect("maven 族应有地址")
|
||||
.ends_with("net/minecraftforge/forge/maven-metadata.xml"));
|
||||
|
||||
let versions = vec!["1.20.1-47.1.106".to_string(), "1.20.1-47.1.90".to_string()];
|
||||
@@ -119,16 +122,16 @@ fn versions_are_normalized_and_displayed() {
|
||||
#[test]
|
||||
fn installer_urls_point_at_official_maven() {
|
||||
assert_eq!(
|
||||
installer_url(LoaderKind::Forge, "1.20.1", "1.20.1-47.2.0"),
|
||||
installer_url(LoaderKind::Forge, "1.20.1", "1.20.1-47.2.0").expect("maven 族应有地址"),
|
||||
"https://maven.minecraftforge.net/net/minecraftforge/forge/1.20.1-47.2.0/forge-1.20.1-47.2.0-installer.jar"
|
||||
);
|
||||
assert_eq!(
|
||||
installer_url(LoaderKind::NeoForge, "1.21.1", "21.1.80"),
|
||||
installer_url(LoaderKind::NeoForge, "1.21.1", "21.1.80").expect("maven 族应有地址"),
|
||||
"https://maven.neoforged.net/releases/net/neoforged/neoforge/21.1.80/neoforge-21.1.80-installer.jar"
|
||||
);
|
||||
// 1.20.1 的 NeoForge 走 forge 布局（文件名也是 forge-）。
|
||||
assert_eq!(
|
||||
installer_url(LoaderKind::NeoForge, "1.20.1", "1.20.1-47.1.106"),
|
||||
installer_url(LoaderKind::NeoForge, "1.20.1", "1.20.1-47.1.106").expect("maven 族应有地址"),
|
||||
"https://maven.neoforged.net/releases/net/neoforged/forge/1.20.1-47.1.106/forge-1.20.1-47.1.106-installer.jar"
|
||||
);
|
||||
}
|
||||
@@ -5,6 +5,7 @@
|
||||
|
||||
mod fabric;
|
||||
mod forge;
|
||||
mod liteloader;
|
||||
mod maven;
|
||||
mod plan;
|
||||
mod vocabulary;
|
||||
|
||||
@@ -36,8 +36,9 @@ fn plan_contains_only_loader_libraries() {
|
||||
layout: &layout,
|
||||
release: &release,
|
||||
environment: &environment(),
|
||||
vanilla_installed: false,
|
||||
});
|
||||
parent_installed: false,
|
||||
})
|
||||
.expect("计划应可组");
|
||||
|
||||
assert_eq!(plan.install.version_id, "1.20.1-fabric-0.15.11");
|
||||
// jar 与资源归原版层，loader 计划里只有库。
|
||||
@@ -71,8 +72,9 @@ fn plan_marks_missing_vanilla_and_unsupported() {
|
||||
layout: &layout,
|
||||
release: &release,
|
||||
environment: &environment(),
|
||||
vanilla_installed: false,
|
||||
});
|
||||
parent_installed: false,
|
||||
})
|
||||
.expect("计划应可组");
|
||||
assert!(plan.vanilla_install_needed);
|
||||
assert!(plan
|
||||
.warnings()
|
||||
@@ -83,8 +85,9 @@ fn plan_marks_missing_vanilla_and_unsupported() {
|
||||
layout: &layout,
|
||||
release: &release,
|
||||
environment: &environment(),
|
||||
vanilla_installed: true,
|
||||
});
|
||||
parent_installed: true,
|
||||
})
|
||||
.expect("计划应可组");
|
||||
assert!(!installed.vanilla_install_needed);
|
||||
|
||||
// 把 support 改成"需要 installer"，计划里要出现"要外调 java"的告警（M35 起可真装）。
|
||||
@@ -96,8 +99,9 @@ fn plan_marks_missing_vanilla_and_unsupported() {
|
||||
layout: &layout,
|
||||
release: &blocked,
|
||||
environment: &environment(),
|
||||
vanilla_installed: true,
|
||||
});
|
||||
parent_installed: true,
|
||||
})
|
||||
.expect("计划应可组");
|
||||
assert!(plan
|
||||
.warnings()
|
||||
.iter()
|
||||
@@ -112,8 +116,9 @@ fn summary_json_carries_loader_block() {
|
||||
layout: &layout,
|
||||
release: &release,
|
||||
environment: &environment(),
|
||||
vanilla_installed: true,
|
||||
});
|
||||
parent_installed: true,
|
||||
})
|
||||
.expect("计划应可组");
|
||||
let summary = plan.summary_json();
|
||||
assert_eq!(summary["loader"]["kind"], "fabric");
|
||||
assert_eq!(summary["loader"]["version_id"], "1.20.1-fabric-0.15.11");
|
||||
@@ -170,14 +175,15 @@ fn loader_meta_and_maven_urls_hit_bmclapi_mirrors() {
|
||||
assert_eq!(candidates[0].source, "bmclapi");
|
||||
assert!(candidates[0].url.contains("/quilt-meta/"));
|
||||
|
||||
let neoforge_installer = maven::installer_url(LoaderKind::NeoForge, "1.21.1", "21.1.80");
|
||||
let neoforge_installer =
|
||||
maven::installer_url(LoaderKind::NeoForge, "1.21.1", "21.1.80").expect("maven 族应有地址");
|
||||
let candidates = table.expand(&neoforge_installer, ResourceKind::Library, &mirror_first);
|
||||
assert_eq!(candidates[0].source, "bmclapi");
|
||||
assert!(candidates[0]
|
||||
.url
|
||||
.starts_with("https://bmclapi2.bangbang93.com/maven/net/neoforged/neoforge/"));
|
||||
|
||||
let forge_meta = maven::metadata_url(LoaderKind::Forge, "1.20.1");
|
||||
let forge_meta = maven::metadata_url(LoaderKind::Forge, "1.20.1").expect("maven 族应有地址");
|
||||
let candidates = table.expand(&forge_meta, ResourceKind::VersionManifest, &mirror_first);
|
||||
assert_eq!(candidates[0].source, "bmclapi");
|
||||
assert!(candidates[0]
|
||||
|
||||
@@ -8,7 +8,7 @@
|
||||
use crate::addon::loader::LoaderKind;
|
||||
use crate::game::{InstanceLoader, LoaderKind as Wide};
|
||||
|
||||
/// `as_str` 是 core 词表的委派：四家装得上的一一对应，且绝不产出别名。
|
||||
/// `as_str` 是 core 词表的委派：五家装得上的一一对应，且绝不产出别名。
|
||||
///
|
||||
/// 抓得住：委派接错支（`Fabric` 映到 `Quilt`）；有人把 `as_str` 改回手写字面量并写错；
|
||||
/// 有人让 `as_str` 产出 `neo-forge`（别名只进不出）；生成端 `<mc>-<kind>-<loader>` 与解析端
|
||||
@@ -21,6 +21,7 @@ fn install_side_ids_are_delegated_to_the_core_vocabulary() {
|
||||
(LoaderKind::Quilt, Wide::Quilt),
|
||||
(LoaderKind::NeoForge, Wide::NeoForge),
|
||||
(LoaderKind::Forge, Wide::Forge),
|
||||
(LoaderKind::LiteLoader, Wide::LiteLoader),
|
||||
];
|
||||
for (install, wide) in cases {
|
||||
assert_eq!(
|
||||
@@ -41,7 +42,7 @@ fn install_side_ids_are_delegated_to_the_core_vocabulary() {
|
||||
/// 别名策略：`neo-forge` 只作为**输入**被接受（Modrinth 的拼法），产出永远是 `neoforge`。
|
||||
///
|
||||
/// 抓得住：别名被搬进词表（`as_str` 开始产出 `neo-forge`）；别名只认小写；安装侧顺手接受了
|
||||
/// 本启动器装不了的几家（原版 / OptiFine / LiteLoader）。
|
||||
/// 本启动器装不了的几家（原版 / OptiFine）。
|
||||
/// 抓不住：`neo-forge` 之外 Modrinth 以后可能再发明的拼法——没有样本可写。
|
||||
#[test]
|
||||
fn modrinth_alias_is_input_only() {
|
||||
@@ -57,7 +58,7 @@ fn modrinth_alias_is_input_only() {
|
||||
"neoforge",
|
||||
"产出不许带连字符"
|
||||
);
|
||||
for raw in ["vanilla", "optifine", "liteloader", "", "rift"] {
|
||||
for raw in ["vanilla", "optifine", "", "rift"] {
|
||||
assert_eq!(LoaderKind::parse(raw), None, "`{raw}` 不该被安装侧接受");
|
||||
}
|
||||
}
|
||||
|
||||
@@ -11,7 +11,7 @@
|
||||
//! 器」的地方一律调 [`InstanceLoader::parse`]，**不许**再写一份标记匹配。生成端
|
||||
//! （[`crate::addon::loader::LoaderKind::version_id`] 拼 `<mc>-<kind>-<loader>`）与解析端的一致
|
||||
//! 性由 [`tests::own_version_ids_parse_back_to_their_loader`] 钉住（**从生成端取 id**，不手抄）；
|
||||
//! OptiFine / LiteLoader 本启动器不能装（见 `presenter::host::install`），只能继承进来。
|
||||
//! OptiFine 本启动器不能装（见 `presenter::host::install`），只能继承进来；LiteLoader 自 M222 起有安装路线。
|
||||
//!
|
||||
//! # 命名词表只有一张表（M126）
|
||||
//!
|
||||
@@ -125,7 +125,7 @@ loader_kind_vocab! {
|
||||
Forge => "forge", marker;
|
||||
/// OptiFine（第三方，本启动器不装，只继承）
|
||||
OptiFine => "optifine", marker;
|
||||
/// LiteLoader（第三方，本启动器不装，只继承）
|
||||
/// LiteLoader（自 M222 起可装：官方版本表 + 从零合成 launchwrapper 清单）
|
||||
LiteLoader => "liteloader", marker;
|
||||
}
|
||||
}
|
||||
|
||||
@@ -0,0 +1,20 @@
|
||||
//! LiteLoader 安装链路的集成测试（`tests/liteloader*` 这个 test target 的入口）。
|
||||
//!
|
||||
//! 判据链：**真实元数据夹具 → 解析 → 合成清单 → 计划 → 落盘 → 继承解析 → 启动参数顺序**。
|
||||
//! 全程不联网：LiteLoader 的库没有 sha1/size，`execute` 的跳过判据是「存在即信」，
|
||||
//! 所以先把每个待下文件按计划里的落点写一份占位字节，执行期就只做「跳过 + 写版本 JSON」。
|
||||
//!
|
||||
//! 夹具来源（可追溯）：
|
||||
//! - `fixtures/liteloader-versions.json` = 2026-11 从 `https://dl.liteloader.com/versions/versions.json`
|
||||
//! 真取的响应（200 / 49129 字节 / 16 个原版版本）裁剪到两个原版版本，**字段名与嵌套结构原样**；
|
||||
//! - `metadata.xml` = 同一次探测里 `repo.mumfrey.com/…/liteloader/1.12.2-SNAPSHOT/maven-metadata.xml`
|
||||
//! 的原样响应（200 / 358 字节）；
|
||||
//! - 原版 / Forge 1.12.2 的版本 JSON 是按官方清单形状写的最小夹具（Forge 那侧的
|
||||
//! `minecraftArguments` 与 `crates/core/src/addon/loader/tests/forge.rs` 的实测夹具一致）。
|
||||
//!
|
||||
//! 未覆盖（如实留档）：真实下载（走 `core::download` 引擎的镜像/退避，已有 M13 的单测覆盖）、
|
||||
//! 真实 MC 启动、`dl.liteloader.com` / `repo.mumfrey.com` 的持续可用性。
|
||||
|
||||
mod guards;
|
||||
mod install;
|
||||
mod support;
|
||||
@@ -0,0 +1,98 @@
|
||||
{
|
||||
"meta": {
|
||||
"description": "LiteLoader is a lightweight mod bootstrap designed to provide basic loader functionality for mods which don't need to modify game mechanics.",
|
||||
"authors": "Mumfrey",
|
||||
"url": "http://dl.liteloader.com",
|
||||
"updated": "2017-11-29T16:31:41+00:00",
|
||||
"updatedTime": 1511973101
|
||||
},
|
||||
"versions": {
|
||||
"1.7.10": {
|
||||
"repo": {
|
||||
"stream": "RELEASE",
|
||||
"type": "ivy",
|
||||
"url": "http://dl.liteloader.com/versions/",
|
||||
"classifier": "mcpnames"
|
||||
},
|
||||
"artefacts": {
|
||||
"com.mumfrey:liteloader": {
|
||||
"63ada46e033d0cb6782bada09ad5ca4e": {
|
||||
"tweakClass": "com.mumfrey.liteloader.launch.LiteLoaderTweaker",
|
||||
"libraries": [
|
||||
{ "name": "net.minecraft:launchwrapper:1.11" },
|
||||
{ "name": "org.ow2.asm:asm-all:5.0.3" }
|
||||
],
|
||||
"srcJar": "liteloader-1.7.10_04-mcpnames-sources.jar",
|
||||
"mcpJar": "liteloader-1.7.10_04-mcpnames.jar",
|
||||
"stream": "RELEASE",
|
||||
"file": "liteloader-1.7.10_04.jar",
|
||||
"version": "1.7.10_04",
|
||||
"md5": "63ada46e033d0cb6782bada09ad5ca4e",
|
||||
"timestamp": "1414368553"
|
||||
},
|
||||
"db7235aefd407ac1fde09a7baba50839": {
|
||||
"tweakClass": "com.mumfrey.liteloader.launch.LiteLoaderTweaker",
|
||||
"libraries": [
|
||||
{ "name": "net.minecraft:launchwrapper:1.9" },
|
||||
{
|
||||
"name": "org.ow2.asm:asm-all:5.0.3",
|
||||
"url": "http://repo.maven.apache.org/maven2/"
|
||||
}
|
||||
],
|
||||
"stream": "RELEASE",
|
||||
"file": "liteloader-1.7.10_00.jar",
|
||||
"version": "1.7.10_00",
|
||||
"md5": "db7235aefd407ac1fde09a7baba50839",
|
||||
"timestamp": "1404330030"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"1.12.2": {
|
||||
"repo": {
|
||||
"stream": "SNAPSHOT",
|
||||
"type": "m2",
|
||||
"url": "http://repo.mumfrey.com/content/repositories/snapshots/",
|
||||
"classifier": ""
|
||||
},
|
||||
"snapshots": {
|
||||
"libraries": [
|
||||
{ "name": "net.minecraft:launchwrapper:1.12" },
|
||||
{
|
||||
"name": "org.spongepowered:mixin:0.7.4-SNAPSHOT",
|
||||
"url": "https://repo.spongepowered.org/maven/"
|
||||
}
|
||||
],
|
||||
"com.mumfrey:liteloader": {
|
||||
"1420785ecbfed5aff4a586c5c9dd97eb": {
|
||||
"tweakClass": "com.mumfrey.liteloader.launch.LiteLoaderTweaker",
|
||||
"libraries": [
|
||||
{ "name": "net.minecraft:launchwrapper:1.12" },
|
||||
{ "name": "org.ow2.asm:asm-all:5.2" }
|
||||
],
|
||||
"stream": "SNAPSHOT",
|
||||
"file": "liteloader-1.12.2-SNAPSHOT.jar",
|
||||
"version": "1.12.2-SNAPSHOT",
|
||||
"build": "1.12.2-SNAPSHOT-r4CC2BB0-b4-4",
|
||||
"md5": "1420785ecbfed5aff4a586c5c9dd97eb",
|
||||
"timestamp": "1511880271",
|
||||
"lastSuccessfulBuild": 4
|
||||
},
|
||||
"latest": {
|
||||
"tweakClass": "com.mumfrey.liteloader.launch.LiteLoaderTweaker",
|
||||
"libraries": [
|
||||
{ "name": "net.minecraft:launchwrapper:1.12" },
|
||||
{ "name": "org.ow2.asm:asm-all:5.2" }
|
||||
],
|
||||
"stream": "SNAPSHOT",
|
||||
"file": "liteloader-1.12.2-SNAPSHOT.jar",
|
||||
"version": "1.12.2-SNAPSHOT",
|
||||
"md5": "1420785ecbfed5aff4a586c5c9dd97eb",
|
||||
"timestamp": "1511880271",
|
||||
"lastSuccessfulBuild": 4
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,157 @@
|
||||
//! 边界与失败面：父版本缺失、组合不支持、数据源形状坏、取消。
|
||||
//!
|
||||
//! 网络层的失败映射（`DownloadError` → `loader_network`）由 `core::download` 的引擎测试
|
||||
//! 与既有加载器测试覆盖，这里**不联网**：外部源的真实可用性在 mission 报告里单独列
|
||||
//! （含探测结果），不混进单元测试冒充。
|
||||
|
||||
use std::sync::atomic::AtomicBool;
|
||||
|
||||
use unlucky_core::addon::loader::liteloader::parse_versions;
|
||||
use unlucky_core::addon::loader::{
|
||||
LoaderErrorKind, LoaderInstallPlan, LoaderKind, LoaderPlanInput, LoaderSource,
|
||||
};
|
||||
use unlucky_core::download::blocking::block_on;
|
||||
use unlucky_core::game::arguments::Environment;
|
||||
use unlucky_core::game::inherit::resolve;
|
||||
use unlucky_core::game::install::{execute_with_cancel, InstallErrorKind};
|
||||
use unlucky_core::game::layout::GameLayout;
|
||||
|
||||
use crate::support::{
|
||||
engine, liteloader_release, prefill, put_version, read_version, TempDir, VANILLA_1122,
|
||||
};
|
||||
|
||||
/// 父版本不是原版、又没装在盘上 → **具名报错**，绝不默默改成叠原版。
|
||||
#[test]
|
||||
fn missing_loader_parent_is_a_named_error() {
|
||||
let temp = TempDir::new("missing-parent");
|
||||
let layout = GameLayout::new(temp.path());
|
||||
put_version(&layout, "1.12.2", VANILLA_1122);
|
||||
let release = liteloader_release("1.12.2-forge-14.23.5.2860");
|
||||
|
||||
let error = LoaderInstallPlan::build(LoaderPlanInput {
|
||||
layout: &layout,
|
||||
release: &release,
|
||||
environment: &Environment::host(),
|
||||
parent_installed: false,
|
||||
})
|
||||
.expect_err("父版本缺失必须报错");
|
||||
assert_eq!(error.kind(), LoaderErrorKind::NotFound);
|
||||
assert!(
|
||||
error.message().contains("1.12.2-forge-14.23.5.2860"),
|
||||
"错误里要点名缺的是哪个父版本：{}",
|
||||
error.message()
|
||||
);
|
||||
assert!(error.hint().is_some(), "要给出下一步怎么办");
|
||||
}
|
||||
|
||||
/// 父版本链：读盘定位原版版本 id（合成 loader id / 定位 jar 都用它）。
|
||||
#[test]
|
||||
fn parent_chain_walks_to_the_vanilla_root() {
|
||||
let temp = TempDir::new("parent-chain");
|
||||
let layout = GameLayout::new(temp.path());
|
||||
put_version(&layout, "1.12.2", VANILLA_1122);
|
||||
put_version(
|
||||
&layout,
|
||||
"1.12.2-forge-14.23.5.2860",
|
||||
crate::support::FORGE_1122,
|
||||
);
|
||||
|
||||
assert_eq!(
|
||||
unlucky_core::addon::loader::parent::root_version_id(&layout, "1.12.2-forge-14.23.5.2860")
|
||||
.expect("两层链应走得到根"),
|
||||
"1.12.2"
|
||||
);
|
||||
assert_eq!(
|
||||
unlucky_core::addon::loader::parent::root_version_id(&layout, "1.12.2").expect("根是自己"),
|
||||
"1.12.2"
|
||||
);
|
||||
|
||||
// 没装的父版本 → not_found（而不是猜一个原版版本号）。
|
||||
let error = unlucky_core::addon::loader::parent::root_version_id(&layout, "9.9.9-forge-1.0.0")
|
||||
.expect_err("缺父版本必须报错");
|
||||
assert_eq!(error.kind(), LoaderErrorKind::NotFound);
|
||||
}
|
||||
|
||||
/// 只有 LiteLoader 接受「父版本不是原版」；别家**具名拒绝**，不去发请求。
|
||||
#[test]
|
||||
fn only_liteloader_accepts_a_non_vanilla_parent() {
|
||||
let temp = TempDir::new("combo-guard");
|
||||
let engine = engine(temp.path());
|
||||
let source = LoaderSource::new(&engine, temp.path());
|
||||
let error = block_on(async {
|
||||
source
|
||||
.resolve_on(
|
||||
LoaderKind::Forge,
|
||||
"1.12.2",
|
||||
Some("14.23.5.2860"),
|
||||
Some("1.12.2-liteloader-1.12.2-SNAPSHOT"),
|
||||
)
|
||||
.await
|
||||
})
|
||||
.expect_err("Forge 叠在 LiteLoader 上必须被拒");
|
||||
assert_eq!(error.kind(), LoaderErrorKind::Unsupported);
|
||||
assert!(
|
||||
error
|
||||
.message()
|
||||
.contains("1.12.2-liteloader-1.12.2-SNAPSHOT"),
|
||||
"要说清是哪个组合：{}",
|
||||
error.message()
|
||||
);
|
||||
}
|
||||
|
||||
/// 版本表形状坏 / 空表：各自给具名大类，不当成「没有版本」糊过去。
|
||||
#[test]
|
||||
fn broken_version_table_is_reported_distinctly() {
|
||||
let shape = parse_versions(r#"{"versions": []}"#).expect_err("形状不符");
|
||||
assert_eq!(shape.kind(), LoaderErrorKind::Metadata);
|
||||
let empty = parse_versions(r#"{"meta": {}, "versions": {}}"#).expect_err("空表");
|
||||
assert_eq!(empty.kind(), LoaderErrorKind::NotFound);
|
||||
|
||||
// 版本段缺失（记录没有 version）：只剩 latest 别名 → 仍当空表处理。
|
||||
let only_latest = r#"{"versions": {"1.7.10": {"artefacts": {"com.mumfrey:liteloader":
|
||||
{"latest": {"tweakClass": "x", "version": "", "file": "liteloader.jar"}}}}}}"#;
|
||||
let error = parse_versions(only_latest).expect_err("只有 http 别名时没有可用版本");
|
||||
assert_eq!(error.kind(), LoaderErrorKind::NotFound);
|
||||
}
|
||||
|
||||
/// 取消：执行段看标志就返回 `Cancelled`，**版本 JSON 不落盘**（不留半成品）。
|
||||
#[test]
|
||||
fn cancel_leaves_no_manifest() {
|
||||
let temp = TempDir::new("cancel");
|
||||
let layout = GameLayout::new(temp.path());
|
||||
put_version(&layout, "1.12.2", VANILLA_1122);
|
||||
let release = liteloader_release("1.12.2");
|
||||
let plan = LoaderInstallPlan::build(LoaderPlanInput {
|
||||
layout: &layout,
|
||||
release: &release,
|
||||
environment: &Environment::host(),
|
||||
parent_installed: true,
|
||||
})
|
||||
.expect("计划应可组");
|
||||
|
||||
let engine = engine(temp.path());
|
||||
prefill(&plan.install);
|
||||
let cancel = AtomicBool::new(true);
|
||||
let error = block_on(execute_with_cancel(
|
||||
&engine,
|
||||
&plan.install,
|
||||
4,
|
||||
None,
|
||||
Some(&cancel),
|
||||
))
|
||||
.expect_err("取消必须返回错误");
|
||||
assert_eq!(error.kind(), InstallErrorKind::Cancelled);
|
||||
assert!(
|
||||
!layout.version_json(&release.version_id).exists(),
|
||||
"取消之后不许留下版本清单"
|
||||
);
|
||||
|
||||
// 继承链在缺清单时也应明确报「父版本缺失」，而不是静默降级成原版。
|
||||
let mut source = std::collections::BTreeMap::new();
|
||||
source.insert("1.12.2".to_string(), read_version(&layout, "1.12.2"));
|
||||
let error = resolve(&source, &release.version_json).expect_err("父版本缺失");
|
||||
assert!(matches!(
|
||||
error,
|
||||
unlucky_core::game::GameError::MissingParent { .. }
|
||||
));
|
||||
}
|
||||
@@ -0,0 +1,174 @@
|
||||
//! 解析 → 计划 → 落盘 → 继承解析 → 启动参数顺序（两条父链：原版 / Forge）。
|
||||
|
||||
use unlucky_core::addon::loader::{LoaderInstallPlan, LoaderKind, LoaderPlanInput};
|
||||
use unlucky_core::download::blocking::block_on;
|
||||
use unlucky_core::game::arguments::Environment;
|
||||
use unlucky_core::game::inherit::resolve;
|
||||
use unlucky_core::game::install::execute;
|
||||
use unlucky_core::game::layout::GameLayout;
|
||||
use unlucky_core::launch::command_builder::tokenize;
|
||||
|
||||
use crate::support::{
|
||||
engine, liteloader_release, prefill, put_version, read_version, TempDir, FORGE_1122,
|
||||
VANILLA_1122,
|
||||
};
|
||||
|
||||
/// 原版父链：装完能落盘，清单指向原版，`arguments.game` 带 tweakClass。
|
||||
#[test]
|
||||
fn installs_over_vanilla_and_writes_the_manifest() {
|
||||
let temp = TempDir::new("vanilla");
|
||||
let layout = GameLayout::new(temp.path());
|
||||
put_version(&layout, "1.12.2", VANILLA_1122);
|
||||
|
||||
let release = liteloader_release("1.12.2");
|
||||
assert_eq!(release.version_id, "1.12.2-liteloader-1.12.2-SNAPSHOT");
|
||||
let plan = LoaderInstallPlan::build(LoaderPlanInput {
|
||||
layout: &layout,
|
||||
release: &release,
|
||||
environment: &Environment::host(),
|
||||
parent_installed: true,
|
||||
})
|
||||
.expect("父版本已装，计划应可组");
|
||||
assert!(!plan.vanilla_install_needed);
|
||||
assert!(plan.install.client_jar().is_none(), "jar 归原版层");
|
||||
|
||||
// 三个库：launchwrapper（Mojang 库仓）+ asm-all（Central）+ 本体 jar（官方直链）。
|
||||
let names: Vec<&str> = plan.files().iter().map(|file| file.name.as_str()).collect();
|
||||
assert_eq!(names.len(), 3, "{names:?}");
|
||||
let loader_jar = plan
|
||||
.files()
|
||||
.iter()
|
||||
.find(|file| file.name == "com.mumfrey:liteloader:1.12.2-SNAPSHOT")
|
||||
.expect("缺本体 jar");
|
||||
assert!(
|
||||
loader_jar
|
||||
.url
|
||||
.ends_with("/1.12.2-SNAPSHOT/liteloader-1.12.2-20171128.144431-4-release.jar"),
|
||||
"本体直链：{}",
|
||||
loader_jar.url
|
||||
);
|
||||
let asm = plan
|
||||
.files()
|
||||
.iter()
|
||||
.find(|file| file.name.contains("asm-all"))
|
||||
.expect("缺 asm-all");
|
||||
assert!(
|
||||
asm.url.starts_with("https://repo1.maven.org/maven2/"),
|
||||
"asm-all 只能从 Central 取：{}",
|
||||
asm.url
|
||||
);
|
||||
|
||||
// 全部落点先铺好占位文件（库无 sha1/size → 存在即信），执行段只写版本 JSON。
|
||||
let engine = engine(temp.path());
|
||||
let prefilled = prefill(&plan.install);
|
||||
assert_eq!(prefilled, 3);
|
||||
let report = block_on(execute(&engine, &plan.install, 4, None)).expect("执行应成功");
|
||||
assert!(report.is_complete(), "{:?}", report.failures(3));
|
||||
|
||||
let written = read_version(&layout, &release.version_id);
|
||||
assert_eq!(written.inherits_from.as_deref(), Some("1.12.2"));
|
||||
assert_eq!(
|
||||
written.main_class.as_deref(),
|
||||
Some("net.minecraft.launchwrapper.Launch")
|
||||
);
|
||||
assert!(
|
||||
written.minecraft_arguments.is_none(),
|
||||
"loader 层不许写 minecraftArguments：那会顶掉父链"
|
||||
);
|
||||
}
|
||||
|
||||
/// Forge 父链：**父链的 FMLTweaker 必须还在**，LiteLoader 的 tweakClass 追加在它后面。
|
||||
///
|
||||
/// 这条是 M218 SURVEY-p1 的「准入条件」：靠 `--tweakClass` 生效，就要求继承时
|
||||
/// `arguments.game` 是追加、`minecraftArguments` 不被子层覆盖。启动参数顺序照
|
||||
/// `core::launch::game_args` 的第 24 项（legacy 子串）→ 第 25 项（`arguments.game`）复现，
|
||||
/// 真实 argv 由 `tests/launch/cmdline_snapshot.rs` 钉住。
|
||||
#[test]
|
||||
fn stacks_on_forge_and_keeps_the_forge_tweak_class() {
|
||||
let temp = TempDir::new("forge");
|
||||
let layout = GameLayout::new(temp.path());
|
||||
put_version(&layout, "1.12.2", VANILLA_1122);
|
||||
put_version(&layout, "1.12.2-forge-14.23.5.2860", FORGE_1122);
|
||||
|
||||
let release = liteloader_release("1.12.2-forge-14.23.5.2860");
|
||||
assert!(!release.parent_is_vanilla());
|
||||
let plan = LoaderInstallPlan::build(LoaderPlanInput {
|
||||
layout: &layout,
|
||||
release: &release,
|
||||
environment: &Environment::host(),
|
||||
parent_installed: true,
|
||||
})
|
||||
.expect("父版本已装，计划应可组");
|
||||
assert_eq!(plan.install.jar_id, "1.12.2", "jar 仍取原版那层");
|
||||
|
||||
let engine = engine(temp.path());
|
||||
prefill(&plan.install);
|
||||
let report = block_on(execute(&engine, &plan.install, 4, None)).expect("执行应成功");
|
||||
assert!(report.is_complete(), "{:?}", report.failures(3));
|
||||
|
||||
let installed = read_version(&layout, &release.version_id);
|
||||
let mut source = std::collections::BTreeMap::new();
|
||||
source.insert("1.12.2".to_string(), read_version(&layout, "1.12.2"));
|
||||
source.insert(
|
||||
"1.12.2-forge-14.23.5.2860".to_string(),
|
||||
read_version(&layout, "1.12.2-forge-14.23.5.2860"),
|
||||
);
|
||||
source.insert(release.version_id.clone(), installed);
|
||||
let resolved = resolve(&source, &source[&release.version_id]).expect("三层继承应可解析");
|
||||
|
||||
// ① 父链的 legacy 参数整串还在（子层没写 minecraftArguments）。
|
||||
let legacy = resolved
|
||||
.minecraft_arguments
|
||||
.as_deref()
|
||||
.expect("Forge 的 minecraftArguments 不许被子层顶掉");
|
||||
assert!(
|
||||
legacy.contains("net.minecraftforge.fml.common.launcher.FMLTweaker"),
|
||||
"Forge 的 tweakClass 丢了：{legacy}"
|
||||
);
|
||||
|
||||
// ② 启动顺序：legacy（第 24 项）在前，arguments.game（第 25 项）在后。
|
||||
let mut game: Vec<String> = tokenize(legacy);
|
||||
game.extend(
|
||||
resolved
|
||||
.arguments
|
||||
.as_ref()
|
||||
.expect("arguments 应保留")
|
||||
.expand(&Environment::host())
|
||||
.game,
|
||||
);
|
||||
let forge_at = game
|
||||
.iter()
|
||||
.position(|token| token.contains("FMLTweaker"))
|
||||
.expect("Forge tweakClass 不在游戏参数里");
|
||||
let liteloader_at = game
|
||||
.iter()
|
||||
.position(|token| token == "com.mumfrey.liteloader.launch.LiteLoaderTweaker")
|
||||
.expect("LiteLoader tweakClass 不在游戏参数里");
|
||||
assert!(
|
||||
forge_at < liteloader_at,
|
||||
"launchwrapper 按出现顺序应用 tweak：Forge 必须在前，实际 {game:?}"
|
||||
);
|
||||
assert_eq!(game[liteloader_at - 1], "--tweakClass");
|
||||
|
||||
// ③ 主类与库顺序：Forge 的库在前（classpath 先到先得），LiteLoader 的在后。
|
||||
assert_eq!(
|
||||
resolved.main_class.as_deref(),
|
||||
Some("net.minecraft.launchwrapper.Launch")
|
||||
);
|
||||
let libraries: Vec<&str> = resolved
|
||||
.libraries
|
||||
.as_deref()
|
||||
.expect("libraries")
|
||||
.iter()
|
||||
.map(|library| library.name.as_str())
|
||||
.collect();
|
||||
let forge_lib = libraries
|
||||
.iter()
|
||||
.position(|name| name.starts_with("net.minecraftforge:forge:"))
|
||||
.expect("缺 Forge 本体库");
|
||||
let liteloader_lib = libraries
|
||||
.iter()
|
||||
.position(|name| name.starts_with("com.mumfrey:liteloader:"))
|
||||
.expect("缺 LiteLoader 本体库");
|
||||
assert!(forge_lib < liteloader_lib, "{libraries:?}");
|
||||
}
|
||||
@@ -0,0 +1,157 @@
|
||||
//! 集成测试公用件：临时游戏目录、离线下载引擎、元数据夹具、父版本清单夹具。
|
||||
|
||||
#![allow(dead_code)]
|
||||
|
||||
use std::path::{Path, PathBuf};
|
||||
use std::sync::atomic::{AtomicUsize, Ordering};
|
||||
use std::sync::Arc;
|
||||
use std::time::Duration;
|
||||
|
||||
use unlucky_core::addon::loader::liteloader::{self, LiteLoaderEntry};
|
||||
use unlucky_core::addon::loader::LoaderRelease;
|
||||
use unlucky_core::download::backoff::BackoffPolicy;
|
||||
use unlucky_core::download::cache::ContentCache;
|
||||
use unlucky_core::download::chunked::ChunkedConfig;
|
||||
use unlucky_core::download::config::EngineConfig;
|
||||
use unlucky_core::download::engine::DownloadEngine;
|
||||
use unlucky_core::download::health::HealthRegistry;
|
||||
use unlucky_core::download::mirrors::MirrorTable;
|
||||
use unlucky_core::download::region::RegionProfile;
|
||||
use unlucky_core::game::layout::GameLayout;
|
||||
use unlucky_core::game::manifest::VersionJson;
|
||||
|
||||
/// 真实响应的裁剪版（见 `tests/liteloader.rs` 文件头的来源说明）。
|
||||
pub const VERSION_TABLE: &str = include_str!("fixtures/liteloader-versions.json");
|
||||
|
||||
/// 1.12.2-SNAPSHOT 的 maven-metadata（真实响应原样）。
|
||||
pub const METADATA_XML: &str = r#"<?xml version="1.0" encoding="UTF-8"?>
|
||||
<metadata>
|
||||
<groupId>com.mumfrey</groupId>
|
||||
<artifactId>liteloader</artifactId>
|
||||
<version>1.12.2-SNAPSHOT</version>
|
||||
<versioning>
|
||||
<snapshot>
|
||||
<timestamp>20171128.144431</timestamp>
|
||||
<buildNumber>4</buildNumber>
|
||||
</snapshot>
|
||||
<lastUpdated>20171128144431</lastUpdated>
|
||||
</versioning>
|
||||
</metadata>"#;
|
||||
|
||||
/// 原版 1.12.2（老式 `minecraftArguments`，与官方清单同形）。
|
||||
pub const VANILLA_1122: &str = r#"{
|
||||
"id": "1.12.2",
|
||||
"type": "release",
|
||||
"mainClass": "net.minecraft.client.main.Main",
|
||||
"assets": "1.12",
|
||||
"assetIndex": {"id": "1.12"},
|
||||
"minecraftArguments": "--username ${auth_player_name} --version ${version_name}",
|
||||
"libraries": [
|
||||
{"name": "com.mojang:patchy:1.1", "url": "https://libraries.minecraft.net/"}
|
||||
]
|
||||
}"#;
|
||||
|
||||
/// Forge 1.12.2-14.23.5.2860（spec-0 的 version.json：主类 launchwrapper + FMLTweaker）。
|
||||
pub const FORGE_1122: &str = r#"{
|
||||
"id": "1.12.2-forge-14.23.5.2860",
|
||||
"inheritsFrom": "1.12.2",
|
||||
"mainClass": "net.minecraft.launchwrapper.Launch",
|
||||
"minecraftArguments": "--tweakClass net.minecraftforge.fml.common.launcher.FMLTweaker",
|
||||
"libraries": [
|
||||
{"name": "net.minecraftforge:forge:1.12.2-14.23.5.2860", "url": "https://maven.minecraftforge.net/"}
|
||||
]
|
||||
}"#;
|
||||
|
||||
/// 唯一临时目录守卫（`drop` 时递归删除）。
|
||||
pub struct TempDir {
|
||||
path: PathBuf,
|
||||
}
|
||||
|
||||
impl TempDir {
|
||||
pub fn new(tag: &str) -> Self {
|
||||
static COUNTER: AtomicUsize = AtomicUsize::new(0);
|
||||
let unique = COUNTER.fetch_add(1, Ordering::Relaxed);
|
||||
let stamp = std::time::SystemTime::now()
|
||||
.duration_since(std::time::UNIX_EPOCH)
|
||||
.map_or(0, |since| since.as_nanos());
|
||||
let path = std::env::temp_dir().join(format!(
|
||||
"ull-liteloader-{tag}-{}-{stamp}-{unique}",
|
||||
std::process::id()
|
||||
));
|
||||
let _ = std::fs::remove_dir_all(&path);
|
||||
std::fs::create_dir_all(&path).expect("临时目录应可创建");
|
||||
Self { path }
|
||||
}
|
||||
|
||||
pub fn path(&self) -> &Path {
|
||||
&self.path
|
||||
}
|
||||
}
|
||||
|
||||
impl Drop for TempDir {
|
||||
fn drop(&mut self) {
|
||||
let _ = std::fs::remove_dir_all(&self.path);
|
||||
}
|
||||
}
|
||||
|
||||
/// 离线引擎：单次尝试、短超时、分块关闭（测试里只用来跑「全部跳过」的执行段）。
|
||||
pub fn engine(cache_root: &Path) -> DownloadEngine {
|
||||
let config = EngineConfig {
|
||||
max_attempts_per_source: 1,
|
||||
backoff: BackoffPolicy {
|
||||
base_ms: 1,
|
||||
max_ms: 2,
|
||||
jitter_ratio: 0.0,
|
||||
max_attempts: 1,
|
||||
},
|
||||
connect_timeout: Duration::from_secs(3),
|
||||
read_timeout: Duration::from_secs(3),
|
||||
chunked: ChunkedConfig::disabled(),
|
||||
..EngineConfig::default()
|
||||
};
|
||||
DownloadEngine::new(
|
||||
config,
|
||||
Arc::new(MirrorTable::builtin()),
|
||||
Arc::new(RegionProfile::direct(0)),
|
||||
Arc::new(HealthRegistry::in_memory()),
|
||||
Arc::new(ContentCache::open(cache_root.join("cache"))),
|
||||
)
|
||||
}
|
||||
|
||||
/// 解析夹具表里某个原版版本的条目。
|
||||
pub fn entries(mc_version: &str) -> Vec<LiteLoaderEntry> {
|
||||
let table = liteloader::parse_versions(VERSION_TABLE).expect("夹具版本表应可解析");
|
||||
table.get(mc_version).cloned().unwrap_or_default()
|
||||
}
|
||||
|
||||
/// 取 1.12.2 的 SNAPSHOT 条目并合成 release（父版本由调用方给）。
|
||||
pub fn liteloader_release(parent_version_id: &str) -> LoaderRelease {
|
||||
let entries = entries("1.12.2");
|
||||
let entry = liteloader::default_entry(&entries).expect("1.12.2 应有一条版本");
|
||||
let url = liteloader::snapshot_artifact_url(entry, METADATA_XML).expect("快照直链");
|
||||
liteloader::build_release("1.12.2", parent_version_id, entry, &url).expect("合成清单")
|
||||
}
|
||||
|
||||
/// 把一份版本 JSON 写进 `versions/<id>/<id>.json`（模拟「父版本已装好」）。
|
||||
pub fn put_version(layout: &GameLayout, id: &str, json: &str) {
|
||||
let path = layout.version_json(id);
|
||||
std::fs::create_dir_all(path.parent().expect("版本目录")).expect("建版本目录");
|
||||
std::fs::write(&path, json).expect("写版本 JSON");
|
||||
}
|
||||
|
||||
/// 读盘上的版本 JSON。
|
||||
pub fn read_version(layout: &GameLayout, id: &str) -> VersionJson {
|
||||
let path = layout.version_json(id);
|
||||
let text = std::fs::read_to_string(&path)
|
||||
.unwrap_or_else(|error| panic!("读不到 {}：{error}", path.display()));
|
||||
VersionJson::from_json_str(&text).expect("版本 JSON 应可解析")
|
||||
}
|
||||
|
||||
/// 按计划把每个待下文件写成占位字节（`execute` 的跳过判据 = 无 sha1 且存在即信）。
|
||||
pub fn prefill(plan: &unlucky_core::game::install::InstallPlan) -> usize {
|
||||
for file in &plan.files {
|
||||
std::fs::create_dir_all(file.dest.parent().expect("文件父目录")).expect("建库目录");
|
||||
std::fs::write(&file.dest, b"placeholder").expect("写占位文件");
|
||||
}
|
||||
plan.files.len()
|
||||
}
|
||||
@@ -1,395 +1,30 @@
|
||||
//! 实例相关 DTO：磁贴与列表视图的唯一数据源。
|
||||
//!
|
||||
//! 按关注点拆成四个子模块（M222 为了给 LiteLoader 加入口而拆，纯搬移 + 新增一支）：
|
||||
//!
|
||||
//! | 子模块 | 内容 |
|
||||
//! |---|---|
|
||||
//! | [`loader`] | 加载器词表（磁贴徽标 + 向导可选）、[`LoaderInfo`] |
|
||||
//! | [`runtime`] | [`Progress`] / [`LaunchStage`] / [`InstanceRuntime`] / [`InstanceSummary`] |
|
||||
//! | [`create`] | 新建实例向导的提交请求 [`CreateRequest`] |
|
||||
//!
|
||||
//! 路径对外**一个字没变**（`unlucky_presenter::dto::InstanceSummary` 等仍从这里取），
|
||||
//! 拆的是文件不是 API。
|
||||
|
||||
use serde::{Deserialize, Serialize};
|
||||
mod create;
|
||||
mod loader;
|
||||
mod runtime;
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests;
|
||||
|
||||
pub use create::CreateRequest;
|
||||
pub use loader::{LoaderInfo, LoaderKind};
|
||||
pub use runtime::{InstanceRuntime, InstanceSummary, LaunchStage, Progress};
|
||||
|
||||
pub use super::launch_failure::{LaunchFailureCause, LaunchFailureStage, LaunchFailureView};
|
||||
|
||||
use std::path::PathBuf;
|
||||
|
||||
use unlucky_core::game::LoaderKind as CoreLoaderKind;
|
||||
|
||||
use super::LaunchArgsView;
|
||||
|
||||
/// 实例标识：core::game 生成的稳定 id，app 视为不透明字符串。
|
||||
pub type InstanceId = String;
|
||||
|
||||
/// 加载器种类（磁贴徽标 + 详情页版本链）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
|
||||
pub enum LoaderKind {
|
||||
/// 原版（无加载器）
|
||||
Vanilla,
|
||||
/// Fabric
|
||||
Fabric,
|
||||
/// Quilt
|
||||
Quilt,
|
||||
/// Forge
|
||||
Forge,
|
||||
/// NeoForge
|
||||
NeoForge,
|
||||
/// OptiFine
|
||||
OptiFine,
|
||||
/// LiteLoader
|
||||
LiteLoader,
|
||||
}
|
||||
|
||||
impl LoaderKind {
|
||||
/// 徽标显示文字。
|
||||
pub fn label(self) -> &'static str {
|
||||
match self {
|
||||
Self::Vanilla => "原版",
|
||||
Self::Fabric => "Fabric",
|
||||
Self::Quilt => "Quilt",
|
||||
Self::Forge => "Forge",
|
||||
Self::NeoForge => "NeoForge",
|
||||
Self::OptiFine => "OptiFine",
|
||||
Self::LiteLoader => "LiteLoader",
|
||||
}
|
||||
}
|
||||
|
||||
/// 本 DTO 种类 → core 的宽种类。
|
||||
///
|
||||
/// **结构映射，一个 id 字面量都没有**：词表只有一个真相源
|
||||
/// （[`CoreLoaderKind::as_str`]），本 crate 写不进第二份。加一支 DTO 种类这里编不过。
|
||||
const fn to_core(self) -> CoreLoaderKind {
|
||||
match self {
|
||||
Self::Vanilla => CoreLoaderKind::Vanilla,
|
||||
Self::Fabric => CoreLoaderKind::Fabric,
|
||||
Self::Quilt => CoreLoaderKind::Quilt,
|
||||
Self::Forge => CoreLoaderKind::Forge,
|
||||
Self::NeoForge => CoreLoaderKind::NeoForge,
|
||||
Self::OptiFine => CoreLoaderKind::OptiFine,
|
||||
Self::LiteLoader => CoreLoaderKind::LiteLoader,
|
||||
}
|
||||
}
|
||||
|
||||
/// core 的宽种类 → 本 DTO 种类（[`Self::to_core`] 的反向，同样不含字面量）。
|
||||
///
|
||||
/// core 给 `game::LoaderKind` 加一支、而 DTO 还没跟上时，这里编不过——这正是要的：
|
||||
/// UI 不许「新加载器默默显示成原版」。
|
||||
const fn from_core(kind: CoreLoaderKind) -> Self {
|
||||
match kind {
|
||||
CoreLoaderKind::Vanilla => Self::Vanilla,
|
||||
CoreLoaderKind::Fabric => Self::Fabric,
|
||||
CoreLoaderKind::Quilt => Self::Quilt,
|
||||
CoreLoaderKind::Forge => Self::Forge,
|
||||
CoreLoaderKind::NeoForge => Self::NeoForge,
|
||||
CoreLoaderKind::OptiFine => Self::OptiFine,
|
||||
CoreLoaderKind::LiteLoader => Self::LiteLoader,
|
||||
}
|
||||
}
|
||||
|
||||
/// 稳定 id（`vanilla` / `fabric` / …；GUI 与 `--json` 同词表）。
|
||||
///
|
||||
/// **委派**给 [`CoreLoaderKind::as_str`]（M126）：词表的源头表在 core（0.2.0 已发布契约；
|
||||
/// 另一处逐字副本是 `ull help instances` 的词表行），这里只剩一次结构映射。
|
||||
#[must_use]
|
||||
pub fn as_str(self) -> &'static str {
|
||||
self.to_core().as_str()
|
||||
}
|
||||
|
||||
/// 从稳定 id 解析（未知给 `None`，由调用方决定报错文案）。
|
||||
///
|
||||
/// 七个 id 的匹配委派给 [`CoreLoaderKind::parse`]；本方法只额外收 `none` / 空串这两个
|
||||
/// **GUI 输入别名**（表单里「不装加载器」的写法）——它们不是对外输出的 id，也绝不参与
|
||||
/// [`Self::as_str`]。
|
||||
pub fn parse(raw: &str) -> Option<Self> {
|
||||
let wanted = raw.trim();
|
||||
if wanted.is_empty() || wanted.eq_ignore_ascii_case("none") {
|
||||
return Some(Self::Vanilla);
|
||||
}
|
||||
Some(Self::from_core(CoreLoaderKind::parse(wanted)?))
|
||||
}
|
||||
|
||||
/// 向导里的可选加载器（顺序即展示顺序）。
|
||||
pub fn wizard_choices() -> [Self; 5] {
|
||||
[
|
||||
Self::Vanilla,
|
||||
Self::Fabric,
|
||||
Self::Quilt,
|
||||
Self::Forge,
|
||||
Self::NeoForge,
|
||||
]
|
||||
}
|
||||
}
|
||||
|
||||
/// 加载器 + 版本（例如 Fabric 0.16.5）。
|
||||
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
|
||||
pub struct LoaderInfo {
|
||||
/// 加载器种类
|
||||
pub kind: LoaderKind,
|
||||
/// 加载器版本号；原版为空串
|
||||
pub version: String,
|
||||
}
|
||||
|
||||
impl Default for LoaderInfo {
|
||||
fn default() -> Self {
|
||||
Self {
|
||||
kind: LoaderKind::Vanilla,
|
||||
version: String::new(),
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
impl LoaderInfo {
|
||||
/// 徽标文字：原版只写「原版」，装加载器时写「Fabric 0.16.5」。
|
||||
pub fn badge(&self) -> String {
|
||||
if self.kind == LoaderKind::Vanilla || self.version.is_empty() {
|
||||
self.kind.label().to_string()
|
||||
} else {
|
||||
format!("{} {}", self.kind.label(), self.version)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 字节进度；`total == 0` 表示总量未知（UI 转不确定态）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default, Serialize, Deserialize)]
|
||||
pub struct Progress {
|
||||
/// 已完成量
|
||||
pub done: u64,
|
||||
/// 总量；0 = 未知
|
||||
pub total: u64,
|
||||
}
|
||||
|
||||
impl Progress {
|
||||
/// 0.0~1.0；未知总量返回 0.0。
|
||||
pub fn ratio(self) -> f32 {
|
||||
if self.total == 0 {
|
||||
0.0
|
||||
} else {
|
||||
(self.done as f32 / self.total as f32).clamp(0.0, 1.0)
|
||||
}
|
||||
}
|
||||
|
||||
/// 总量是否已知。
|
||||
pub fn is_known(self) -> bool {
|
||||
self.total > 0
|
||||
}
|
||||
}
|
||||
|
||||
/// 启动管线阶段（磁贴进度环的文案来源；D8 的 10 阶段在 P1 细化）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
|
||||
pub enum LaunchStage {
|
||||
/// 下载资源
|
||||
Download,
|
||||
/// 校验文件
|
||||
Verify,
|
||||
/// 组装命令行并拉起进程
|
||||
Launch,
|
||||
/// 进程已起、等待游戏窗口（M28 的窗口检测阶段）
|
||||
Window,
|
||||
}
|
||||
|
||||
impl LaunchStage {
|
||||
/// 磁贴上的阶段文案。
|
||||
pub fn label(self) -> &'static str {
|
||||
match self {
|
||||
Self::Download => "下载资源",
|
||||
Self::Verify => "校验文件",
|
||||
Self::Launch => "组装命令行",
|
||||
Self::Window => "等待窗口",
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 实例运行时状态（磁贴的四种外观）。
|
||||
#[derive(Debug, Clone, PartialEq, Eq, Default, Serialize, Deserialize)]
|
||||
pub enum InstanceRuntime {
|
||||
/// 空闲
|
||||
#[default]
|
||||
Idle,
|
||||
/// 启动管线进行中
|
||||
Busy {
|
||||
/// 当前阶段
|
||||
stage: LaunchStage,
|
||||
/// 该阶段进度
|
||||
progress: Progress,
|
||||
},
|
||||
/// 游戏进程存活
|
||||
Running {
|
||||
/// 进程号（停止/诊断用）
|
||||
pid: u32,
|
||||
},
|
||||
/// 上次启动失败（磁贴显示「重试」）
|
||||
///
|
||||
/// M161 之前这里只有一个 `reason: String`，而且里面已经写着「启动失败：…」——
|
||||
/// 界面再包一层就成了「英文前缀 + 中文句子」，中文界面则是「启动失败 · 启动失败：…」。
|
||||
/// 现在给的是结构化原因（见 [`LaunchFailureCause`]）：**没起来**与**起来又崩**是两种形状，
|
||||
/// 界面各说各的话（复审 P1-1：早先崩溃被说成「启动游戏进程失败」）。
|
||||
Failed {
|
||||
/// 这一场为什么是失败态
|
||||
cause: LaunchFailureCause,
|
||||
},
|
||||
}
|
||||
|
||||
/// 实例摘要：磁贴/列表视图唯一数据源。
|
||||
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
|
||||
pub struct InstanceSummary {
|
||||
/// 稳定 id
|
||||
pub id: InstanceId,
|
||||
/// 显示名
|
||||
pub name: String,
|
||||
/// 游戏版本（如 1.20.4）
|
||||
pub mc_version: String,
|
||||
/// 加载器信息
|
||||
pub loader: LoaderInfo,
|
||||
/// ISO-8601 UTC 最后游玩时间；None = 从未启动
|
||||
pub last_played: Option<String>,
|
||||
/// 运行时状态
|
||||
pub runtime: InstanceRuntime,
|
||||
/// 实例图标路径（P0 直接给路径；P1 换成 core 提供的图像句柄）
|
||||
pub icon: Option<PathBuf>,
|
||||
/// 隔离档位（`isolated` / `shared` / `custom`；未知为空）
|
||||
pub isolation: String,
|
||||
/// 该实例绑定的版本 id（详情页/启动用）
|
||||
pub version_id: String,
|
||||
/// 版本本体是否在盘上（缺载荷时磁贴亮黄条）
|
||||
pub version_present: bool,
|
||||
/// 启动参数（M157：实例配置页「启动参数」区的数据；含三级回落后的生效值与版本门槛）
|
||||
pub launch: LaunchArgsView,
|
||||
}
|
||||
|
||||
/// 新建实例向导提交给 host 的请求（已通过向导校验）。
|
||||
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
|
||||
pub struct CreateRequest {
|
||||
/// 目标原版版本 id（`1.20.4`）
|
||||
pub version: String,
|
||||
/// 加载器
|
||||
pub loader: LoaderKind,
|
||||
/// 加载器版本（空 = 让 core 取最新）
|
||||
pub loader_version: String,
|
||||
/// 实例名（空 = 用版本 id / 加载器版本 id）
|
||||
pub name: String,
|
||||
}
|
||||
|
||||
impl CreateRequest {
|
||||
/// 实际使用的实例名。
|
||||
pub fn instance_name(&self) -> String {
|
||||
if self.name.trim().is_empty() {
|
||||
self.version.clone()
|
||||
} else {
|
||||
self.name.trim().to_string()
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
|
||||
#[test]
|
||||
fn loader_badges_and_ids() {
|
||||
let vanilla = LoaderInfo::default();
|
||||
assert_eq!(vanilla.badge(), "原版");
|
||||
let fabric = LoaderInfo {
|
||||
kind: LoaderKind::Fabric,
|
||||
version: "0.16.5".to_string(),
|
||||
};
|
||||
assert_eq!(fabric.badge(), "Fabric 0.16.5");
|
||||
for kind in LoaderKind::wizard_choices() {
|
||||
assert_eq!(LoaderKind::parse(kind.as_str()), Some(kind));
|
||||
}
|
||||
assert_eq!(LoaderKind::parse("fabric"), Some(LoaderKind::Fabric));
|
||||
assert_eq!(LoaderKind::parse("unknown"), None);
|
||||
}
|
||||
|
||||
/// 对外契约：七个 id 在测试里**独立抄一遍**（0.2.0 已发布形状），并与 core 的 `ALL` 做
|
||||
/// **集合比较**——这是对外词表的守卫（与 CLI 的 help 守卫互补）。显示路径另有守卫：
|
||||
/// `presenter::host::game::every_core_loader_kind_reaches_the_tile_as_itself`（按 `ALL` 遍历）。
|
||||
///
|
||||
/// 为什么不是编译器管：编译期只拦得到「漏 match」，而新种类在还有 match 的消费方用最省事的
|
||||
/// `=> Vanilla` 糊过去**编得过**，那时新加载器会静默显示成原版（`game::loader` 模块文档
|
||||
/// 第 ③ 步）。对外词表由下面第 ② 段的集合断言守，显示路径由上面那条测试守。
|
||||
///
|
||||
/// 抓得住：改词表（`neoforge` → `neo_forge`）；**新增一家加载器而没主动更新这份契约**
|
||||
/// （core 的 `ALL` 多一支 ⇒ 集合不等）；DTO 委派接错支（`OptiFine` 映到 `LiteLoader`）；
|
||||
/// `parse` 收进不该有的别名。
|
||||
/// 抓不住：core 的解析规则（那是 `game::loader` 的
|
||||
/// `every_stable_id_parses_back_to_its_kind` 等测试的职责），以及真二进制输出面的 JSON
|
||||
/// （CLI 的 `json_rows_expose_loader_kind_and_version`）。
|
||||
#[test]
|
||||
fn loader_kind_ids_are_the_released_contract() {
|
||||
const CONTRACT: [(LoaderKind, &str); 7] = [
|
||||
(LoaderKind::Vanilla, "vanilla"),
|
||||
(LoaderKind::Fabric, "fabric"),
|
||||
(LoaderKind::Quilt, "quilt"),
|
||||
(LoaderKind::Forge, "forge"),
|
||||
(LoaderKind::NeoForge, "neoforge"),
|
||||
(LoaderKind::OptiFine, "optifine"),
|
||||
(LoaderKind::LiteLoader, "liteloader"),
|
||||
];
|
||||
|
||||
// ① DTO 这一层：每支的 id、反查、大小写。
|
||||
for (kind, id) in CONTRACT {
|
||||
assert_eq!(kind.as_str(), id, "{kind:?} 的稳定 id 变了");
|
||||
assert_eq!(LoaderKind::parse(id), Some(kind), "`{id}` 认不回来");
|
||||
let upper = id.to_ascii_uppercase();
|
||||
assert_eq!(LoaderKind::parse(&upper), Some(kind), "大写 `{upper}`");
|
||||
}
|
||||
|
||||
// ② core 的词表 ↔ 这份契约：**集合相等**才过（多一支、少一支、改一个字都红）。
|
||||
let mut actual: Vec<&str> = CoreLoaderKind::ALL
|
||||
.iter()
|
||||
.map(|kind| kind.as_str())
|
||||
.collect();
|
||||
actual.sort_unstable();
|
||||
let mut expected: Vec<&str> = CONTRACT.iter().map(|(_, id)| *id).collect();
|
||||
expected.sort_unstable();
|
||||
assert_eq!(
|
||||
actual, expected,
|
||||
"core 的 `LoaderKind::ALL` 必须逐字等于对外契约：加一家加载器时先改这里 + help"
|
||||
);
|
||||
|
||||
// GUI 输入别名（不是对外 id）：不装加载器有三种写法；别名与拼法都不许混进词表。
|
||||
for alias in ["none", "", " "] {
|
||||
assert_eq!(
|
||||
LoaderKind::parse(alias),
|
||||
Some(LoaderKind::Vanilla),
|
||||
"`{alias}`"
|
||||
);
|
||||
}
|
||||
assert_eq!(LoaderKind::parse("neo-forge"), None, "别名只归安装侧");
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn progress_ratio_handles_unknown_total() {
|
||||
assert_eq!(Progress { done: 1, total: 0 }.ratio(), 0.0);
|
||||
assert!((Progress { done: 1, total: 4 }.ratio() - 0.25).abs() < f32::EPSILON);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn create_request_defaults_name_to_version() {
|
||||
let request = CreateRequest {
|
||||
version: "1.20.4".to_string(),
|
||||
loader: LoaderKind::Vanilla,
|
||||
loader_version: String::new(),
|
||||
name: " ".to_string(),
|
||||
};
|
||||
assert_eq!(request.instance_name(), "1.20.4");
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn instance_summary_is_serde_round_trip_safe() {
|
||||
let instance = InstanceSummary {
|
||||
id: "inst-1".to_string(),
|
||||
name: "生存".to_string(),
|
||||
mc_version: "1.20.4".to_string(),
|
||||
loader: LoaderInfo {
|
||||
kind: LoaderKind::Fabric,
|
||||
version: "0.16.5".to_string(),
|
||||
},
|
||||
last_played: Some("2026-10-31T12:00:00.000Z".to_string()),
|
||||
runtime: InstanceRuntime::Busy {
|
||||
stage: LaunchStage::Window,
|
||||
progress: Progress { done: 1, total: 2 },
|
||||
},
|
||||
icon: None,
|
||||
isolation: "isolated".to_string(),
|
||||
version_id: "1.20.4".to_string(),
|
||||
version_present: true,
|
||||
launch: LaunchArgsView::default(),
|
||||
};
|
||||
let text = serde_json::to_string(&instance).expect("序列化");
|
||||
let back: InstanceSummary = serde_json::from_str(&text).expect("反序列化");
|
||||
assert_eq!(back, instance);
|
||||
}
|
||||
}
|
||||
pub use super::LaunchArgsView;
|
||||
@@ -0,0 +1,34 @@
|
||||
//! 新建实例向导提交给 host 的请求。
|
||||
|
||||
use serde::{Deserialize, Serialize};
|
||||
|
||||
use super::LoaderKind;
|
||||
|
||||
/// 新建实例向导提交给 host 的请求（已通过向导校验）。
|
||||
///
|
||||
/// ⚠️ **没有「父版本」槽位**：向导/下载页只装「叠在原版上」的那一层。要把 LiteLoader 叠在
|
||||
/// Forge 上，core 侧已有真实装配路径（`LoaderSource::resolve_on` 的 `parent` 参数 +
|
||||
/// `LoaderPlanInput::parent_installed`），但把父版本从 UI 传下来需要同时扩 `CreateRequest`、
|
||||
/// 下载页草稿与向导校验三处，本轮只做原版父链（见 M222 报告「未做/待排」）。
|
||||
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
|
||||
pub struct CreateRequest {
|
||||
/// 目标原版版本 id（`1.20.4`）
|
||||
pub version: String,
|
||||
/// 加载器
|
||||
pub loader: LoaderKind,
|
||||
/// 加载器版本（空 = 让 core 取最新）
|
||||
pub loader_version: String,
|
||||
/// 实例名（空 = 用版本 id / 加载器版本 id）
|
||||
pub name: String,
|
||||
}
|
||||
|
||||
impl CreateRequest {
|
||||
/// 实际使用的实例名。
|
||||
pub fn instance_name(&self) -> String {
|
||||
if self.name.trim().is_empty() {
|
||||
self.version.clone()
|
||||
} else {
|
||||
self.name.trim().to_string()
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,138 @@
|
||||
//! 加载器词表（磁贴徽标 + 向导可选）与 [`LoaderInfo`]。
|
||||
|
||||
use serde::{Deserialize, Serialize};
|
||||
|
||||
use unlucky_core::game::LoaderKind as CoreLoaderKind;
|
||||
|
||||
/// 加载器种类（磁贴徽标 + 详情页版本链）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
|
||||
pub enum LoaderKind {
|
||||
/// 原版（无加载器）
|
||||
Vanilla,
|
||||
/// Fabric
|
||||
Fabric,
|
||||
/// Quilt
|
||||
Quilt,
|
||||
/// Forge
|
||||
Forge,
|
||||
/// NeoForge
|
||||
NeoForge,
|
||||
/// OptiFine
|
||||
OptiFine,
|
||||
/// LiteLoader
|
||||
LiteLoader,
|
||||
}
|
||||
|
||||
impl LoaderKind {
|
||||
/// 徽标显示文字。
|
||||
pub fn label(self) -> &'static str {
|
||||
match self {
|
||||
Self::Vanilla => "原版",
|
||||
Self::Fabric => "Fabric",
|
||||
Self::Quilt => "Quilt",
|
||||
Self::Forge => "Forge",
|
||||
Self::NeoForge => "NeoForge",
|
||||
Self::OptiFine => "OptiFine",
|
||||
Self::LiteLoader => "LiteLoader",
|
||||
}
|
||||
}
|
||||
|
||||
/// 本 DTO 种类 → core 的宽种类。
|
||||
///
|
||||
/// **结构映射，一个 id 字面量都没有**：词表只有一个真相源
|
||||
/// （[`CoreLoaderKind::as_str`]），本 crate 写不进第二份。加一支 DTO 种类这里编不过。
|
||||
const fn to_core(self) -> CoreLoaderKind {
|
||||
match self {
|
||||
Self::Vanilla => CoreLoaderKind::Vanilla,
|
||||
Self::Fabric => CoreLoaderKind::Fabric,
|
||||
Self::Quilt => CoreLoaderKind::Quilt,
|
||||
Self::Forge => CoreLoaderKind::Forge,
|
||||
Self::NeoForge => CoreLoaderKind::NeoForge,
|
||||
Self::OptiFine => CoreLoaderKind::OptiFine,
|
||||
Self::LiteLoader => CoreLoaderKind::LiteLoader,
|
||||
}
|
||||
}
|
||||
|
||||
/// core 的宽种类 → 本 DTO 种类（[`Self::to_core`] 的反向，同样不含字面量）。
|
||||
///
|
||||
/// core 给 `game::LoaderKind` 加一支、而 DTO 还没跟上时，这里编不过——这正是要的：
|
||||
/// UI 不许「新加载器默默显示成原版」。
|
||||
const fn from_core(kind: CoreLoaderKind) -> Self {
|
||||
match kind {
|
||||
CoreLoaderKind::Vanilla => Self::Vanilla,
|
||||
CoreLoaderKind::Fabric => Self::Fabric,
|
||||
CoreLoaderKind::Quilt => Self::Quilt,
|
||||
CoreLoaderKind::Forge => Self::Forge,
|
||||
CoreLoaderKind::NeoForge => Self::NeoForge,
|
||||
CoreLoaderKind::OptiFine => Self::OptiFine,
|
||||
CoreLoaderKind::LiteLoader => Self::LiteLoader,
|
||||
}
|
||||
}
|
||||
|
||||
/// 稳定 id（`vanilla` / `fabric` / …；GUI 与 `--json` 同词表）。
|
||||
///
|
||||
/// **委派**给 [`CoreLoaderKind::as_str`]（M126）：词表的源头表在 core（0.2.0 已发布契约；
|
||||
/// 另一处逐字副本是 `ull help instances` 的词表行），这里只剩一次结构映射。
|
||||
#[must_use]
|
||||
pub fn as_str(self) -> &'static str {
|
||||
self.to_core().as_str()
|
||||
}
|
||||
|
||||
/// 从稳定 id 解析（未知给 `None`，由调用方决定报错文案）。
|
||||
///
|
||||
/// 七个 id 的匹配委派给 [`CoreLoaderKind::parse`]；本方法只额外收 `none` / 空串这两个
|
||||
/// **GUI 输入别名**（表单里「不装加载器」的写法）——它们不是对外输出的 id，也绝不参与
|
||||
/// [`Self::as_str`]。
|
||||
pub fn parse(raw: &str) -> Option<Self> {
|
||||
let wanted = raw.trim();
|
||||
if wanted.is_empty() || wanted.eq_ignore_ascii_case("none") {
|
||||
return Some(Self::Vanilla);
|
||||
}
|
||||
Some(Self::from_core(CoreLoaderKind::parse(wanted)?))
|
||||
}
|
||||
|
||||
/// 向导里的可选加载器（顺序即展示顺序）。
|
||||
///
|
||||
/// 六选 = 原版 + 五家能装的。OptiFine 仍**不在这里**：它要跑外部 `optifine.Patcher` 并原地
|
||||
/// 改 zip，core 侧至今没有安装路线（见 `DevDocs/artifacts/m218/SURVEY-p1.md` §3），
|
||||
/// 放进向导只会让用户选完才失败。
|
||||
pub fn wizard_choices() -> [Self; 6] {
|
||||
[
|
||||
Self::Vanilla,
|
||||
Self::Fabric,
|
||||
Self::Quilt,
|
||||
Self::Forge,
|
||||
Self::NeoForge,
|
||||
Self::LiteLoader,
|
||||
]
|
||||
}
|
||||
}
|
||||
|
||||
/// 加载器 + 版本（例如 Fabric 0.16.5）。
|
||||
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
|
||||
pub struct LoaderInfo {
|
||||
/// 加载器种类
|
||||
pub kind: LoaderKind,
|
||||
/// 加载器版本号；原版为空串
|
||||
pub version: String,
|
||||
}
|
||||
|
||||
impl Default for LoaderInfo {
|
||||
fn default() -> Self {
|
||||
Self {
|
||||
kind: LoaderKind::Vanilla,
|
||||
version: String::new(),
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
impl LoaderInfo {
|
||||
/// 徽标文字：原版只写「原版」，装加载器时写「Fabric 0.16.5」。
|
||||
pub fn badge(&self) -> String {
|
||||
if self.kind == LoaderKind::Vanilla || self.version.is_empty() {
|
||||
self.kind.label().to_string()
|
||||
} else {
|
||||
format!("{} {}", self.kind.label(), self.version)
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,115 @@
|
||||
//! 进度 / 阶段 / 运行时状态 / 实例摘要（磁贴与列表的唯一数据源）。
|
||||
|
||||
use std::path::PathBuf;
|
||||
|
||||
use serde::{Deserialize, Serialize};
|
||||
|
||||
use super::super::LaunchArgsView;
|
||||
use super::{InstanceId, LoaderInfo};
|
||||
|
||||
/// 字节进度；`total == 0` 表示总量未知（UI 转不确定态）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default, Serialize, Deserialize)]
|
||||
pub struct Progress {
|
||||
/// 已完成量
|
||||
pub done: u64,
|
||||
/// 总量；0 = 未知
|
||||
pub total: u64,
|
||||
}
|
||||
|
||||
impl Progress {
|
||||
/// 0.0~1.0；未知总量返回 0.0。
|
||||
pub fn ratio(self) -> f32 {
|
||||
if self.total == 0 {
|
||||
0.0
|
||||
} else {
|
||||
(self.done as f32 / self.total as f32).clamp(0.0, 1.0)
|
||||
}
|
||||
}
|
||||
|
||||
/// 总量是否已知。
|
||||
pub fn is_known(self) -> bool {
|
||||
self.total > 0
|
||||
}
|
||||
}
|
||||
|
||||
/// 启动管线阶段（磁贴进度环的文案来源；D8 的 10 阶段在 P1 细化）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
|
||||
pub enum LaunchStage {
|
||||
/// 下载资源
|
||||
Download,
|
||||
/// 校验文件
|
||||
Verify,
|
||||
/// 组装命令行并拉起进程
|
||||
Launch,
|
||||
/// 进程已起、等待游戏窗口（M28 的窗口检测阶段）
|
||||
Window,
|
||||
}
|
||||
|
||||
impl LaunchStage {
|
||||
/// 磁贴上的阶段文案。
|
||||
pub fn label(self) -> &'static str {
|
||||
match self {
|
||||
Self::Download => "下载资源",
|
||||
Self::Verify => "校验文件",
|
||||
Self::Launch => "组装命令行",
|
||||
Self::Window => "等待窗口",
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 实例运行时状态（磁贴的四种外观）。
|
||||
#[derive(Debug, Clone, PartialEq, Eq, Default, Serialize, Deserialize)]
|
||||
pub enum InstanceRuntime {
|
||||
/// 空闲
|
||||
#[default]
|
||||
Idle,
|
||||
/// 启动管线进行中
|
||||
Busy {
|
||||
/// 当前阶段
|
||||
stage: LaunchStage,
|
||||
/// 该阶段进度
|
||||
progress: Progress,
|
||||
},
|
||||
/// 游戏进程存活
|
||||
Running {
|
||||
/// 进程号（停止/诊断用）
|
||||
pid: u32,
|
||||
},
|
||||
/// 上次启动失败（磁贴显示「重试」）
|
||||
///
|
||||
/// M161 之前这里只有一个 `reason: String`，而且里面已经写着「启动失败：…」——
|
||||
/// 界面再包一层就成了「英文前缀 + 中文句子」，中文界面则是「启动失败 · 启动失败：…」。
|
||||
/// 现在给的是结构化原因（见 [`crate::dto::LaunchFailureCause`]）：**没起来**与**起来又崩**是两种形状，
|
||||
/// 界面各说各的话（复审 P1-1：早先崩溃被说成「启动游戏进程失败」）。
|
||||
Failed {
|
||||
/// 这一场为什么是失败态
|
||||
cause: crate::dto::LaunchFailureCause,
|
||||
},
|
||||
}
|
||||
|
||||
/// 实例摘要：磁贴/列表视图唯一数据源。
|
||||
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
|
||||
pub struct InstanceSummary {
|
||||
/// 稳定 id
|
||||
pub id: InstanceId,
|
||||
/// 显示名
|
||||
pub name: String,
|
||||
/// 游戏版本（如 1.20.4）
|
||||
pub mc_version: String,
|
||||
/// 加载器信息
|
||||
pub loader: LoaderInfo,
|
||||
/// ISO-8601 UTC 最后游玩时间；None = 从未启动
|
||||
pub last_played: Option<String>,
|
||||
/// 运行时状态
|
||||
pub runtime: InstanceRuntime,
|
||||
/// 实例图标路径（P0 直接给路径；P1 换成 core 提供的图像句柄）
|
||||
pub icon: Option<PathBuf>,
|
||||
/// 隔离档位（`isolated` / `shared` / `custom`；未知为空）
|
||||
pub isolation: String,
|
||||
/// 该实例绑定的版本 id（详情页/启动用）
|
||||
pub version_id: String,
|
||||
/// 版本本体是否在盘上（缺载荷时磁贴亮黄条）
|
||||
pub version_present: bool,
|
||||
/// 启动参数（M157：实例配置页「启动参数」区的数据；含三级回落后的生效值与版本门槛）
|
||||
pub launch: LaunchArgsView,
|
||||
}
|
||||
@@ -0,0 +1,146 @@
|
||||
//! 实例 DTO 的单测（词表契约 / 徽标 / 序列化往返）。
|
||||
|
||||
use super::*;
|
||||
use unlucky_core::game::LoaderKind as CoreLoaderKind;
|
||||
|
||||
#[test]
|
||||
fn loader_badges_and_ids() {
|
||||
let vanilla = LoaderInfo::default();
|
||||
assert_eq!(vanilla.badge(), "原版");
|
||||
let fabric = LoaderInfo {
|
||||
kind: LoaderKind::Fabric,
|
||||
version: "0.16.5".to_string(),
|
||||
};
|
||||
assert_eq!(fabric.badge(), "Fabric 0.16.5");
|
||||
let liteloader = LoaderInfo {
|
||||
kind: LoaderKind::LiteLoader,
|
||||
version: "1.12.2-SNAPSHOT".to_string(),
|
||||
};
|
||||
assert_eq!(liteloader.badge(), "LiteLoader 1.12.2-SNAPSHOT");
|
||||
for kind in LoaderKind::wizard_choices() {
|
||||
assert_eq!(LoaderKind::parse(kind.as_str()), Some(kind));
|
||||
}
|
||||
assert_eq!(LoaderKind::parse("fabric"), Some(LoaderKind::Fabric));
|
||||
assert_eq!(LoaderKind::parse("unknown"), None);
|
||||
}
|
||||
|
||||
/// 向导可选集：**每一支都能被 core 的安装侧接受**（OptiFine 不在其中，因为它装不了）。
|
||||
///
|
||||
/// 抓得住：把 OptiFine 塞进向导（选完才失败）、漏掉 LiteLoader（GUI 走不到真实路线）。
|
||||
#[test]
|
||||
fn wizard_choices_are_all_installable() {
|
||||
let installable: Vec<&str> = LoaderKind::wizard_choices()
|
||||
.iter()
|
||||
.filter(|kind| **kind != LoaderKind::Vanilla)
|
||||
.map(|kind| kind.as_str())
|
||||
.collect();
|
||||
for id in &installable {
|
||||
assert!(
|
||||
unlucky_core::addon::loader::LoaderKind::parse(id).is_some(),
|
||||
"`{id}` 在向导里但安装侧不认"
|
||||
);
|
||||
}
|
||||
assert_eq!(installable.len(), 5, "原版 + 五家能装的：{installable:?}");
|
||||
assert!(!installable.contains(&"optifine"));
|
||||
}
|
||||
|
||||
/// 对外契约：七个 id 在测试里**独立抄一遍**（0.2.0 已发布形状），并与 core 的 `ALL` 做
|
||||
/// **集合比较**——这是对外词表的守卫（与 CLI 的 help 守卫互补）。显示路径另有守卫：
|
||||
/// `presenter::host::game::every_core_loader_kind_reaches_the_tile_as_itself`（按 `ALL` 遍历）。
|
||||
///
|
||||
/// 为什么不是编译器管：编译期只拦得到「漏 match」，而新种类在还有 match 的消费方用最省事的
|
||||
/// `=> Vanilla` 糊过去**编得过**，那时新加载器会静默显示成原版（`game::loader` 模块文档
|
||||
/// 第 ③ 步）。对外词表由下面第 ② 段的集合断言守，显示路径由上面那条测试守。
|
||||
///
|
||||
/// 抓得住：改词表（`neoforge` → `neo_forge`）；**新增一家加载器而没主动更新这份契约**
|
||||
/// （core 的 `ALL` 多一支 ⇒ 集合不等）；DTO 委派接错支（`OptiFine` 映到 `LiteLoader`）；
|
||||
/// `parse` 收进不该有的别名。
|
||||
/// 抓不住：core 的解析规则（那是 `game::loader` 的
|
||||
/// `every_stable_id_parses_back_to_its_kind` 等测试的职责），以及真二进制输出面的 JSON
|
||||
/// （CLI 的 `json_rows_expose_loader_kind_and_version`）。
|
||||
#[test]
|
||||
fn loader_kind_ids_are_the_released_contract() {
|
||||
const CONTRACT: [(LoaderKind, &str); 7] = [
|
||||
(LoaderKind::Vanilla, "vanilla"),
|
||||
(LoaderKind::Fabric, "fabric"),
|
||||
(LoaderKind::Quilt, "quilt"),
|
||||
(LoaderKind::Forge, "forge"),
|
||||
(LoaderKind::NeoForge, "neoforge"),
|
||||
(LoaderKind::OptiFine, "optifine"),
|
||||
(LoaderKind::LiteLoader, "liteloader"),
|
||||
];
|
||||
|
||||
// ① DTO 这一层：每支的 id、反查、大小写。
|
||||
for (kind, id) in CONTRACT {
|
||||
assert_eq!(kind.as_str(), id, "{kind:?} 的稳定 id 变了");
|
||||
assert_eq!(LoaderKind::parse(id), Some(kind), "`{id}` 认不回来");
|
||||
let upper = id.to_ascii_uppercase();
|
||||
assert_eq!(LoaderKind::parse(&upper), Some(kind), "大写 `{upper}`");
|
||||
}
|
||||
|
||||
// ② core 的词表 ↔ 这份契约：**集合相等**才过（多一支、少一支、改一个字都红）。
|
||||
let mut actual: Vec<&str> = CoreLoaderKind::ALL
|
||||
.iter()
|
||||
.map(|kind| kind.as_str())
|
||||
.collect();
|
||||
actual.sort_unstable();
|
||||
let mut expected: Vec<&str> = CONTRACT.iter().map(|(_, id)| *id).collect();
|
||||
expected.sort_unstable();
|
||||
assert_eq!(
|
||||
actual, expected,
|
||||
"core 的 `LoaderKind::ALL` 必须逐字等于对外契约：加一家加载器时先改这里 + help"
|
||||
);
|
||||
|
||||
// GUI 输入别名（不是对外 id）：不装加载器有三种写法；别名与拼法都不许混进词表。
|
||||
for alias in ["none", "", " "] {
|
||||
assert_eq!(
|
||||
LoaderKind::parse(alias),
|
||||
Some(LoaderKind::Vanilla),
|
||||
"`{alias}`"
|
||||
);
|
||||
}
|
||||
assert_eq!(LoaderKind::parse("neo-forge"), None, "别名只归安装侧");
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn progress_ratio_handles_unknown_total() {
|
||||
assert_eq!(Progress { done: 1, total: 0 }.ratio(), 0.0);
|
||||
assert!((Progress { done: 1, total: 4 }.ratio() - 0.25).abs() < f32::EPSILON);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn create_request_defaults_name_to_version() {
|
||||
let request = CreateRequest {
|
||||
version: "1.20.4".to_string(),
|
||||
loader: LoaderKind::Vanilla,
|
||||
loader_version: String::new(),
|
||||
name: " ".to_string(),
|
||||
};
|
||||
assert_eq!(request.instance_name(), "1.20.4");
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn instance_summary_is_serde_round_trip_safe() {
|
||||
let instance = InstanceSummary {
|
||||
id: "inst-1".to_string(),
|
||||
name: "生存".to_string(),
|
||||
mc_version: "1.20.4".to_string(),
|
||||
loader: LoaderInfo {
|
||||
kind: LoaderKind::Fabric,
|
||||
version: "0.16.5".to_string(),
|
||||
},
|
||||
last_played: Some("2026-10-31T12:00:00.000Z".to_string()),
|
||||
runtime: InstanceRuntime::Busy {
|
||||
stage: LaunchStage::Window,
|
||||
progress: Progress { done: 1, total: 2 },
|
||||
},
|
||||
icon: None,
|
||||
isolation: "isolated".to_string(),
|
||||
version_id: "1.20.4".to_string(),
|
||||
version_present: true,
|
||||
launch: LaunchArgsView::default(),
|
||||
};
|
||||
let text = serde_json::to_string(&instance).expect("序列化");
|
||||
let back: InstanceSummary = serde_json::from_str(&text).expect("反序列化");
|
||||
assert_eq!(back, instance);
|
||||
}
|
||||
@@ -6,8 +6,8 @@
|
||||
//! 差异只在线程模型：进度经 [`super::job::HostTask::Install`] 回流（文件计数 + 字节 + 速度/ETA），
|
||||
//! 且整段跑在后台线程里（`block_on` 不占 UI 线程）。
|
||||
//!
|
||||
//! 加载器范围：原版 + Fabric/Quilt/Forge/NeoForge（四家，与 CLI 对齐）。OptiFine/LiteLoader
|
||||
//! 两家 core 侧都还没有安装管线，仍在 GUI 里显式拒装并说清去哪装。
|
||||
//! 加载器范围：原版 + Fabric/Quilt/Forge/NeoForge/LiteLoader（五家，与 CLI 对齐）。OptiFine
|
||||
//! 仍没有安装管线（要跑外部 `optifine.Patcher` + 原地改 zip），在 GUI 里显式拒装并说清去哪装。
|
||||
//! 失败一律落 `.ULL/logs/install.log`（[`super::install_journal`]），文案里带日志路径。
|
||||
|
||||
use std::path::PathBuf;
|
||||
@@ -87,7 +87,7 @@ pub fn loader_label(kind: LoaderKind, version: &str) -> String {
|
||||
}
|
||||
}
|
||||
|
||||
/// GUI 侧支持的加载器（五选：原版 + 四家加载器，与 CLI 的 `--loader` 词表一致）。
|
||||
/// GUI 侧支持的加载器（六选：原版 + 五家加载器，与 CLI 的 `--loader` 词表一致）。
|
||||
///
|
||||
/// 写成穷举 `matches!` 而不是 `true`：将来 core 加了第六种加载器，这里默认拒绝，
|
||||
/// 由 [`unsupported_reason`] 给出明确说法，而不是让它走进不属于它的安装分支。
|
||||
@@ -99,13 +99,14 @@ pub fn supported(kind: LoaderKind) -> bool {
|
||||
| LoaderKind::Quilt
|
||||
| LoaderKind::Forge
|
||||
| LoaderKind::NeoForge
|
||||
| LoaderKind::LiteLoader
|
||||
)
|
||||
}
|
||||
|
||||
/// 不支持的加载器 → 给用户的可执行建议。
|
||||
pub fn unsupported_reason(kind: LoaderKind) -> String {
|
||||
format!(
|
||||
"{} 还没有接入安装管线（目前支持原版 + Fabric/Quilt/Forge/NeoForge）；请先在实例页导入已有版本，或换成受支持的加载器。",
|
||||
"{} 还没有接入安装管线（目前支持原版 + Fabric/Quilt/Forge/NeoForge/LiteLoader）；请先在实例页导入已有版本，或换成受支持的加载器。",
|
||||
kind.label()
|
||||
)
|
||||
}
|
||||
|
||||
@@ -122,8 +122,11 @@ pub(super) fn install_loader(
|
||||
layout: &env.game,
|
||||
release: &release,
|
||||
environment: &Environment::host(),
|
||||
vanilla_installed: env.game.is_version_installed(version),
|
||||
});
|
||||
// 向导/下载页只能装「叠在原版上」的层（CreateRequest 没有父版本槽位），
|
||||
// 所以父版本恒等于原版版本；真装缺原版时由下面的 `vanilla_install_needed` 补装。
|
||||
parent_installed: env.game.is_version_installed(&release.parent_version_id),
|
||||
})
|
||||
.map_err(|error| error.to_string())?;
|
||||
if plan.vanilla_install_needed {
|
||||
let mut vanilla = request.clone();
|
||||
vanilla.loader = LoaderKind::Vanilla;
|
||||
|
||||
@@ -143,11 +143,13 @@ fn loader_support_matrix_is_explicit() {
|
||||
LoaderKind::Quilt,
|
||||
LoaderKind::Forge,
|
||||
LoaderKind::NeoForge,
|
||||
// M222：LiteLoader 走「官方版本表 + 从零合成 launchwrapper 清单」，不跑外部进程。
|
||||
LoaderKind::LiteLoader,
|
||||
] {
|
||||
assert!(supported(kind), "{} 应当受支持", kind.label());
|
||||
}
|
||||
// 这两家 core 侧还没有安装管线，仍然显式拒装并说清去哪装。
|
||||
for kind in [LoaderKind::OptiFine, LoaderKind::LiteLoader] {
|
||||
// OptiFine 仍没有安装管线（要跑外部 Patcher + 原地改 zip），显式拒装并说清可替代做法。
|
||||
for kind in [LoaderKind::OptiFine] {
|
||||
assert!(!supported(kind), "{} 不该被当成可装", kind.label());
|
||||
let reason = unsupported_reason(kind);
|
||||
assert!(reason.contains(kind.label()), "{reason}");
|
||||
|
||||
Reference in new issue
Block a user