run-integration-tests

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

Ir a la instalación

Repositorio: dotnet/maui
Última actividad en el origen: 30 de enero de 2026 a las 14:58
Idioma detectado de SKILL.md: inglés
Estrellas: 23.298
Forks: 1957

Opciones de instalación

De forma predeterminada está seleccionado el prompt que primero revisa el origen. Puedes cambiar a un comando directo o descargar una copia local.

Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.

Un comando directo omite el prompt de revisión. Revisa el origen antes de ejecutarlo.

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

El comando permanece en una sola línea. Desplázate horizontalmente para revisarlo antes de copiarlo.

¿Prefieres una copia local? Descarga los archivos que SkillsMP tiene disponibles ahora.

Revisa los archivos de origen

Lee SKILL.md y los archivos complementarios que muestra SkillsMP antes de decidir si quieres instalarlo.

Explorador de archivos

2 archivos

SKILL.md

Instrucciones de origen · Vista previa de solo lectura

Volver a la búsqueda Volver a la instalación

# 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

Opciones de instalación

Revisa los archivos de origen