快速上手WinFormium：用HTML5构建现代化Windows桌面应用

WinFormium是一个基于Chromium Embedded Framework（CEF）的开源项目，让.NET开发者能够使用HTML5、CSS3和JavaScript等前端技术来创建功能丰富的Windows桌面应用程序。本文将带你从零开始，在10分钟内创建你的第一个WinFormium应用。

开发环境快速配置

开始之前，请确保你的环境满足以下要求：

必备组件：

• Visual Studio 2019或更高版本
• .NET 6.0 SDK或更高版本

三步创建你的首个WinFormium应用

第一步：创建项目基础结构

打开Visual Studio，选择创建新的Windows窗体应用项目。无论是选择.NET Framework还是.NET Core版本，WinFormium都能完美支持。

第二步：安装核心NuGet包

通过NuGet包管理器安装WinFormium的核心组件：

Install-Package NetDimension.NanUI
Install-Package NetDimension.NanUI.Runtime

对于.NET Framework项目，可能还需要安装以下预览版依赖：

Install-Package SharpGen.Runtime -Version 2.1.2-beta
Install-Package SharpGen.Runtime.COM -Version 2.1.2-beta

第三步：配置应用启动入口

修改Program.cs文件，设置WinFormium应用的启动配置：

using WinFormium;

class Program
{
    [STAThread]
    static void Main()
    {
        var appBuilder = WinFormiumApp.CreateBuilder();
        appBuilder.UseWinFormiumApp<MyApplication>();
        var app = appBuilder.Build();
        app.Run();
    }
}

创建应用配置类

新建MyApplication.cs文件，继承WinFormiumStartup基类，配置应用初始化流程：

using WinFormium;

class MyApplication : WinFormiumStartup
{
    protected override MainWindowCreationAction? UseMainWindow(MainWindowOptions options)
    {
        return options.UseMainFormium<MainWindow>();
    }

    protected override void WinFormiumMain(string[] args)
    {
        ApplicationConfiguration.Initialize();
    }

    protected override void ConfigurationChromiumEmbedded(ChromiumEnvironmentBuiler builder)
    {
        // 在此处配置CEF环境参数
    }

    protected override void ConfigureServices(IServiceCollection services)
    {
        // 配置依赖注入服务
    }
}

设计现代化应用窗口

新建MainWindow.cs文件，创建继承自Formium的主窗口类：

using WinFormium;
using WinFormium.Forms;

class MainWindow : Formium
{
    public MainWindow()
    {
        Url = "https://cn.bing.com"; // 设置首页地址
    }

    protected override FormStyle ConfigureWindowStyle(WindowStyleBuilder builder)
    {
        var style = builder.UseSystemForm();
        style.TitleBar = false; // 禁用系统标题栏
        style.DefaultAppTitle = "我的首个HTML5桌面应用";
        return style;
    }
}

运行与效果验证

完成配置后，编译并运行项目，你将看到：

• 一个显示必应搜索页面的现代化窗口
• 无传统标题栏的简洁界面设计
• 可通过拖动边框调整窗口尺寸

核心概念快速理解

Formium类：WinFormium框架的核心组件，代表一个能够加载和显示网页内容的窗口，继承自Windows窗体的Form基类。

自定义窗口样式：通过设置TitleBar = false，你可以完全控制窗口的外观和行为，为UI设计提供无限可能。

常见配置问题

Q: 如何为自定义窗口添加控制按钮？ A: 可以通过HTML/CSS设计界面元素，然后使用JavaScript与C#代码进行交互。

Q: 如何配置CEF运行时参数？ A: 在ConfigurationChromiumEmbedded方法中设置缓存路径、GPU加速等选项。

进阶学习路径

1. 掌握自定义标题栏和控制按钮的实现
2. 学习C#与JavaScript的双向通信机制
3. 了解应用打包和分发的最佳实践

通过这个快速入门指南，你已经成功创建了一个基础的WinFormium应用程序。WinFormium的强大之处在于它将Web技术的灵活性与Windows桌面应用的稳定性完美结合，为现代桌面应用开发开辟了新的道路。