Squirrel.Windows项目入门指南：应用程序打包全流程解析

Squirrel.Windows项目入门指南：应用程序打包全流程解析

Squirrel.Windows An installation and update framework for Windows desktop apps 项目地址: https://gitcode.com/gh_mirrors/sq/Squirrel.Windows

前言

Squirrel.Windows是一个强大的Windows应用程序自动更新框架，它简化了应用程序的打包、分发和更新流程。本文将深入讲解Squirrel.Windows项目中的打包环节，帮助开发者掌握从构建到发布的完整流程。

一、打包前的准备工作

1.1 版本控制

在开始打包前，必须正确设置应用程序版本号。这是Squirrel更新机制的基础。

// 在Properties/AssemblyInfo.cs文件中设置
[assembly: AssemblyVersion("1.0.0")]
[assembly: AssemblyFileVersion("1.0.0")]

最佳实践：

• 遵循语义化版本控制规范(Major.Minor.Patch)
• 每次发布新版本时递增版本号
• 保持AssemblyVersion和AssemblyFileVersion一致

1.2 构建配置

确保使用Release模式构建应用程序：

1. 在Visual Studio中选择"Release"配置
2. 清理并重新构建解决方案
3. 确认bin/Release目录包含所有必需文件

二、创建NuGet包

Squirrel使用NuGet包格式作为应用程序分发的基础格式。以下是详细步骤：

2.1 包结构规范

正确的包结构对Squirrel至关重要：

lib/
└── net45/
    ├── MyApp.exe
    ├── MyApp.exe.config
    ├── Squirrel.dll
    └── 其他依赖文件

2.2 使用NuGet Package Explorer

1. 创建新包：

   • 打开NuGet Package Explorer
   • 选择"Create a new package"

2. 编辑元数据：

   • ID：应用程序名称（无空格）
   • 版本：与AssemblyInfo.cs一致
   • 作者：您的名称或公司
   • 描述：应用程序简介

3. 添加文件：

   • 创建lib/net45目录结构
   • 添加所有必需文件：
     • 应用程序主程序及配置文件
     • 非标准.NET DLL依赖项
     • Squirrel运行时文件

4. 排除文件：

   • 调试文件(*.pdb)
   • Visual Studio宿主进程文件(.vshost.)

5. 保存包：

   • 使用标准命名格式：MyApp.1.0.0.nupkg
   • 建议保存在解决方案根目录

三、Releasify过程详解

Releasify是Squirrel特有的过程，它将NuGet包转换为可分发格式。

3.1 执行Releasify

在Visual Studio的包管理器控制台中运行：

Squirrel --releasify MyApp.1.0.0.nupkg

常见问题解决：

• 如果提示"Squirrel不可识别"，尝试重启Visual Studio
• 确保NuGet包路径正确
• 检查是否有足够的磁盘空间

3.2 Releasify输出内容

命令执行后会生成以下文件结构：

Releases/
├── Setup.exe
├── RELEASES
├── MyApp.1.0.0-full.nupkg
└── MyApp.1.0.0-delta.nupkg (仅更新时生成)

文件说明：

1. Setup.exe：安装引导程序
2. RELEASES：版本清单文件
3. -full.nupkg：完整应用包
4. -delta.nupkg：差异更新包（节省带宽）

四、高级打包技巧

4.1 自动化构建

建议将打包过程集成到CI/CD流程中：

• 使用MSBuild任务自动设置版本号
• 在Post-build事件中调用NuGet pack
• 自动执行releasify命令

4.2 包优化建议

1. 文件精简：

   • 只包含运行时必需文件
   • 移除调试符号
   • 压缩资源文件

2. 签名验证：

   • 为Setup.exe添加数字签名
   • 验证NuGet包的完整性

3. 多版本管理：

   • 保持Releases目录结构清晰
   • 定期清理旧版本包

五、后续步骤

完成打包后，您可以：

1. 测试安装程序功能
2. 部署到更新服务器
3. 配置自动更新策略

通过本文的详细指导，您应该已经掌握了使用Squirrel.Windows打包应用程序的核心流程。正确的打包是确保自动更新功能正常工作的基础，建议在实际操作中严格遵循规范。

Squirrel.Windows An installation and update framework for Windows desktop apps 项目地址: https://gitcode.com/gh_mirrors/sq/Squirrel.Windows