快速入門:建立並發佈 AI 的 Windows 應用程式

在這個快速入門中,你會從一個空白資料夾切換到一個已發佈的 Windows 應用程式,並全程使用 AI 協助。 不需要 Visual Studio。

Note

偏好Visual Studio工作? 請參閱 設定適用於 Windows 開發的 GitHub Copilot。 本快速入門指南使用 VS Code 和 winapp CLI。

  • 安裝所需工具(~5分鐘)
  • 從命令列架構 WinUI 應用程式
  • 使用 winui-dev AI 代理來新增功能
  • 打包並發佈至 Microsoft Store

完成時間: 約30分鐘
費用:免費(GitHub Copilot 免費方案已足夠)


Prerequisites

在開始之前,請先安裝以下工具。 全部免費。

1. Visual Studio Code

winget install Microsoft.VisualStudioCode

2. .NET SDK 10 或更新版本

winget install Microsoft.DotNet.SDK.10

3. Windows 應用程式 Development CLI (winapp CLI)

winget install Microsoft.winappcli --source winget

4. WinUI dotnet new templates

dotnet new install Microsoft.WindowsAppSDK.WinUI.CSharp.Templates

5. GitHub CLI(執行 gh copilot 指令時必備 — 需 GitHub Copilot 訂閱,免費方案可用)

winget install GitHub.cli

Important

安裝完成後關閉並重新開啟終端機。 gh 指令要等到新的 shell 工作階段載入更新後的 PATH,才能使用。

gh auth login

6. GitHub Copilot 的 WinUI 代理插件

gh copilot plugin install winui@awesome-copilot

7. VS Code 的 WinApp 擴充功能

code --install-extension microsoft-winappcli.winapp

或者在擴充功能面板搜尋 WinApp (Ctrl+Shift+X)。 完整指令參考請參見 VS Code 工具 。

確認你的設定

winapp --version

步驟 1:搭建新的 WinUI 應用程式

建立一個新資料夾,並用 NavigationView 佈局搭建 WinUI 應用程式:

mkdir MyFirstApp
cd MyFirstApp
dotnet new winui-navview

步驟二:執行該應用程式

先建置並執行應用程式,確認一切正常運作,再開始新增功能:

dotnet run

該應用程式以鬆散版面套件啟動——無需安裝 MSIX。 你應該會看到一個 WinUI 3 應用程式,裡面有包含「首頁」、「關於」和「設定」頁面的導覽檢視:

MyFirstApp 執行截圖 — WinUI 3 視窗,導覽檢視顯示首頁、關於和設定項目,首頁顯示「這是首頁」。

成功啟動後,請用 VS Code 開啟專案:

code .

Note

在第一次成功的 之前,請勿按下 dotnet run。 VS Code 的除錯器會尋找尚不存在的 .exe。 成功後 dotnet run ,F5 和 WinApp 擴充功能面板中的 執行 按鈕都能正常運作。


步驟三:使用 AI 代理新增功能

在 VS Code 中,開啟 GitHub Copilot Chat (Ctrl+Alt+I),切換到 Agent mode,選擇 winui-dev代理。 請輸入如下請求:

Add a settings page to my WinUI NavigationView app with a toggle for dark mode

代理程式會產生程式碼、建立所需的檔案,並更新你的導航結構。 檢視變更,然後驗證結果:

dotnet run

請前往執行中的應用程式中的設定頁面確認該功能是否正確新增。

Tip

想要自動化 UI 驗證嗎? 請參閱 測試 WinUI 應用程式 ,了解 winapp ui 檢查、搜尋及截圖應用程式介面樹的指令——對 CI 管線非常有用。


步驟四:打包應用程式

先把你的應用程式發佈到資料夾,然後打包成 MSIX 安裝程式。

Important

打包步驟會將憑證安裝到您電腦上的受信任根憑證存放區,且需要使用 已提升權限的(系統管理員)終端機。 右鍵點選 PowerShell 或 Windows 終端機,選擇 以管理員身份執行,然後回到你的專案資料夾。

dotnet publish -o ./publish
winapp pack ./publish --generate-cert --install-cert

--generate-cert --install-cert 建立並安裝本地開發憑證,讓你能安裝並測試套件。 不要分發用此憑證簽署的套件。

你不需要自己的程式碼簽署憑證來發佈到 Microsoft Store,因為 Microsoft Store 會為你的套件簽署。 在提交之前,請確認你的資訊清單中的套件識別與你在 Partner Center 的應用程式身分識別相符。 依照 商店就緒檢查清單 進行,找出常見的上傳與認證程序問題。


步驟 5:發佈到 Microsoft Store

發佈有兩個部分:一次性在 Partner Center 設置,以及透過命令列提交更新。

  1. 設定你的開發者帳號。 註冊與驗證可能需要數天時間,因此請 盡早開始,最好在開始這個快速入門前。

  2. 請在 Partner Center 提交您的首次提交內容。先保留應用程式名稱,然後在Partner Center完成首次提交。 請參見 建立應用程式提交。 打包桌面應用程式,包括 WinUI 3 應用程式,提交時需提供隱私政策網址。

  3. 從指令列提交更新。 在您的應用程式發佈後,您可以提交更新的套件:

    winapp store publish ./*.msix --appId <your-app-id>
    

Note

出版需要合作夥伴 中心帳號。 應用程式認證通常需要1到3個工作天。

在你使用 winapp store 更新之前:

  • winapp store執行 Microsoft Store 開發者 CLI,而它無法進行你應用程式的首次提交。 請在 Partner Center 完成第一次提交內容。
  • 你的 Partner Center 帳號必須有關聯的 Microsoft Entra ID 租戶,並且你用 Microsoft Entra ID 帳號登入 CLI,而不是個人 Microsoft 帳戶。 請參閱 Microsoft Store 開發者 CLI 的先決條件。
  • 目前僅支援免費產品透過 CLI 進行更新。

下一步

你用免費工具和 AI 協助打造並發佈了 Windows 應用程式。 以下是接下來該去的地方: