DevCheck: LongPath support, verify nuget.exe, fix ExitCode, fix InstallWindowsSDK, add/fix SettingsFile, update Getting Started docs #5785

* New options:
  * -CheckNugetExe - Verify nuget.exe is present
  * -FixAll - Enable all -Fix* options plus -NugetRestore
  * -FixLongPath - Enable LongPath support if necessary
  * -InstallWindowsSDK - Download and install Windows Platform SDKs (if necessary)
  * -NugetExe <path> - Location of nuget.exe (default=".user\nuget.exe")
  * -NugetMinVersion <version> - Minimum required version of nuget.exe (default="6.14.0.116")
  * -NugetExeUpdate - Download nuget.exe to the -NugetExe path
  * -NugetRestore - Restore nuget packages
* Fixed error reporting. ExitCode=0 if successful, ExitCode=1 if 1+ issue(s) occurred
* Added LongPath detection/enablement
* Enhanced -CheckVisualStudio to detect `vswhere.exe` in PATH if not found at default install location
* Fixed Install-WindowsSDK to respect -Offline
* Changed SettingsFile handling:
  * -SaveSettingsFile is now a boolean
  * Default filename is DevCheck-Settings.ps1 next to DevCheck.ps1
  * Removed fallback to look for SettingsFile in root\.user
  * Added a default settings file for this repo
    * paths to check/update dependencies (-CheckDependencies, -SyncDependencies)
    * Windows SDK versions/URLs to check/install (-CheckWindowsSDK, -InstallWindowsSDK)
    * paths/files to check to restore Nuget packages (-NugetRestore)
* Updated Getting Started documentation (`docs\Coding-Guidelines\GettingStarted.md`)

Ubersimplified usage to check everything is ready to rock and if not, fix it:
```
DevCheck -FixAll
```
See Getting Started documentation for more details.

Author: DrusTheAxe

build/AzurePipelinesTemplates/WindowsAppSDK-RunTests-Steps.yml

@@ -8,11 +8,11 @@ parameters:
 
 steps:
   - task: powershell@2
-    displayName: 'DevCheck: Setup/Verify development environment'
+    displayName: 'DevCheck: Setup/Verify test environment'
     inputs:
       targetType: filePath
       filePath: tools\DevCheck\DevCheck.ps1
-      arguments: -NoInteractive -Offline -Verbose -CheckTestPfx -Clean -CheckDependencies -CheckVisualStudio -ShowSystemInfo
+      arguments: -NoInteractive -Offline -Verbose -CheckTestPfx -Clean -ShowSystemInfo
       workingDirectory: '$(Build.SourcesDirectory)'
 
   - task: DownloadPipelineArtifact@2
@@ -150,7 +150,7 @@ steps:
         Get-Service | Out-Host
         sc.exe queryex te.service | Write-Host
         sc.exe qc te.service | Write-Host
-  
+
   - task: PowerShell@2
     displayName: 'Run TAEF Tests'
     inputs:
@@ -198,4 +198,4 @@ steps:
     inputs:
       targetPath: '$(Build.SourcesDirectory)\TestOutput'
       artifact: '$(System.StageName)_${{ parameters.ImageName }}_$(buildConfiguration)$(buildPlatform)_$(Agent.JobStatus)$(artifactAttempt)'
-      Parallel: true
+      Parallel: true

docs/Coding-Guidelines/GettingStarted.md

@@ -2,77 +2,37 @@
 
 # Tooling Prerequisites
 
-Development requires the following installed tools...
-
-1. Windows 10 SDK 10.0.17763.0 (RS5)
-
-The SDK can be installed via winget:
-
-    winget install Microsoft.WindowsSDK.10.0.17736
-
-or via the browser:
-
-* Browse to https://go.microsoft.com/fwlink/p/?LinkID=2033908
-* Save the offered download `winsdksetup.exe`
-* Run winsdksetup.exe
-
-**NOTE:** Visual Studio 2022 doesn't include this SDK but will use it if installed on the machine.
-
-2. Windows 11 SDK 10.0.26100.2454 (24H2)
-   a. Browse to https://go.microsoft.com/fwlink/?linkid=2300556
-   b. Save the offered download `winsdksetup.exe`
-   c. Run winsdksetup.exe
-
-**NOTE:** Visual Studio 2022 doesn't include this SDK but will use it if installed on the machine.
-
-3. Visual Studio 2022 with...
-   * Workloads
-      * .NET desktop development
-      * Desktop development with C++
-      * Universal Windows Platform development
-   * Individual components including
-      * .NET 6.0 Runtime (LTS)
-      * .NET 7.0 Runtime
-      * .NET SDK
-      * Git for Windows
-      * NuGet package manager
-      * NuGet targets and build tasks
-      * C# and Visual Basic Roslyn compilers
-      * MSBuild
-      * MSVC v143 - VS 2022 C++ ARM64 build tools (Latest)
-      * MSVC v143 - VS 2022 C++ x64/x86 build tools (Latest)
-      * MSVC v143 - VS 2022 C++ ARM64 Spectre-mitigated libs (Latest)
-      * MSVC v143 - VS 2022 C++ x64/x86 Spectre-mitigated libs (Latest)
-      * Windows Universal CRT SDK
-      * C# and Visual Basic
-      * C++ core features
-      * C++/WinRT
-      * Windows 10 SDK (10.0.18362.0)
-      * Windows 10 SDK (10.0.19041.0)
-      * Windows 10 SDK (10.0.20348.0)
-      * Windows 10 SDK (10.0.22000.0)
-      * Windows 10 SDK (10.0.22621.0)
-      * Windows Universal C Runtime
-      * and more! See [VisualStudio2022.vsconfig](https://github.com/microsoft/WindowsAppSDK/blob/develop/docs/Coding-Guidelines/VisualStudio2022.vsconfig) for the complete list
-
-**NOTE:** You can tell the Visual Studio Installer to do the heavy lifting for you
-via `More` / `Import configuration` and select `docs\Coding-Guidelines\VisualStudio2022.vsconfig`.
-
-4. Run NuGet Restore
-   * Download nuget.exe version >= 6.2.1 from https://www.nuget.org/downloads
-     e.g. https://dist.nuget.org/win-x86-commandline/v6.2.1/nuget.exe
-   * Open a command prompt
-   * CD to the project root e.g. `cd c:\source\repos\windowsappsdk`
-   * Run `nuget.exe restore`
+Development requires the following installation:
+
+1. Install Visual Studio 2022
+
+   Select the following workloads:
+     * .NET desktop development
+     * Desktop development with C++
+     * Universal Windows Platform development
+
+   Additional components are quired. To add them via the Visual Studio Installer...
+     * select `More` / `Import configuration`
+     * select the file `docs\Coding-Guidelines\VisualStudio2022.vsconfig` in the repository
+     * select `Review details`
+     * select `Modify`
+   and wait for the install to complete.
+
+2. Run `DevCheck -CheckAll -FixAll` from an admin prompt to verify your configuration and perform
+   additional installation and configuration updates (if necessary). See `One-Time Setup` for more details.
 
 # One-Time Setup
 
 Run the `DevCheck.cmd` from an elevated command prompt (e.g. right-click on "Command Prompt"
 in the Start Menu and select `Run as Administrator`) to update your development environment. The script will:
 
 * Verify Windows' Developer Mode is enabled.
+* Verify LongPath support (and enable if necessary).
+* Verify nuget.exe is available (and download if necessary).
 * Verify Visual Studio is installed with the required components.
-* Create a test certificate and add it to the certificate store. Used to sign test packages for inner-loop development and testing.
+* Verify Windows 10 SDK 10.0.17763.0 is installed (and install if necessary).
+* Verify Windows 11 SDK 10.0.26100.4654+ is installed (and install if necessary).
+* Verify a password-protected test certificate exists and add it to the certificate store (or create if necessary). Used to sign test packages for inner-loop development and testing.
 * Install the TAEF service (TE.Service). Used by TAEF to enable test functionality (e.g. RunAs).
 * Verify the project's dependencies are sanctioned and using the correct version(s).
 

tools/DevCheck/DevCheck-Settings.ps1

@@ -0,0 +1,27 @@
+# Copyright (c) Microsoft Corporation and Contributors.
+# Licensed under the MIT License.
+
+# DevCheck Settings
+
+# Do not alter contents except in the Customization block
+# Everything else is owned by DevCheck and subject to change without warning
+
+$me = (Get-Item $PSScriptRoot).FullName
+Write-Verbose "$me BEGIN Customization"
+#-----------------------------------------------------------------------
+# BEGIN Customization
+
+# Set paths to scan by -CheckDependencies and -SyncDependencies
+$global:dependency_paths = ('dev', 'test', 'installer', 'tools')
+
+# Set Windows SDKs to check/install by -CheckWindowsSDK and -InstallWindowsSDK
+$global:windows_sdks = (('10.0.17763.0', 'https://go.microsoft.com/fwlink/p/?LinkID=2033908'),
+                        ('10.0.26100.4654', 'https://go.microsoft.com/fwlink/p/?LinkID=2327008'))
+
+# Set Nuget Restore paths/filenames (relative to project root directory)
+$global:nuget_restore_filenames = ('WindowsAppRuntime.sln')
+
+# END   Customization
+#-----------------------------------------------------------------------
+$me = (Get-Item $PSScriptRoot).FullName
+Write-Verbose "$me END Customization"