Skip to content

BUILD.md

Latest commit

 

History

History
79 lines (56 loc) · 3.29 KB

BUILD.md

File metadata and controls

79 lines (56 loc) · 3.29 KB

编译指南 — ImToolbox

环境要求

工具 最低版本 下载地址
操作系统 Windows 10 / 11 —
.NET SDK 10.0（LTS 长期支持版） dotnet.microsoft.com/download/dotnet/10.0
Visual Studio 2022 v17.12+ visualstudio.microsoft.com
VS 工作负载 .NET 桌面开发 在 VS 安装程序中勾选

说明： Visual Studio 为可选项，也可使用 dotnet 命令行工具进行编译。

方式一 — Visual Studio（推荐）

1. 用 Visual Studio 2022 打开  ImToolbox.sln
2. Ctrl+Shift+B  →  生成解决方案
3. F5           →  启动调试运行
   （Windows 会弹出 UAC 权限提示，点击"是"以允许访问注册表）

输出路径：ImToolbox\bin\Debug\net10.0-windows\ImToolbox.exe

方式二 — dotnet 命令行

# 构建（Debug 调试版）
dotnet build ImToolbox.sln

# 直接运行
dotnet run --project ImToolbox\ImToolbox.csproj

# 发布为单文件 EXE（Release 版，无需目标机器安装 .NET 运行时）
dotnet publish ImToolbox\ImToolbox.csproj `
  -c Release `
  -r win-x64 `
  --self-contained true `
  -p:PublishSingleFile=true `
  -p:ApplicationIcon=icon\app.ico `
  -o publish

发布输出：publish\ImToolbox.exe

验证 .NET 版本

dotnet --version
# 预期输出：10.x.x

运行权限说明

程序通过 app.manifest 请求管理员权限，启动时 Windows 会弹出 UAC 提示。各模块所需权限如下：

功能 注册表路径 是否需要管理员
模块一 — 读取输入法列表 HKCU + HKLM（只读） 否（UAC 提示仍会出现）
模块三 — 调整输入法顺序 HKCU\Keyboard Layout\Preload 否
模块二 — 安装/卸载 (待实现) HKLM\SYSTEM\... 是

常见编译错误

错误信息 原因 解决方法
NETSDK1045：SDK 不支持 net10.0 未安装 .NET 10 SDK 安装 .NET 10 SDK
MSB4019：找不到 WPF 项目类型 VS 工作负载缺失 在 VS 安装程序中添加 .NET 桌面开发 工作负载
找不到文件 app.manifest 文件缺失 确认 app.manifest 位于 ImToolbox\ 目录下