PACKAGING_GUIDE.md 4.4 KB

🚀 Windows 打包指南

📦 已创建的打包脚本

我为你的 Tauri 项目创建了完整的 Windows 打包工具:

📋 脚本文件

  1. build-windows.ps1 - PowerShell 打包脚本(推荐)

    • 功能最全,支持参数配置
    • 自动环境检查和错误处理
    • 彩色输出和进度显示
  2. build-windows.bat - 批处理打包脚本

    • 简单易用,无需 PowerShell
    • 适合所有 Windows 环境
  3. check-env.bat - 环境检查脚本

    • 验证构建环境是否正确
    • 检查所有必需的工具和依赖
  4. WINDOWS_BUILD_README.md - 详细使用说明

    • 完整的使用指南
    • 故障排除和常见问题

🏃‍♂️ 快速开始

第一步:检查环境

# 双击运行或在命令提示符中运行
check-env.bat

这个脚本会检查:

  • ✅ Node.js 16+
  • ✅ npm
  • ✅ Rust/Cargo 1.60+
  • ✅ Visual Studio Build Tools
  • ✅ 项目配置文件

第二步:开始打包

如果环境检查通过,运行打包脚本:

方法一:PowerShell 脚本(推荐)

.\build-windows.ps1

方法二:批处理脚本

build-windows.bat

📁 输出文件位置

打包完成后,exe 文件位于:

src-tauri/target/release/bundle/msi/
├── 游铛铛_0.1.0_x64.msi    # Windows 安装包
└── 游铛铛_0.1.0_x64.exe    # 便携版 exe(如果配置了)

⚙️ PowerShell 脚本参数

# 基本打包
.\build-windows.ps1

# 清理构建缓存后重新构建
.\build-windows.ps1 -Clean

# 跳过依赖安装
.\build-windows.ps1 -SkipDeps

# 显示详细输出
.\build-windows.ps1 -Verbose

🔧 系统要求

必需软件

  1. Node.js 16+

  2. Rust 1.60+

  3. Visual Studio Build Tools ⚠️ 重要

安装提示

如果缺少 Visual Studio Build Tools:

  1. 访问 https://visualstudio.microsoft.com/downloads/
  2. 下载 "Build Tools for Visual Studio"
  3. 运行安装程序
  4. 选择 "C++ build tools" 工作负载
  5. 安装 Windows 10 SDK(或更高版本)

📊 构建流程

脚本会自动执行以下步骤:

  1. 环境验证 - 检查所有必需工具
  2. 依赖安装 - npm install
  3. 浏览器下载 - 下载 Chromium 到项目目录
  4. Rust 构建 - 编译 Tauri Rust 后端
  5. 前端构建 - 构建 Vue.js 应用
  6. 打包 - 生成最终的 exe 文件

🎯 使用生成的应用

安装版(.msi)

  • 双击安装到系统
  • 会添加到开始菜单

便携版(.exe)

  • 直接双击运行
  • 无需安装,绿色软件
  • 可移动到任何目录

🚨 常见问题

构建失败

问题1:LINK 错误

LINK : fatal error LNK1104: cannot open file 'kernel32.lib'

解决:重新安装 Visual Studio Build Tools,确保选择了 C++ 组件

问题2:网络超时

npm ERR! network timeout

解决:检查网络连接,或使用国内镜像

问题3:权限不足

Access denied

解决:以管理员身份运行命令提示符

环境问题

问题:工具未找到

  • 确保所有工具都添加到 PATH 环境变量
  • 重启命令提示符/PowerShell

问题:版本过低

  • Node.js 建议使用 16+
  • Rust 建议使用 1.60+

🔄 重新构建

如果需要重新构建:

# 清理所有缓存
.\build-windows.ps1 -Clean

# 或手动清理
Remove-Item node_modules -Recurse -Force
Remove-Item src-tauri/target -Recurse -Force
Remove-Item browsers -Recurse -Force

📞 获取帮助

  1. 首先运行 check-env.bat 检查环境
  2. 查看 WINDOWS_BUILD_README.md 详细说明
  3. 检查项目中的 BUILD_GUIDE.md
  4. 如有问题,可查看脚本中的错误信息

🎉 成功标志

当看到以下输出时,表示打包成功:

✅ 构建完成!
📁 输出位置: src-tauri/target/release/bundle/msi/
📦 生成的文件: 游铛铛_0.1.0_x64.msi
🎉 打包成功!

开始使用:

  1. 双击 check-env.bat 检查环境
  2. 如果检查通过,双击 build-windows.bat 开始打包
  3. 等待构建完成,获取你的 exe 文件!

如有任何问题,请查看详细的 WINDOWS_BUILD_README.md 文件。