34.7 发布桌面程序（WinForm/WPF）

版本说明

以下内容仅限 Furion 4.8.7.28 + 版本使用。

Furion 框架灵活的架构模式使得 Web 和各客户端（WinForm/WPF/Console）项目之间迁移变得非常简单，只需要极少数修改即可实现无缝迁移。

通过这种方式可以实现类似前端的 Electron/Tauri 混合式开发。

本章节提供如何将 Web 项目发布（迁移）到 WinForm/WPF 中，同样也适合控制台应用程序。

34.7.1 迁移步骤

34.7.1.1 创建 `WinForm/WPF` 项目

通过 Visual Studio 创建 WinForm/WPF 项目，同样适合控制台项目。

34.7.1.2 初始化 `WinForm/WPF` 配置

WinForm 初始化

namespace WinFormsApp1;

internal static class Program
{
    [STAThread]
    private static void Main()
    {
        Serve.RunNative(RunOptions.Default);    // 默认 5000 端口，如果出现占用，推荐使用下面的方式
        // Serve.RunNative(RunOptions.Default, Serve.IdleHost.Urls);   // 随机端口

        ApplicationConfiguration.Initialize();
        Application.Run(Native.CreateInstance<Form1>());
    }
}

关于 Web 主机环境

默认情况下，通过 WinForm 启动 Web 主机环境总是为 Production，但在开发阶段可能会出现配置加载错误问题，这时只需要添加 ConfigureOptions 配置即可，如：

Serve.RunNative(RunOptions.Default
     .ConfigureOptions(new WebApplicationOptions
    {
        // Debugger.IsAttached 可判断释放为 Debug 模式
        EnvironmentName = Debugger.IsAttached ? "Development" : default
    }));

WPF 初始化

using System.Windows;

namespace WpfApp1;

public partial class App : Application
{
    public App()
    {
        Serve.RunNative(RunOptions.Default);    // 默认 5000 端口，如果出现占用，推荐使用下面的方式
        // Serve.RunNative(RunOptions.Default, Serve.IdleHost.Urls);   // 随机端口
    }

    protected override void OnStartup(StartupEventArgs e)
    {
        Native.CreateInstance<MainWindow>().Show();
        base.OnStartup(e);
    }
}

关于 Web 主机环境

默认情况下，通过 WPF 启动 Web 主机环境总是为 Production，但在开发阶段可能会出现配置加载错误问题，这时只需要添加 ConfigureOptions 配置即可，如：

Serve.RunNative(RunOptions.Default
     .ConfigureOptions(new WebApplicationOptions
    {
        // Debugger.IsAttached 可判断释放为 Debug 模式
        EnvironmentName = Debugger.IsAttached ? "Development" : default
    }));

34.7.1.3 添加 `YourProject.Web.Core` 层引用

<ItemGroup>
    <ProjectReference Include="..\Your.Web.Core\Furion.Web.Core.csproj" />
</ItemGroup>

34.7.1.4 拷贝 `YourProject.Web.Entry` 内容

如果有 YourProject.Web.Entry 启动层包含 *.json 文件、Controllers、Views 、wwwroot 目录则拷贝到 WinForm/WPF 中

34.7.2 配置 `WinForm/WPF` 项目文件

双击 WinForm/WPF 项目进入 .csproj 文件编辑。

34.7.2.1 修改 `Sdk` 属性

将 Sdk="Microsoft.NET.Sdk" 修改为 Sdk="Microsoft.NET.Sdk.Razor"

<Project Sdk="Microsoft.NET.Sdk.Razor">

34.7.2.2 添加 `MVC/Razor` 支持

WinForm

<Project Sdk="Microsoft.NET.Sdk.Razor">

	<PropertyGroup>
		<OutputType>WinExe</OutputType>
		<TargetFramework>net7.0-windows</TargetFramework>
		<Nullable>enable</Nullable>
		<UseWindowsForms>true</UseWindowsForms>
		<ImplicitUsings>enable</ImplicitUsings>
		<SatelliteResourceLanguages>en-US</SatelliteResourceLanguages>
		<PublishReadyToRunComposite>true</PublishReadyToRunComposite>
		<AddRazorSupportForMvc>true</AddRazorSupportForMvc>
	</PropertyGroup>

</Project>

WPF

<Project Sdk="Microsoft.NET.Sdk.Razor">

	<PropertyGroup>
		<OutputType>WinExe</OutputType>
		<TargetFramework>net7.0-windows</TargetFramework>
		<Nullable>enable</Nullable>
		<ImplicitUsings>enable</ImplicitUsings>
		<UseWPF>true</UseWPF>
		<SatelliteResourceLanguages>en-US</SatelliteResourceLanguages>
		<PublishReadyToRunComposite>true</PublishReadyToRunComposite>
		<AddRazorSupportForMvc>true</AddRazorSupportForMvc>
	</PropertyGroup>

</Project>

34.7.2.3 添加 `wwwroot` 静态发布配置

如果 YourProject.Web.Entry 包含 wwwroot 目录，则添加以下配置，否则跳过。

<ItemGroup>
	<Content Update="wwwroot\**\*">
		<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
	</Content>
</ItemGroup>

34.7.2.4 完整配置

完整的配置大概如下：

WinForm

<Project Sdk="Microsoft.NET.Sdk.Razor">

	<PropertyGroup>
		<OutputType>WinExe</OutputType>
		<TargetFramework>net7.0-windows</TargetFramework>
		<Nullable>enable</Nullable>
		<UseWindowsForms>true</UseWindowsForms>
		<ImplicitUsings>enable</ImplicitUsings>
		<SatelliteResourceLanguages>en-US</SatelliteResourceLanguages>
		<PublishReadyToRunComposite>true</PublishReadyToRunComposite>
		<AddRazorSupportForMvc>true</AddRazorSupportForMvc>
	</PropertyGroup>

	<ItemGroup>
		<Content Update="wwwroot\**\*">
			<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
		</Content>
	</ItemGroup>

	<ItemGroup>
		<ProjectReference Include="..\Furion.Web.Core\Furion.Web.Core.csproj" />
	</ItemGroup>

</Project>

WPF

<Project Sdk="Microsoft.NET.Sdk.Razor">

    <PropertyGroup>
        <OutputType>WinExe</OutputType>
        <TargetFramework>net7.0-windows</TargetFramework>
        <Nullable>enable</Nullable>
        <ImplicitUsings>enable</ImplicitUsings>
        <UseWPF>true</UseWPF>
        <SatelliteResourceLanguages>en-US</SatelliteResourceLanguages>
		<PublishReadyToRunComposite>true</PublishReadyToRunComposite>
        <AddRazorSupportForMvc>true</AddRazorSupportForMvc>
    </PropertyGroup>

	<ItemGroup>
		<Content Update="wwwroot\**\*">
			<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
		</Content>
	</ItemGroup>

	<ItemGroup>
		<ProjectReference Include="..\Furion.Web.Core\Furion.Web.Core.csproj" />
	</ItemGroup>

</Project>

37.7.3 嵌入 `WebView2`

我们可以在 WinForm/WinForm 层添加 Microsoft.Web.WebView2 包，然后在窗口中添加 WebView2 组件，实现类似前端 Electron.js 混合开发。

37.7.3.1 添加 `WebView2` 拓展

dotnet add package Microsoft.Web.WebView2

特别注意

Microsoft.Web.WebView2 v1.0.1722.32 版本存在很严重问题（微软错误更新），所以避免安装该版本。

37.7.3.2 添加 `WebView2` 控件并填充窗口

WinForm

using Microsoft.AspNetCore.Hosting.Server;
using Microsoft.Extensions.Hosting;

namespace WinFormsApp1;

public partial class Form1 : Form
{
    public Form1(IServer server)	// 注入 IServer 服务，获取 Web 启动地址/端口
    {
        InitializeComponent();

        webview.Dock = DockStyle.Fill;
        webview.Source = new Uri(server.GetServerAddress());
    }
}

WPF

<Wpf:WebView2 Name="webview" />

using Microsoft.AspNetCore.Hosting.Server;
using Microsoft.Extensions.Hosting;
using System.Windows;

namespace WpfApp1;

public partial class MainWindow : Window
{
    public MainWindow(IServer server)   // 注入 IServer 服务，获取 Web 启动地址/端口
    {
        InitializeComponent();
        webview.Source = new Uri(server.GetServerAddress());
    }
}

34.7.3.3 预览效果

34.7.4 发布 `WinForm/WPF`

34.7.4.1 启动层添加 `SingleFilePublish`

通常桌面软件都是发布为不依赖环境（独立发布），所以在启动层添加 SingleFilePublish.cs 文件编辑。

详细教程可查看【34.5 单文件发布】

using Furion;
using System.Reflection;

namespace WinFormsApp1;

public class SingleFilePublish : ISingleFilePublish
{
    public Assembly[] IncludeAssemblies()
    {
        return Array.Empty<Assembly>();
    }

    public string[] IncludeAssemblyNames()
    {
        return new[]
        {
            "Furion.Application",
            "Furion.Core",
            "Furion.EntityFramework.Core",
            "Furion.Web.Core"
        };
    }
}