建立 WinForms 軟體安裝程式

安裝「安裝範本」套件

下載並安裝 Microsoft Visual Studio Installer Projects 2022 這個套件,或是依照下面的步驟一步一步來。

首先先在 Visual Studio 工具列選擇「延伸模組」> 管理延伸模組

在右上角的搜尋框中輸入 installer ,找到 Microsoft Visual Studio Installer Projects 2022,點選下載:

然後關閉 Visual Studio ,依照步驟完成套件安裝:

建立「安裝範本」專案

重新開啟 Visual Studio 並回到專案後,在側邊欄的「方案總管」中,使用滑鼠右鍵點擊「解決方案」 > 加入 > 新增專案:

找到 Setup Project 範本,點選下一步:

這個示範專案筆者就直接將名稱命名為 Setup ,通常會命名為專案顯示名稱(英文)+Setup。
點選 Application Folder,在右側的視窗中使用滑鼠右鍵點擊,點選 Add > 專案輸出:

選擇發布項目,組態選擇「(作用中)」

點選 SetUp 專案,在「屬性」中的 Manufacturer 請調整為可辨識的名稱,這裡會影響到專案安裝的路徑

以預設的內容為例安裝後會儲存到此路徑:
    
C:\Program Files (x86)\Default Company Name\Setup\
    

如果想要發布為 x64 的話也可以調整「屬性」中的 TargetPlatform 為 x64,這樣預設安裝連結就會變為:
    
C:\Program Files\Default Company Name\Setup\
    

建立應用程式捷徑

使用滑鼠右鍵點擊建立的內容,選擇「Create Shortcut to 發布項目 from ...」

這個是安裝後會產生的應用程式捷徑,可以在「屬性」中調整顯示名稱:

自訂 icon

在畫面上使用滑鼠右鍵點擊,選擇 Add > 檔案 ,選擇要用來設定為應用程式圖示的 .ico 檔案

點選剛剛建立的捷徑,點擊「屬性」中的 Icon 欄位,選擇 Browse... ,找到剛剛加入的 .ico 檔案,點選 Ok

然後把這個捷徑「剪下」,到 User's Desktop 中貼上,安裝完畢後就會在使用者的桌面上自動建立捷徑了

如果要在開始選單中出現「應用程式捷徑」的話就要把上面的步驟再做一次,然後貼上到 User's Programs Menu 中(因為沒有複製功能...)

發布安裝檔

要正式發布,我們會把上方的 Debug 切換為 Release ,然後在「方案總管」中使用滑鼠右鍵點擊「Setup」,點選建置。
等建置完成後再次點選滑鼠右鍵,選擇「再檔案總管中開啟資料夾」

就會在 Release 資料夾中看到我們剛剛發布的安裝檔了:

使用安裝檔安裝應用程式

點擊 Setup.msi 檔案就可以安裝程式了:

安裝時自動安裝依賴檔案

目前的安裝檔沒有包含依賴套件,如果拿去沒有安裝 .NET Desktop Runtime 的電腦上安裝就會彈出下面的錯誤訊息,要求使用者自行去網頁下載和安裝:

使用滑鼠右鍵點擊 Setup 專案 > 屬性,在屬性頁中點選「Prerequisites...」,依照框架選擇執行階段(筆者這裡是使用 .NET 8 ,64 位元,選擇 .NET Desktop 執行階段 8.0.4 (x64) ),點選確定

這樣在執行 setup.exe 時就會自動檢查是否已經安裝套件,沒有的話就會跳出視窗協助安裝:


註:發布時會產出 setup.exe 和 Setup.msi ,需要點擊 setup.exe 才會檢查是否已安裝元件,但是還是需要保留 Setup.msi ,才可以正常安裝應用程式。在筆者的測試中如果不需要檢查元件則可以省略 setup.exe 檔案

留言