Fluent-Steam-Lua 快速开始:从克隆到发布,3 条命令拿到单文件 exe
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
克隆完成后,目录里几个关键入口:
- 主工程:SteamLuaManager.csproj
- 界面层:Views/(主窗口、首页、设置等)
- 服务层:Services/(Steam 路径检测、内核安装、清单管理等)
三、命令 2:构建验证
dotnet build SteamLuaManager.csproj -c Release
SteamLuaManager.csproj 内置了 3 个构建前自动执行的任务,首次构建会稍慢:
- 重打包内嵌更新器:构建 Updater/ 并压成
Resources/Updater.zip; - 重打包监控子进程:构建 SvcMonitor/ 并压成
Resources/SvcMonitor.zip; - 拉取 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 启动后,程序会自动完成三件事:
- 定位 Steam 安装路径:优先读注册表
InstallPath,失败后依次探测常见安装目录,实现见 Services/SteamPathService.cs; - 后台检查软件更新与内核更新(可在设置中关闭);
- 扫描
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/ 下的源码结构。