New <MultiTarget> system, added multitarget-aware ProjectReference generator

.gitignore

@@ -357,4 +357,4 @@ MigrationBackup/
 
 # Community Toolkit Labs generated files
 Toolkit.Labs.All.sln
-Labs.SampleRefs.props
+common/MultiTarget/Generated/**

.vscode/launch.json

@@ -27,7 +27,7 @@
       "type": "PowerShell",
       "request": "launch",
       "name": "Discover samples",
-      "script": "${workspaceFolder}/DiscoverSamples.ps1",
+      "script": "${workspaceFolder}/common/MultiTarget/GenerateAllProjectReferences.ps1; ${workspaceFolder}/common/GenerateVSCodeLaunchConfig.ps1; ",
       "presentation": {
         "group": "2",
         "order": 2

GenerateAllSolution.ps1

@@ -4,6 +4,10 @@ Param (
     [string]$UseUnoWinUI = 2
 )
 
+# Generate required props for "All" solution.
+& ./common/MultiTarget/GenerateAllProjectReferences.ps1
+& ./common/GenerateVSCodeLaunchConfig.ps1
+
 # Set WinUI version for Uno projects
 $originalWorkingDirectory = Get-Location;
 
@@ -243,6 +247,3 @@ $solutionTemplate = $solutionTemplate -replace "(?m)^\s*`r`n", "";
 # Save
 Set-Content -Path $generatedSolutionFilePath -Value $solutionTemplate;
 Write-Output "Solution generated at $generatedSolutionFilePath";
-
-# Run sample discovery
-& ./DiscoverSamples.ps1

common/GenerateVSCodeLaunchConfig.ps1

@@ -0,0 +1,62 @@
+Param (    
+    [Parameter(HelpMessage = "Disables suppressing changes to the ./.vscode/launch.json file in git, allowing changes to be committed.")] 
+    [switch]$allowGitChanges = $false
+)
+
+function CreateVsCodeLaunchConfigJson {
+  param (
+    [string]$projectName
+  )
+
+  return "{
+    `"name`": `"$projectName`",
+    `"type`": `"coreclr`",
+    `"request`": `"launch`",
+    `"program`": `"dotnet`",
+    `"args`": [
+      `"run`",
+      `"build`",
+      `"/r`",
+      `"/p:UnoSourceGeneratorUseGenerationHost=true`",
+      `"/p:UnoSourceGeneratorUseGenerationController=false`",
+      `"/p:UnoRemoteControlPort=443`",
+      `"--project=`$`{workspaceFolder`}/labs/$projectName/samples/$projectName.Wasm/$projectName.Wasm.csproj`"
+    ],
+    `"presentation`": {
+      `"group`": `"2`"
+    },
+    `"cwd`": `"`$`{workspaceFolder`}/labs/$projectName/samples/$projectName.Wasm`"
+  }";
+}
+
+$launchConfigJson = Get-Content -Path "$PSScriptRoot/../.vscode/launch.json" -ErrorAction Stop;
+$launchConfig = $launchConfigJson | ConvertFrom-Json;
+
+# Remove all non-generated configurations
+$originalConfigurations = $launchConfig.configurations;
+$launchConfig.configurations = @();
+$launchConfig.configurations += $originalConfigurations[0];
+$launchConfig.configurations += $originalConfigurations[1];
+
+foreach ($wasmProjectPath in Get-ChildItem -Recurse -Path "$PSScriptRoot/../*/*/samples/*.Wasm/*.Wasm.csproj") {
+  $projectName = [System.IO.Path]::GetFileNameWithoutExtension($wasmProjectPath) -Replace ".Wasm", "";
+  Write-Host "Generating VSCode launch config for $projectName";
+
+  $configJson = CreateVsCodeLaunchConfigJson $projectName;
+  $config = $configJson | ConvertFrom-Json;
+
+  $launchConfig.configurations += $config;
+}
+
+if ($allowGitChanges.IsPresent) {
+  Write-Warning "Changes to the default launch.json can now be committed. Run this command again without the -allowGitChanges flag to disable committing further changes.";
+  git update-index --no-assume-unchanged $PSScriptRoot/../.vscode/launch.json
+}
+else {
+  Write-Output "Changes to the default launch.json are now suppressed. To switch branches, run git reset --hard with a clean working tree. Include the -allowGitChanges flag to enable committing changes.";
+  git update-index --assume-unchanged $PSScriptRoot/../.vscode/launch.json
+}
+
+# Save
+Set-Content -Path "$PSScriptRoot/../.vscode/launch.json" -Value ($launchConfig | ConvertTo-Json -Depth 9);
+Write-Output "Saved VSCode launch configs to $(Resolve-Path $PSScriptRoot/../.vscode/launch.json)";

common/Labs.Head.props

@@ -29,6 +29,8 @@
     <IsAllExperimentHead Condition="$(MSBuildProjectName.StartsWith('CommunityToolkit.Labs.')) == 'true'">true</IsAllExperimentHead>
     <IsProjectTemplateHead Condition="$(MSBuildProjectName.StartsWith('ProjectTemplate')) == 'true'">true</IsProjectTemplateHead>
     <IsSingleExperimentHead Condition="'$(IsAllExperimentHead)' != 'true' AND '$(IsProjectTemplateHead)' != 'true'">true</IsSingleExperimentHead>
+
+		<DefineConstants Condition="$(IsAllExperimentHead) == 'true'">$(DefineConstants);LABS_ALL_SAMPLES</DefineConstants>
   </PropertyGroup>
 
   <!-- See https://github.com/CommunityToolkit/Labs-Windows/issues/142 -->

common/MultiTarget/Defaults.props

@@ -0,0 +1,5 @@
+<Project>
+    <PropertyGroup>
+        <MultiTarget>uwp;wasdk;wpf;wasm;linuxgtk;macos;ios;android;</MultiTarget>
+    </PropertyGroup>
+</Project>

common/MultiTarget/GenerateAllProjectReferences.ps1

@@ -0,0 +1,46 @@
+Param (
+  [Parameter(HelpMessage = "The directory where props files for discovered projects should be saved.")]
+  [string]$projectPropsOutputDir = "$PSScriptRoot/Generated"
+)
+
+$preWorkingDir = $pwd;
+Set-Location $PSScriptRoot;
+
+# Delete and recreate output folder.
+Remove-Item -Path $projectPropsOutputDir -Recurse -Force -ErrorAction SilentlyContinue | Out-Null;
+New-Item -ItemType Directory -Force -Path $projectPropsOutputDir -ErrorAction SilentlyContinue | Out-Null;
+
+# Discover projects in provided paths
+foreach ($projectPath in Get-ChildItem -Directory -Depth 0 -Path "$PSScriptRoot/../../labs/") {
+  # Normalize project path
+  $projectName = $projectPath.Name;
+
+  # Folder layout is expected to match the Community Toolkit.
+  # Uses the <MultiTarget> values from the source library project as the fallback for the sample project.
+  # This behavior also implemented in MultiTarget.props for TargetFramework evaluation. 
+  $srcPath = Resolve-Path "$($projectPath.FullName)\src";
+  $srcProjectPath = Get-ChildItem -File "$srcPath\*.csproj";
+
+  $samplePath = Resolve-Path "$($projectPath.FullName)\samples\$projectName.Samples";
+  $sampleProjectPath = Get-ChildItem -File "$samplePath\*.csproj";
+
+  if ($srcProjectPath.Length -eq 0) {
+    Write-Error "Could not locate source csproj for $projectName";
+    exit(-1);
+  }
+
+  if ($sampleProjectPath.Length -eq 0) {
+    Write-Error "Could not locate sample csproj for $projectName";
+    exit(-1);
+  }
+
+  # Generate <ProjectReference>s for sample project
+  # Use source project MultiTarget as first fallback.
+  & $PSScriptRoot\GenerateMultiTargetAwareProjectReferenceProps.ps1 -projectPath $sampleProjectPath -outputPath "$projectPropsOutputDir/$($sampleProjectPath.BaseName).props" -multiTargetFallbackPropsPath @("$srcPath/MultiTarget.props", "$samplePath/MultiTarget.props", "$PSScriptRoot/Defaults.props");
+
+  # Generate <ProjectReference>s for src project
+  & $PSScriptRoot\GenerateMultiTargetAwareProjectReferenceProps.ps1 -projectPath $srcProjectPath -outputPath "$projectPropsOutputDir/$($srcProjectPath.BaseName).props" -multiTargetFallbackPropsPath @("$srcPath/MultiTarget.props", "$PSScriptRoot/Defaults.props");
+}
+
+
+Set-Location $preWorkingDir;

common/MultiTarget/GenerateMultiTargetAwareProjectReferenceProps.ps1

@@ -0,0 +1,84 @@
+Param (    
+    [Parameter(HelpMessage = "The full path of the csproj to generated references to.", Mandatory = $true)] 
+    [string]$projectPath,
+
+    [Parameter(HelpMessage = "A path to a .props file where generated content should be saved to.", Mandatory = $true)] 
+    [string]$outputPath,
+
+    [Parameter(HelpMessage = "The path to the template used to generate the props file.")] 
+    [string]$templatePath = "$PSScriptRoot/MultiTargetAwareProjectReference.props.template",
+
+    [Parameter(HelpMessage = "The path to the props file that contains the default MultiTarget values.")] 
+    [string[]]$multiTargetFallbackPropsPath = @("$PSScriptRoot/Defaults.props"),
+
+    [Parameter(HelpMessage = "The placeholder text to replace when inserting the project file name into the template.")] 
+    [string]$projectFileNamePlaceholder = "[ProjectFileName]",
+
+    [Parameter(HelpMessage = "The placeholder text to replace when inserting the project path into the template.")] 
+    [string]$projectRootPlaceholder = "[ProjectRoot]"
+)
+
+$preWorkingDir = $pwd;
+Set-Location $PSScriptRoot;
+
+$relativeProjectPath = Invoke-Expression -C "(Resolve-Path -Relative -Path $projectPath)";
+$templateContents = Get-Content -Path $templatePath;
+
+Set-Location $preWorkingDir;
+
+# Insert csproj file name.
+$csprojFileName = [System.IO.Path]::GetFileName($relativeProjectPath);
+$templateContents = $templateContents -replace [regex]::escape($projectFileNamePlaceholder), $csprojFileName;
+
+# Insert project directory
+$relativeProjectDirectory = [System.IO.Path]::GetDirectoryName($relativeProjectPath);
+$templateContents = $templateContents -replace [regex]::escape($projectRootPlaceholder), "$relativeProjectDirectory";
+
+function LoadMultiTargetsFrom([string] $path) {
+    $fileContents = "";
+
+    # If file does not exist
+    if ($false -eq (Test-Path -Path $path -PathType Leaf)) {
+        # Load first available default
+        foreach ($fallbackPath in $multiTargetFallbackPropsPath) {
+            if (Test-Path $fallbackPath) {
+                $fileContents = Get-Content $fallbackPath -ErrorAction Stop;
+                break;
+            }
+        }
+    }
+    else {
+        # Load requested file
+        $fileContents = Get-Content $path -ErrorAction Stop;
+    }
+
+    # Parse file contents
+    $regex = Select-String -Pattern '<MultiTarget>(.+?)<\/MultiTarget>' -InputObject $fileContents;
+
+    if ($null -eq $regex -or $null -eq $regex.Matches -or $null -eq $regex.Matches.Groups -or $regex.Matches.Groups.Length -lt 2) {
+        Write-Error "Couldn't get MultiTarget property from $path";
+        exit(-1);
+    }
+
+    return $regex.Matches.Groups[1].Value;
+}
+
+# Load multitarget preferences for project
+$multiTargets = LoadMultiTargetsFrom("$([System.IO.Path]::GetDirectoryName($projectPath))\MultiTarget.props");
+
+$templateContents = $templateContents -replace [regex]::escape("[IntendedTargets]"), $multiTargets;
+
+$multiTargets = $multiTargets.Split(';');
+Write-Host "Generating project references for $([System.IO.Path]::GetFileNameWithoutExtension($csprojFileName)): $($multiTargets -Join ', ')"
+
+$templateContents = $templateContents -replace [regex]::escape("[CanTargetWasm]"), "'$($multiTargets.Contains("wasm").ToString().ToLower())'";
+$templateContents = $templateContents -replace [regex]::escape("[CanTargetUwp]"), "'$($multiTargets.Contains("uwp").ToString().ToLower())'";
+$templateContents = $templateContents -replace [regex]::escape("[CanTargetWasdk]"), "'$($multiTargets.Contains("wasdk").ToString().ToLower())'";
+$templateContents = $templateContents -replace [regex]::escape("[CanTargetWpf]"), "'$($multiTargets.Contains("wpf").ToString().ToLower())'";
+$templateContents = $templateContents -replace [regex]::escape("[CanTargetLinuxGtk]"), "'$($multiTargets.Contains("linuxgtk").ToString().ToLower())'";
+$templateContents = $templateContents -replace [regex]::escape("[CanTargetMacOS]"), "'$($multiTargets.Contains("macos").ToString().ToLower())'";
+$templateContents = $templateContents -replace [regex]::escape("[CanTargetiOS]"), "'$($multiTargets.Contains("ios").ToString().ToLower())'";
+$templateContents = $templateContents -replace [regex]::escape("[CanTargetDroid]"), "'$($multiTargets.Contains("android").ToString().ToLower())'";
+
+# Save to disk
+Set-Content -Path $outputPath -Value $templateContents;