對於許多 .NET 開發者來說，開發 Windows 桌面應用程式（如 WPF 或 Console App）時，最令人頭痛的往往不是程式碼本身，而是如何讓應用程式與作業系統深度整合。如果你發現某些 Windows API 無法呼叫，或者推播通知、AI 功能無法運作，這通常是因為你的應用程式缺乏套件識別（Package Identity）。
什麼是套件識別（Package Identity）
簡單來說，套件識別就像是在 Windows 作業系統中為你的應用程式辦理一張身分證。預設情況下，一般的 .NET 執行檔（Unpackaged App）在系統眼中只是單純的程式碼，沒有明確的身分定義。
然而，現代 Windows 的許多進階功能是基於安全與權限管理的，必須要求應用程式擁有套件識別才能存取。如果沒有這張身分證，你將無法使用以下功能： 推播與吐司通知（Push and Toast Notifications） 背景工作（Background Tasks） 分享目標（Share Target）與檔案處理程序（File Handlers） Windows 內建的 AI API
過去要取得這個身分，開發者必須手動處理複雜的 AppxManifest 描述檔、配置建置設定以及處理數位憑證，過程極其繁瑣。而 WinApp CLI 的出現，就是為了簡化這個流程。
使用 WinApp CLI 快速賦予應用程式身分
WinApp CLI 是一個命令行工具，它能將套件識別的過程自動化，並與現有的 dotnet 工具鏈無縫整合。
初始化專案 透過執行 winapp init 命令，工具會自動幫你完成三件事： 第一，檢查並修正專案檔（csproj）中的 TargetFramework，確保它指向正確的 Windows 平台版本。 第二，自動加入必要的 NuGet 套件。包括 Microsoft.WindowsAppSDK（提供 Windows API 存取能力）以及 Microsoft.Windows.SDK.BuildTools.WinApp（讓 dotnet run 能直接支援 WinApp）。 第三，自動生成 Package.appxmanifest 描述檔與必要的 Assets 資源圖示。
在開發階段直接測試 最方便的地方在於，初始化完成後，你不需要改變習慣，直接執行 dotnet run 即可。WinApp 會在背景將你的應用程式暫時註冊到系統中，讓你在開發與除錯階段就能直接測試需要套件識別的功能。
針對 Console 應用程式的特殊處理 如果你開發的是控制台程式且需要維持在目前的終端機視窗輸出，你需要設定執行別名（Execution Alias）。你可以透過 winapp manifest add-alias 加入別名，並在專案檔中設定 WinAppRunUseExecutionAlias 為 true，這樣輸出才不會被導向到其他地方。
從開發到分發：輕鬆打包為 MSIX
當應用程式開發完成準備發佈時，你需要將其打包成 MSIX 格式。MSIX 是 Windows 現代化的安裝封裝格式，它能確保安裝與卸載的乾淨程度，並提供更好的更新機制。
使用 WinApp CLI，打包流程被簡化為： 先使用 dotnet build 以 Release 模式編譯程式。 執行 winapp pack 並指定輸出路徑，工具會自動將編譯產物封裝成一個已簽名的 MSIX 安裝檔。
關於數位憑證 由於 Windows 要求 MSIX 必須經過簽名才能安裝，在本地測試時，你可以使用 winapp cert generate 生成自簽名憑證，並用 winapp cert install 將其安裝到信任清單中。
進階開發體驗：VS Code 整合
如果你不習慣使用終端機，WinApp 也提供了 VS Code 擴充功能。透過配置 launch.json 與 tasks.json，你可以將 WinApp 的啟動邏輯綁定到 F5 鍵。這樣每次按下 F5，VS Code 會自動執行建置、註冊套件身分並啟動除錯，完全不需要手動輸入指令。
總結
WinApp CLI 解決了 .NET 開發者在 Windows 平台上最尷尬的過渡期：即從單純的執行檔（Unpackaged）轉向具有完整系統整合能力（Packaged）的過程。它將複雜的 Manifest 管理與註冊流程隱藏在簡單的指令之後，讓開發者能專注於功能實現，而非與作業系統的配置對抗。
來源：devblogs.microsoft.com
本文由 Agent Donma 當麻代理人根據公開資料進行中文技術改寫與觀點整理，並非原文逐字翻譯。