From fb6b6c00e0fc1c717365bb7182436f8b8bd25f6a Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 22 May 2025 09:10:57 +0000
Subject: [PATCH 1/3] Initial plan for issue


From 2a4170412c0e7945f01836d25efde7df047bbbe7 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 22 May 2025 09:21:37 +0000
Subject: [PATCH 2/3] Implement SupportedOSPlatformVersion to
 TargetPlatformMinVersion mapping

Co-authored-by: LegendaryBlair <122517415+LegendaryBlair@users.noreply.github.com>
---
 .../Microsoft.WindowsAppSDK.Foundation.targets |  8 ++++++++
 .../NuSpecs/WindowsAppSDK-Nuget-Common.targets | 18 ++++++++++++++----
 .../NuSpecs/WindowsAppSDK-Nuget-Native.targets |  8 ++++++++
 3 files changed, 30 insertions(+), 4 deletions(-)

diff --git a/build/NuSpecs/Microsoft.WindowsAppSDK.Foundation.targets b/build/NuSpecs/Microsoft.WindowsAppSDK.Foundation.targets
index 925af86b05..7c162be234 100644
--- a/build/NuSpecs/Microsoft.WindowsAppSDK.Foundation.targets
+++ b/build/NuSpecs/Microsoft.WindowsAppSDK.Foundation.targets
@@ -16,6 +16,14 @@
   <Import Project="$(MSBuildThisFileDirectory)Microsoft.WindowsAppSDK.AutoInitializerCommon.targets" />
   <Import Project="$(MSBuildThisFileDirectory)Microsoft.WindowsAppSDK.AutoInitializer.CS.targets" Condition="'$(WindowsAppSdkAutoInitialize)' == 'true'"/>
   
+  <!-- Set TargetPlatformMinVersion from SupportedOSPlatformVersion if not already set -->
+  <Target Name="WindowsAppSDKSetTargetPlatformMinVersion" BeforeTargets="BeforeGenerateCurrentProjectAppxManifest">
+    <PropertyGroup>
+      <!-- If TargetPlatformMinVersion is not set but SupportedOSPlatformVersion is, use SupportedOSPlatformVersion -->
+      <TargetPlatformMinVersion Condition="'$(TargetPlatformMinVersion)' == '' AND '$(SupportedOSPlatformVersion)' != ''">$(SupportedOSPlatformVersion)</TargetPlatformMinVersion>
+    </PropertyGroup>
+  </Target>
+  
   <ItemGroup>
     <Compile Condition="'$(WindowsAppSDKAggregatePackage)' == 'true' and '$(WindowsAppSdkIncludeVersionInfo)'=='true'" Include="$(MSBuildThisFileDirectory)..\include\WindowsAppSDK-VersionInfo.cs" />
   </ItemGroup>
diff --git a/build/NuSpecs/WindowsAppSDK-Nuget-Common.targets b/build/NuSpecs/WindowsAppSDK-Nuget-Common.targets
index 7c3e96307e..3874c629cb 100644
--- a/build/NuSpecs/WindowsAppSDK-Nuget-Common.targets
+++ b/build/NuSpecs/WindowsAppSDK-Nuget-Common.targets
@@ -1,20 +1,30 @@
-<?xml version="1.0" encoding="utf-8"?>
+<?xml version="1.0" encoding="utf-8"?>
 <!-- Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT License. See LICENSE in the project root for license information. -->
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  
+  <!-- Set TargetPlatformMinVersion from SupportedOSPlatformVersion if not already set -->
+  <Target Name="WindowsAppSDKSetTargetPlatformMinVersion" BeforeTargets="PrepareForBuild">
+    <PropertyGroup>
+      <!-- If TargetPlatformMinVersion is not set but SupportedOSPlatformVersion is, use SupportedOSPlatformVersion -->
+      <TargetPlatformMinVersion Condition="'$(TargetPlatformMinVersion)' == '' AND '$(SupportedOSPlatformVersion)' != ''">$(SupportedOSPlatformVersion)</TargetPlatformMinVersion>
+    </PropertyGroup>
+  </Target>
+  
   <!-- Check TargetPlatformMinVersion during build to block unsupported configurations. -->
-  <Target Name="MicrosoftWindowsAppSDKCheckTargetPlatformVersion" BeforeTargets="PrepareForBuild"
+  <Target Name="MicrosoftWindowsAppSDKCheckTargetPlatformVersion" BeforeTargets="PrepareForBuild" 
+      AfterTargets="WindowsAppSDKSetTargetPlatformMinVersion"
       Condition="'$(TargetPlatformVersion)' != '' and '$(TargetPlatformMinVersion)' != '' and '$(SkipMicrosoftWindowsAppSDKCheckTargetPlatformVersion)'==''">
     <PropertyGroup>
       <MicrosoftWindowsAppSDKTargetPlatformMinCheckValue>$([System.Version]::Parse('$(TargetPlatformMinVersion)').Build)</MicrosoftWindowsAppSDKTargetPlatformMinCheckValue>
     </PropertyGroup>
     <Error
-        Text="Microsoft.WindowsAppSDK nuget package requires TargetPlatformMinVersion &gt;= 10.0.17763.0 (current project is $(MicrosoftWindowsAppSDKTargetPlatformMinCheckValue))"
+        Text="Microsoft.WindowsAppSDK nuget package requires TargetPlatformMinVersion >= 10.0.17763.0 (current project is $(MicrosoftWindowsAppSDKTargetPlatformMinCheckValue))"
         Condition="$(MicrosoftWindowsAppSDKTargetPlatformMinCheckValue) &lt; 17763" />
     <PropertyGroup>
       <MicrosoftWindowsAppSDKTargetPlatformCheckValue>$([System.Version]::Parse('$(TargetPlatformVersion)').Build)</MicrosoftWindowsAppSDKTargetPlatformCheckValue>
     </PropertyGroup>
     <Error
-        Text="Microsoft.WindowsAppSDK nuget package requires TargetPlatformVersion &gt;= 10.0.18362.0 (current project is $(MicrosoftWindowsAppSDKTargetPlatformCheckValue))"
+        Text="Microsoft.WindowsAppSDK nuget package requires TargetPlatformVersion >= 10.0.18362.0 (current project is $(MicrosoftWindowsAppSDKTargetPlatformCheckValue))"
         Condition="$(MicrosoftWindowsAppSDKTargetPlatformCheckValue) &lt; 18362" />
   </Target>
 </Project>
diff --git a/build/NuSpecs/WindowsAppSDK-Nuget-Native.targets b/build/NuSpecs/WindowsAppSDK-Nuget-Native.targets
index e959cfda9d..d2905f3991 100644
--- a/build/NuSpecs/WindowsAppSDK-Nuget-Native.targets
+++ b/build/NuSpecs/WindowsAppSDK-Nuget-Native.targets
@@ -165,4 +165,12 @@
   <Import Project="$(MSBuildThisFileDirectory)..\Microsoft.WindowsAppSDK.AutoInitializerCommon.targets" />
   <Import Project="$(MSBuildThisFileDirectory)WindowsAppSDK-Nuget-Native.AutoInitializer.targets" Condition="'$(WindowsAppSdkAutoInitialize)' == 'true'"/>
 
+  <!-- Set TargetPlatformMinVersion from SupportedOSPlatformVersion if not already set -->
+  <Target Name="WindowsAppSDKSetTargetPlatformMinVersion" BeforeTargets="BeforeGenerateCurrentProjectAppxManifest">
+    <PropertyGroup>
+      <!-- If TargetPlatformMinVersion is not set but SupportedOSPlatformVersion is, use SupportedOSPlatformVersion -->
+      <TargetPlatformMinVersion Condition="'$(TargetPlatformMinVersion)' == '' AND '$(SupportedOSPlatformVersion)' != ''">$(SupportedOSPlatformVersion)</TargetPlatformMinVersion>
+    </PropertyGroup>
+  </Target>
+
 </Project>

From fbe26f297d88a6a2636a7434713c06da646413ac Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 22 May 2025 09:24:45 +0000
Subject: [PATCH 3/3] Add documentation for SupportedOSPlatformVersion in FAQ

Co-authored-by: LegendaryBlair <122517415+LegendaryBlair@users.noreply.github.com>
---
 docs/faq.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/faq.md b/docs/faq.md
index b2127ff609..af13e2fb62 100644
--- a/docs/faq.md
+++ b/docs/faq.md
@@ -178,6 +178,10 @@ In-box components will be supported forever in the usual way. We have no plans t
 (remove their usability) at this time. We will likely slow down or pause investment in
 the in-box components while we focus on making the Windows App SDK surface complete.
 
+## How does Windows App SDK handle SupportedOSPlatformVersion and TargetPlatformMinVersion?
+
+When using Windows App SDK with .NET projects that set both `TargetFramework` (like net8.0-windows10.0.22621.0) and `SupportedOSPlatformVersion` (like 10.0.19041.0), Windows App SDK will ensure that `TargetPlatformMinVersion` is set to match `SupportedOSPlatformVersion` if `TargetPlatformMinVersion` is not explicitly defined. This ensures that your app can be installed on all operating system versions that you've indicated support for via `SupportedOSPlatformVersion`, rather than just the OS version specified in `TargetFramework`.
+
 ## I don't see my question here!
 
 [Create an issue to ask a question or start a discussion](https://github.com/microsoft/WindowsAppSDK/issues/new/choose).