UniGetUI 离线安装包制作完全指南：4步搞定无网环境部署

UniGetUI 离线安装包制作完全指南：4步搞定无网环境部署

【免费下载链接】UniGetUIUniGetUI: The Graphical Interface for your package managers. Could be terribly described as a package manager manager to manage your package managers项目地址: https://gitcode.com/GitHub_Trending/wi/UniGetUI

UniGetUI 是 WinGet、Scoop、Chocolatey 等包管理器的图形界面工具，一套界面管好所有装包渠道。默认安装流程依赖在线拉取运行时组件，内网或断网机器上很容易卡住。这篇文章带你从源码出发，产出一个自包含一切依赖的 UniGetUI 离线安装包，拿到无网机器上双击就能装、装完就能用。

先弄清「离线」是怎么做到的

整个思路拆开看其实就三层：

1. 应用自包含：src/Directory.Build.props里PublishSelfContained=true，发布产物把 .NET 运行时一起打进unigetui_bin/，目标机器不用单独装 .NET。
2. 安装包自包含：Inno Setup 脚本 UniGetUI.iss 把整个产物目录、以及 VC++ 运行时、WebView2 等依赖的安装器全部压进一个 EXE。
3. 文件自检：产物里附带的IntegrityTree.json（SHA256 哈希表）让应用启动时能核对自己有没有缺文件，这正是离线部署最怕的问题。

只要这三样齐了，装到断网机器上就是一个纯本地过程。

环境怎么备齐：.NET 10 SDK 与 Inno Setup 6

在一台Windows 10/11 64 位的联网机器上准备工具链，这里就是未来唯一需要网络的环节：

• .NET 10 SDK：版本由 global.json 锁定（10.0.103，允许 rollForward），装高版本 SDK 即可满足。
• Inno Setup 6：只用它的命令行编译器ISCC.exe，装在默认位置即可被构建脚本自动发现。
• 克隆源码：

git clone https://gitcode.com/GitHub_Trending/wi/UniGetUI cd UniGetUI

为什么要在联网机上做？因为 Inno Setup 的依赖机制（见 InstallerExtras/CodeDependencies.iss）是在安装时才去下载 VC++/WebView2——离线包要么提前把这些依赖装进目标系统，要么安装时用开关跳过，后面细说。

构建产物怎么出：自包含 publish + 完整性树

UniGetUI.iss的[Files]段只认一个目录：仓库根目录下的unigetui_bin/。先把 Avalonia 主工程发布成 Windows x64 自包含产物，再把输出挪进unigetui_bin/：

dotnet publish src/UniGetUI.Avalonia/UniGetUI.Avalonia.csproj -c Release -p:Platform=x64 -r win-x64

产物就位后，生成完整性树：

pwsh scripts/generate-integrity-tree.ps1 -Path unigetui_bin

这一步会递归计算每个文件的 SHA256 并写入unigetui_bin/IntegrityTree.json。做完的效果：unigetui_bin/里既有UniGetUI.exe和全部运行时 DLL，又有一份可被运行时IntegrityTester核对的哈希清单，断网机启动应用时会用它自检文件完整性。

打包命令一次跑通：ISCC 与 iss 脚本要点

打包前先看 UniGetUI.iss 里三处和离线强相关的配置，心里有数再动手：

• [Files]：部署unigetui_bin\*全量文件，外加一份安装包自身（UniGetUI.Installer.exe）用于日后免重装自修复。
• [Tasks]：提供regularinstall（常规安装，写注册表、建快捷方式）和portableinstall（便携安装，只往目录里放一个ForceUniGetUIMobile标记文件）两种模式，便携版适合 U 盘带走。
• SignTool=azsign：官方构建会数字签名，本地构建没有证书，打包前把它注释掉、并把SignedUninstaller改为no——scripts/build.ps1会自动完成这两处临时改写并恢复。

然后一条命令出包：

ISCC.exe UniGetUI.iss /Ooutput

或者偷懒让 scripts/build.ps1 一条龙跑完：测试 → publish → 整理unigetui_bin/→ 刷新完整性树 → 找 ISCC 打包 → 输出 SHA256 校验和文件。它会自动禁用签名、自动定位ISCC.exe，产物统一落在output/目录，还附一份checksums.x64.txt方便你分发包时校验。

离线依赖怎么补齐：VC++、WebView2 与 netcorecheck

UniGetUI 本体自包含之后，剩下的外部依赖只有三个，处理方式各不相同：

依赖探测逻辑在 InstallerExtras/CodeDependencies.iss：它先查注册表判断 VC++ 和 WebView2 是否已装，已装则完全跳过下载。所以如果你的离线机提前用别的渠道装好这两个组件，安装包全程零联网即可完成；反之就用/NoVCRedist /NoEdgeWebView参数跳过，接受目标机可能缺少对应运行时的风险。

成果怎么验证：断网装机实测

拿到output/UniGetUI Installer.exe后，建议在一台断网的虚拟机（或真实内网机）上走一遍：

1. 核对产物：用output/checksums.x64.txt里的 SHA256 值比对安装包，确认拷贝过程没坏文件。
2. 常规安装：运行安装包选「常规安装」，装完启动 UniGetUI，确认能列出 WinGet/Scoop 等已装包——这一步顺带验证了完整性树自检通过。
3. 便携安装：另选一台机器，装时勾选便携模式（portableinstall），它不写注册表、不建快捷方式，目录整体拷走就能在任意机器运行，是 U 盘分发场景的最优解。
4. 断网复验：全程不插网线，安装与启动均应无网络请求失败提示。

常见坑与延伸阅读

• 启动报缺文件 / 完整性校验失败：unigetui_bin/里动过文件却没重新生成清单，重跑一次scripts/generate-integrity-tree.ps1 -Path unigetui_bin再打包即可。
• ISCC 报错找不到签名工具：确认SignTool=行已注释、SignedUninstaller=no，别用官方签名配置打本地包。
• 构建时找不到 ISCC：说明 Inno Setup 6 没装或没装在默认路径，装好后重跑，或给build.ps1加-SkipInstaller先出 zip 再手动打包。
• 想进一步理解安装器行为（进程杀活、更新标记、自修复部署），直接读 UniGetUI.iss 的[Code]段；命令行与 IPC 能力可查 docs/CLI.md；构建体系与发布约定的权威说明在 AGENTS.md。

【免费下载链接】UniGetUIUniGetUI: The Graphical Interface for your package managers. Could be terribly described as a package manager manager to manage your package managers项目地址: https://gitcode.com/GitHub_Trending/wi/UniGetUI