290 lines
12 KiB
Rust
290 lines
12 KiB
Rust
//! 解析 → 计划 → 落盘 → 继承解析 → 启动参数顺序（两条父链：原版 / Forge）。
|
||
|
||
use unlucky_core::addon::loader::{LoaderInstallPlan, 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:?}");
|
||
}
|
||
|
||
/// **新式 args 的父链**：父版本用 `arguments.game`（没有 `minecraftArguments`）。
|
||
///
|
||
/// 现实里 LiteLoader 只到 1.12.2，碰不到这种父版本；但「追加语义」是这套路线的准入条件，
|
||
/// 两种父版本形状都得钉住——否则哪天上游把老版本清单改成新式，我们会静默丢参数。
|
||
/// 这里用一份**手工夹具**（`--launchTarget forgeclient` 是 Forge 1.13+ 的真实形态）说明：
|
||
/// 父层参数在前、LiteLoader 的 tweakClass 在后，中间不互相覆盖。
|
||
#[test]
|
||
fn new_style_parent_args_are_appended_not_replaced() {
|
||
const MODERN_PARENT: &str = r#"{
|
||
"id": "1.12.2-modern-1.0",
|
||
"inheritsFrom": "1.12.2",
|
||
"mainClass": "net.minecraft.launchwrapper.Launch",
|
||
"arguments": {"game": ["--launchTarget", "forgeclient"], "jvm": ["-Dmodern=1"]},
|
||
"libraries": [{"name": "example:modern:1.0", "url": "https://example.invalid/"}]
|
||
}"#;
|
||
|
||
let temp = TempDir::new("modern-args");
|
||
let layout = GameLayout::new(temp.path());
|
||
put_version(&layout, "1.12.2", VANILLA_1122);
|
||
put_version(&layout, "1.12.2-modern-1.0", MODERN_PARENT);
|
||
|
||
let release = liteloader_release("1.12.2-modern-1.0");
|
||
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 report = block_on(execute(&engine, &plan.install, 4, None)).expect("执行应成功");
|
||
assert!(report.is_complete(), "{:?}", report.failures(3));
|
||
|
||
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-modern-1.0".to_string(),
|
||
read_version(&layout, "1.12.2-modern-1.0"),
|
||
);
|
||
source.insert(
|
||
release.version_id.clone(),
|
||
read_version(&layout, &release.version_id),
|
||
);
|
||
let resolved = resolve(&source, &source[&release.version_id]).expect("三层继承应可解析");
|
||
|
||
// 父层用的是新式参数：子层没有把 legacy 串写进来，继承后仍然没有。
|
||
assert!(resolved.minecraft_arguments.is_none());
|
||
let game = resolved
|
||
.arguments
|
||
.as_ref()
|
||
.expect("arguments")
|
||
.expand(&Environment::host())
|
||
.game;
|
||
let assert_order = |needle: &str| {
|
||
game.iter()
|
||
.position(|token| token == needle)
|
||
.unwrap_or_else(|| panic!("缺 `{needle}`：{game:?}"))
|
||
};
|
||
assert!(
|
||
assert_order("forgeclient")
|
||
< assert_order("com.mumfrey.liteloader.launch.LiteLoaderTweaker"),
|
||
"父层参数必须在前：{game:?}"
|
||
);
|
||
}
|
||
|
||
/// LiteLoader 生效所依赖的**两条继承合并律**（M222 第一步核实，直接钉在合并函数上）。
|
||
///
|
||
/// 1. `arguments.game`：父在前、子在后**追加**（所以 tweakClass 能叠在父链参数之后）；
|
||
/// 2. `minecraftArguments`：**子覆盖父**（所以 loader 层绝不能写它，否则父链的 tweakClass
|
||
/// 整串消失）。
|
||
///
|
||
/// 抓得住：有人把 `minecraftArguments` 改成追加（HMCL/原版语义不是这样），或把
|
||
/// `arguments.game` 改成整体替换（LiteLoader/其它叠层加载器当场失效）。
|
||
/// 抓不住：真实启动 argv 的顺序（那是 `launch::game_args` 的第 24/25 项，
|
||
/// 由 `tests/launch/cmdline_snapshot.rs` 钉住；本 mission 没有改那一层）。
|
||
#[test]
|
||
fn merge_laws_liteloader_depends_on() {
|
||
use unlucky_core::game::inherit::merge;
|
||
use unlucky_core::game::manifest::VersionJson;
|
||
|
||
let parse = |json: &str| VersionJson::from_json_str(json).expect("夹具应可解析");
|
||
|
||
let parent = parse(
|
||
r#"{"id":"p","minecraftArguments":"--tweakClass FMLTweaker","arguments":{"game":["--parent"]}}"#,
|
||
);
|
||
let child = parse(r#"{"id":"c","arguments":{"game":["--child"]}}"#);
|
||
let merged = merge(&child, &parent);
|
||
assert_eq!(
|
||
merged.minecraft_arguments.as_deref(),
|
||
Some("--tweakClass FMLTweaker"),
|
||
"子没写就继承父（这条是「叠在 Forge 上」的前提）"
|
||
);
|
||
let game: Vec<String> = merged
|
||
.arguments
|
||
.as_ref()
|
||
.expect("arguments")
|
||
.expand(&Environment::host())
|
||
.game;
|
||
assert_eq!(
|
||
game,
|
||
["--parent", "--child"],
|
||
"arguments.game 是父在前、子在后追加"
|
||
);
|
||
|
||
// 子写了 minecraftArguments：整串替换（不是追加）。
|
||
let loud_child = parse(r#"{"id":"c2","minecraftArguments":"--tweakClass LiteLoaderTweaker"}"#);
|
||
let merged = merge(&loud_child, &parent);
|
||
assert_eq!(
|
||
merged.minecraft_arguments.as_deref(),
|
||
Some("--tweakClass LiteLoaderTweaker"),
|
||
"子覆盖父：这正是 loader 层不许写 minecraftArguments 的原因"
|
||
);
|
||
}
|