diff --git a/README.md b/README.md index 8a08ad97b7..fe944a9837 100644 --- a/README.md +++ b/README.md @@ -13,7 +13,7 @@ WinUI 3 is the next generation of the WinUI framework. It dramatically expands W The WinUI community call is your monthly opportunity to learn about native UX development for Windows with WinUI. -In these calls we’ll discuss the WinUI roadmap, our status and your feedback. +In these calls we’ll discuss the WinUI [roadmap](docs/roadmap.md), our status and your feedback. You can watch them online here on YouTube at the [Windows Developer channel](https://www.youtube.com/channel/UCzLbHrU7U3cUDNQWWAqjceA). @@ -21,7 +21,7 @@ Add the event to your calendar: [ICS calendar file](docs/communitycalls/WinUICom ## Using WinUI 3 -You can build new Windows apps using WinUI 3, which ships as a part of the Windows App SDK. The latest available stable release is the Windows App SDK 0.8 (previously called Project Reunion). With this release, you can ship production Desktop apps to the Microsoft Store. +You can build new Windows apps using WinUI 3, which ships as a part of the Windows App SDK. The latest available stable release is the Windows App SDK 1.0 (previously called Project Reunion). With this release, you can ship production Desktop apps to the Microsoft Store. See the [installation instructions](https://docs.microsoft.com/windows/apps/windows-app-sdk/set-up-your-development-environment), and guidelines on [creating your first WinUI 3 app](https://docs.microsoft.com/windows/apps/winui/winui3/create-your-first-winui3-app). @@ -32,14 +32,14 @@ You can download and use WinUI packages in your app using the NuGet package mana | NuGet Package | Build Status | Latest Versions | Documentation | | --- | --- | --- | --- | -| [Microsoft.UI.Xaml](https://www.nuget.org/packages/Microsoft.UI.Xaml)
Controls and Fluent Design for UWP apps | [![Build Status](https://dev.azure.com/ms/microsoft-ui-xaml/_apis/build/status/WinUI-Public-MUX-CI?branchName=main)](https://dev.azure.com/ms/microsoft-ui-xaml/_build/latest?definitionId=20?branchName=main) | [![latest stable version](https://img.shields.io/nuget/v/Microsoft.UI.Xaml.svg)](https://www.nuget.org/packages/Microsoft.UI.Xaml)
[![latest prerelease version](https://img.shields.io/nuget/vpre/Microsoft.UI.Xaml.svg)](https://www.nuget.org/packages/Microsoft.UI.Xaml/absoluteLatest) | [2.5 release](https://docs.microsoft.com/windows/apps/winui/winui2/release-notes/winui-2.5) | +| [Microsoft.UI.Xaml](https://www.nuget.org/packages/Microsoft.UI.Xaml)
Controls and Fluent Design for UWP apps | [![Build Status](https://dev.azure.com/ms/microsoft-ui-xaml/_apis/build/status/WinUI-Public-MUX-CI?branchName=main)](https://dev.azure.com/ms/microsoft-ui-xaml/_build/latest?definitionId=20?branchName=main) | [![latest stable version](https://img.shields.io/nuget/v/Microsoft.UI.Xaml.svg)](https://www.nuget.org/packages/Microsoft.UI.Xaml)
[![latest prerelease version](https://img.shields.io/nuget/vpre/Microsoft.UI.Xaml.svg)](https://www.nuget.org/packages/Microsoft.UI.Xaml/absoluteLatest) | [2.7 release](https://docs.microsoft.com/windows/apps/winui/winui2/release-notes/winui-2.7) | | [Microsoft.UI.Xaml.Core.Direct](https://www.nuget.org/packages/Microsoft.UI.Xaml.Core.Direct)
Low-level APIs for middleware components | | [![latest prerelease version](https://img.shields.io/nuget/vpre/Microsoft.UI.Xaml.Core.Direct.svg)](https://www.nuget.org/packages/Microsoft.UI.Xaml.Core.Direct/absoluteLatest) | [2.0 prerelease](https://docs.microsoft.com/uwp/api/microsoft.ui.xaml.core.direct) | You can also build a WinUI package yourself from source. See [Contributing to the Windows UI Library](CONTRIBUTING.md) for more information on building and contributing to WinUI. ## Documentation -To find resources for Windows UI 2.6, like the Figma design toolkit, Segoe UI Variable Font, and samples, visit [Design toolkits and samples for Windows apps](https://docs.microsoft.com/windows/apps/design/downloads/) +To find resources for Windows UI 2.7, like the [Figma design toolkit](aka.ms/figmatoolkit), Segoe UI Variable Font, and samples, visit [Design toolkits and samples for Windows apps](https://docs.microsoft.com/windows/apps/design/downloads/) If you find any issues with the Windows UI toolkit, you can file a bug [here](https://aka.ms/WinUIToolkitBug) @@ -83,7 +83,7 @@ You don't need version checks or conditional XAML markup to use WinUI controls o ### Version support -The Microsoft.UI.Xaml 2.4 NuGet package requires your project to have TargetPlatformVersion >= 10.0.18362.0 and TargetPlatformMinVersion >= 10.0.15063.0 when building. +The Microsoft.UI.Xaml 2.7 NuGet package requires your project to have TargetPlatformVersion >= 10.0.18362.0 and TargetPlatformMinVersion >= 10.0.15063.0 when building. Your app's users can be on any of the following supported Windows 10 versions: @@ -100,7 +100,9 @@ For info on the WinUI release schedule and high level plans please see the [Wind ## WinUI 3 is a part of the Windows App SDK family The [Windows App SDK](https://github.com/microsoft/ProjectReunion) is a set of libraries, frameworks, components, and tools that you can use in your apps to access powerful Windows platform functionality from all kinds of apps on many versions of Windows. The Windows App SDK combines the powers of Win32 native applications alongside modern API usage techniques, so your apps light up everywhere your users are. -Other Windows App SDK components are: [WebView2](https://docs.microsoft.com/microsoft-edge/webview2/), [MSIX (MSIX-Core)](https://docs.microsoft.com/windows/msix/overview), [C++/WinRT](https://github.com/microsoft/cppwinrt), [Rust/WinRT](https://github.com/microsoft/winrt-rs), and [C#/WinRT](https://github.com/microsoft/cswinrt). If you'd like to learn more and contribute to Windows App SDK, or have **UWP/app model related questions**, visit our [Github repo](https://github.com/microsoft/ProjectReunion). +Other Windows App SDK components are: [WebView2](https://docs.microsoft.com/microsoft-edge/webview2/), [MSIX (MSIX-Core)](https://docs.microsoft.com/windows/msix/overview), [C++/WinRT](https://github.com/microsoft/cppwinrt), [Rust/WinRT](https://github.com/microsoft/winrt-rs), and [C#/WinRT](https://github.com/microsoft/cswinrt). If you'd like to learn more and contribute to Windows App SDK, or have **UWP/app model related questions**, visit our [Github repo](https://github.com/microsoft/WindowsAppSDK). + +To see the Windows App SDK full roadmap and features that are under consideration (or to submit feature requests), [visit the productboard portal](https://portal.productboard.com/winappsdk/1-windows-app-sdk). ## Data/Telemetry diff --git a/docs/roadmap.md b/docs/roadmap.md index 9fc34c0d5c..363003f82a 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -55,7 +55,7 @@ It focuses on enabling three main use cases: 3. **Enabling other frameworks** * Providing the native implementation for other frameworks like [React Native](https://github.com/Microsoft/react-native-windows) when running on Windows -WinUI 3 is available as a part of the [Windows App SDK](https://docs.microsoft.com/windows/apps/windows-app-sdk) for building stable and supported desktop/Win32 apps for production scenarios. The latest release is the Windows App SDK 0.8, which you can download and read more about at the documentation linked below: +WinUI 3 is available as a part of the [Windows App SDK](https://docs.microsoft.com/windows/apps/windows-app-sdk) for building stable and supported desktop/Win32 apps for production scenarios. The latest release is the Windows App SDK 1.0, which you can download and read more about at the documentation linked below: [Stable release channel for the Windows App SDK](https://docs.microsoft.com/windows/apps/windows-app-sdk/stable-channel) @@ -66,7 +66,7 @@ There's also a version of WinUI 3 available that includes experimental features. ## WinUI 3 Feature Roadmap -The images below lists out what the WinUI team plans to ship in 2021. +The images below list out what the WinUI team has shipped in 2021. Stay tuned for an updated visual roadmap for 2022. The Windows App SDK ships experimental, preview, and stable builds (with WinUI 3 as a component). You can read more about the shipping schedule and cadence in our [Release Channels doc](https://docs.microsoft.com/windows/apps/windows-app-sdk/release-channels). For more details on when specific features will become available, see the feature roadmap table below. @@ -96,35 +96,36 @@ For questions or status updates on either features listed here, or features not Blank - Not available - -**WinUI 3 - Windows App SDK 0.8** is our latest release. - -| Customer Capability | Project Reunion 0.5
(March 2021) | Windows App SDK 0.8
(June 2021) | Windows App SDK 1.0
(Q4 2021) | Planned for a future update | -| ------------------------------------------------------ | -------------------------------- | ------------------------------- | ----------------------------- | --------------------------- | -| Supported in any app using the Windows App SDK | 🟢 | 🟢 | 🟢 | 🟢 | -| Contains new Windows 11 controls/styles from WinUI 2.6 | | | 🟢 | 🟢 -| Supports MSIX Deployment | 🟢 | 🟢 | 🟢 | 🟢 | -| Supports Unpackaged (non-MSIX) Deployment | | | 🟢 | 🟢 | -| Works downlevel to Windows 10 version 1809 and above | 🟢 | 🟢 | 🟢 | 🟢 | -| Supports the latest .NET | 🟢 | 🟢 | 🟢 | 🟢 | -| ARM64 support | 🟢 | 🟢 | 🟢 | 🟢 | -| ` ` | 🟢 | 🟢 | 🟢 | 🟢 | -| Intellisense, Hot Reload, Live Visual Tree | 🔷 | 🔷 | 🟢 | 🟢 | -| Chromium-based WebView2 | 🟢 | 🟢 | 🟢 | 🟢 | -| Title bar customization | 🟢 | 🟢 | 🟢 | 🟢 | -| Fluent Shadows | 🟢 | 🟢 | 🟢 | 🟢 | -| Input validation for data fields | 🔷 | 🔷 | 🔷 | 🟢 | -| Supports multiple top-level windows on the same thread | 🔷 | 🔷 | 🔷 | 🟢 | -| Support multiple top-level windows on separate threads | 🔷 | 🔷 | 🔷 | 🟢 | -| Drag and drop | 🟢 | 🟢 | 🟢 | 🟢 | -| RenderTargetBitmap | 🟢 | 🟢 | 🟢 | 🟢 | -| Mouse cursor customization | 🟢 | 🟢 | 🟢 | 🟢 | -| Animated Gif support | 🟢 | 🟢 | 🟢 | 🟢 | -| VirtualSurfaceImageSource (VSIS) support | 🟢 | 🟢 | 🟢 | 🟢 | -| In-app acrylic | 🟢 | 🟢 | 🟢 | 🟢 | -| Background acrylic | | | |🟢 | | -| Mica | | | | 🟢 | | -| XAML Islands | | | | 🟢 | -| Media Controls (e.g. ``) | | | | 🟢 | -| `` | | | | 🟢 | -| `` | | | | 🟪 | +**WinUI 3 - Windows App SDK 1.0** is our latest release. + +| Customer Capability | Project Reunion 0.5
(March 2021) | Windows App SDK 0.8
(June 2021) | Windows App SDK 1.0
(November 2021) | Planned for Windows App SDK 1.1 | Planned for a future update | +| ------------------------------------------------------ | -------------------------------- | ------------------------------- | ----------------------------- | --------------------------- | --------------------------- | +| Supported in any app using the Windows App SDK | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | +| Contains new Windows 11 controls/styles from WinUI 2.6 | | | 🟢 | 🟢 | 🟢 | +| Supports MSIX Deployment | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | +| Supports Unpackaged (non-MSIX) Deployment | | | 🟢 | 🟢 | 🟢 | +| Works downlevel to Windows 10 version 1809 and above | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | +| Supports the latest .NET | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | +| ARM64 support | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | +| ` ` | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | +| Intellisense, Hot Reload, Live Visual Tree | 🔷 | 🔷 | 🟢[^1] | 🟢 | 🟢 | +| Chromium-based WebView2 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | +| Title bar customization | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | +| Fluent Shadows | 🟢 | 🟢 | 🟢 | 🟢 +| Input validation for data fields | 🔷 | 🔷 | 🔷 | 🔷 | 🟢 | +| Supports multiple top-level windows on the same thread | 🔷 | 🔷 | 🔷 | 🟢 | 🟢 | +| Support multiple top-level windows on separate threads | 🔷 | 🔷 | 🔷 | 🔷 | 🟢 | +| Drag and drop | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | +| RenderTargetBitmap | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | +| Mouse cursor customization | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | +| Animated Gif support | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | +| VirtualSurfaceImageSource (VSIS) support | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | +| In-app acrylic | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | +| Background acrylic | | | | 🟢 | 🟢 | +| Mica | | | | 🟢 | 🟢 | +| XAML Islands | | 🔷 | 🔷 | 🔷 | 🟢 | +| Media Controls (e.g. ``) | | | | | 🟢 | +| `` | | | | | 🟢 | +| `` | | | | | 🟪 | + +[^1]: Supported in packaged apps only