From 858094fdee2e22fdfaf280ff86fbd93b966a4a72 Mon Sep 17 00:00:00 2001
From: Rolf Bjarne Kvinge <rolf@xamarin.com>
Date: Thu, 2 Jul 2026 14:49:35 +0200
Subject: [PATCH 1/2] [templates] Change the replacement value from literal TFM
 to DOTNET_TFM

Change the 'replaces' field in template.json files from the literal TFM
(e.g. 'net10.0-ios') to 'DOTNET_TFM', and update the corresponding
project files to use 'DOTNET_TFM' as the placeholder value.

This makes it easier to update templates for new .NET versions, since
the replacement token is now a fixed string rather than a version-specific
value that needs to change every release.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
---
 .../maccatalyst/csharp/.template.config/template.json           | 2 +-
 .../maccatalyst/csharp/MacCatalystApp1.csproj                   | 2 +-
 .../maccatalyst/visualbasic/.template.config/template.json      | 2 +-
 .../maccatalyst/visualbasic/MacCatalystApp1.vbproj              | 2 +-
 .../maccatalystbinding/csharp/.template.config/template.json    | 2 +-
 .../maccatalystbinding/csharp/MacCatalystBinding1.csproj        | 2 +-
 .../maccatalystlib/csharp/.template.config/template.json        | 2 +-
 .../maccatalystlib/csharp/MacCatalystLib1.csproj                | 2 +-
 .../maccatalystlib/visualbasic/.template.config/template.json   | 2 +-
 .../maccatalystlib/visualbasic/MacCatalystLib1.vbproj           | 2 +-
 .../csharp/.template.config/template.json                       | 2 +-
 .../csharp/iOSNotificationContentExtension1.csproj              | 2 +-
 .../csharp/.template.config/template.json                       | 2 +-
 .../csharp/iOSNotificationServiceExtension1.csproj              | 2 +-
 .../ios-tabbed/.template.config/template.json                   | 2 +-
 .../Microsoft.iOS.Templates/ios-tabbed/iOSTabbedApp1.csproj     | 2 +-
 .../ios/csharp/.template.config/template.json                   | 2 +-
 .../Templates/Microsoft.iOS.Templates/ios/csharp/iOSApp1.csproj | 2 +-
 .../ios/fsharp/.template.config/template.json                   | 2 +-
 .../Templates/Microsoft.iOS.Templates/ios/fsharp/iOSApp1.fsproj | 2 +-
 .../ios/visualbasic/.template.config/template.json              | 2 +-
 .../Microsoft.iOS.Templates/ios/visualbasic/iOSApp1.vbproj      | 2 +-
 .../iosbinding/csharp/.template.config/template.json            | 2 +-
 .../iosbinding/csharp/iOSBinding1.csproj                        | 2 +-
 .../ioslib/csharp/.template.config/template.json                | 2 +-
 .../Microsoft.iOS.Templates/ioslib/csharp/iOSLib1.csproj        | 2 +-
 .../ioslib/visualbasic/.template.config/template.json           | 2 +-
 .../Microsoft.iOS.Templates/ioslib/visualbasic/iOSLib1.vbproj   | 2 +-
 .../macos/csharp/.template.config/template.json                 | 2 +-
 .../Microsoft.macOS.Templates/macos/csharp/macOSApp1.csproj     | 2 +-
 .../macos/visualbasic/.template.config/template.json            | 2 +-
 .../macos/visualbasic/macOSApp1.vbproj                          | 2 +-
 .../macosbinding/csharp/.template.config/template.json          | 2 +-
 .../macosbinding/csharp/macOSBinding1.csproj                    | 2 +-
 .../macoslib/csharp/.template.config/template.json              | 2 +-
 .../Microsoft.macOS.Templates/macoslib/csharp/macOSLib1.csproj  | 2 +-
 .../macoslib/visualbasic/.template.config/template.json         | 2 +-
 .../macoslib/visualbasic/macOSLib1.vbproj                       | 2 +-
 .../tvos/csharp/.template.config/template.json                  | 2 +-
 .../Microsoft.tvOS.Templates/tvos/csharp/tvOSApp1.csproj        | 2 +-
 .../tvos/visualbasic/.template.config/template.json             | 2 +-
 .../Microsoft.tvOS.Templates/tvos/visualbasic/tvOSApp1.vbproj   | 2 +-
 .../tvosbinding/csharp/.template.config/template.json           | 2 +-
 .../tvosbinding/csharp/tvOSBinding1.csproj                      | 2 +-
 .../tvoslib/csharp/.template.config/template.json               | 2 +-
 .../Microsoft.tvOS.Templates/tvoslib/csharp/tvOSLib1.csproj     | 2 +-
 .../tvoslib/visualbasic/.template.config/template.json          | 2 +-
 .../tvoslib/visualbasic/tvOSLib1.vbproj                         | 2 +-
 48 files changed, 48 insertions(+), 48 deletions(-)

diff --git a/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalyst/csharp/.template.config/template.json b/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalyst/csharp/.template.config/template.json
index 8af3713f46d3..ba625c50f61e 100644
--- a/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalyst/csharp/.template.config/template.json
+++ b/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalyst/csharp/.template.config/template.json
@@ -55,7 +55,7 @@
           "description": "Target net10.0-maccatalyst"
         }
       ],
-      "replaces": "net10.0-maccatalyst",
+      "replaces": "DOTNET_TFM",
       "defaultValue": "net10.0-maccatalyst"
     }
   },
diff --git a/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalyst/csharp/MacCatalystApp1.csproj b/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalyst/csharp/MacCatalystApp1.csproj
index 55f4ff8cce66..999497ca6655 100644
--- a/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalyst/csharp/MacCatalystApp1.csproj
+++ b/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalyst/csharp/MacCatalystApp1.csproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net10.0-maccatalyst</TargetFramework>
+    <TargetFramework>DOTNET_TFM</TargetFramework>
     <!-- The default runtime is maccatalyst-x64, except in Release config, in which case the default is maccatalyst-x64;maccatalyst-arm64.
          When specifying both architectures, use the plural <RuntimeIdentifiers> instead of the singular <RuntimeIdentifer>.
          The App Store will NOT accept apps with ONLY maccatalyst-arm64 indicated;
diff --git a/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalyst/visualbasic/.template.config/template.json b/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalyst/visualbasic/.template.config/template.json
index 40694862e626..2b49ffd0ae14 100644
--- a/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalyst/visualbasic/.template.config/template.json
+++ b/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalyst/visualbasic/.template.config/template.json
@@ -55,7 +55,7 @@
           "description": "Target net10.0-maccatalyst"
         }
       ],
-      "replaces": "net10.0-maccatalyst",
+      "replaces": "DOTNET_TFM",
       "defaultValue": "net10.0-maccatalyst"
     }
   },
diff --git a/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalyst/visualbasic/MacCatalystApp1.vbproj b/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalyst/visualbasic/MacCatalystApp1.vbproj
index 1e2c58bd5a7a..0dccb08bcb2d 100644
--- a/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalyst/visualbasic/MacCatalystApp1.vbproj
+++ b/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalyst/visualbasic/MacCatalystApp1.vbproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net10.0-maccatalyst</TargetFramework>
+    <TargetFramework>DOTNET_TFM</TargetFramework>
     <!-- The default runtime is maccatalyst-x64, except in Release config, in which case the default is maccatalyst-x64;maccatalyst-arm64.
          When specifying both architectures, use the plural <RuntimeIdentifiers> instead of the singular <RuntimeIdentifer>.
          The App Store will NOT accept apps with ONLY maccatalyst-arm64 indicated;
diff --git a/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalystbinding/csharp/.template.config/template.json b/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalystbinding/csharp/.template.config/template.json
index 63099f2f3def..fcc1534808c0 100644
--- a/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalystbinding/csharp/.template.config/template.json
+++ b/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalystbinding/csharp/.template.config/template.json
@@ -28,7 +28,7 @@
           "description": "Target net10.0-maccatalyst"
         }
       ],
-      "replaces": "net10.0-maccatalyst",
+      "replaces": "DOTNET_TFM",
       "defaultValue": "net10.0-maccatalyst"
     }
   }
diff --git a/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalystbinding/csharp/MacCatalystBinding1.csproj b/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalystbinding/csharp/MacCatalystBinding1.csproj
index 1752e39550f9..52a7c2c62340 100644
--- a/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalystbinding/csharp/MacCatalystBinding1.csproj
+++ b/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalystbinding/csharp/MacCatalystBinding1.csproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net10.0-maccatalyst</TargetFramework>
+    <TargetFramework>DOTNET_TFM</TargetFramework>
     <RootNamespace Condition="'$(name)' != '$(name{-VALUE-FORMS-}safe_namespace)'">MacCatalystBinding1</RootNamespace>
     <Nullable>enable</Nullable>
     <ImplicitUsings>true</ImplicitUsings>
diff --git a/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalystlib/csharp/.template.config/template.json b/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalystlib/csharp/.template.config/template.json
index 872f85fde0f0..b59d42e90fca 100644
--- a/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalystlib/csharp/.template.config/template.json
+++ b/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalystlib/csharp/.template.config/template.json
@@ -28,7 +28,7 @@
           "description": "Target net10.0-maccatalyst"
         }
       ],
-      "replaces": "net10.0-maccatalyst",
+      "replaces": "DOTNET_TFM",
       "defaultValue": "net10.0-maccatalyst"
     }
   }
diff --git a/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalystlib/csharp/MacCatalystLib1.csproj b/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalystlib/csharp/MacCatalystLib1.csproj
index a7cd97586142..39fa16afee0e 100644
--- a/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalystlib/csharp/MacCatalystLib1.csproj
+++ b/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalystlib/csharp/MacCatalystLib1.csproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net10.0-maccatalyst</TargetFramework>
+    <TargetFramework>DOTNET_TFM</TargetFramework>
     <RootNamespace Condition="'$(name)' != '$(name{-VALUE-FORMS-}safe_namespace)'">MacCatalystLib1</RootNamespace>
     <Nullable>enable</Nullable>
     <ImplicitUsings>true</ImplicitUsings>
diff --git a/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalystlib/visualbasic/.template.config/template.json b/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalystlib/visualbasic/.template.config/template.json
index ce24519503ce..146e0c220117 100644
--- a/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalystlib/visualbasic/.template.config/template.json
+++ b/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalystlib/visualbasic/.template.config/template.json
@@ -28,7 +28,7 @@
           "description": "Target net10.0-maccatalyst"
         }
       ],
-      "replaces": "net10.0-maccatalyst",
+      "replaces": "DOTNET_TFM",
       "defaultValue": "net10.0-maccatalyst"
     }
   }
diff --git a/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalystlib/visualbasic/MacCatalystLib1.vbproj b/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalystlib/visualbasic/MacCatalystLib1.vbproj
index 027ffe5d31af..5768b9974282 100644
--- a/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalystlib/visualbasic/MacCatalystLib1.vbproj
+++ b/dotnet/Templates/Microsoft.MacCatalyst.Templates/maccatalystlib/visualbasic/MacCatalystLib1.vbproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net10.0-maccatalyst</TargetFramework>
+    <TargetFramework>DOTNET_TFM</TargetFramework>
     <RootNamespace Condition="'$(name)' != '$(name{-VALUE-FORMS-}safe_namespace)'">MacCatalystLib1</RootNamespace>
   </PropertyGroup>
 </Project>
diff --git a/dotnet/Templates/Microsoft.iOS.Templates/ios-notification-content-extension/csharp/.template.config/template.json b/dotnet/Templates/Microsoft.iOS.Templates/ios-notification-content-extension/csharp/.template.config/template.json
index 5a76e43970fc..26ac154ef3fa 100644
--- a/dotnet/Templates/Microsoft.iOS.Templates/ios-notification-content-extension/csharp/.template.config/template.json
+++ b/dotnet/Templates/Microsoft.iOS.Templates/ios-notification-content-extension/csharp/.template.config/template.json
@@ -67,7 +67,7 @@
           "description": "Target net10.0-ios"
         }
       ],
-      "replaces": "net10.0-ios",
+      "replaces": "DOTNET_TFM",
       "defaultValue": "net10.0-ios"
     }
   },
diff --git a/dotnet/Templates/Microsoft.iOS.Templates/ios-notification-content-extension/csharp/iOSNotificationContentExtension1.csproj b/dotnet/Templates/Microsoft.iOS.Templates/ios-notification-content-extension/csharp/iOSNotificationContentExtension1.csproj
index 1298fa33f674..a618a651aec5 100644
--- a/dotnet/Templates/Microsoft.iOS.Templates/ios-notification-content-extension/csharp/iOSNotificationContentExtension1.csproj
+++ b/dotnet/Templates/Microsoft.iOS.Templates/ios-notification-content-extension/csharp/iOSNotificationContentExtension1.csproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net10.0-ios</TargetFramework>
+    <TargetFramework>DOTNET_TFM</TargetFramework>
     <OutputType>Library</OutputType>
     <RootNamespace Condition="'$(name)' != '$(name{-VALUE-FORMS-}safe_namespace)'">iOSNotificationContentExtension1</RootNamespace>
     <Nullable>enable</Nullable>
diff --git a/dotnet/Templates/Microsoft.iOS.Templates/ios-notification-service-extension/csharp/.template.config/template.json b/dotnet/Templates/Microsoft.iOS.Templates/ios-notification-service-extension/csharp/.template.config/template.json
index 548a32fa3cb8..daa00b502c79 100644
--- a/dotnet/Templates/Microsoft.iOS.Templates/ios-notification-service-extension/csharp/.template.config/template.json
+++ b/dotnet/Templates/Microsoft.iOS.Templates/ios-notification-service-extension/csharp/.template.config/template.json
@@ -75,7 +75,7 @@
           "description": "Target net10.0-ios"
         }
       ],
-      "replaces": "net10.0-ios",
+      "replaces": "DOTNET_TFM",
       "defaultValue": "net10.0-ios"
     }
   },
diff --git a/dotnet/Templates/Microsoft.iOS.Templates/ios-notification-service-extension/csharp/iOSNotificationServiceExtension1.csproj b/dotnet/Templates/Microsoft.iOS.Templates/ios-notification-service-extension/csharp/iOSNotificationServiceExtension1.csproj
index 416b1255ffc2..d3a1b49548da 100644
--- a/dotnet/Templates/Microsoft.iOS.Templates/ios-notification-service-extension/csharp/iOSNotificationServiceExtension1.csproj
+++ b/dotnet/Templates/Microsoft.iOS.Templates/ios-notification-service-extension/csharp/iOSNotificationServiceExtension1.csproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net10.0-ios</TargetFramework>
+    <TargetFramework>DOTNET_TFM</TargetFramework>
     <OutputType>Library</OutputType>
     <RootNamespace Condition="'$(name)' != '$(name{-VALUE-FORMS-}safe_namespace)'">iOSNotificationServiceExtension1</RootNamespace>
     <Nullable>enable</Nullable>
diff --git a/dotnet/Templates/Microsoft.iOS.Templates/ios-tabbed/.template.config/template.json b/dotnet/Templates/Microsoft.iOS.Templates/ios-tabbed/.template.config/template.json
index 787152b99241..2deffccbd85b 100644
--- a/dotnet/Templates/Microsoft.iOS.Templates/ios-tabbed/.template.config/template.json
+++ b/dotnet/Templates/Microsoft.iOS.Templates/ios-tabbed/.template.config/template.json
@@ -79,7 +79,7 @@
           "description": "Target net10.0-ios"
         }
       ],
-      "replaces": "net10.0-ios",
+      "replaces": "DOTNET_TFM",
       "defaultValue": "net10.0-ios"
     }
   },
diff --git a/dotnet/Templates/Microsoft.iOS.Templates/ios-tabbed/iOSTabbedApp1.csproj b/dotnet/Templates/Microsoft.iOS.Templates/ios-tabbed/iOSTabbedApp1.csproj
index 670a634fadc4..e79d75a2d922 100644
--- a/dotnet/Templates/Microsoft.iOS.Templates/ios-tabbed/iOSTabbedApp1.csproj
+++ b/dotnet/Templates/Microsoft.iOS.Templates/ios-tabbed/iOSTabbedApp1.csproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net10.0-ios</TargetFramework>
+    <TargetFramework>DOTNET_TFM</TargetFramework>
     <RootNamespace Condition="'$(name)' != '$(name{-VALUE-FORMS-}safe_namespace)'">iOSTabbedApp1</RootNamespace>
     <OutputType>Exe</OutputType>
     <Nullable>enable</Nullable>
diff --git a/dotnet/Templates/Microsoft.iOS.Templates/ios/csharp/.template.config/template.json b/dotnet/Templates/Microsoft.iOS.Templates/ios/csharp/.template.config/template.json
index 7d6a618dc583..ce83f2719ab1 100644
--- a/dotnet/Templates/Microsoft.iOS.Templates/ios/csharp/.template.config/template.json
+++ b/dotnet/Templates/Microsoft.iOS.Templates/ios/csharp/.template.config/template.json
@@ -77,7 +77,7 @@
           "description": "Target net10.0-ios"
         }
       ],
-      "replaces": "net10.0-ios",
+      "replaces": "DOTNET_TFM",
       "defaultValue": "net10.0-ios"
     }
   },
diff --git a/dotnet/Templates/Microsoft.iOS.Templates/ios/csharp/iOSApp1.csproj b/dotnet/Templates/Microsoft.iOS.Templates/ios/csharp/iOSApp1.csproj
index 444134e9512b..64ccae32ba82 100644
--- a/dotnet/Templates/Microsoft.iOS.Templates/ios/csharp/iOSApp1.csproj
+++ b/dotnet/Templates/Microsoft.iOS.Templates/ios/csharp/iOSApp1.csproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net10.0-ios</TargetFramework>
+    <TargetFramework>DOTNET_TFM</TargetFramework>
     <RootNamespace Condition="'$(name)' != '$(name{-VALUE-FORMS-}safe_namespace)'">iOSApp1</RootNamespace>
     <OutputType>Exe</OutputType>
     <Nullable>enable</Nullable>
diff --git a/dotnet/Templates/Microsoft.iOS.Templates/ios/fsharp/.template.config/template.json b/dotnet/Templates/Microsoft.iOS.Templates/ios/fsharp/.template.config/template.json
index 03d4dbbe8a40..281d929c3826 100644
--- a/dotnet/Templates/Microsoft.iOS.Templates/ios/fsharp/.template.config/template.json
+++ b/dotnet/Templates/Microsoft.iOS.Templates/ios/fsharp/.template.config/template.json
@@ -77,7 +77,7 @@
           "description": "Target net10.0-ios"
         }
       ],
-      "replaces": "net10.0-ios",
+      "replaces": "DOTNET_TFM",
       "defaultValue": "net10.0-ios"
     }
   },
diff --git a/dotnet/Templates/Microsoft.iOS.Templates/ios/fsharp/iOSApp1.fsproj b/dotnet/Templates/Microsoft.iOS.Templates/ios/fsharp/iOSApp1.fsproj
index 8f7149cdb466..26eb61748a1f 100644
--- a/dotnet/Templates/Microsoft.iOS.Templates/ios/fsharp/iOSApp1.fsproj
+++ b/dotnet/Templates/Microsoft.iOS.Templates/ios/fsharp/iOSApp1.fsproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net10.0-ios</TargetFramework>
+    <TargetFramework>DOTNET_TFM</TargetFramework>
     <RootNamespace Condition="'$(name)' != '$(name{-VALUE-FORMS-}safe_namespace)'">iOSApp1</RootNamespace>
     <OutputType>Exe</OutputType>
     <SupportedOSPlatformVersion>minOSVersion</SupportedOSPlatformVersion>
diff --git a/dotnet/Templates/Microsoft.iOS.Templates/ios/visualbasic/.template.config/template.json b/dotnet/Templates/Microsoft.iOS.Templates/ios/visualbasic/.template.config/template.json
index 93adaa7ebd2d..db4db674d814 100644
--- a/dotnet/Templates/Microsoft.iOS.Templates/ios/visualbasic/.template.config/template.json
+++ b/dotnet/Templates/Microsoft.iOS.Templates/ios/visualbasic/.template.config/template.json
@@ -77,7 +77,7 @@
           "description": "Target net10.0-ios"
         }
       ],
-      "replaces": "net10.0-ios",
+      "replaces": "DOTNET_TFM",
       "defaultValue": "net10.0-ios"
     }
   },
diff --git a/dotnet/Templates/Microsoft.iOS.Templates/ios/visualbasic/iOSApp1.vbproj b/dotnet/Templates/Microsoft.iOS.Templates/ios/visualbasic/iOSApp1.vbproj
index f1213e2867fd..1d29570a5b9d 100644
--- a/dotnet/Templates/Microsoft.iOS.Templates/ios/visualbasic/iOSApp1.vbproj
+++ b/dotnet/Templates/Microsoft.iOS.Templates/ios/visualbasic/iOSApp1.vbproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net10.0-ios</TargetFramework>
+    <TargetFramework>DOTNET_TFM</TargetFramework>
     <RootNamespace Condition="'$(name)' != '$(name{-VALUE-FORMS-}safe_namespace)'">iOSApp1</RootNamespace>
     <OutputType>Exe</OutputType>
     <SupportedOSPlatformVersion>minOSVersion</SupportedOSPlatformVersion>
diff --git a/dotnet/Templates/Microsoft.iOS.Templates/iosbinding/csharp/.template.config/template.json b/dotnet/Templates/Microsoft.iOS.Templates/iosbinding/csharp/.template.config/template.json
index eed6b46698b3..fe519fe03225 100644
--- a/dotnet/Templates/Microsoft.iOS.Templates/iosbinding/csharp/.template.config/template.json
+++ b/dotnet/Templates/Microsoft.iOS.Templates/iosbinding/csharp/.template.config/template.json
@@ -28,7 +28,7 @@
           "description": "Target net10.0-ios"
         }
       ],
-      "replaces": "net10.0-ios",
+      "replaces": "DOTNET_TFM",
       "defaultValue": "net10.0-ios"
     }
   }
diff --git a/dotnet/Templates/Microsoft.iOS.Templates/iosbinding/csharp/iOSBinding1.csproj b/dotnet/Templates/Microsoft.iOS.Templates/iosbinding/csharp/iOSBinding1.csproj
index 2c4d667ad624..66cc5ce28b36 100644
--- a/dotnet/Templates/Microsoft.iOS.Templates/iosbinding/csharp/iOSBinding1.csproj
+++ b/dotnet/Templates/Microsoft.iOS.Templates/iosbinding/csharp/iOSBinding1.csproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net10.0-ios</TargetFramework>
+    <TargetFramework>DOTNET_TFM</TargetFramework>
     <RootNamespace Condition="'$(name)' != '$(name{-VALUE-FORMS-}safe_namespace)'">iOSBinding1</RootNamespace>
     <Nullable>enable</Nullable>
     <ImplicitUsings>true</ImplicitUsings>
diff --git a/dotnet/Templates/Microsoft.iOS.Templates/ioslib/csharp/.template.config/template.json b/dotnet/Templates/Microsoft.iOS.Templates/ioslib/csharp/.template.config/template.json
index 7314b5110349..64f11d86619e 100644
--- a/dotnet/Templates/Microsoft.iOS.Templates/ioslib/csharp/.template.config/template.json
+++ b/dotnet/Templates/Microsoft.iOS.Templates/ioslib/csharp/.template.config/template.json
@@ -28,7 +28,7 @@
           "description": "Target net10.0-ios"
         }
       ],
-      "replaces": "net10.0-ios",
+      "replaces": "DOTNET_TFM",
       "defaultValue": "net10.0-ios"
     }
   }
diff --git a/dotnet/Templates/Microsoft.iOS.Templates/ioslib/csharp/iOSLib1.csproj b/dotnet/Templates/Microsoft.iOS.Templates/ioslib/csharp/iOSLib1.csproj
index 9cb39736081b..17be5e985231 100644
--- a/dotnet/Templates/Microsoft.iOS.Templates/ioslib/csharp/iOSLib1.csproj
+++ b/dotnet/Templates/Microsoft.iOS.Templates/ioslib/csharp/iOSLib1.csproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net10.0-ios</TargetFramework>
+    <TargetFramework>DOTNET_TFM</TargetFramework>
     <RootNamespace Condition="'$(name)' != '$(name{-VALUE-FORMS-}safe_namespace)'">iOSLib1</RootNamespace>
     <Nullable>enable</Nullable>
     <ImplicitUsings>true</ImplicitUsings>
diff --git a/dotnet/Templates/Microsoft.iOS.Templates/ioslib/visualbasic/.template.config/template.json b/dotnet/Templates/Microsoft.iOS.Templates/ioslib/visualbasic/.template.config/template.json
index 83428b3ed701..a4ae4e34c3c8 100644
--- a/dotnet/Templates/Microsoft.iOS.Templates/ioslib/visualbasic/.template.config/template.json
+++ b/dotnet/Templates/Microsoft.iOS.Templates/ioslib/visualbasic/.template.config/template.json
@@ -28,7 +28,7 @@
           "description": "Target net10.0-ios"
         }
       ],
-      "replaces": "net10.0-ios",
+      "replaces": "DOTNET_TFM",
       "defaultValue": "net10.0-ios"
     }
   }
diff --git a/dotnet/Templates/Microsoft.iOS.Templates/ioslib/visualbasic/iOSLib1.vbproj b/dotnet/Templates/Microsoft.iOS.Templates/ioslib/visualbasic/iOSLib1.vbproj
index 01858d4cca78..f98e72564d09 100644
--- a/dotnet/Templates/Microsoft.iOS.Templates/ioslib/visualbasic/iOSLib1.vbproj
+++ b/dotnet/Templates/Microsoft.iOS.Templates/ioslib/visualbasic/iOSLib1.vbproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net10.0-ios</TargetFramework>
+    <TargetFramework>DOTNET_TFM</TargetFramework>
     <RootNamespace Condition="'$(name)' != '$(name{-VALUE-FORMS-}safe_namespace)'">iOSLib1</RootNamespace>
   </PropertyGroup>
 </Project>
diff --git a/dotnet/Templates/Microsoft.macOS.Templates/macos/csharp/.template.config/template.json b/dotnet/Templates/Microsoft.macOS.Templates/macos/csharp/.template.config/template.json
index 6753cf91c43e..20cb438c4023 100644
--- a/dotnet/Templates/Microsoft.macOS.Templates/macos/csharp/.template.config/template.json
+++ b/dotnet/Templates/Microsoft.macOS.Templates/macos/csharp/.template.config/template.json
@@ -54,7 +54,7 @@
           "description": "Target net10.0-macos"
         }
       ],
-      "replaces": "net10.0-macos",
+      "replaces": "DOTNET_TFM",
       "defaultValue": "net10.0-macos"
     }
   },
diff --git a/dotnet/Templates/Microsoft.macOS.Templates/macos/csharp/macOSApp1.csproj b/dotnet/Templates/Microsoft.macOS.Templates/macos/csharp/macOSApp1.csproj
index bc3d6111a60d..ae812d2a21ef 100644
--- a/dotnet/Templates/Microsoft.macOS.Templates/macos/csharp/macOSApp1.csproj
+++ b/dotnet/Templates/Microsoft.macOS.Templates/macos/csharp/macOSApp1.csproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net10.0-macos</TargetFramework>
+    <TargetFramework>DOTNET_TFM</TargetFramework>
     <RootNamespace Condition="'$(name)' != '$(name{-VALUE-FORMS-}safe_namespace)'">macOSApp1</RootNamespace>
     <OutputType>Exe</OutputType>
     <Nullable>enable</Nullable>
diff --git a/dotnet/Templates/Microsoft.macOS.Templates/macos/visualbasic/.template.config/template.json b/dotnet/Templates/Microsoft.macOS.Templates/macos/visualbasic/.template.config/template.json
index 6946227198d2..4d532c7a6c84 100644
--- a/dotnet/Templates/Microsoft.macOS.Templates/macos/visualbasic/.template.config/template.json
+++ b/dotnet/Templates/Microsoft.macOS.Templates/macos/visualbasic/.template.config/template.json
@@ -54,7 +54,7 @@
           "description": "Target net10.0-macos"
         }
       ],
-      "replaces": "net10.0-macos",
+      "replaces": "DOTNET_TFM",
       "defaultValue": "net10.0-macos"
     }
   },
diff --git a/dotnet/Templates/Microsoft.macOS.Templates/macos/visualbasic/macOSApp1.vbproj b/dotnet/Templates/Microsoft.macOS.Templates/macos/visualbasic/macOSApp1.vbproj
index 8c5020bee806..3cfa0c74e7fa 100644
--- a/dotnet/Templates/Microsoft.macOS.Templates/macos/visualbasic/macOSApp1.vbproj
+++ b/dotnet/Templates/Microsoft.macOS.Templates/macos/visualbasic/macOSApp1.vbproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net10.0-macos</TargetFramework>
+    <TargetFramework>DOTNET_TFM</TargetFramework>
     <RootNamespace Condition="'$(name)' != '$(name{-VALUE-FORMS-}safe_namespace)'">macOSApp1</RootNamespace>
     <OutputType>Exe</OutputType>
     <SupportedOSPlatformVersion>minOSVersion</SupportedOSPlatformVersion>
diff --git a/dotnet/Templates/Microsoft.macOS.Templates/macosbinding/csharp/.template.config/template.json b/dotnet/Templates/Microsoft.macOS.Templates/macosbinding/csharp/.template.config/template.json
index 515c4a24fc09..074ec8535ce5 100644
--- a/dotnet/Templates/Microsoft.macOS.Templates/macosbinding/csharp/.template.config/template.json
+++ b/dotnet/Templates/Microsoft.macOS.Templates/macosbinding/csharp/.template.config/template.json
@@ -28,7 +28,7 @@
           "description": "Target net10.0-macos"
         }
       ],
-      "replaces": "net10.0-macos",
+      "replaces": "DOTNET_TFM",
       "defaultValue": "net10.0-macos"
     }
   }
diff --git a/dotnet/Templates/Microsoft.macOS.Templates/macosbinding/csharp/macOSBinding1.csproj b/dotnet/Templates/Microsoft.macOS.Templates/macosbinding/csharp/macOSBinding1.csproj
index 319241aff00a..2a70c928c9ab 100644
--- a/dotnet/Templates/Microsoft.macOS.Templates/macosbinding/csharp/macOSBinding1.csproj
+++ b/dotnet/Templates/Microsoft.macOS.Templates/macosbinding/csharp/macOSBinding1.csproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net10.0-macos</TargetFramework>
+    <TargetFramework>DOTNET_TFM</TargetFramework>
     <RootNamespace Condition="'$(name)' != '$(name{-VALUE-FORMS-}safe_namespace)'">macOSBinding1</RootNamespace>
     <Nullable>enable</Nullable>
     <ImplicitUsings>true</ImplicitUsings>
diff --git a/dotnet/Templates/Microsoft.macOS.Templates/macoslib/csharp/.template.config/template.json b/dotnet/Templates/Microsoft.macOS.Templates/macoslib/csharp/.template.config/template.json
index bc498986d225..59f22bc71865 100644
--- a/dotnet/Templates/Microsoft.macOS.Templates/macoslib/csharp/.template.config/template.json
+++ b/dotnet/Templates/Microsoft.macOS.Templates/macoslib/csharp/.template.config/template.json
@@ -28,7 +28,7 @@
           "description": "Target net10.0-macos"
         }
       ],
-      "replaces": "net10.0-macos",
+      "replaces": "DOTNET_TFM",
       "defaultValue": "net10.0-macos"
     }
   }
diff --git a/dotnet/Templates/Microsoft.macOS.Templates/macoslib/csharp/macOSLib1.csproj b/dotnet/Templates/Microsoft.macOS.Templates/macoslib/csharp/macOSLib1.csproj
index 3f2b2b69f141..70524baa9017 100644
--- a/dotnet/Templates/Microsoft.macOS.Templates/macoslib/csharp/macOSLib1.csproj
+++ b/dotnet/Templates/Microsoft.macOS.Templates/macoslib/csharp/macOSLib1.csproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net10.0-macos</TargetFramework>
+    <TargetFramework>DOTNET_TFM</TargetFramework>
     <RootNamespace Condition="'$(name)' != '$(name{-VALUE-FORMS-}safe_namespace)'">macOSLib1</RootNamespace>
     <Nullable>enable</Nullable>
     <ImplicitUsings>true</ImplicitUsings>
diff --git a/dotnet/Templates/Microsoft.macOS.Templates/macoslib/visualbasic/.template.config/template.json b/dotnet/Templates/Microsoft.macOS.Templates/macoslib/visualbasic/.template.config/template.json
index 206105e7b0e3..6382132468f4 100644
--- a/dotnet/Templates/Microsoft.macOS.Templates/macoslib/visualbasic/.template.config/template.json
+++ b/dotnet/Templates/Microsoft.macOS.Templates/macoslib/visualbasic/.template.config/template.json
@@ -28,7 +28,7 @@
           "description": "Target net10.0-macos"
         }
       ],
-      "replaces": "net10.0-macos",
+      "replaces": "DOTNET_TFM",
       "defaultValue": "net10.0-macos"
     }
   }
diff --git a/dotnet/Templates/Microsoft.macOS.Templates/macoslib/visualbasic/macOSLib1.vbproj b/dotnet/Templates/Microsoft.macOS.Templates/macoslib/visualbasic/macOSLib1.vbproj
index 024a27230715..7c7030d92fa6 100644
--- a/dotnet/Templates/Microsoft.macOS.Templates/macoslib/visualbasic/macOSLib1.vbproj
+++ b/dotnet/Templates/Microsoft.macOS.Templates/macoslib/visualbasic/macOSLib1.vbproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net10.0-macos</TargetFramework>
+    <TargetFramework>DOTNET_TFM</TargetFramework>
     <RootNamespace Condition="'$(name)' != '$(name{-VALUE-FORMS-}safe_namespace)'">macOSLib1</RootNamespace>
   </PropertyGroup>
 </Project>
diff --git a/dotnet/Templates/Microsoft.tvOS.Templates/tvos/csharp/.template.config/template.json b/dotnet/Templates/Microsoft.tvOS.Templates/tvos/csharp/.template.config/template.json
index ef909577cc50..99c9a7d6ef3c 100644
--- a/dotnet/Templates/Microsoft.tvOS.Templates/tvos/csharp/.template.config/template.json
+++ b/dotnet/Templates/Microsoft.tvOS.Templates/tvos/csharp/.template.config/template.json
@@ -54,7 +54,7 @@
           "description": "Target net10.0-tvos"
         }
       ],
-      "replaces": "net10.0-tvos",
+      "replaces": "DOTNET_TFM",
       "defaultValue": "net10.0-tvos"
     }
   },
diff --git a/dotnet/Templates/Microsoft.tvOS.Templates/tvos/csharp/tvOSApp1.csproj b/dotnet/Templates/Microsoft.tvOS.Templates/tvos/csharp/tvOSApp1.csproj
index 21fa578f6e5e..883eeece5bd5 100644
--- a/dotnet/Templates/Microsoft.tvOS.Templates/tvos/csharp/tvOSApp1.csproj
+++ b/dotnet/Templates/Microsoft.tvOS.Templates/tvos/csharp/tvOSApp1.csproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net10.0-tvos</TargetFramework>
+    <TargetFramework>DOTNET_TFM</TargetFramework>
     <RootNamespace Condition="'$(name)' != '$(name{-VALUE-FORMS-}safe_namespace)'">tvOSApp1</RootNamespace>
     <OutputType>Exe</OutputType>
     <Nullable>enable</Nullable>
diff --git a/dotnet/Templates/Microsoft.tvOS.Templates/tvos/visualbasic/.template.config/template.json b/dotnet/Templates/Microsoft.tvOS.Templates/tvos/visualbasic/.template.config/template.json
index 520b77fb3151..c82a3f0051a3 100644
--- a/dotnet/Templates/Microsoft.tvOS.Templates/tvos/visualbasic/.template.config/template.json
+++ b/dotnet/Templates/Microsoft.tvOS.Templates/tvos/visualbasic/.template.config/template.json
@@ -54,7 +54,7 @@
           "description": "Target net10.0-tvos"
         }
       ],
-      "replaces": "net10.0-tvos",
+      "replaces": "DOTNET_TFM",
       "defaultValue": "net10.0-tvos"
     }
   },
diff --git a/dotnet/Templates/Microsoft.tvOS.Templates/tvos/visualbasic/tvOSApp1.vbproj b/dotnet/Templates/Microsoft.tvOS.Templates/tvos/visualbasic/tvOSApp1.vbproj
index 18a39765a7be..263f36108f5f 100644
--- a/dotnet/Templates/Microsoft.tvOS.Templates/tvos/visualbasic/tvOSApp1.vbproj
+++ b/dotnet/Templates/Microsoft.tvOS.Templates/tvos/visualbasic/tvOSApp1.vbproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net10.0-tvos</TargetFramework>
+    <TargetFramework>DOTNET_TFM</TargetFramework>
     <RootNamespace Condition="'$(name)' != '$(name{-VALUE-FORMS-}safe_namespace)'">tvOSApp1</RootNamespace>
     <OutputType>Exe</OutputType>
     <SupportedOSPlatformVersion>minOSVersion</SupportedOSPlatformVersion>
diff --git a/dotnet/Templates/Microsoft.tvOS.Templates/tvosbinding/csharp/.template.config/template.json b/dotnet/Templates/Microsoft.tvOS.Templates/tvosbinding/csharp/.template.config/template.json
index d6596e5c38fc..fc4ccb1dd108 100644
--- a/dotnet/Templates/Microsoft.tvOS.Templates/tvosbinding/csharp/.template.config/template.json
+++ b/dotnet/Templates/Microsoft.tvOS.Templates/tvosbinding/csharp/.template.config/template.json
@@ -28,7 +28,7 @@
           "description": "Target net10.0-tvos"
         }
       ],
-      "replaces": "net10.0-tvos",
+      "replaces": "DOTNET_TFM",
       "defaultValue": "net10.0-tvos"
     }
   }
diff --git a/dotnet/Templates/Microsoft.tvOS.Templates/tvosbinding/csharp/tvOSBinding1.csproj b/dotnet/Templates/Microsoft.tvOS.Templates/tvosbinding/csharp/tvOSBinding1.csproj
index 12ad10b218dd..38845bc5338b 100644
--- a/dotnet/Templates/Microsoft.tvOS.Templates/tvosbinding/csharp/tvOSBinding1.csproj
+++ b/dotnet/Templates/Microsoft.tvOS.Templates/tvosbinding/csharp/tvOSBinding1.csproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net10.0-tvos</TargetFramework>
+    <TargetFramework>DOTNET_TFM</TargetFramework>
     <RootNamespace Condition="'$(name)' != '$(name{-VALUE-FORMS-}safe_namespace)'">tvOSBinding1</RootNamespace>
     <Nullable>enable</Nullable>
     <ImplicitUsings>true</ImplicitUsings>
diff --git a/dotnet/Templates/Microsoft.tvOS.Templates/tvoslib/csharp/.template.config/template.json b/dotnet/Templates/Microsoft.tvOS.Templates/tvoslib/csharp/.template.config/template.json
index 315c4ccb1343..eb186051dbe3 100644
--- a/dotnet/Templates/Microsoft.tvOS.Templates/tvoslib/csharp/.template.config/template.json
+++ b/dotnet/Templates/Microsoft.tvOS.Templates/tvoslib/csharp/.template.config/template.json
@@ -28,7 +28,7 @@
           "description": "Target net10.0-tvos"
         }
       ],
-      "replaces": "net10.0-tvos",
+      "replaces": "DOTNET_TFM",
       "defaultValue": "net10.0-tvos"
     }
   }
diff --git a/dotnet/Templates/Microsoft.tvOS.Templates/tvoslib/csharp/tvOSLib1.csproj b/dotnet/Templates/Microsoft.tvOS.Templates/tvoslib/csharp/tvOSLib1.csproj
index 8d43c262fa52..acf7d7ff371d 100644
--- a/dotnet/Templates/Microsoft.tvOS.Templates/tvoslib/csharp/tvOSLib1.csproj
+++ b/dotnet/Templates/Microsoft.tvOS.Templates/tvoslib/csharp/tvOSLib1.csproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net10.0-tvos</TargetFramework>
+    <TargetFramework>DOTNET_TFM</TargetFramework>
     <RootNamespace Condition="'$(name)' != '$(name{-VALUE-FORMS-}safe_namespace)'">tvOSLib1</RootNamespace>
     <Nullable>enable</Nullable>
     <ImplicitUsings>true</ImplicitUsings>
diff --git a/dotnet/Templates/Microsoft.tvOS.Templates/tvoslib/visualbasic/.template.config/template.json b/dotnet/Templates/Microsoft.tvOS.Templates/tvoslib/visualbasic/.template.config/template.json
index 6f04fad95772..f995495686d9 100644
--- a/dotnet/Templates/Microsoft.tvOS.Templates/tvoslib/visualbasic/.template.config/template.json
+++ b/dotnet/Templates/Microsoft.tvOS.Templates/tvoslib/visualbasic/.template.config/template.json
@@ -28,7 +28,7 @@
           "description": "Target net10.0-tvos"
         }
       ],
-      "replaces": "net10.0-tvos",
+      "replaces": "DOTNET_TFM",
       "defaultValue": "net10.0-tvos"
     }
   }
diff --git a/dotnet/Templates/Microsoft.tvOS.Templates/tvoslib/visualbasic/tvOSLib1.vbproj b/dotnet/Templates/Microsoft.tvOS.Templates/tvoslib/visualbasic/tvOSLib1.vbproj
index 442479772640..4272a8f35a60 100644
--- a/dotnet/Templates/Microsoft.tvOS.Templates/tvoslib/visualbasic/tvOSLib1.vbproj
+++ b/dotnet/Templates/Microsoft.tvOS.Templates/tvoslib/visualbasic/tvOSLib1.vbproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net10.0-tvos</TargetFramework>
+    <TargetFramework>DOTNET_TFM</TargetFramework>
     <RootNamespace Condition="'$(name)' != '$(name{-VALUE-FORMS-}safe_namespace)'">tvOSLib1</RootNamespace>
   </PropertyGroup>
 </Project>

From 78cfbdb54b990e4c6cb1b8ae6db38d24776f4cf1 Mon Sep 17 00:00:00 2001
From: Rolf Bjarne Kvinge <rolf@xamarin.com>
Date: Thu, 2 Jul 2026 14:55:11 +0200
Subject: [PATCH 2/2] [templates] Add script to update TFM values in templates

Add dotnet/update-tfm-in-templates.sh which updates the hardcoded target
framework values (choices, defaultValue, descriptions) in template.json
and localize files for new .NET versions.

The script:
- Reads DOTNET_TFM from Make.config to determine the current version
- Computes whether to include the previous TFM based on support policy:
  previous TFM is supported until May 15th of the year after the current
  major .NET version was released
- Updates all template.json Framework choices and localize strings
- Handles UTF-8 BOM files correctly
- Is idempotent (safe to run multiple times)

Also run the script to normalize the JSON formatting in the template and
localize files.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
---
 dotnet/update-tfm-in-templates.sh | 293 ++++++++++++++++++++++++++++++
 1 file changed, 293 insertions(+)
 create mode 100755 dotnet/update-tfm-in-templates.sh

diff --git a/dotnet/update-tfm-in-templates.sh b/dotnet/update-tfm-in-templates.sh
new file mode 100755
index 000000000000..051d9d70cbae
--- /dev/null
+++ b/dotnet/update-tfm-in-templates.sh
@@ -0,0 +1,293 @@
+#!/bin/bash -eu
+
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+
+# This script updates the target framework values in the project templates
+# for a new .NET version.
+#
+# It updates:
+#   - template.json: choices, defaultValue, and description fields
+#   - localize/*.json: Framework choice keys and descriptions
+#
+# The 'replaces' field in template.json and the <TargetFramework> in .csproj/.vbproj/.fsproj
+# files use the fixed placeholder 'DOTNET_TFM' and do not need updating.
+#
+# Usage: ./dotnet/update-tfm-in-templates.sh
+#
+# The script reads DOTNET_TFM from Make.config to determine the current .NET version,
+# then computes which TFMs to offer based on the support policy:
+#   - The previous TFM is supported until May 15th of the year after the current
+#     major .NET version was released.
+#   - At most two TFMs are offered (current + previous, if still supported).
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# Read DOTNET_TFM from Make.config
+DOTNET_TFM=$(grep '^DOTNET_TFM=' "$REPO_ROOT/Make.config" | head -1 | cut -d= -f2)
+if [ -z "$DOTNET_TFM" ]; then
+    echo "Error: Could not read DOTNET_TFM from Make.config"
+    exit 1
+fi
+
+# Extract major version number (e.g., "net10.0" -> 10)
+CURRENT_MAJOR=$(echo "$DOTNET_TFM" | sed -E 's/net([0-9]+)\.0/\1/')
+PREVIOUS_MAJOR=$((CURRENT_MAJOR - 1))
+
+# Determine if the previous TFM should still be offered.
+# Policy: previous TFM is supported until May 15th of the year after the
+# current major .NET version was released.
+# .NET versions are released in November of their version year (e.g., .NET 10
+# was released in November 2025), so the previous TFM is supported until
+# May 15th of the following year (e.g., May 15th, 2026 for .NET 10).
+SUPPORT_CUTOFF_YEAR=$((CURRENT_MAJOR + 2016))
+SUPPORT_CUTOFF_DATE="${SUPPORT_CUTOFF_YEAR}-05-15"
+TODAY=$(date +%Y-%m-%d)
+
+INCLUDE_PREVIOUS=false
+if [[ "$TODAY" < "$SUPPORT_CUTOFF_DATE" ]]; then
+    INCLUDE_PREVIOUS=true
+fi
+
+PREVIOUS_TFM="net${PREVIOUS_MAJOR}.0"
+
+echo "Current DOTNET_TFM: $DOTNET_TFM (major: $CURRENT_MAJOR)"
+echo "Previous TFM: $PREVIOUS_TFM (major: $PREVIOUS_MAJOR)"
+echo "Support cutoff for previous TFM: $SUPPORT_CUTOFF_DATE"
+echo "Today: $TODAY"
+echo "Include previous TFM: $INCLUDE_PREVIOUS"
+echo ""
+
+TEMPLATES_DIR="$REPO_ROOT/dotnet/Templates"
+
+# Map template directories to their platform suffix
+get_platform () {
+    case "$1" in
+        Microsoft.iOS.Templates) echo "ios" ;;
+        Microsoft.tvOS.Templates) echo "tvos" ;;
+        Microsoft.macOS.Templates) echo "macos" ;;
+        Microsoft.MacCatalyst.Templates) echo "maccatalyst" ;;
+    esac
+}
+
+TEMPLATE_DIRS="Microsoft.iOS.Templates Microsoft.tvOS.Templates Microsoft.macOS.Templates Microsoft.MacCatalyst.Templates"
+
+update_template_json () {
+    local file="$1"
+    local platform="$2"
+    local current_tfm="${DOTNET_TFM}-${platform}"
+    local previous_tfm="${PREVIOUS_TFM}-${platform}"
+    local include_previous="$INCLUDE_PREVIOUS"
+
+    python3 - "$file" "$current_tfm" "$previous_tfm" "$include_previous" << 'PYTHON_EOF'
+import re
+import sys
+import codecs
+import json
+
+file_path = sys.argv[1]
+current_tfm = sys.argv[2]
+previous_tfm = sys.argv[3]
+include_previous = sys.argv[4] == "true"
+
+with open(file_path, 'rb') as f:
+    raw = f.read()
+
+# Detect and preserve BOM
+has_bom = raw.startswith(codecs.BOM_UTF8)
+if has_bom:
+    text = raw.decode('utf-8-sig')
+else:
+    text = raw.decode('utf-8')
+
+if '"Framework"' not in text:
+    sys.exit(0)
+
+# Find the Framework block and replace choices/defaultValue within it only.
+# Locate "Framework": { ... } by finding its start and matching braces.
+fw_match = re.search(r'"Framework"\s*:\s*\{', text)
+if not fw_match:
+    sys.exit(0)
+
+# Find the matching closing brace for the Framework object
+start = fw_match.end() - 1  # position of the opening {
+depth = 0
+end = start
+for i in range(start, len(text)):
+    if text[i] == '{':
+        depth += 1
+    elif text[i] == '}':
+        depth -= 1
+        if depth == 0:
+            end = i + 1
+            break
+
+fw_text = text[start:end]
+
+# Build the new choices block
+if include_previous:
+    new_choices = (
+        '[\n'
+        '        {\n'
+        f'          "choice": "{current_tfm}",\n'
+        f'          "description": "Target {current_tfm}"\n'
+        '        },\n'
+        '        {\n'
+        f'          "choice": "{previous_tfm}",\n'
+        f'          "description": "Target {previous_tfm}"\n'
+        '        }\n'
+        '      ]'
+    )
+else:
+    new_choices = (
+        '[\n'
+        '        {\n'
+        f'          "choice": "{current_tfm}",\n'
+        f'          "description": "Target {current_tfm}"\n'
+        '        }\n'
+        '      ]'
+    )
+
+# Replace choices and defaultValue within the Framework block only
+fw_text = re.sub(
+    r'("choices"\s*:\s*)\[.*?\]',
+    r'\g<1>' + new_choices,
+    fw_text,
+    count=1,
+    flags=re.DOTALL
+)
+fw_text = re.sub(
+    r'("defaultValue"\s*:\s*)"[^"]*"',
+    rf'\g<1>"{current_tfm}"',
+    fw_text,
+    count=1
+)
+
+text = text[:start] + fw_text + text[end:]
+
+with open(file_path, 'wb') as f:
+    if has_bom:
+        f.write(codecs.BOM_UTF8)
+    f.write(text.encode('utf-8'))
+PYTHON_EOF
+}
+
+update_localize_json () {
+    local file="$1"
+    local platform="$2"
+    local current_tfm="${DOTNET_TFM}-${platform}"
+    local previous_tfm="${PREVIOUS_TFM}-${platform}"
+    local include_previous="$INCLUDE_PREVIOUS"
+
+    python3 - "$file" "$current_tfm" "$previous_tfm" "$include_previous" << 'PYTHON_EOF'
+import re
+import sys
+import codecs
+
+file_path = sys.argv[1]
+current_tfm = sys.argv[2]
+previous_tfm = sys.argv[3]
+include_previous = sys.argv[4] == "true"
+
+with open(file_path, 'rb') as f:
+    raw = f.read()
+
+# Detect and preserve BOM
+has_bom = raw.startswith(codecs.BOM_UTF8)
+if has_bom:
+    text = raw.decode('utf-8-sig')
+else:
+    text = raw.decode('utf-8')
+
+had_trailing_newline = text.endswith('\n')
+
+# Remove all existing Framework choice lines
+lines = text.split('\n')
+result = []
+for line in lines:
+    if '"symbols/Framework/choices/' in line:
+        continue
+    result.append(line)
+text = '\n'.join(result)
+
+# Build replacement lines
+new_lines = f'  "symbols/Framework/choices/{current_tfm}/description": "Target {current_tfm}"'
+if include_previous:
+    new_lines += f',\n  "symbols/Framework/choices/{previous_tfm}/description": "Target {previous_tfm}"'
+
+# Insert before the closing }
+# Find the last closing brace and insert before it
+lines = text.split('\n')
+# Find the index of the last line that is just '}'
+close_idx = None
+for i in range(len(lines) - 1, -1, -1):
+    if lines[i].strip() == '}':
+        close_idx = i
+        break
+
+if close_idx is not None:
+    # Ensure the previous content line has a trailing comma
+    for j in range(close_idx - 1, -1, -1):
+        stripped = lines[j].strip()
+        if stripped and stripped != '{':
+            if not stripped.endswith(','):
+                lines[j] = lines[j].rstrip() + ','
+            break
+    lines.insert(close_idx, new_lines)
+
+text = '\n'.join(lines)
+
+# Preserve original trailing newline behavior
+if had_trailing_newline and not text.endswith('\n'):
+    text += '\n'
+elif not had_trailing_newline and text.endswith('\n'):
+    text = text.rstrip('\n')
+
+with open(file_path, 'wb') as f:
+    if has_bom:
+        f.write(codecs.BOM_UTF8)
+    f.write(text.encode('utf-8'))
+PYTHON_EOF
+}
+
+for template_dir_name in $TEMPLATE_DIRS; do
+    platform=$(get_platform "$template_dir_name")
+    template_base="$TEMPLATES_DIR/$template_dir_name"
+
+    if [ ! -d "$template_base" ]; then
+        echo "Warning: $template_base not found, skipping."
+        continue
+    fi
+
+    echo "Processing $template_dir_name (platform: $platform)..."
+
+    # Find and update all template.json files
+    while IFS= read -r -d '' template_json; do
+        # Only process templates that have a Framework parameter
+        if ! grep -q '"Framework"' "$template_json"; then
+            continue
+        fi
+
+        echo "  Updating: $template_json"
+        update_template_json "$template_json" "$platform"
+
+        # Update localize files in the same .template.config directory
+        localize_dir="$(dirname "$template_json")/localize"
+        if [ -d "$localize_dir" ]; then
+            for localize_file in "$localize_dir"/templatestrings.*.json; do
+                if [ -f "$localize_file" ]; then
+                    update_localize_json "$localize_file" "$platform"
+                fi
+            done
+        fi
+    done < <(find "$template_base" -path '*/.template.config/template.json' -print0)
+done
+
+echo ""
+echo "Done. Templates updated for $DOTNET_TFM."
+if [ "$INCLUDE_PREVIOUS" = true ]; then
+    echo "Previous TFM ($PREVIOUS_TFM) is included as an option (cutoff: $SUPPORT_CUTOFF_DATE)."
+else
+    echo "Previous TFM ($PREVIOUS_TFM) is NOT included (past cutoff: $SUPPORT_CUTOFF_DATE)."
+fi