NanUI项目WinFormium应用打包指南

NanUI项目WinFormium应用打包指南

NanUI NanUI is an open source .NET project for .NET developers who want to create desktop applications with HTML, CSS and JavaScript. 项目地址: https://gitcode.com/gh_mirrors/na/NanUI

前言

NanUI是一个基于Chromium的.NET WinForms界面框架，使用WinFormium开发应用后，如何正确打包应用程序是开发者需要掌握的重要技能。本文将详细介绍WinFormium应用打包的完整流程和注意事项，帮助开发者快速掌握打包技巧。

传统项目打包方案

对于使用传统.NET项目格式开发的WinFormium应用，打包过程需要开发者手动组织文件结构。以下是详细步骤：

1. 编译项目

首先使用Release配置编译项目，编译完成后在项目输出文件夹中可以找到以下内容：

• 主程序可执行文件(.exe)
• 配置文件(.exe.config)
• 项目依赖的DLL文件

2. 添加CEF运行时文件

WinFormium依赖于CEF运行时环境，需要将相关文件一并打包。根据项目平台架构的不同，处理方式有所差异：

AnyCPU架构

需要打包整个fx文件夹，结构如下：

[bin]
|- [Release]
|--- YourApp.exe
|--- YourApp.exe.config
|--- Dependence1.dll
|--- ...
|--- [fx]
|----- *.*

x86/x64架构

需要选择性打包特定文件，结构如下：

[bin]
|- [Release]
|--- [locales]
|----- *.*
|--- YourApp.exe
|--- YourApp.exe.config
|--- Dependence1.dll
|--- ...
|--- chrome_elf.dll
|--- libcef.dll
|--- 其他CEF核心文件

3. 文件验证

打包前务必验证文件结构是否正确：

1. 按照上述结构组织文件
2. 直接运行主程序
3. 观察是否能正常启动和运行

验证通过后，即可使用任何安装程序制作工具(如Inno Setup、NSIS等)进行打包。

SDK风格项目打包方案

对于使用新式SDK项目格式的应用，Visual Studio提供了更便捷的发布方式：

1. 右键点击项目文件
2. 选择"发布"选项
3. 按照发布向导完成操作

多进程应用特殊处理

如果应用采用了主进程+子进程的架构，需要特别注意：

• 确保子进程项目的输出文件也被包含在发布文件夹中
• 可通过修改项目文件自动复制子进程输出文件
• 或手动将子进程相关文件复制到主进程输出目录

重要注意事项

1. 避免使用单文件发布：当前WinFormium对单文件发布模式支持不完善，可能导致CEF运行时文件无法正确加载。

2. 平台一致性：确保打包的CEF运行时文件与项目目标平台(x86/x64/AnyCPU)完全匹配。

3. 文件完整性：CEF运行时依赖大量文件，缺少任何一个关键文件都可能导致应用无法启动。

4. 测试验证：打包完成后，应在干净环境中测试安装包，确保所有依赖项都被正确安装。

最佳实践建议

1. 使用专业打包工具：推荐使用专业的安装程序制作工具，它们能更好地处理文件依赖和安装逻辑。

2. 考虑自动更新：对于需要频繁更新的应用，建议集成自动更新机制。

3. 精简文件体积：可以移除locales文件夹中不需要的语言文件，减小安装包体积。

4. 签名验证：对发布的可执行文件进行数字签名，提高用户信任度。

通过遵循以上指南，开发者可以确保WinFormium应用打包过程顺利进行，最终交付给用户完整可用的应用程序。

NanUI NanUI is an open source .NET project for .NET developers who want to create desktop applications with HTML, CSS and JavaScript. 项目地址: https://gitcode.com/gh_mirrors/na/NanUI