Releases: microsoft/TemplateStudio
v5.5 Release of Template Studio for WinUI (C#)
Download the extension at VS marketplace : Template Studio for WinUI (C#)
This update updates WinUI (C#) extension to version 5.5.
Some highlights :
- Updated to Windows App SDK 1.4.2
- Updated to WinUIEx 2.3.2
- Titlebar has been revamped and no longer needs workaround code. It now supports interactive clickable elements. See here for details.
Thanks to all the contributors who have been providing critical fixes and filing issues. This release has been possible because of your efforts.
v5.4 Release of Template Studio for WinUI (C#)
Download the extension at VS marketplace : Template Studio for WinUI (C#)
This update updates WinUI (C#) extension to version 5.4.
Some highlights :
- Updated to Windows App SDK 1.3.230502000
- Updated to WinUIEx 2.2
- Updated to MVVM Toolkit 8.1 and enabled source generators
- Some custom titlebar related workarounds have been added back as customers on Windows 10 were facing issues.
- More titlebar related bug fixes - allows dynamic titlebar theme change when OS global theme is changed while the app is running.
- ARM64 install target for the extensions. See here for details.
- Improved localization
v5.3 Release of Template Studio
This update brings all the plugins to version 5.3. They support Visual Studio 2022. You can download them from the Visual Studio Marketplace.
Template Studio for WinUI (C#)
- Updated to .NET 7
- Updated to Windows App SDK 1.2.3
- Updated to WinUIEx 2.1
- Custom title bar related workarounds have been removed. The latest version of WinAppSDK already contains the fixes.
- Version updated to 5.3 (no changes otherwise)
- Version updated to 5.3 (no changes otherwise)
v5.2 Release of Template Studio
Template Studio for WinUI (C#)
- Restored Edit Project functionality now under
Add -> New Item (Template Studio)
within the Project context menu- Due to significant changes in the project templates, we recommend creating a new project with the 5.2 extension and migrating your old project to the new template in order to edit projects
- Editing existing projects is possible but will require manual changes to resolve merge conflicts and other build issues
- Added App Notifications support
- Added MSTest support
- Integrated WinUIEx to provide additional windowing functionality
- NavigationView and MenuBar projects now use Mica by default
- Window position and size are persisted for MSIX apps
- Set additional properties in
MainWindow.xaml
or access additional functionality onApp.MainWindow
- Improved code style
- Enabled ImplicitUsings
- Enabled Nullable
- Display README.md in the editor on project creation to improve the Getting Started experience
- Updated the Core project to .NET 6 from .NET Standard
- Updated to Windows App SDK 1.1.3
- Onboarded to localization service to localize more of the Template Studio wizard going forward
- Restored Edit Project functionality now under
Add -> New Item (Template Studio)
within the Project context menu- To edit a project created with an earlier version of the extension, add
<ImplicitUsings>enable</ImplicitUsings>
to the App and Core project files, add<LangVersion>latest</LangVersion>
to the Core project file, runAnalyze -> Code Cleanup
on the solution to remove unnecessary usings, and convert to file-scoped namespace declarations by typing a semicolon after the namespace name in all cs files. You will also need to updateCommunityToolkit.
using statements toMicrosoft.Toolkit.
.
- To edit a project created with an earlier version of the extension, add
- Improved code style
- Enabled ImplicitUsings
- Converted to file-scoped namespace declarations
- Restored Edit Project functionality now under
Add -> New Item (Template Studio)
within the Project context menu
Known Issues
- Editing WinUI projects created with older versions of the extension requires manual changes (#4582)
- UITestMethods fail in GitHub Actions CI (#4581)
- Investigate dotnet CLI with MSTest project (#4579)
- Notification APIs crash for unpackaged, framework-dependent, x86 builds of apps running on x64 machines due to a platform bug with the Main and Singleton packages in the Windows App SDK Runtime (#4570)
- Deploy is unchecked in the build configurations for packaged projects (#4442)
v5.1 Release of Template Studio
Template Studio for WinUI (C#)
- Refreshed UX based on WinUI designer feedback
- Custom title bar for full window theming support
- NavigationView integration with custom title bar
- NavigationView icons differentiated per page type
- MenuBar Settings interface redesigned
- Removed stale custom styles and applied styles aligned with WinUI design guidelines
- Updated to Windows App SDK 1.1
- Added support for Self-Contained Deployment
- Improved code style
- Applied expression bodies to properties, accessors, and methods
- Converted to file-scoped namespace declarations
- Fixed Code Analysis warnings
- Fixed Code Cleanup issues
- Added .editorconfig to enforce code style guidelines
- Added .vsconfig to ensure required Visual Studio components are installed
- Updated package references
Note: Existing projects created with the Visual Studio 2019 extension will not be updatable with the Visual Studio 2022 extensions.
Known Issues
v5.0 Release of Template Studio
- Refactored the Windows Template Studio extension into separate extensions per framework:
- Template Studio for WinUI (C#)
- Template Studio for WinUI (C++) (FUTURE)
- Template Studio for WPF
- Template Studio for UWP
- Added support for Visual Studio 2022
- Updated the WinUI and WPF templates to .NET 6.0 and updated all package references
- Updated the WinUI templates to Windows App SDK 1.0.1
- Migrated from two-project packaging to single-project packaging
- Added support for unpackaged projects by allowing the MSIX feature to be removed in the wizard
Note: Existing projects created with the Visual Studio 2019 extension will not be updatable with the Visual Studio 2022 extensions.
Known Issues
- Deploy is unchecked in the build configurations for packaged projects (#4442)
Release 4.1.21179.01
Please head to https://aka.ms/wtsinstall to install the VSIX.
Included in this version:
1. New project types for WinUI project creation:
- Blank Advanced: Includes a navigation frame and basic services and styles + folder scaffolding
- Menubar: Includes a menubar on the top of the screen to navigate between pages
2. Update to Windows App SDK 0.8 (previously known as Project Reunion)
3. Bug fixes
Updated nuget packages:
WinUI templates:
Package | Version |
---|---|
Project.Reunion | 0.8.0 |
CommunityToolkit.WinUI.UI.Controls | 7.0.3 |
CommunityToolkit.WinUI.UI.Animations | 7.0.3 |
CommunityToolkit.WinUI.UI.Controls.DataGrid | 7.0.3 |
CommunityToolkit.Mvvm | 7.0.3 |
Microsoft.Xaml.Behaviors.WinUI.Managed | 2.0.4 |
UWP templates:
Package | Version |
---|---|
Microsoft.AppCenter.Analytics | 4.3.0 |
Microsoft.AppCenter.Crashes | 4.3.0 |
Microsoft.Identity.Client | 4.33.0 |
Microsoft.NETCore.UniversalWindowsPlatform | 6.2.12 |
Microsoft.NET.Test.Sdk | 16.10.0 |
Microsoft.Toolkit.Mvvm | 7.0.2 |
Microsoft.Toolkit.Uwp | 7.0.2 |
Microsoft.Toolkit.Uwp.Notifications | 7.0.2 |
Microsoft.Toolkit.Uwp.UI.Animations | 7.0.2 |
Microsoft.Toolkit.Uwp.UI.Controls | 7.0.2 |
Microsoft.Toolkit.Uwp.UI.Controls.DataGrid | 7.0.2 |
MSTest.TestAdapter | 2.2.4 |
MSTest.TestFramework | 2.2.4 |
NUnit | 3.13.2 |
NUnit3TestAdapter | 4.0.0 |
Swashbuckle.AspNetCore | 6.1.4 |
Telerik.UI.for.UniversalWindowsPlatform | 1.0.2.5 |
Win2D.uwp | 1.26.0 |
WPF templates:
Package | Version |
---|---|
MahApps.Metro | 2.4.6 |
Microsoft.Extensions.Http | 3.1.16 |
Microsoft.Extensions.Hosting | 3.1.16 |
Microsoft.Extensions.Configuration | 3.1.16 |
Microsoft.Extensions.Configuration.Binder | 3.1.16 |
Microsoft.Extensions.Configuration.CommandLine | 3.1.16 |
Microsoft.Extensions.Configuration.Json | 3.1.16 |
Microsoft.Identity.Client | 4.33.0 |
Microsoft.NETCore.UniversalWindowsPlatform | 6.2.12 |
Microsoft.NET.Test.Sdk | 16.10.0 |
Microsoft.Toolkit.Mvvm | 7.0.2 |
Microsoft.Toolkit.Uwp.Notifications | 7.0.2 |
MSTest.TestAdapter | 2.2.4 |
MSTest.TestFramework | 2.2.4 |
NUnit | 3.13.2 |
NUnit3TestAdapter | 4.0.0 |
Prism.Unity | 8.1.97 |
Fluent.Ribbon | 8.0.3 |
4.0.21152.01
Please head to https://aka.ms/wtsinstall to install the VSIX.
Included in this version:
1. Addition of C# WinUI 3 project templates:
- App (WinUI 3 in Desktop)
This template allows you to create a new WinUI in Desktop App choosing from the following options;- Project Type + Design Pattern:
- Blank project (without any scaffolding or frameworks)
- Navigation Pane + MVVMToolkit
- Pages: Blank, Settings, WebView, ListDetails, Content Grid and DataGrid
- Features: Settings Storage, MSIX Packaging, Theme Selection
- Project Type + Design Pattern:
- Class Library (WinUI 3 in Desktop)
2. Addition of C++ WinUI 3 project templates:
- App (WinUI 3 in Desktop)
- Windows Runtime Component (WinUI 3)
3. Addition of templates adding new items to any existing project
We offer the following item templates for C# and C++:
- Blank page
- Blank Window (Desktop)
- Custom Control
- Resource Dictionary
- Resources File
- User Control
3.10.21120.03
Please head to https://aka.ms/wtsinstall to install the VSIX.
Included in this version:
-
Added MVVM Toolkit as framework to UWP and WPF templates
This framework replaces MVVM Basic and MVVM Light which have been deprecated. For information on how to migrate see Migrating from MVVM Light and Migrating from MVVM Basic -
Added ToastNotification feature for WPF templates
-
Bug fixes
-
Breaking changes in WPF templates:
-
Updated Prism to Version 8.0.0:
We've update the Prism templates to use version 8.0.0 removing the following lines on the ViewModels:
xmlns:prism="http://prismlibrary.com/" prism:ViewModelLocator.AutoWireViewModel="True"
If you add a new Page to an existing project that uses Prism 7.0, you need to add those lines to the ViewModel. -
ToastNotifications required the addition of an isInitialized flag on the ApplicationHostService to prevent repeated app initialization:
When adding a new SettingsPage to an existing project you'll get two warnings on the ApplicationHostService. You can either include the
_isInitialized flag as described in Toast Notification - App Life Cycle or add the initialization code manually to the corresponding methods.
-
-
Breaking changes in UWP templates:
- Renamed MasterDetailView to ListDetailView in Windows Community Toolkit 7.0.0:
The MasterDetailView control was renamed to ListDetailView in Windows Community Toolkit 7.0.0, the properties where adjusted accordingly. For more details see ListDetailsView - Windows Community Toolkit | Microsoft Docs
- Renamed MasterDetailView to ListDetailView in Windows Community Toolkit 7.0.0:
Updated nuget packages in UWP templates:
Package | Version |
---|---|
AdaptiveCards | 2.7.1 |
Appium.WebDriver | 4.3.1 |
Microsoft.AppCenter.Analytics | 4.2.0 |
Microsoft.AppCenter.Crashes | 4.2.0 |
Microsoft.Identity.Client | 4.29.0 |
Microsoft.NET.Test.Sdk | 16.9.4 |
Microsoft.Toolkit.Mvvm | 7.0.1 |
Microsoft.Toolkit.Uwp | 7.0.1 |
Microsoft.Toolkit.Uwp.Notifications | 7.0.1 |
Microsoft.Toolkit.Uwp.UI.Animations | 7.0.1 |
Microsoft.Toolkit.Uwp.UI.Controls | 7.0.1 |
Microsoft.Toolkit.Uwp.UI.Controls.DataGrid | 7.0.1 |
MSTest.TestAdapter | 2.2.3 |
MSTest.TestFramework | 2.2.3 |
NUnit | 3.13.1 |
Swashbuckle.AspNetCore | 6.1.2 |
Telerik.UI.for.UniversalWindowsPlatform | 1.0.2.3 |
Updated nuget packages in WPF templates:
Package | Version |
---|---|
Appium.WebDriver | 4.3.1 |
coverlet.collector | 3.0.3 |
MahApps.Metro | 2.4.4 |
Microsoft.Extensions.Hosting | 3.1.14 |
Microsoft.Extensions.Http | 3.1.14 |
Microsoft.Extensions.Configuration | 3.1.14 |
Microsoft.Extensions.Configuration.Binder | 3.1.14 |
Microsoft.Extensions.Configuration.CommandLine | 3.1.14 |
Microsoft.Extensions.Configuration.Json | 3.1.14 |
Microsoft.Identity.Client | 4.29.0 |
Microsoft.NET.Test.Sdk | 16.9.4 |
Microsoft.Toolkit.Mvvm | 7.0.1 |
Moq | 4.16.1 |
MSTest.TestAdapter | 2.2.3 |
MSTest.TestFramework | 2.2.3 |
Newtonsoft.Json | 13.0.1 |
NUnit | 3.13.1 |
3.9.20351.02
Please head to https://aka.ms/wtsinstall to install the VSIX.
Included in this version:
-
Added Testing templates to WPF project generation:
- Test App with MSTest
- Test App with NUnit
- Test App with Xunit
- Test Core library with MSTest
- Test Core library with NUnit
- Test Core library with Xunit
- Win App Driver
-
Accessibility improvements in Wizard
-
Bug fixes
Updated nuget packages in UWP templates:
Package | Version |
---|---|
AdaptiveCards | 2.3.0 |
Appium.WebDriver | 4.2.1 |
Microsoft.AppCenter.Analytics | 4.0.0 |
Microsoft.AppCenter.Crashes | 4.0.0 |
Microsoft.AspNetCore.Authentication.JwtBearer | 3.1.10 |
Microsoft.Identity.Client | 4.23.0 |
Microsoft.NET.Test.Sdk | 16.8.0 |
Swashbuckle.AspNetCore | 5.6.3 |
Telerik.UI.for.UniversalWindowsPlatform | 1.0.2.1 |
Updated nuget packages in WPF templates:
Package | Version |
---|---|
Fluent.Ribbon | 8.0.2 |
MahApps.Metro | 2.4.1 |
Microsoft.Extensions.Configuration | 3.1.10 |
Microsoft.Extensions.Configuration.CommandLine | 3.1.10 |
Microsoft.Extensions.Configuration.Json | 3.1.10 |
Microsoft.Extensions.Hosting | 3.1.10 |
Microsoft.Extensions.Http | 3.1.10 |
Microsoft.Identity.Client | 4.23.0 |
Microsoft.NET.Test.Sdk | 16.8.0 |
Moq | 4.15.2 |
OSVersionHelper | 1.1.24 |