,,

C#winform軟件實現一次編譯，跨平臺windows和linux兼容運行

當前位置：點晴教程→知識管理交流 →『技術文檔交流』

admin

2025年5月19日 8:57 本文熱度 147

一、背景：

微軟的.net core開發工具，目前來看，winform界面軟件還沒有打算要支持linux系統下運行的意思，要想讓c#桌面軟件在linux系統上運行，開發起來還比較麻煩。微軟只讓c#的控制臺軟件支持在linux運行。

二、解決方案：

我想到的一個方案是自定義封裝軟件的System.Windows.Forms組件，把支持windows和linux的界面框架GTK封裝進System.Windows.Forms中！

三、組件封裝

這個System.Windows.Forms是實現C#界面的關鍵組件，Form界面的所有控件都封裝在這個組件里。在.net core環境里，這個組件在框架Microsoft.WindowsDesktop.App.WindownsForms下。當開發工程的輸出模式是“windows應用程序”時，就會自動引用Microsoft.WindowsDesktop.App.WindownsForms，如果開發工程的輸出模式是“控制臺應用程序”時，工程不會引用Microsoft.WindowsDesktop.App.WindownsForms，也無法開桌面軟件的界面。

為了兼容VS原生界面表單開發，我開發了這個組件GTKSystem.Windows.Forms，這個組件的控件類庫命名空間和類名稱沿用了原生System.Windows.Forms的類庫名稱，可以在原生開發的C#軟件工程里，直接引用GTKSystem.Windows.Forms就能兼容運行。

四、技術開發

目前實現的控件：Form、Button、CheckBox、CheckedListBox、ComboBox、DataGridView、DateTimePicker、GroupBox、Label、LinkLabel、MaskedTextBox、MenuStrip、MonthCalendar、NumericUpDown、Panel、PictureBox、RadioButton、RichTextBox、SplitContainer、SplitterPanel、TabControl、TextBox、TreeView。

以上控件都只實現了常用功能的屬性和方法，事件主要實現了鼠標事件、驗證事件、加載事件，還有很多平常不用的屬性事件已經實現了接口，但是沒有實現執行功能，主要是因為程序量太多，沒有去做。對于有能力的開發人員，組件也是可以拿到相關的屬性事件（如WidgetEvent）去實現需要的功能。

重寫的類也很多，重點說一下這幾個類：Bitmap、Image、System.ComponentModel.ComponentResourceManager、System.Resources.ResourceManager。這幾個類是Form界面引用圖像資源必需的。在控制臺程序架構里，是沒有Bitmap、Image類庫的，而且ComponentResourceManager和ResourceManager都不能讀取資源圖像數據。我在GTKSystem.Windows.Forms里封裝實現了Bitmap和Image類，實現了ComponentResourceManager和ResourceManager讀取資源圖像數據。

Bitmap和Image類除了常用屬性外，新增屬性Image.PixbufData存放圖像數據，用于GTKSystem的使用。

ComponentResourceManager和ResourceManager主要是實現了GetObject方法，讀取資源數據。

五、使用方法

修改.net core的windows應用程序工程屬性，把輸出類型改為“控制臺應用程序”，或者把windows窗體配置勾選去掉，配置變為<UseWindowsForms>false</UseWindowsForms>。

<PropertyGroup>
<OutputType>WinExe</OutputType>
<UseWindowsForms>false</UseWindowsForms>
</PropertyGroup>

1、新建System.Resources.ResourceManager類
在項目下新建System.Resources.ResourceManager類，繼承GTKSystem.Resources.ResourceManager，用于覆蓋原生System.Resources.ResourceManager類。
GTKSystem.Resources.ResourceManager實現了項目資源文件和圖像文件讀取。
如果項目里沒有使用資源圖像文件，可以不用新建此文件。

2、新建System.ComponentModel.ComponentResourceManager類
在項目下新建System.ComponentModel.ComponentResourceManager類，繼承GTKSystem.ComponentModel.ComponentResourceManager，用于覆蓋原生System.ComponentModel.ComponentResourceManager類。
GTKSystem.ComponentModel.ComponentResourceManager實現了項目資源文件和圖像文件讀取（調用GTKSystem.Resources.ResourceManager）。
如果項目里沒有使用資源圖像文件，可以不用新建此文件。

3、GTKWinFormsApp.csproj
配置UseWindowsForms為false，或者使用控制臺應用程序
<UseWindowsForms>false</UseWindowsForms>

4、引用GTKSystem.Windows.Forms、System.Resources.Extensions
System.Resources.Extensions是空程序dll，VS加載Form界面時驗證需要此dll.

5、GTKWinFormsApp\obj\Debug\netcoreapp3.1\GTKWinFormsApp.designer.runtimeconfig.json
GTKWinFormsApp\obj\Release\netcoreapp3.1\GTKWinFormsApp.designer.runtimeconfig.json
將name設置為Microsoft.WindowsDesktop.App，用于VS支持可視化Form表單，重新加載工程或重啟VS
"runtimeOptions": {
"framework": {
"name": "Microsoft.WindowsDesktop.App"
},