在 .NET MAUI（Windows）中使用 WinApp CLI

本指南著重於 MAUI 特有的一個陷阱：位於 Platforms/Windows/Package.appxmanifest 的來源資訊清單包含 $placeholder$ 權杖，而 winapp package 不會解析這些權杖。 對於 MAUI，請使用由 obj\...\resizetizer\m\Package.appxmanifest 產生的資訊清單來封包。

具體的MAUI範例專案可於 samples/maui-app.取得。

先決條件

1. .NET SDK + MAUI 工作負載（Windows）：

   winget install Microsoft.DotNet.SDK.10 --source winget
   dotnet workload install maui-windows
   

2. Winapp CLI：

   winget install Microsoft.winappcli --source winget
   

1. 建立 MAUI 應用程式並發佈 Windows 介面

dotnet new maui -n mymauiapp --no-restore
cd mymauiapp

# The stock template targets every MAUI platform. Keep only Windows when
# maui-windows is the only installed workload.
[xml]$project = Get-Content .\mymauiapp.csproj
$propertyGroup = $project.SelectSingleNode("/*[local-name()='Project']/*[local-name()='PropertyGroup'][1]")
$project.SelectNodes("/*[local-name()='Project']/*[local-name()='PropertyGroup']/*[local-name()='TargetFrameworks']") |
  ForEach-Object { $_.ParentNode.RemoveChild($_) | Out-Null }
$windowsTfm = $project.CreateElement("TargetFrameworks", $project.DocumentElement.NamespaceURI)
$windowsTfm.InnerText = "net10.0-windows10.0.19041.0"
$propertyGroup.PrependChild($windowsTfm) | Out-Null
$project.Save((Resolve-Path .\mymauiapp.csproj).Path)

dotnet publish .\mymauiapp.csproj `
  -c Release `
  -f net10.0-windows10.0.19041.0 `
  -r win-x64 `
  -p:WindowsPackageType=None `
  -p:SelfContained=true `
  -p:WindowsAppSDKSelfContained=true `
  --output .\publish\win-x64

2. 使用產生的 MAUI 資訊清單進行封裝

$manifest = ".\obj\Release\net10.0-windows10.0.19041.0\win-x64\resizetizer\m\Package.appxmanifest"
if (-not (Test-Path $manifest)) { throw "Resolved manifest not found: $manifest" }

winapp cert generate --manifest $manifest --if-exists overwrite

winapp package .\publish\win-x64 `
  --manifest $manifest `
  --executable mymauiapp.exe `
  --cert .\devcert.pfx

3. 可選性：簽署未封裝的二進位檔

winapp sign .\publish\win-x64\mymauiapp.exe .\devcert.pfx --password password

驗證腳本（dev + CI）

使用 MAUI 範例的 Pester 測試指令碼：

.\scripts\test-samples.ps1 -Samples maui-app

這會執行 samples/maui-app/test.Tests.ps1，從零建立 MAUI 應用程式，發佈 Windows 輸出，驗證所產生的 resizetizer manifest 路徑，使用 winapp 將 MSIX 打包，並簽署未封裝的執行檔。

同樣的腳本也被接入 .github/workflows/test-samples.yml 矩陣條目下方 maui-app 。