<# .SYNOPSIS Builds an specific directory containing a sample solution. .DESCRIPTION This script attempts to build a directory containing a driver sample Solution for the specified configurations and platforms. .PARAMETER Directory Path to a directory containing a valid Visual Studio Solution (.sln file). This is the solution that will be built. .PARAMETER SampleName A friendly name to refer to the sample. Is unspecified, a name will be automatically generated one from the sample path. .PARAMETER Configuration Configuration name that will be used to build the solution. Common available values are "Debug" and "Release". .PARAMETER Platform Platform to build the solution for (e.g. "x64", "arm64"). .PARAMETER LogFilesDirectoy Path to a directory where the log files will be written to. If not provided, outputs will be logged to the current working directory. .INPUTS None. .OUTPUTS Verbose output about the execution of this script will be provided only if -Verbose is provided. Otherwise, no output will be generated. .EXAMPLE .\Build-Sample -Directory .\usb\kmdf_fx2 .EXAMPLE .\Build-Sample -Directory .\usb\kmdf_fx2 -Configuration 'Release' -Platform 'x64' -Verbose -LogFilesDirectory .\_logs #> [CmdletBinding()] param( [Parameter(Mandatory = $true, HelpMessage = 'Enter one directory path', Position = 0)] [string]$Directory, [string]$SampleName, [string]$Configuration = "Debug", [string]$Platform = "x64", $LogFilesDirectory = (Get-Location) ) $Verbose = $false if ($PSBoundParameters.ContainsKey('Verbose')) { $Verbose = $PsBoundParameters.Get_Item('Verbose') } $oldPreference = $ErrorActionPreference $ErrorActionPreference = "stop" try { # Check that msbuild can be called before trying anything. Get-Command "msbuild" | Out-Null } catch { Write-Verbose "`u{274C} msbuild cannot be called from current environment. Check that msbuild is set in current path (for example, that it is called from a Visual Studio developer command)." Write-Error "msbuild cannot be called from current environment." exit 1 } finally { $ErrorActionPreference = $oldPreference } if (-not (Test-Path -Path $Directory -PathType Container)) { Write-Warning "`u{274C} A valid directory could not be found under $Directory" exit 1 } New-Item -ItemType Directory -Force -Path $LogFilesDirectory | Out-Null if (-not (Test-Path -Path $LogFilesDirectory -PathType Container)) { Write-Warning "`u{274C} A valid directory for storing log files could not be created under $LogFilesDirectory" # No exit here: process will continue but logs won't be available. } if ([string]::IsNullOrWhitespace($SampleName)) { $SampleName = (Resolve-Path $Directory).Path.Replace((Get-Location), '').Replace('\', '.').Trim('.').ToLower() } $solutionFile = Get-ChildItem -Path $Directory -Filter *.sln | Select-Object -ExpandProperty FullName -First 1 if ($null -eq $solutionFile) { Write-Warning "`u{274C} A solution could not be found under $Directory" exit 1 } $configurationIsSupported = $false $inSolutionConfigurationPlatformsSection = $false foreach ($line in Get-Content -Path $solutionFile) { if (-not $inSolutionConfigurationPlatformsSection -and $line -match "\s*GlobalSection\(SolutionConfigurationPlatforms\).*") { $inSolutionConfigurationPlatformsSection = $true; continue; } elseif ($line -match "\s*EndGlobalSection.*") { $inSolutionConfigurationPlatformsSection = $false; continue; } if ($inSolutionConfigurationPlatformsSection) { [regex]$regex = ".*=\s*(?(?.*)\|(?.*))\s*" $match = $regex.Match($line) if ([string]::IsNullOrWhiteSpace($match.Groups["ConfigString"].Value) -or [string]::IsNullOrWhiteSpace($match.Groups["Platform"].Value)) { Write-Warning "Could not parse configuration entry $line from file $solutionFile." continue; } if ($match.Groups["Configuration"].Value.Trim() -eq $Configuration -and $match.Groups["Platform"].Value.Trim() -eq $Platform) { $configurationIsSupported = $true; } } } if (-not $configurationIsSupported) { Write-Verbose "[$SampleName] `u{23E9} Skipped. Configuration $Configuration|$Platform not supported." exit 2 } $errorLogFilePath = "$LogFilesDirectory\$SampleName.$Configuration.$Platform.err" $warnLogFilePath = "$LogFilesDirectory\$SampleName.$Configuration.$Platform.wrn" $OutLogFilePath = "$LogFilesDirectory\$SampleName.$Configuration.$Platform.out" Write-Verbose "Building Sample: $SampleName; Configuration: $Configuration; Platform: $Platform {" msbuild $solutionFile -clp:Verbosity=m -t:clean,build -property:Configuration=$Configuration -property:Platform=$Platform -p:TargetVersion=Windows10 -p:InfVerif_AdditionalOptions="/msft /sw1205 /sw1324 /sw1420 /sw1421" -p:SignToolWS=/fdws -p:DriverCFlagAddOn=/wd4996 -flp1:errorsonly`;logfile=$errorLogFilePath -flp2:WarningsOnly`;logfile=$warnLogFilePath -noLogo > $OutLogFilePath if ($env:WDS_WipeOutputs -ne $null) { Write-Verbose ("WipeOutputs: "+$Directory+" "+(((Get-Volume ($DriveLetter=(Get-Item ".").PSDrive.Name)).SizeRemaining/1GB))) Get-ChildItem -path $Directory -Recurse -Include x64|Remove-Item -Recurse Get-ChildItem -path $Directory -Recurse -Include arm64|Remove-Item -Recurse } if ($LASTEXITCODE -ne 0) { if ($Verbose) { Write-Warning "`u{274C} Build failed. Log available at $errorLogFilePath" } exit 1 } Write-Verbose "Building Sample: $SampleName; Configuration: $Configuration; Platform: $Platform }"