# 分发 Windows 版 Tauri 应用程序此技能涵盖 Tauri v2 应用程序的 Windows 分发，包括 MSI/NSIS 安装程序创建、自定义和 Microsoft Store 提交。 ## 安装程序格式概述 Tauri 支持两种 Windows 安装程序格式：格式|扩展|搭建平台 |注释 ---|---|---|--- WiX MSI | `.msi` |仅限 Windows |传统 Windows 安装程序国家信息安全局 | `-setup.exe` |跨平台|可以在 Linux/macOS 上构建 ## 建筑安装人员 ### 标准构建 (Windows) npm 运行 tauri 构建 # 或纱线金牛座构建 # 或 pnpm tauri 构建 # 或货运金牛座建造 ### 目标架构 # 64 位（默认） npm run tauri build ---target x86_64-pc-windows-msvc # 32位 npm run tauri build ---target i686-pc-windows-msvc # ARM64（需要额外的 VS 构建工具） npm run tauri build ---target aarch64-pc-windows-msvc ### 跨平台 NSIS 构建 (Linux/macOS) NSIS 安装程序可以在非 Windows 系统上构建： **先决条件（Linux）：** # 安装 NSIS 和构建工具 (Debian/Ubuntu) sudo apt install nsis lld llvm clang # 安装 Windows Rust 目标 rustup 目标添加 x86_64-pc-windows-msvc # 安装cargo-xwin 货物安装--锁定货物-xwin **先决条件（macOS）：** # 通过自制程序安装酿造安装nsis llvm # 将 LLVM 添加到路径导出 PATH="/opt/homebrew/opt/llvm/bin:$PATH" # 安装 Windows Rust 目标 rustup 目标添加 x86_64-pc-windows-msvc # 安装cargo-xwin 货物安装--锁定货物-xwin **构建命令：** npm run tauri build -- --runner Cargo-xwin --target x86_64-pc-windows-msvc ## WebView2 安装模式配置 WebView2 运行时在最终用户计算机上的安装方式：模式|需要互联网 |尺寸影响|最适合 ---|---|---|--- `下载Bootstrapper` |是的 | 0 MB |默认、最小的安装程序 `embedBootstrapper` |是的 | 〜1.8 MB |更好的 Windows 7 支持 `离线安装程序` |没有 | ~127 MB |离线/气隙环境 `固定版本` |没有 | 〜180 MB |受控的企业部署 `跳过` |没有 | 0 MB |不推荐 ### 配置 { “捆绑”：{ “窗户”：{ “webview安装模式”：{ "type": "embedBootstrapper" // 或：downloadBootstrapper、offlineInstaller、fixedVersion } } } } 对于 `fixedVersion`，添加路径：`"path": "./WebView2Runtime"` ## WiX MSI 定制 ### 自定义 WiX 模板替换默认模板： { “捆绑”：{ “窗户”：{ “维克斯”：{ “模板”：“./windows/custom-template.wxs” } } } } ### WiX 片段通过 XML 片段添加自定义功能： **1\.创建片段文件**（`src-tauri/windows/fragments/registry.wxs`）： <片段> <组件 ID="MyRegistryEntry" 目录="INSTALLDIR"> **2\.配置中参考：** { “捆绑”：{ “窗户”：{ “维克斯”：{ "fragmentPaths": ["./windows/fragments/registry.wxs"], “componentRefs”：[“MyFragmentRegistryEntries”] } } } } ### 国际化 (WiX) { “捆绑”：{ “窗户”：{ “维克斯”：{ "language": ["en-US", "fr-FR", "de-DE"], // 单: "fr-FR" "localePath": "./windows/locales" // 可选：自定义区域设置文件 } } } } ## NSIS 安装程序自定义 ### 安装模式模式|需要管理员 |安装位置|使用案例 ---|---|---|--- `每个用户` |没有 | `%LOCALAPPDATA%` |默认，无高程 `每台机器` |是的 | `%PROGRAMFILES%` |系统范围内的安装 `两者` |是的 |用户选择|灵活部署 { “捆绑”：{ “窗户”：{ “nsis”：{ “安装模式”：“每台机器” } } } } ### 安装程序挂钩使用自定义 NSIS 脚本扩展安装： **1\.创建钩子文件**（`src-tauri/windows/hooks.nsh`）： !宏 NSIS_HOOK_PREINSTALL ;在文件安装之前运行详细打印“正在准备安装...” !宏结束 !宏 NSIS_HOOK_POSTINSTALL ;安装完成后运行 DetailPrint“正在配置应用程序...” ;示例：安装 VC++ Redistributable ReadRegStr $0 HKLM“SOFTWARE\Microsoft\VisualStudio\14.0\VC\Runtimes\x64”“已安装” ${如果} $0 != "1" ExecWait '“$INSTDIR\vc_redist.x64.exe”/安静/norestart' ${EndIf} !宏结束 !宏 NSIS_HOOK_PREUNINSTALL ;卸载前运行详细打印“正在清理...” !宏结束 !宏 NSIS_HOOK_POSTUNINSTALL ;卸载后运行详细信息打印“删除完成” !宏结束 **2\.配置中参考：** { “捆绑”：{ “窗户”：{ “nsis”：{ "installerHooks": "./windows/hooks.nsh" } } } } ### 国际化（NSIS） NSIS 安装程序在单个文件中支持多种语言： { “捆绑”：{ “窗户”：{ “nsis”：{ “语言”：[“英语”，“法语”，“德语”，“西班牙语”]， “显示语言选择器”：true } } } } ### 最低 WebView2 版本需要特定的 WebView2 版本： { “捆绑”：{ “窗户”：{ “nsis”：{ “最小Webview2版本”：“110.0.1531.0” } } } } ## 完整配置示例 { “捆绑”：{ “主动”：真实， “目标”：[“msi”，“nsis”]， "图标": ["icons/icon.ico"], “窗户”：{ "certificateThumbprint": "YOUR_CERTIFICATE_THUMBPRINT", "timestampUrl": "http://timestamp.digicert.com", “webview安装模式”：{ “类型”：“嵌入引导程序” }, “维克斯”：{ “语言”：[“en-US”，“de-DE”]， "fragmentPaths": ["./windows/fragments/registry.wxs"], “componentRefs”：[“MyRegistryEntries”] }, “nsis”：{ "installMode": "两者", "installerHooks": "./windows/hooks.nsh", “语言”：[“英语”，“德语”]， “显示语言选择器”：true， “最小Webview2版本”：“110.0.1531.0” } } } } ## 特殊配置 ### Windows 7 支持 { “捆绑”：{ “窗户”：{ “webview安装模式”：{ “类型”：“嵌入引导程序” } } } } 在 `Cargo.toml` 中启用 Windows 7 通知支持： [依赖项] tauri = { 版本 = "2", 功能 = ["windows7-compat"] } ### FIPS 合规性构建前设置环境变量： **PowerShell：** $env:TAURI_BUNDLER_WIX_FIPS_COMPLIANT = "true" npm 运行 tauri 构建 **命令提示符：** 设置 TAURI_BUNDLER_WIX_FIPS_COMPLIANT=true npm 运行 tauri 构建 ## Microsoft 商店分发 ### 要求 1. 开发者注册的 Microsoft 帐户 2. 离线安装程序WebView2模式（商店政策要求） 3. 发行商名称与产品名称不同 ### 商店特定配置创建 `tauri.microsoftstore.conf.json`： { “捆绑”：{ “窗户”：{ “webview安装模式”：{ “type”：“离线安装程序” } } }, “标识符”：“com.yourcompany.yourapp”， "publisher": "您的公司名称" } ### 生成商店图标 npm 运行 tauri 图标 /path/to/app-icon.png 这会生成所有必需的图标大小，包括 Microsoft Store 资源。 ### 为商店构建 npm run tauri build -- --config tauri.microsoftstore.conf.json ### 提交流程 1. 使用离线安装程序配置进行构建 2. 使用有效的代码签名证书对安装程序进行签名 3. 在合作伙伴中心创建应用程序列表（应用程序和游戏） 4. 保留唯一的应用程序名称 5. 将安装程序上传到分发服务 6. 商店列表中的链接安装程序 URL 7. 提交认证 ### 发布者名称限制您的发布商名称不能与您的产品名称匹配。如果您的包标识符是“com.myapp.myapp”，请显式设置不同的发布者： { “标识符”：“com.myapp.myapp”， “出版商”：“MyApp Software Inc” } ## 代码签名 ### 使用证书指纹 { “捆绑”：{ “窗户”：{ "certificateThumbprint": "YOUR_CERTIFICATE_THUMBPRINT", “timestampUrl”：“http://timestamp.digicert.com” } } } ### 环境变量 # 证书路径导出 TAURI_SIGNING_PRIVATE_KEY_PASSWORD="您的密码" # 或者通过 tauri.conf.json ### 时间戳服务器常见的时间戳服务器： * DigiCert：`http://timestamp.digicert.com` * Sectigo：`http://timestamp.sectigo.com` * GlobalSign：`http://timestamp.globalsign.com/tsa/r6advanced1` ## 故障排除 ### MSI 构建在非 Windows 上失败 MSI 文件只能使用 WiX Toolset 在 Windows 上构建。使用 NSIS 进行跨平台构建。 ### WebView2 未安装 1.检查webview安装模式配置 2. 验证引导程序模式的互联网连接 3. 对于离线模式，确保安装程序大小可接受 ### NSIS 交叉编译错误 1. 验证 NSIS 是否已安装并位于 PATH 中 2.检查LLVM/clang安装 3. 确保安装了 Windows Rust 目标 4.验证cargo-xwin是否已安装 ### 未找到证书 1. 验证证书是否安装在 Windows 证书存储中 2. 检查指纹是否完全匹配（无空格） 3. 确保证书具有私钥访问权限

分发 Windows 版 Tauri

包含技能