Templates: Add optional Central Package Management support to UmbracoProject and UmbracoExtension templates

templates/UmbracoExtension/.template.config/dotnetcli.host.json

@@ -20,6 +20,10 @@
     "SiteDomain": {
       "longName": "site-domain",
       "shortName": "sd"
+    },
+    "PackageManagement": {
+      "longName": "package-management",
+      "shortName": "pm"
     }
   }
 }

templates/UmbracoExtension/.template.config/ide.host.json

@@ -11,6 +11,14 @@
       "id": "UmbracoVersion",
       "isVisible": true
     },
+    {
+      "id": "PackageManagement",
+      "isVisible": true,
+      "defaultValue": "Central",
+      "description": {
+        "text": "Choose how to manage NuGet package versions"
+      }
+    },
     {
       "id": "SupportPagesAndViews",
       "isVisible": true,

templates/UmbracoExtension/.template.config/template.json

@@ -30,6 +30,29 @@
       "defaultValue": "*",
       "replaces": "UMBRACO_VERSION_FROM_TEMPLATE"
     },
+    "PackageManagement": {
+      "type": "parameter",
+      "datatype": "choice",
+      "defaultValue": "Central",
+      "displayName": "Package Version Management",
+      "description": "Choose how to manage NuGet package versions",
+      "choices": [
+        {
+          "choice": "Central",
+          "displayName": "Central package management",
+          "description": "Use Directory.Packages.props (recommended for new standalone projects)"
+        },
+        {
+          "choice": "PerProject",
+          "displayName": "Per project",
+          "description": "Use versions in .csproj (recommended when adding to existing projects)"
+        }
+      ]
+    },
+    "UseCPM": {
+      "type": "computed",
+      "value": "(PackageManagement == \"Central\")"
+    },
     "SkipRestore": {
       "displayName": "Skip restore",
       "description": "If specified, skips the automatic restore of the project on create.",
@@ -131,8 +154,14 @@
           "exclude": [
             "[Cc]lient/src/dashboards/**"
           ]
+        },
+        {
+          "condition": "(!UseCPM)",
+          "exclude": [
+            "Directory.Packages.props"
+          ]
         }
       ]
     }
   ]
-}
+}

templates/UmbracoExtension/Directory.Packages.props

@@ -0,0 +1,15 @@
+<Project>
+  <PropertyGroup>
+    <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
+    <!-- Allow floating versions so extensions can align with the host Umbraco project's package versions -->
+    <CentralPackageFloatingVersionsEnabled>true</CentralPackageFloatingVersionsEnabled>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <!-- Umbraco API packages - Used by extension templates -->
+    <PackageVersion Include="Umbraco.Cms.Api.Common" Version="UMBRACO_VERSION_FROM_TEMPLATE" />
+    <PackageVersion Include="Umbraco.Cms.Api.Management" Version="UMBRACO_VERSION_FROM_TEMPLATE" />
+    <PackageVersion Include="Umbraco.Cms.Web.Common" Version="UMBRACO_VERSION_FROM_TEMPLATE" />
+    <PackageVersion Include="Umbraco.Cms.Web.Website" Version="UMBRACO_VERSION_FROM_TEMPLATE" />
+  </ItemGroup>
+</Project>

templates/UmbracoExtension/Umbraco.Extension.csproj

@@ -18,15 +18,28 @@
     <FrameworkReference Include="Microsoft.AspNetCore.App" />
   </ItemGroup>
 
+  <!--#if (UseCPM) -->
+  <!-- Central package management - no versions -->
+  <ItemGroup>
+    <PackageReference Include="Umbraco.Cms.Api.Common" />
+    <PackageReference Include="Umbraco.Cms.Api.Management" />
+    <PackageReference Include="Umbraco.Cms.Web.Common" />
+    <PackageReference Include="Umbraco.Cms.Web.Website" />
+  </ItemGroup>
+  <!--#endif -->
+
+  <!--#if (!UseCPM) -->
+  <!-- Per-project - with versions -->
   <ItemGroup>
-    <PackageReference Include="Umbraco.Cms.Web.Website" Version="UMBRACO_VERSION_FROM_TEMPLATE" />
-    <PackageReference Include="Umbraco.Cms.Web.Common" Version="UMBRACO_VERSION_FROM_TEMPLATE" />
     <PackageReference Include="Umbraco.Cms.Api.Common" Version="UMBRACO_VERSION_FROM_TEMPLATE" />
     <PackageReference Include="Umbraco.Cms.Api.Management" Version="UMBRACO_VERSION_FROM_TEMPLATE" />
+    <PackageReference Include="Umbraco.Cms.Web.Common" Version="UMBRACO_VERSION_FROM_TEMPLATE" />
+    <PackageReference Include="Umbraco.Cms.Web.Website" Version="UMBRACO_VERSION_FROM_TEMPLATE" />
   </ItemGroup>
+  <!--#endif -->
 
   <ItemGroup>
-    <!-- Dont include the client folder as part of packaging nuget build -->
+    <!-- Don't include the client folder as part of packaging nuget build -->
     <Content Remove="Client\**" />
 
     <!-- However make the Umbraco-package.json included for dotnet pack or nuget package and visible to the solution -->

templates/UmbracoProject/.template.config/dotnetcli.host.json

@@ -13,6 +13,10 @@
       "longName": "use-delivery-api",
       "shortName": "da"
     },
+    "PackageManagement": {
+      "longName": "package-management",
+      "shortName": "pm"
+    },
     "Docker": {
       "longName": "add-docker",
       "shortName": ""

templates/UmbracoProject/.template.config/ide.host.json

@@ -7,6 +7,14 @@
     "text": "Umbraco Web Application - An empty Umbraco CMS web application."
   },
   "symbolInfo": [
+    {
+      "id": "PackageManagement",
+      "isVisible": true,
+      "defaultValue": "Central",
+      "description": {
+        "text": "Choose how to manage NuGet package versions"
+      }
+    },
     {
       "id": "UseHttpsRedirect",
       "isVisible": true,

templates/UmbracoProject/.template.config/template.json

@@ -35,6 +35,12 @@
             ".dockerignore",
             "entrypoint.sh"
           ]
+        },
+        {
+          "condition": "(!UseCPM)",
+          "exclude": [
+            "Directory.Packages.props"
+          ]
         }
       ]
     }
@@ -80,6 +86,29 @@
         ]
       }
     },
+    "PackageManagement": {
+      "type": "parameter",
+      "datatype": "choice",
+      "defaultValue": "Central",
+      "displayName": "Package Version Management",
+      "description": "Choose how to manage NuGet package versions",
+      "choices": [
+        {
+          "choice": "Central",
+          "displayName": "Central package management",
+          "description": "Use Directory.Packages.props (recommended for new standalone projects)"
+        },
+        {
+          "choice": "PerProject",
+          "displayName": "Per project",
+          "description": "Use versions in .csproj (recommended when adding to existing projects)"
+        }
+      ]
+    },
+    "UseCPM": {
+      "type": "computed",
+      "value": "(PackageManagement == \"Central\")"
+    },
     "DotnetVersion": {
       "type": "generated",
       "generator": "switch",

templates/UmbracoProject/Directory.Packages.props

@@ -0,0 +1,14 @@
+<Project>
+  <PropertyGroup>
+    <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
+    <CentralPackageFloatingVersionsEnabled>true</CentralPackageFloatingVersionsEnabled>
+  </PropertyGroup>
+  <ItemGroup>
+    <PackageVersion Include="Umbraco.Cms" Version="UMBRACO_VERSION_FROM_TEMPLATE" />
+    <PackageVersion Include="Umbraco.Cms.DevelopmentMode.Backoffice" Version="UMBRACO_VERSION_FROM_TEMPLATE" />
+    <PackageVersion Include="Microsoft.ICU.ICU4C.Runtime" Version="72.1.0.3" />
+    <!--#if (StarterKit != "None") -->
+    <PackageVersion Include="STARTER_KIT_NAME" Version="STARTER_KIT_VERSION" />
+    <!--#endif -->
+  </ItemGroup>
+</Project>

templates/UmbracoProject/UmbracoProject.csproj

@@ -7,10 +7,29 @@
     <CompressionEnabled>false</CompressionEnabled> <!-- Disable compression. E.g. for umbraco backoffice files. These files should be precompressed by node and not let dotnet handle it -->
   </PropertyGroup>
 
+  <!--#if (UseCPM) -->
   <ItemGroup>
-    <PackageReference Include="Umbraco.Cms" Version="UMBRACO_VERSION_FROM_TEMPLATE" />
+    <PackageReference Include="Umbraco.Cms"/>
     <!--#if (ModelsBuilderMode == "InMemoryAuto" || (DevelopmentMode == "BackofficeDevelopment" && ModelsBuilderMode == "Default")) -->
-    <PackageReference Include="Umbraco.Cms.DevelopmentMode.Backoffice" Version="UMBRACO_VERSION_FROM_TEMPLATE" />
+    <PackageReference Include="Umbraco.Cms.DevelopmentMode.Backoffice"/>
+    <!--#endif -->
+    <!--#if (StarterKit != "None") -->
+    <PackageReference Include="STARTER_KIT_NAME"/>
+    <!--#endif -->
+  </ItemGroup>
+
+  <ItemGroup>
+    <!-- Opt-in to app-local ICU to ensure consistent globalization APIs across different platforms -->
+    <PackageReference Include="Microsoft.ICU.ICU4C.Runtime"/>
+    <RuntimeHostConfigurationOption Include="System.Globalization.AppLocalIcu" Value="72.1.0.3" Condition="$(RuntimeIdentifier.StartsWith('linux')) or $(RuntimeIdentifier.StartsWith('win')) or ('$(RuntimeIdentifier)' == '' and !$([MSBuild]::IsOSPlatform('osx')))" />
+  </ItemGroup>
+  <!--#endif -->
+
+  <!--#if (!UseCPM) -->
+  <ItemGroup>
+    <PackageReference Include="Umbraco.Cms" Version="UMBRACO_VERSION_FROM_TEMPLATE"/>
+    <!--#if (ModelsBuilderMode == "InMemoryAuto" || (DevelopmentMode == "BackofficeDevelopment" && ModelsBuilderMode == "Default")) -->
+    <PackageReference Include="Umbraco.Cms.DevelopmentMode.Backoffice" Version="UMBRACO_VERSION_FROM_TEMPLATE"/>
     <!--#endif -->
     <!--#if (StarterKit != "None") -->
     <PackageReference Include="STARTER_KIT_NAME" Version="STARTER_KIT_VERSION"/>
@@ -19,9 +38,10 @@
 
   <ItemGroup>
     <!-- Opt-in to app-local ICU to ensure consistent globalization APIs across different platforms -->
-    <PackageReference Include="Microsoft.ICU.ICU4C.Runtime" Version="72.1.0.3" />
+    <PackageReference Include="Microsoft.ICU.ICU4C.Runtime" Version="72.1.0.3"/>
     <RuntimeHostConfigurationOption Include="System.Globalization.AppLocalIcu" Value="72.1.0.3" Condition="$(RuntimeIdentifier.StartsWith('linux')) or $(RuntimeIdentifier.StartsWith('win')) or ('$(RuntimeIdentifier)' == '' and !$([MSBuild]::IsOSPlatform('osx')))" />
   </ItemGroup>
+  <!--#endif -->
 
   <PropertyGroup>
     <!-- Razor files are needed for the backoffice to work correctly -->