Fluent-Steam-Lua 快速开始:从克隆到发布,3 条命令拿到单文件 exe

原创2026-11-03 19:07:422,137 阅读

Fluent-Steam-Lua 快速开始:从克隆到发布,3 条命令拿到单文件 exe

Fluent-Steam-Lua 是一款基于 WPF + Fluent Design 的现代化轻量级 Steam Lua 入库管理工具,目前适配 OpenSteamTool 内核。本快速开始教程带你用 3 条命令完成克隆、构建、发布,最终产出一个可直接分发、无需依赖工程目录的单文件 exe,全程约 5 分钟。

一、准备工作:3 条命令前的必备清单 🧰

项目 要求 说明
操作系统 Windows 10 1809+ / Windows 11 需 64 位系统(发布目标为 win-x64)
构建环境 .NET 8 SDK 用于 dotnet build / dotnet publish
运行环境 .NET 8 Runtime 发布的 exe 依赖它运行(非自包含模式)
网络 构建时必需 自动拉取 CloudRedirect 原生 DLL 并做 SHA256 校验

💡 只需在别人的电脑上运行发布产物,装 .NET 8 Runtime 即可;自己构建才需要 SDK。

二、命令 1:克隆仓库

git clone https://gitcode.com/gh_mirrors/fl/Fluent-Steam-Lua
cd Fluent-Steam-Lua

克隆完成后,目录里几个关键入口:

三、命令 2:构建验证

dotnet build SteamLuaManager.csproj -c Release

SteamLuaManager.csproj 内置了 3 个构建前自动执行的任务,首次构建会稍慢:

  1. 重打包内嵌更新器:构建 Updater/ 并压成 Resources/Updater.zip;
  2. 重打包监控子进程:构建 SvcMonitor/ 并压成 Resources/SvcMonitor.zip;
  3. 拉取 cloud_redirect.dll:云存档重定向所需的原生 DLL,带 SHA256 校验,网络异常时自动回退本地缓存。

看到日志出现 cloud_redirect.dll ... 已就绪(SHA256 已验证),说明构建链路正常。

🚀 也可以跳过发布,直接 dotnet run --project SteamLuaManager.csproj 快速体验界面。

四、命令 3:发布单文件 exe ⚡

dotnet publish SteamLuaManager.csproj -c Release -r win-x64 --self-contained false -p:DebugType=none -p:AppExeName="Fluent Steam Lua" -p:PublishSingleFile=true -o publish/single

执行完在 publish\single\ 下得到 Fluent Steam Lua.exe,这就是可分发的单文件产物。

核心参数速读:

参数 作用
-c Release 发布 Release 配置,体积与性能最优
-r win-x64 指定 Windows x64 平台
--self-contained false 不捆绑运行时,目标机需预装 .NET 8 Runtime
-p:PublishSingleFile=true 单文件发布,运行时自动释放到 %TEMP%\.net
-p:AppExeName="Fluent Steam Lua" 产物 exe 的命名(SteamLuaManager.csproj 中通过 AppExeName 控制程序集名)
-o publish/single 输出目录

💡 想要散文件版本(便于排查部分兼容性问题),去掉 -p:AppExeName 与 -p:PublishSingleFile=true,输出到 publish/loose 即可,两条命令的差异一目了然。

五、首次运行:自动定位 Steam 并安装内核

双击 Fluent Steam Lua.exe 启动后,程序会自动完成三件事:

  1. 定位 Steam 安装路径:优先读注册表 InstallPath,失败后依次探测常见安装目录,实现见 Services/SteamPathService.cs;
  2. 后台检查软件更新与内核更新(可在设置中关闭);
  3. 扫描 config\lua 目录,读取已入库游戏的 Lua 清单,展示游戏封面与中文游戏名。

若尚未安装内核,在首页一键点击安装内核:工具会自动下载 OpenSteamTool 内核并写入 Steam 目录,落盘文件严格受白名单限制(OpenSteamTool.dll、dwmapi.dll 等),安装逻辑见 Services/IOpenSteamToolService.cs。

六、常见问题排查(FAQ)❓

Q:构建时报 cloud_redirect.dll 拉取失败?

A:该 DLL 构建时联网获取,网络抖动且本地有缓存时会自动回退缓存继续构建。需要复现旧版本构建时可固定版本:

dotnet build -p:CloudRedirectVersion=v2.6.5

Q:双击 exe 提示缺少 .NET 运行时?

A:目标机安装 .NET 8 Runtime;或将发布参数改为 --self-contained true 得到自包含版本(体积更大但免依赖)。

Q:安装内核提示目标文件被占用?

A:Steam 正在运行会锁住内核 DLL。先完全退出 Steam,再重新安装即可。

七、总结:3 条命令速查卡 ✅

git clone https://gitcode.com/gh_mirrors/fl/Fluent-Steam-Lua
cd Fluent-Steam-Lua && dotnet build SteamLuaManager.csproj -c Release
dotnet publish SteamLuaManager.csproj -c Release -r win-x64 --self-contained false -p:AppExeName="Fluent Steam Lua" -p:PublishSingleFile=true -o publish/single

克隆 → 构建 → 发布,你已拿到可发给他人直接运行的单文件 Fluent Steam Lua.exe。更多功能特性与模块说明,可参阅 README.md 以及 Services/、ViewModels/ 下的源码结构。

登录后查看全文
Fluent-Steam-Lua