解决WindowsTauri构建时下载WiX等打包文件失败

适用场景

本文适用于在Windows环境下使用Tauri框架构建桌面应用程序时遇到WiX工具集和NSIS安装程序下载失败的情况。这种情况通常发生在以下场景中：

• 网络连接不稳定或受限的环境
• 企业内网环境无法访问外部资源
• 国内用户访问GitHub等国外资源受限
• 需要离线构建的开发环境
• CI/CD流水线中需要预先准备依赖项

适配系统与环境配置要求

系统要求

• Windows 10或更高版本
• Rust工具链（stable版本）
• Node.js 16+ 和 npm/yarn/pnpm
• Tauri CLI工具

环境配置

• 确保Rust和Node.js环境正确配置
• 具备管理员权限以创建系统目录
• 至少2GB可用磁盘空间用于存放构建工具

资源使用教程

手动下载WiX工具集

1. 获取WiX工具包

   • 访问WiX工具集官方发布页面
   • 下载最新版本的wix314-binaries.zip文件

2. 创建目录结构

   • 打开资源管理器，导航至：C:\Users\你的用户名\AppData\Local\
   • 创建tauri文件夹（如果不存在）
   • 在tauri文件夹内创建WixTools314文件夹

3. 解压文件

   • 将下载的wix314-binaries.zip解压到WixTools314文件夹
   • 确保解压后包含candle.exe、light.exe等核心文件

手动下载NSIS工具

1. 获取NSIS工具包

   • 下载nsis-3.zip文件
   • 下载NSIS-ApplicationID.zip文件
   • 下载nsis_tauri_utils.dll文件

2. 创建NSIS目录

   • 在tauri文件夹内创建NSIS文件夹
   • 将nsis-3.zip解压到NSIS文件夹

3. 配置插件目录

   • 在NSIS文件夹内创建Plugins子文件夹
   • 在Plugins内创建x86-unicode子文件夹
   • 将NSIS-ApplicationID.zip解压，复制ReleaseUnicode/ApplicationID.dll到x86-unicode目录
   • 复制nsis_tauri_utils.dll到x86-unicode目录

验证目录结构

完成上述步骤后，目录结构应如下所示：

C:\Users\用户名\AppData\Local\tauri\
├── WixTools314/
│   ├── doc/
│   ├── sdk/
│   ├── x86/
│   ├── candle.exe
│   └── light.exe
└── NSIS/
    ├── Bin/
    ├── Contrib/
    ├── Plugins/
    │   └── x86-unicode/
    │       ├── ApplicationID.dll
    │       └── nsis_tauri_utils.dll
    └── Stubs/

构建验证

完成手动下载和配置后，重新运行构建命令：

npm run tauri build
# 或
cargo tauri build

构建过程将使用本地已下载的工具文件，不再尝试从网络下载。

常见问题及解决办法

问题1：目录位置错误

症状：构建时仍然提示下载失败 解决：确认目录路径正确，特别是WixTools314（不是WixTools）和NSIS文件夹的大小写和位置

问题2：文件哈希验证失败

症状：提示"mis-hashed files"或"missing some files" 解决：删除对应的工具目录，重新下载并放置正确的文件版本

问题3：权限不足

症状：无法创建目录或写入文件 解决：以管理员身份运行命令行工具，或手动创建所需目录

问题4：版本不匹配

症状：构建过程中出现兼容性错误 解决：确保下载的工具版本与Tauri版本兼容，参考Tauri官方文档推荐的版本

问题5：网络代理问题

症状：即使手动放置文件，仍然尝试网络下载 解决：检查网络代理设置，或尝试在完全离线的环境中构建

问题6：缓存问题

症状：修改后构建行为没有变化 解决：清理Tauri和Cargo的缓存目录，或重启开发环境

通过以上方法，可以有效解决Windows环境下Tauri构建时下载WiX和NSIS工具失败的问题，确保构建过程的顺利进行。