WinFormium 是 .NET 平台上的一个开源框架

<p align="center"> <img src="./artworks/WinFormiumLogo.png" width="144" /> </p> <h1 align="center">WinFormium 项目（曾用名：NanUI）</h1> <p align="center"><strong>用 HTML, CSS 和 JavaScript 轻松构建功能强大的 WinForm 应用程序。</strong></p> # WinFormium Click [[Here]](https://github.com/XuanchenLin/NanUI) to see the English version.    一直以来 NanUI 的发型版本都处于测试阶段，经过了 9 年的迭代，是时候为 NanUI 发布正式版了！在 NanUI v1.0 正式版发布时，将正式启用项目的新名称 - **WinFormium** ## ⭐ 关于 WinFormium 是 .NET 平台上的一个开源框架（曾用名：NanUI），用于使用 HTML5、CSS3 和 JavaScript 创建 WinForm 应用程序的用户界面。 它基于 [Xilium.CefGlue](https://bitbucket.org/xilium/xilium.cefglue/wiki/Home) 项目，该项目是 [Chromium Embedded Framework (CEF)](https://bitbucket.org/chromiumembedded/cef) 的 .NET 实现。 如果您正在寻找一个用于创建具有现代用户界面的 WinForm 应用程序的框架，WinFormium 是一个不错的选择。 您可以使用 HTML、CSS 和 JavaScript 创建用户界面，并使用 C# 编写应用程序的业务逻辑。 **如果您喜欢 👍，请给 WinFormium 项目一颗星 ⭐。** 如果这个项目对你有帮助，请考虑资助它。 [](docs/assets/qrcode.png) [](docs/assets/qrcode.png) ## 🖥️ 环境要求 **开发环境** - .NET Framework 4.6.2 或更高版本 / .NET 6.0 或更高版本 - Visual Studio 2019 或更高版本（强烈建议使用 VS2022） **部署环境** - Microsoft Windows 7 Service Pack 1 或更高版本 - .Net Framework 4.6.2 或更高版本 - .NET 6.0 需要 Windows 7 Service Pack 1 或更高版本 - .NET 7.0/8.0 需要 Windows 10 或 Windows 11 这是一个 **仅限 Windows** 的框架，所以它目前不能在 Linux 或者 MacOS 环境运行。 支持的最低 Windows 版本是 Windows 7 Service Pack 1，并且 Windows 7 不支持某些功能（例如 DirectComposition 离屏渲染）。 ## 🧰 入门 按照以下步骤即可创建一个简单的 WinFormium 应用程序： **1. 通过默认模板创建一个 WinForm 应用程序。** **2. 安装 WinFormium NuGet 包** 打开 NuGet 包管理器来安装或使用 NuGet 包管理器控制台，然后运行以下命令来安装 WinFormium nuget 包： ```powershell PM> Install-Package NetDimension.NanUI ``` 安装 WinFormium 所依赖的 Chromium Embedded Framework 依赖项： ```powershell PM> Install-Package NetDimension.NanUI.Runtime ``` CEF 运行库巨大，再加上众所周知的原因，中国内地玩家请自行设置 NuGet 使用国内镜像。 - **Azure CDN** - https://nuget.cdn.azure.cn/v3/index.json - **华为云** - https://repo.huaweicloud.com/repository/nuget/v3/index.json **3. 一个基本的 WinFormium 应用程序需要以下代码：** 按如下示例修改 **Program.cs** 文件中的代码： ```csharp using WinFormium; class Program { [STAThread] static void Main(string[] args) { var builder = WinFormiumApp.CreateBuilder(); builder.UseWinFormiumApp<MyApp>(); var app = builder.Build(); app.Run(); } } ``` 创建一个类继承 **WinFormiumStartup** 来配置应用程序： ```csharp using WinFormium; class MyAPP : WinFormiumStartup { protected override MainWindowCreationAction? UseMainWindow(MainWindowOptions opts) { // 设置应用程序的主窗体 return opts.UseMainFormium<MyWindow>(); } protected override void WinFormiumMain(string[] args) { // Main函数中的代码应该在这里，该函数只在主进程中运行。这样可以防止子进程运行一些不正确的初始化代码。 ApplicationConfiguration.Initialize(); } protected override void ConfigurationChromiumEmbedded(ChromiumEnvironmentBuiler cef) { // 在此处配置 Chromium Embedded Framwork } protected override void ConfigureServices(IServiceCollection services) { // 在这里配置该应用程序的服务 } } ``` 创建一个类实现 **Formium**，用于配置应用程序的主窗口： ```csharp using WinFormium; using WinFormium.Forms; class MyWindow : Formium { public MyWindow() { Url = "https://www.google.com"; } protected override FormStyle ConfigureWindowStyle(WindowStyleBuilder builder) { // 此处配置窗口的样式和属性，或留空以使用默认样式 var style = builder.UseSystemForm(); style.TitleBar = false; style.DefaultAppTitle = "My first WinFomrim app"; return style; } } ``` **4. 生成并运行你的第一个 WinFormium 应用程序** ## 📖 文档 有关更多信息，请参阅 - [文档](docs/README.md) 或 [Wiki](https://gitee.com/dotnetchina/NanUI/wikis)。 ## 🤖 示例代码 - [Minimal WinFormium App](./examples/MinimalWinFormiumApp) - 介绍 WinFormium 的基本用法。 ## 🔗 第三方库引用和工具集 - CEF - [https://bitbucket.org/chromiumembedded/cef]() - Xilium.CefGlue - [https://gitlab.com/xiliumhq/chromiumembedded/cefglue]() - Vanara.Library - [https://github.com/dahall/Vanara/]() - Vortice.Windows - [https://github.com/amerkoleci/Vortice.Windows]() - SkiaSharp - [https://github.com/mono/SkiaSharp]() - React - [https://github.com/facebook/react]() - React-Router - [https://github.com/remix-run/react-router]() - Vite - [https://github.com/vitejs/vite]() ## 🏆 灵感来源 在创建此版本的 WinFormium 时，我受到以下歌曲和专辑的启发，特此感谢。 - **Strandels** - Chance Of Rain - **One Direction** - What a Feeling (Made In The A.M.) - **Thomas Rhett** - VHS (Center Point Road) - **Sammy Kershaw** - She Don't Know She's Beautiful (Haunted Heart) - **Chrissy Steele** - Two Bodies (Magnet To Steele) - **Halestorm** - I Like It Heavy (Into the Wild Life) - **Joan Jett & The Blackhearts** - I Hate Myself for Loving You (Up Your Alley)