C#winform軟體實作一次編譯，跨平台windows和linux相容執行

2024-03-06碼農

一、背景：

微軟的.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"
},