.NET MAUIでの winapp CLI の使用 (Windows)

このガイドでは、1 つの MAUI 固有の落とし穴に焦点を当てています。 Platforms/Windows/Package.appxmanifest のソース マニフェストには、解決されない $placeholder$ トークン winapp package 含まれています。 MAUI の場合は、 obj\...\resizetizer\m\Package.appxmanifestから生成されたマニフェストを使用してパッケージ化します。

具体的なマウイ島のサンプルプロジェクトは、 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

検証スクリプト (開発 + CI)

MAUI サンプル Pester テスト スクリプトを使用します。

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

これにより、samples/maui-app/test.Tests.ps1が実行され、MAUI アプリが最初から作成され、Windows出力が発行され、生成された resizetizer マニフェスト パスが検証され、winappで MSIX がパッケージ化され、パッケージ化されていない実行可能ファイルに署名されます。

同じスクリプトも、maui-app マトリックス エントリの下の.github/workflows/test-samples.ymlにワイヤードされます。

  • 最終更新: