API template updates (#49394)

* Default webapi template to use minimal APIs & introduce option to use controllers
* Rename api template to webapiaot and remove aot option as it's always aot now

Author: DamianEdwards

src/ProjectTemplates/Shared/ArgConstants.cs

@@ -6,7 +6,7 @@ namespace Templates.Test.Helpers;
 internal static class ArgConstants
 {
     public const string UseProgramMain = "--use-program-main";
-    public const string UseMinimalApis = "--use-minimal-apis";
+    public const string UseControllers = "--use-controllers";
     public const string Pwa = "--pwa";
     public const string CallsGraph = "--calls-graph";
     public const string CalledApiUrl = "--called-api-url";

src/ProjectTemplates/Web.ProjectTemplates/Api-CSharp.csproj.in

@@ -6,10 +6,8 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <NoDefaultLaunchSettingsFile Condition="'$(ExcludeLaunchSettings)' == 'True'">true</NoDefaultLaunchSettingsFile>
     <RootNamespace Condition="'$(name)' != '$(name{-VALUE-FORMS-}safe_namespace)'">Company.WebApplication1</RootNamespace>
-    <!--#if (NativeAot) -->
     <InvariantGlobalization>true</InvariantGlobalization>
     <PublishAot>true</PublishAot>
-    <!--#endif -->
   </PropertyGroup>
 
 </Project>

src/ProjectTemplates/Web.ProjectTemplates/content/Api-CSharp/.template.config/dotnetcli.host.json

@@ -21,10 +21,6 @@
     "UseProgramMain": {
       "longName": "use-program-main",
       "shortName": ""
-    },
-    "NativeAot": {
-      "longName": "aot",
-      "shortName": ""
     }
   },
   "usageExamples": [

src/ProjectTemplates/Web.ProjectTemplates/content/Api-CSharp/.template.config/ide.host.json

@@ -9,10 +9,6 @@
       "isVisible": true,
       "persistenceScope": "shared",
       "persistenceScopeName": "Microsoft"
-    },
-    {
-      "id": "NativeAot",
-      "isVisible": true
     }
   ]
 }

src/ProjectTemplates/Web.ProjectTemplates/content/Api-CSharp/.template.config/template.json

@@ -3,15 +3,17 @@
   "author": "Microsoft",
   "classifications": [
     "Web",
-    "API"
+    "Web API",
+    "API",
+    "Service"
   ],
-  "name": "ASP.NET Core API",
+  "name": "ASP.NET Core Web API (native AOT)",
   "generatorVersions": "[1.0.0.0-*)",
-  "description": "A project template for creating an ASP.NET Core API application.",
+  "description": "A project template for creating a RESTful Web API using ASP.NET Core minimal APIs published as native AOT.",
   "groupIdentity": "Microsoft.Web.Api",
   "precedence": "9000",
   "identity": "Microsoft.Web.Api.CSharp.8.0",
-  "shortName": "api",
+  "shortName": "webapiaot",
   "tags": {
     "language": "C#",
     "type": "project"
@@ -128,13 +130,6 @@
       "defaultValue": "false",
       "displayName": "Do not use _top-level statements",
       "description": "Whether to generate an explicit Program class and Main method instead of top-level statements."
-    },
-    "NativeAot" : {
-      "type": "parameter",
-      "datatype": "bool",
-      "defaultValue": "false",
-      "displayName": "Enable _native AOT publish",
-      "description": "Whether to enable the project for publishing as native AOT."
     }
   },
   "primaryOutputs": [

src/ProjectTemplates/Web.ProjectTemplates/content/Api-CSharp/Program.Main.cs

@@ -1,7 +1,5 @@
-#if NativeAot
 using System.Text.Json.Serialization;
 
-#endif
 namespace Company.ApiApplication1;
 
 public class Program
@@ -10,13 +8,11 @@ public static void Main(string[] args)
     {
         var builder = WebApplication.CreateSlimBuilder(args);
 
-        #if (NativeAot)
         builder.Services.ConfigureHttpJsonOptions(options =>
         {
             options.SerializerOptions.TypeInfoResolverChain.Insert(0, AppJsonSerializerContext.Default);
         });
 
-        #endif
         var app = builder.Build();
 
         var sampleTodos = new Todo[] {
@@ -40,7 +36,6 @@ public static void Main(string[] args)
 
 public record Todo(int Id, string? Title, DateOnly? DueBy = null, bool IsComplete = false);
 
-#if (NativeAot)
 [JsonSerializable(typeof(Todo[]))]
 internal partial class AppJsonSerializerContext : JsonSerializerContext
 {

src/ProjectTemplates/Web.ProjectTemplates/content/Api-CSharp/Program.cs

@@ -1,16 +1,12 @@
-#if (NativeAot)
 using System.Text.Json.Serialization;
 
-#endif
 var builder = WebApplication.CreateSlimBuilder(args);
 
-#if (NativeAot)
 builder.Services.ConfigureHttpJsonOptions(options =>
 {
     options.SerializerOptions.TypeInfoResolverChain.Insert(0, AppJsonSerializerContext.Default);
 });
 
-#endif
 var app = builder.Build();
 
 var sampleTodos = new Todo[] {
@@ -32,7 +28,6 @@
 
 public record Todo(int Id, string? Title, DateOnly? DueBy = null, bool IsComplete = false);
 
-#if (NativeAot)
 [JsonSerializable(typeof(Todo[]))]
 internal partial class AppJsonSerializerContext : JsonSerializerContext
 {

src/ProjectTemplates/Web.ProjectTemplates/content/GrpcService-CSharp/.template.config/template.json

@@ -3,11 +3,13 @@
   "author": "Microsoft",
   "classifications": [
     "Web",
-    "gRPC"
+    "gRPC",
+    "API",
+    "Service"
   ],
   "name": "ASP.NET Core gRPC Service",
   "generatorVersions": "[1.0.0.0-*)",
-  "description": "A project template for creating a gRPC ASP.NET Core service.",
+  "description": "A project template for creating a gRPC service using ASP.NET Core, with optional support for publishing as native AOT.",
   "groupIdentity": "Microsoft.Web.Grpc",
   "precedence": "9800",
   "identity": "Microsoft.Grpc.Service.CSharp.8.0",

src/ProjectTemplates/Web.ProjectTemplates/content/WebApi-CSharp/.template.config/dotnetcli.host.json

@@ -6,7 +6,12 @@
     },
     "UseMinimalAPIs": {
       "longName": "use-minimal-apis",
-      "shortName": "minimal"
+      "shortName": "minimal",
+      "isHidden": true
+    },
+    "UseControllers": {
+      "longName": "use-controllers",
+      "shortName": "controllers"
     },
     "AADInstance": {
       "longName": "aad-instance",

src/ProjectTemplates/Web.ProjectTemplates/content/WebApi-CSharp/.template.config/ide.host.json

@@ -26,10 +26,20 @@
         "overrideDefaultText": true
       },
       "invertBoolean": true,
-      "isVisible": true,
+      "isVisible": false,
       "defaultValue": "true",
       "persistenceScope": "templateGroup"
     },
+    {
+      "id": "UseControllers",
+      "name": {
+        "text": "Use controllers",
+        "overrideDefaultText": true
+      },
+      "isVisible": true,
+      "defaultValue": "false",
+      "persistenceScope": "templateGroup"
+    },
     {
       "id": "UseProgramMain",
       "isVisible": true,