run-integration-tests

Build, pack, and run .NET MAUI integration tests locally. Validates templates, samples, and end-to-end scenarios using the local workload.

Zur Installation springen

Repository: dotnet/maui
Letzte Quellaktivität: 30. Januar 2026 um 14:58
Erkannte Sprache von SKILL.md: Englisch
Sterne: 23.298
Forks: 1.957

Installationsoptionen

Standardmäßig ist der Prompt ausgewählt, der zuerst die Quelle prüft. Sie können zu einem direkten Befehl wechseln oder eine lokale Kopie herunterladen.

Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.

Ein direkter Befehl überspringt den Prüf-Prompt. Prüfen Sie die Quelle, bevor Sie ihn ausführen.

npx skills add https://github.com/dotnet/maui --skill run-integration-tests

Der Befehl bleibt in einer Zeile. Scrollen Sie horizontal, um ihn vor dem Kopieren vollständig zu prüfen.

Sie bevorzugen eine lokale Kopie? Laden Sie die Dateien herunter, die SkillsMP derzeit vorliegen.

Quelldateien prüfen

Lesen Sie SKILL.md und alle von SkillsMP angezeigten Begleitdateien, bevor Sie sich für eine Installation entscheiden.

Datei-Explorer

2 Dateien

SKILL.md

Quellanweisungen · Schreibgeschützte Vorschau

Zurück zur Suche Zurück zur Installation

# Run with specific category
pwsh .github/skills/run-integration-tests/scripts/Run-IntegrationTests.ps1 -Category "WindowsTemplates"

# Run with Release configuration
pwsh .github/skills/run-integration-tests/scripts/Run-IntegrationTests.ps1 -Category "Samples" -Configuration "Release"

# Run with custom test filter
pwsh .github/skills/run-integration-tests/scripts/Run-IntegrationTests.ps1 -TestFilter "FullyQualifiedName~BuildSample"

# Skip build step (if already built)
pwsh .github/skills/run-integration-tests/scripts/Run-IntegrationTests.ps1 -Category "Build" -SkipBuild

# macOS: Skip Xcode version check (for version mismatches)
pwsh .github/skills/run-integration-tests/scripts/Run-IntegrationTests.ps1 -Category "macOSTemplates" -SkipBuild -SkipInstall -SkipXcodeVersionCheck

# Auto-provision SDK if not found (first-time setup)
pwsh .github/skills/run-integration-tests/scripts/Run-IntegrationTests.ps1 -Category "Build" -AutoProvision

Parameter	Required	Default	Description
`-Category`	No	-	Test category to run (WindowsTemplates, Samples, Build, etc.)
`-TestFilter`	No	-	Custom NUnit test filter expression
`-Configuration`	No	Debug	Build configuration (Debug/Release)
`-SkipBuild`	No	false	Skip build/pack step if already done
`-SkipInstall`	No	false	Skip workload installation if already done
`-SkipXcodeVersionCheck`	No	false	Skip Xcode version validation (macOS)
`-AutoProvision`	No	false	Automatically provision local SDK if not found
`-ResultsDirectory`	No	artifacts/integration-tests	Directory for test results

# Run WindowsTemplates tests
pwsh .github/skills/run-integration-tests/scripts/Run-IntegrationTests.ps1 -Category "WindowsTemplates"

# Run Samples tests
pwsh .github/skills/run-integration-tests/scripts/Run-IntegrationTests.ps1 -Category "Samples"

# Run multiple categories
pwsh .github/skills/run-integration-tests/scripts/Run-IntegrationTests.ps1 -TestFilter "Category=Build|Category=Blazor"

# Step 1: Restore dotnet tools
dotnet tool restore

# Step 2: Provision local SDK and install workloads (~5 minutes)
dotnet cake --target=dotnet

# Step 3: Install MAUI local workloads
dotnet cake --target=dotnet-local-workloads

# Check SDK exists
ls .dotnet/dotnet

# Check MAUI SDK version
ls .dotnet/packs/Microsoft.Maui.Sdk

Issue	Solution
"MAUI_PACKAGE_VERSION was not set"	Ensure build step completed successfully
"Local .dotnet SDK not found"	Run `dotnet tool restore && dotnet cake --target=dotnet && dotnet cake --target=dotnet-local-workloads`
Template not found	Workload installation may have failed
Build failures	Check `artifacts/log/` for detailed build logs
"Cannot proceed with locked .dotnet folder"	Kill processes using `.dotnet`: `Get-Process \| Where-Object { $_.Path -like "\.dotnet\" } \| ForEach-Object { Stop-Process -Id $_.Id -Force }`
Session times out / becomes invalid	Integration tests are long-running (15-60+ min). Run manually in a terminal window instead of via Copilot CLI
Tests take too long	Start with `Build` category (fastest), then run others. Use `-SkipBuild -SkipInstall` if workloads are already installed
iOS tests fail with "mlaunch exited with 1"	Simulator state issue. Run individual tests instead of the whole category (see below)
iOS simulator state errors (code 137/149)	Reset simulator: `xcrun simctl shutdown all && xcrun simctl erase all` or run tests individually

cd D:\repos\dotnet\maui

# Option 1: Use the skill script
pwsh .github/skills/run-integration-tests/scripts/Run-IntegrationTests.ps1 -Category "Build" -SkipBuild -SkipInstall

# Option 2: Run dotnet test directly (if workloads already installed)
$env:MAUI_PACKAGE_VERSION = (Get-ChildItem .dotnet\packs\Microsoft.Maui.Sdk -Directory | Sort-Object Name -Descending | Select-Object -First 1).Name
.dotnet\dotnet test src\TestUtils\src\Microsoft.Maui.IntegrationTests --filter "Category=Build"

# Windows categories (run on Windows)
$categories = @("Build", "WindowsTemplates", "Blazor", "MultiProject", "Samples")
foreach ($cat in $categories) {
    Write-Host "Running $cat..." -ForegroundColor Cyan
    pwsh .github/skills/run-integration-tests/scripts/Run-IntegrationTests.ps1 -Category $cat -SkipBuild -SkipInstall
}

# Available iOS tests
$iosTests = @(
    "RunOniOS_MauiDebug",
    "RunOniOS_MauiRelease",
    "RunOniOS_MauiReleaseTrimFull",
    "RunOniOS_BlazorDebug",
    "RunOniOS_BlazorRelease",
    "RunOniOS_MauiNativeAOT"
)

# Run a specific iOS test
pwsh .github/skills/run-integration-tests/scripts/Run-IntegrationTests.ps1 -TestFilter "FullyQualifiedName~RunOniOS_MauiDebug" -SkipBuild -SkipInstall -SkipXcodeVersionCheck

# Run all iOS tests individually (more reliable than running category)
foreach ($test in $iosTests) {
    Write-Host "Running $test..." -ForegroundColor Cyan
    pwsh .github/skills/run-integration-tests/scripts/Run-IntegrationTests.ps1 -TestFilter "FullyQualifiedName~$test" -SkipBuild -SkipInstall -SkipXcodeVersionCheck
}

name	run-integration-tests
description	Build, pack, and run .NET MAUI integration tests locally. Validates templates, samples, and end-to-end scenarios using the local workload.
metadata	{"author":"dotnet-maui","version":"1.0"}
compatibility	Requires Windows for WindowsTemplates category. macOS for macOSTemplates, RunOniOS, RunOnAndroid.

Category	Platform	Description
`Build`	All	Basic template build tests
`WindowsTemplates`	Windows	Windows-specific template scenarios
`macOSTemplates`	macOS	macOS-specific scenarios
`Blazor`

name	run-integration-tests
description	Build, pack, and run .NET MAUI integration tests locally. Validates templates, samples, and end-to-end scenarios using the local workload.
metadata	{"author":"dotnet-maui","version":"1.0"}
compatibility	Requires Windows for WindowsTemplates category. macOS for macOSTemplates, RunOniOS, RunOnAndroid.

Category	Platform	Description
`Build`	All	Basic template build tests
`WindowsTemplates`	Windows	Windows-specific template scenarios
`macOSTemplates`	macOS	macOS-specific scenarios
`Blazor`

run-integration-tests

Installationsoptionen

Quelldateien prüfen