microsoft · bbonaby · Apr 5, 2024 · Mar 29, 2024 · Mar 29, 2024 · Mar 29, 2024
diff --git a/settings/DevHome.Settings/Strings/en-us/Resources.resw b/settings/DevHome.Settings/Strings/en-us/Resources.resw
@@ -565,5 +565,13 @@
   <data name="QuietBackgroundProcessesExperiment_Description" xml:space="preserve">
     <value>Silence and track background processes that may hinder device performance</value>
     <comment>Inline description of the Quiet Background Processes experimental feature on the 'Settings -> Experiments' page where you enable it.</comment>
+  </data>
+	<data name="EnvironmentsCreationFlow_Description" xml:space="preserve">
+    <value>Create a local or cloud machine from Dev Home</value>
+    <comment>Text within a display card that explains what users can do with the Environments creation feature. Users can choose to toggle this on/off to add or remove the feature.</comment>
+  </data>
+	<data name="EnvironmentsCreationFlow_Name" xml:space="preserve">
+    <value>Environments Creation</value>
+    <comment>Title text for the Environments creation feature.</comment>
   </data>
 </root>
diff --git a/src/App.xaml b/src/App.xaml
@@ -19,6 +19,7 @@
                 <ResourceDictionary Source="ms-appx:///DevHome.Dashboard/Styles/Dashboard_ThemeResources.xaml" />
                 <ResourceDictionary Source="ms-appx:///DevHome.SetupFlow/Styles/SetupFlow_ThemeResources.xaml" />
                 <ResourceDictionary Source="ms-appx:///DevHome.Common/Environments/Styles/HorizontalCardStyles.xaml" />
+                <ResourceDictionary Source="ms-appx:///DevHome.Common/Views/AdaptiveCardViews/AdaptiveCardResourceTemplates.xaml" />
             </ResourceDictionary.MergedDictionaries>
         </ResourceDictionary>
     </Application.Resources>

diff --git a/src/NavConfig.jsonc b/src/NavConfig.jsonc
@@ -100,6 +100,27 @@
           "visible": false
         }
       ]
+    },
+    {
+      "identity": "EnvironmentsCreationFlow",
+      "enabledByDefault": false,
+      "buildTypeOverrides": [
+        {
+          "buildType": "dev",
+          "enabledByDefault": true,
+          "visible": true
+        },
+        {
+          "buildType": "canary",
+          "enabledByDefault": true,
+          "visible": true
+        },
+        {
+          "buildType": "release",
+          "enabledByDefault": false,
+          "visible": false
+        }
+      ]
     }
   ]
 }
diff --git a/tools/SetupFlow/DevHome.SetupFlow/Assets/CreateVirtualEnvironment.png b/tools/SetupFlow/DevHome.SetupFlow/Assets/CreateVirtualEnvironment.png
diff --git a/tools/SetupFlow/DevHome.SetupFlow/Exceptions/AdaptiveCardNotRetrievedException.cs b/tools/SetupFlow/DevHome.SetupFlow/Exceptions/AdaptiveCardNotRetrievedException.cs
@@ -0,0 +1,18 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace DevHome.SetupFlow.Exceptions;
+
+public class AdaptiveCardNotRetrievedException : Exception
+{
+    public AdaptiveCardNotRetrievedException(string message)
+        : base(message)
+    {
+    }
+}
diff --git a/tools/SetupFlow/DevHome.SetupFlow/Extensions/ServiceExtensions.cs b/tools/SetupFlow/DevHome.SetupFlow/Extensions/ServiceExtensions.cs
@@ -10,6 +10,7 @@
 using DevHome.SetupFlow.Services.WinGet.Operations;
 using DevHome.SetupFlow.TaskGroups;
 using DevHome.SetupFlow.ViewModels;
+using DevHome.SetupFlow.ViewModels.Environments;
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Hosting;
 using Microsoft.Extensions.Options;
@@ -33,6 +34,7 @@ public static IServiceCollection AddSetupFlow(this IServiceCollection services,
         services.AddReview();
         services.AddSummary();
         services.AddSummaryInformation();
+        services.AddCreateEnvironment();
 
         // View-models
         services.AddSingleton<SetupFlowViewModel>();
@@ -194,4 +196,18 @@ private static IServiceCollection AddSetupTarget(this IServiceCollection service
 
         return services;
     }
+
+    private static IServiceCollection AddCreateEnvironment(this IServiceCollection services)
+    {
+        // Task groups
+        services.AddTransient<EnvironmentCreationOptionsTaskGroup>();
+        services.AddTransient<SelectEnvironmentProviderTaskGroup>();
+
+        // View models
+        services.AddTransient<CreateEnvironmentReviewViewModel>();
+        services.AddTransient<EnvironmentCreationOptionsViewModel>();
+        services.AddTransient<SelectEnvironmentProviderViewModel>();
+
+        return services;
+    }
 }
diff --git a/...s/SetupFlow/DevHome.SetupFlow/Models/Environments/CreationAdaptiveCardSessionEndedData.cs b/...s/SetupFlow/DevHome.SetupFlow/Models/Environments/CreationAdaptiveCardSessionEndedData.cs
@@ -0,0 +1,31 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+using DevHome.Common.Environments.Models;
+
+namespace DevHome.SetupFlow.Models.Environments;
+
+/// <summary>
+/// Data payload for when the <see cref="Microsoft.Windows.DevHome.SDK.IExtensionAdaptiveCardSession2">
+/// session Ends. This data is used to send the user input from an adaptive card session back to an object
+/// that subscribes to the <see cref="Microsoft.Windows.DevHome.SDK.IExtensionAdaptiveCardSession2.Stopped">
+/// event.
+/// </summary>
+public class CreationAdaptiveCardSessionEndedData
+{
+    /// <summary>
+    /// Gets the JSON string of the user input from the adaptive card session
+    /// </summary>
+    public string UserInputResultJson { get; private set; }
+
+    /// <summary>
+    /// Gets the provider details for the compute system provider. <see cref="ComputeSystemProviderDetails"/>
+    /// </summary>
+    public ComputeSystemProviderDetails ProviderDetails { get; private set; }
+
+    public CreationAdaptiveCardSessionEndedData(string userInputResultJson, ComputeSystemProviderDetails providerDetails)
+    {
+        UserInputResultJson = userInputResultJson;
+        ProviderDetails = providerDetails;
+    }
+}
diff --git a/...etupFlow/DevHome.SetupFlow/Models/Environments/CreationAdaptiveCardSessionEndedMessage.cs b/...etupFlow/DevHome.SetupFlow/Models/Environments/CreationAdaptiveCardSessionEndedMessage.cs
@@ -0,0 +1,18 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+using CommunityToolkit.Mvvm.Messaging.Messages;
+
+namespace DevHome.SetupFlow.Models.Environments;
+
+/// <summary>
+/// Message for sending the data payload for the <see cref="Microsoft.Windows.DevHome.SDK.IExtensionAdaptiveCardSession2">
+/// object's session back to a subscriber when the session ends.
+/// </summary>
+public class CreationAdaptiveCardSessionEndedMessage : ValueChangedMessage<CreationAdaptiveCardSessionEndedData>
+{
+    public CreationAdaptiveCardSessionEndedMessage(CreationAdaptiveCardSessionEndedData value)
+        : base(value)
+    {
+    }
+}
diff --git a/...Flow/DevHome.SetupFlow/Models/Environments/CreationOptionsReviewPageDataRequestMessage.cs b/...Flow/DevHome.SetupFlow/Models/Environments/CreationOptionsReviewPageDataRequestMessage.cs
@@ -0,0 +1,20 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+using AdaptiveCards.Rendering.WinUI3;
+using CommunityToolkit.Mvvm.Messaging.Messages;
+
+namespace DevHome.SetupFlow.Models.Environments;
+
+/// <summary>
+/// Message for requesting a rendered adaptive card that was created from a <see cref="DevHome.Common.Models.ExtensionAdaptiveCard."/>
+/// object in one view model to a view.
+/// </summary>
+/// <remarks>
+/// This is used when a view that displays an adaptive card needs to request the rendered adaptive card from the view model.
+/// The view in this case would not want to using Binding to bind to the adaptive card, but instead request it and then manually
+/// add it to its UI. This prevents xaml binding crashes with "Element is already the child of another element" exceptions.
+/// </remarks>
+public sealed class CreationOptionsReviewPageDataRequestMessage : RequestMessage<RenderedAdaptiveCard>
+{
+}
diff --git a/.../SetupFlow/DevHome.SetupFlow/Models/Environments/CreationOptionsViewPageRequestMessage.cs b/.../SetupFlow/DevHome.SetupFlow/Models/Environments/CreationOptionsViewPageRequestMessage.cs
@@ -0,0 +1,20 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+using AdaptiveCards.Rendering.WinUI3;
+using CommunityToolkit.Mvvm.Messaging.Messages;
+
+namespace DevHome.SetupFlow.Models.Environments;
+
+/// <summary>
+/// Message for requesting a rendered adaptive card that was created from a <see cref="DevHome.Common.Models.ExtensionAdaptiveCard."/>
+/// object in one view model to a view.
+/// </summary>
+/// <remarks>
+/// This is used when a view that displays an adaptive card needs to request the rendered adaptive card from the view model.
+/// The view in this case would not want to using Binding to bind to the adaptive card, but instead request it and then manually
+/// add it to its UI. This prevents xaml binding crashes with "Element is already the child of another element" exceptions.
+/// </remarks>
+public sealed class CreationOptionsViewPageRequestMessage : RequestMessage<RenderedAdaptiveCard>
+{
+}
diff --git a/tools/SetupFlow/DevHome.SetupFlow/Models/Environments/CreationProviderChangedMessage.cs b/tools/SetupFlow/DevHome.SetupFlow/Models/Environments/CreationProviderChangedMessage.cs
@@ -0,0 +1,19 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+using CommunityToolkit.Mvvm.Messaging.Messages;
+using DevHome.Common.Environments.Models;
+
+namespace DevHome.SetupFlow.Models.Environments;
+
+/// <summary>
+/// Message for sending the <see cref="ComputeSystemProviderDetails"/> from one view model to
+/// another view model when the provider changes.
+/// </summary>
+public class CreationProviderChangedMessage : ValueChangedMessage<ComputeSystemProviderDetails>
+{
+    public CreationProviderChangedMessage(ComputeSystemProviderDetails value)
+        : base(value)
+    {
+    }
+}
diff --git a/tools/SetupFlow/DevHome.SetupFlow/Models/Environments/NewAdaptiveCardAvailableMessage.cs b/tools/SetupFlow/DevHome.SetupFlow/Models/Environments/NewAdaptiveCardAvailableMessage.cs
@@ -0,0 +1,23 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+using CommunityToolkit.Mvvm.Messaging.Messages;
+
+namespace DevHome.SetupFlow.Models.Environments;
+
+/// <summary>
+/// Message for sending a rendered adaptive card that was created from a <see cref="DevHome.Common.Models.ExtensionAdaptiveCard."/>
+/// object in one view model to a view.
+/// </summary>
+/// <remarks>
+/// Since multiple view models can listen for this message in the setup flow, this object is used to to send the rendered adaptive card
+/// as well as the current view model that is being displayed in the setup flow. Listeners can use the current view model in use
+/// by the <see cref="Services.SetupFlowOrchestrator"/> to determine if they should display the adaptive card or not.
+/// </remarks>
+public class NewAdaptiveCardAvailableMessage : ValueChangedMessage<RenderedAdaptiveCardData>
+{
+    public NewAdaptiveCardAvailableMessage(RenderedAdaptiveCardData value)
+        : base(value)
+    {
+    }
+}
diff --git a/tools/SetupFlow/DevHome.SetupFlow/Models/Environments/RenderedAdaptiveCardData.cs b/tools/SetupFlow/DevHome.SetupFlow/Models/Environments/RenderedAdaptiveCardData.cs
@@ -0,0 +1,23 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+using AdaptiveCards.Rendering.WinUI3;
+
+namespace DevHome.SetupFlow.Models.Environments;
+
+/// <summary>
+/// Data object that contains the rendered adaptive card and the current view model being used in
+/// the setup flow by the <see cref="Services.SetupFlowOrchestrator"/>.
+/// </summary>
+public class RenderedAdaptiveCardData
+{
+    public object CurrentSetupFlowViewModel { get; private set; }
+
+    public RenderedAdaptiveCard RenderedAdaptiveCard { get; set; }
+
+    public RenderedAdaptiveCardData(object currentSetupFlowViewModel, RenderedAdaptiveCard renderedAdaptiveCard)
+    {
+        CurrentSetupFlowViewModel = currentSetupFlowViewModel;
+        RenderedAdaptiveCard = renderedAdaptiveCard;
+    }
+}
diff --git a/tools/SetupFlow/DevHome.SetupFlow/Selectors/ReviewTabViewSelector.cs b/tools/SetupFlow/DevHome.SetupFlow/Selectors/ReviewTabViewSelector.cs
@@ -3,6 +3,7 @@
 
 using System;
 using DevHome.SetupFlow.ViewModels;
+using DevHome.SetupFlow.ViewModels.Environments;
 using Microsoft.UI.Xaml;
 using Microsoft.UI.Xaml.Controls;
 
@@ -35,6 +36,11 @@ public DataTemplate SetupTargetTabTemplate
         get; set;
     }
 
+    public DataTemplate CreateEnvironmentTabTemplate
+    {
+        get; set;
+    }
+
     protected override DataTemplate SelectTemplateCore(object item)
     {
         return ResolveDataTemplate(item, () => base.SelectTemplateCore(item));
@@ -59,6 +65,7 @@ private DataTemplate ResolveDataTemplate(object item, Func<DataTemplate> default
             RepoConfigReviewViewModel => RepoConfigTabTemplate,
             AppManagementReviewViewModel => AppManagementTabTemplate,
             SetupTargetReviewViewModel => SetupTargetTabTemplate,
+            CreateEnvironmentReviewViewModel => CreateEnvironmentTabTemplate,
             _ => defaultDataTemplate(),
         };
     }

diff --git a/tools/SetupFlow/DevHome.SetupFlow/Selectors/SetupFlowViewSelector.cs b/tools/SetupFlow/DevHome.SetupFlow/Selectors/SetupFlowViewSelector.cs
@@ -3,6 +3,7 @@
 
 using System;
 using DevHome.SetupFlow.ViewModels;
+using DevHome.SetupFlow.ViewModels.Environments;
 using Microsoft.UI.Xaml;
 using Microsoft.UI.Xaml.Controls;
 
@@ -29,7 +30,11 @@ public class SetupFlowViewSelector : DataTemplateSelector
 
     public DataTemplate SummaryTemplate { get; set; }
 
-    public DataTemplate ConfigurationFileTemplate { get; set; }
+    public DataTemplate ConfigurationFileTemplate { get; set; }
+
+    public DataTemplate SelectEnvironmentsProviderTemplate { get; set; }
+
+    public DataTemplate EnvironmentCreationOptionsTemplate { get; set; }
 
     protected override DataTemplate SelectTemplateCore(object item)
     {
@@ -58,7 +63,9 @@ private DataTemplate ResolveDataTemplate(object item, Func<DataTemplate> default
             LoadingViewModel => LoadingTemplate,
             SummaryViewModel => SummaryTemplate,
             ConfigurationFileViewModel => ConfigurationFileTemplate,
-            SetupTargetViewModel => SetupTargetTemplate,
+            SetupTargetViewModel => SetupTargetTemplate,
+            SelectEnvironmentProviderViewModel => SelectEnvironmentsProviderTemplate,
+            EnvironmentCreationOptionsViewModel => EnvironmentCreationOptionsTemplate,
             _ => defaultDataTemplate(),
         };
     }