WinARM64EC support, fix for capturing output

Author: darianmiller

CHANGELOG.md

@@ -8,6 +8,11 @@ All notable changes to this project will be documented in this file.
 
 - Change order of pscustomobject to display `output` first so the user doesn't have
 to scroll to see the rest of the result fields
+- Add `WinARM64EC` as a valid MSBuild platform value, with test coverage for
+  passing it through to `/p:Platform=WinARM64EC`
+- Fix `-ShowOutput` so MSBuild output is streamed line-by-line while still
+  being captured in the result object's `.output` property
+
 
 ## [0.6.0] - 2026-04-01
 

README.md

@@ -28,7 +28,7 @@ and the Delphi `RootDir` (and optionally the Platform and Config settings.)
 
 ```powershell
 delphi-msbuild.ps1 `
-  -ProjectFile .\src\MyApp.dpr `
+  -ProjectFile .\src\MyApp.dproj `
   -RootDir     'C:\Program Files (x86)\Embarcadero\Studio\23.0' 
 ```
 
@@ -104,6 +104,7 @@ Valid values:
 - `iOSSimulator64`
 - `Android32`
 - `Android64`
+- `WinARM64EC`
 
 ## -Config
 
@@ -232,8 +233,8 @@ delphi-inspect.ps1 -DetectLatest -Platform Win32 -BuildSystem MSBuild |
 
 When set (meant for non-object pipeline usage)
 
-- MSBuild output streams directly to stdout in real time.
-- The result object's `.output` property is `null`.
+- MSBuild output streams to the console in real time.
+- The result object's `.output` property still contains the full captured text.
 - On build failure, a `Write-Error` message is emitted to stderr.
 
 When not set (default):
@@ -277,9 +278,9 @@ This allows downstream pipeline steps to consume the build result.
 | `unitSearchPath` | string[] | Value of `-UnitSearchPath`; `$null` when not supplied    |
 | `exitCode`       | int      | MSBuild process exit code                                |
 | `success`        | bool     | `$true` when `exitCode` is 0                             |
-| `output`         | string   | Captured MSBuild output; `$null` when `-ShowOutput`      |
+| `output`         | string   | Captured MSBuild output                                  |
 
-Note: On fata errors before MSBuild is invoked (exit codes 2, 3, 4) no result
+Note: On fatal errors before MSBuild is invoked (exit codes 2, 3, 4) no result
 object is emitted.
 
 ------------------------------------------------------------------------
@@ -339,8 +340,8 @@ delphi-inspect.ps1 -DetectLatest -Platform Win32 -BuildSystem MSBuild |
   delphi-msbuild.ps1 -ProjectFile .\src\MyApp.dproj -ShowOutput
 ```
 
-MSBuild output appears on stdout as it runs.  `$result.output` is
-`$null` in this mode.
+MSBuild output appears in the console as it runs.  `$result.output` is still
+populated in this mode.
 
 ## Example 4) Normal -- feed result into a downstream step
 
@@ -411,9 +412,9 @@ $result.output     # captured MSBuild output containing error diagnostics
 ```
 
 Inspect `$result.output` to see the MSBuild error lines.  When
-`-ShowOutput` is used, the output has already streamed to console and
-`$result.output` is `$null`; a `Write-Error` message is emitted to
-stderr instead.
+`-ShowOutput` is used, the output has already streamed to the console and
+is still available in `$result.output`; a `Write-Error` message is emitted
+to stderr as well.
 
 ------------------------------------------------------------------------
 

source/delphi-msbuild.ps1

@@ -34,8 +34,8 @@ NOTES
   are Debug and Release.
 
   MSBuild output is always captured and returned in the result object's
-  .output property.  Use -ShowOutput to also stream output to stdout in real
-  time; .output is populated in both cases.
+  .output property.  Use -ShowOutput to also stream output to the console in
+  real time; .output is populated in both cases.
 
   Exit codes:
     0  success
@@ -65,7 +65,7 @@ param(
   [string]$RootDir,
 
   [ValidateSet('Win32','Win64','macOS32','macOS64','macOSARM64','Linux64',
-               'iOS32','iOSSimulator32','iOS64','iOSSimulator64','Android32','Android64')]
+               'iOS32','iOSSimulator32','iOS64','iOSSimulator64','Android32','Android64','WinARM64EC')]
   [string]$Platform = 'Win32',
 
   [string]$Config = 'Debug',
@@ -178,18 +178,27 @@ function Invoke-RsvarsEnvironment {
 
 # Invoke msbuild.exe with the given arguments.
 # Returns [pscustomobject]@{ ExitCode; Output } where Output is always the
-# captured build text.  When -ShowOutput is set the text is also written to
-# the host so the caller sees it in real time.
+# captured build text.  When -ShowOutput is set each output line is also
+# written to the host as MSBuild emits it.
 # Separated into its own function so tests can mock it.
 function Invoke-MsbuildExe {
   param(
     [string[]]$Arguments,
     [switch]$ShowOutput
   )
 
-  $output = & msbuild.exe @Arguments 2>&1 | Out-String
-  if ($ShowOutput) { Write-Host $output }
-  return [pscustomobject]@{ ExitCode = $LASTEXITCODE; Output = $output }
+  $outputLines = New-Object System.Collections.Generic.List[string]
+  & msbuild.exe @Arguments 2>&1 | ForEach-Object {
+    $line = [string]$_
+    [void]$outputLines.Add($line)
+    if ($ShowOutput) { Write-Host $line }
+  }
+  $exitCode = $LASTEXITCODE
+  $output = $outputLines -join [Environment]::NewLine
+  if ($outputLines.Count -gt 0) {
+    $output += [Environment]::NewLine
+  }
+  return [pscustomobject]@{ ExitCode = $exitCode; Output = $output }
 }
 
 # Assemble MSBuild arguments and invoke the build.

tests/pwsh/delphi-msbuild.Tests.ps1

@@ -24,6 +24,7 @@
 
   Describe 4 - Invoke-MsbuildProject:
     Passes correct MSBuild arguments to Invoke-MsbuildExe.
+    Passes WinARM64EC platform through to MSBuild arguments.
     Forwards -ShowOutput switch to Invoke-MsbuildExe.
     Returns the result object from Invoke-MsbuildExe.
     ExeOutputDir adds /p:DCC_ExeOutput; omitted adds nothing.
@@ -254,6 +255,29 @@ Describe 'Invoke-MsbuildProject' {
 
   }
 
+  Context 'WinARM64EC platform is passed correctly' {
+
+    BeforeAll {
+      $script:capturedArgs = $null
+      Mock Invoke-MsbuildExe {
+        $script:capturedArgs = $Arguments
+        return [pscustomobject]@{ ExitCode = 0; Output = '' }
+      }
+
+      Invoke-MsbuildProject `
+        -ProjectFile 'C:\Projects\MyApp.dproj' `
+        -Platform    'WinARM64EC' `
+        -Config      'Debug' `
+        -Target      'Build' `
+        -Verbosity   'normal'
+    }
+
+    It 'passes /p:Platform=WinARM64EC' {
+      $script:capturedArgs | Should -Contain '/p:Platform=WinARM64EC'
+    }
+
+  }
+
   Context 'returns the result object from Invoke-MsbuildExe' {
 
     BeforeAll {
@@ -566,6 +590,25 @@ Describe 'Main flow -- pre-MSBuild validation (no MSBuild invoked)' {
 
   }
 
+  Context 'accepts WinARM64EC before pre-MSBuild validation' {
+
+    BeforeAll {
+      $script:result = Invoke-ToolProcess -ScriptPath $script:scriptPath -Arguments @(
+        '-ProjectFile', 'C:\Fake\MyApp.dproj',
+        '-Platform',    'WinARM64EC'
+      )
+    }
+
+    It 'continues past parameter binding and exits 3 for missing rootDir' {
+      $script:result.ExitCode | Should -Be 3
+    }
+
+    It 'stderr contains the missing rootDir message' {
+      $script:result.StdErr -join ' ' | Should -Match 'root dir'
+    }
+
+  }
+
   Context 'exits 3 when rootDir directory does not exist on disk' {
 
     BeforeAll {