c3c8b190bd
* Add the new Microsoft.Windows.SDK.BuildTools package to the template so that it is installed when a new project is created using the VSIX. * Addressed comments. * Added definition for WindowsSDKBuildToolsVersion. Fixing case mismatch of WindowsAppSDKVersion in Directory.Build.props (if this change results in 0.5.7 getting used in the VSIX template project files, then clearly we were just getting lucky so far; I'll remove the line in that case). * Install of the NuGet pacakge failed because it couldn't be found. I think that's because the source was absent. It may be that we don't want to use the public nuget source here, but this at least will confirm the suspicion. * Don't underestimate the importance of the semi-colan character. * Attempted fix of: In the Packages subfolder of the VSIX install, I don't see the Microsoft.Windows.SDK.BuildTools .NUPKG. * Undoing addition of the public nuget source. We clearly don't need it since we're successfully using the CppWinRT package already. * Attempt to fix the C++ templates gap: with the wap proj blank app template, the build tools nuget isn't being installed. * Same for CS templates now. * Adding some missing changes... * Adding more missing files... * Fix mistakes. * Tabs to spaces. |
||
|---|---|---|
| .github | ||
| assets | ||
| build | ||
| dev | ||
| docs | ||
| eng | ||
| installer | ||
| localpackages | ||
| specs | ||
| test | ||
| tools | ||
| .editorconfig | ||
| .gitattributes | ||
| .gitignore | ||
| ApiScan.Cpp.props | ||
| Directory.Build.props | ||
| HybridCRT.props | ||
| LICENSE | ||
| LICENSE-CODE | ||
| README.md | ||
| SdkVersion.props | ||
| WindowsAppRuntime.sln | ||
| build_all.cmd | ||
| environment.props | ||
| global.json | ||
| nuget.config | ||
| version.props | ||
README.md
Windows App SDK - Calling all Windows developers!
Previously known as Project Reunion.
| Delight users with modern UI | Access new platform features | Backwards compatible |
|---|---|---|
 Powerful WinUI 3 UI |
 Localization + power status + more |
 Down to Windows 10 1809 |
...and more, without having to rewrite your app!
- Use your current installer (no requirement to use MSIX, but there are reliability/security benefits to using MSIX!)
- 100% additive (only add what you need, leave the rest of your app as-is)
- Works with Win32, WPF, WinForms, and more apps
Plus, create beautiful, modern apps for Windows 11 that are backwards compatible to Windows 10 October 2018 Update (build 17763 / version 1809)!
Use it now!
Desktop apps can use the 0.8 release now!
Some notes about 0.8...
- 0.8 Stable requires using MSIX, but unpackaged apps can try the 0.8 Experimental release!
- 0.8 Stable only includes WinUI 3 / Text rendering / Resource management
- WinUI 3 currently cannot be added to existing WPF/WinForms/etc apps (we'll enable that in a future release via XAML Islands).
Roadmap
Here's a snippet of what's currently available and what we intend to deliver in 2021 (times/features/releases are tentative and subject to change):
| App type | 0.8 | 1.0 (Q4 2021) | Future |
|---|---|---|---|
| Packaged MSIX apps (WinUI 3, WPF, etc) |
✅ WinUI 3** ✅ Text rendering ✅ Resource management 🔄 App lifecycle 🔄 Windowing |
✅ WinUI 3** ✅ Text rendering ✅ Resource management ✅ App lifecycle ✅ Windowing 🔄 Push Notifications |
✅ WinUI 3 ✅ Text rendering ✅ Resource management ✅ App lifecycle ✅ Windowing ✅ Push Notifications |
| Unpackaged apps (WinUI 3, WPF, etc) |
🔄 Text rendering 🔄 Resource management 🔄 App lifecycle 🔄 Windowing |
✅ WinUI 3** ✅ Text rendering ✅ Resource management ✅ App lifecycle ✅ Windowing 🔄 Push Notifications |
✅ WinUI 3 ✅ Text rendering ✅ Resource management ✅ App lifecycle ✅ Windowing ✅ Push Notifications |
✅ Supported | 🔄 Experimental
** - WinUI 3 in 0.8 and 1.0 is only supported for use by full WinUI 3 apps. You'll be able to use WinUI 3 in WPF/WinForms/other apps in a future release via XAML Islands.
See our full roadmap for more details.
Version support
The Windows App SDK aims to work on supported versions of Windows. Right now we support down to build 17763 (version 1809/October 2018 Update) of Windows 10. Wherever possible, we'll use techniques like 'polyfills' and custom implementations to do the heavy lifting for you and make sure your app works across Windows versions and devices. In the future, there may be a couple APIs that are dependent on new OS features (like new Action Center functionality), however we will do our best to ensure this is the exception and not the norm, and provide reasonable fallbacks when possible.
Helpful links
- More details about the Windows App SDK - More on what the project is and how we're approaching the work.
- Video on Windows App SDK - Learn about the Windows App SDK in a 22 minute video!
- Roadmap - Where we're going!
- Contributor guide - How to contribute to the Windows App SDK.
- FAQ - Frequently asked questions about the Windows App SDK.
- Developer docs - Microsoft documentation covering a wide range of Windows App SDK topics.
- Samples - Discover Windows App SDK samples to assist in learning how to use the latest features!
Contributing
We want to hear from you!
File a new issue! Tell us what problem you're trying to solve, how you've tried to solve it so far, and what would be the ideal solution for your app. Bonus points if there's a gist or existing repo we can look at with you.
-
Ask a question
Also, have a look at our frequently asked questions page which we will update periodically. -
Start a discussion
Discussions can be about any topics or ideas related to the Windows App SDK. For example, you might start a Discussion issue to see if others are interested in a cool new idea you've been thinking about that isn't quite ready to be filed as a more formal Feature Proposal. -
Make a feature proposal
What components do you want to see in the Windows App SDK? For example you can propose a new API on an existing type, or an idea for a new API. It's fine if you don't have all the details: you can start with a summary and rationale.
Over time, we will add Windows App SDK code into this repo and provide code contribution/developer guidelines.
Read more about the contribution guide here.
Data collection
The software may collect information about you and your use of the software and send it to Microsoft. Microsoft may use this information to provide services and improve our products and services. You may turn off the telemetry as described in the repository. There are also some features in the software that may enable you and Microsoft to collect data from users of your applications. If you use these features, you must comply with applicable law, including providing appropriate notices to users of your applications together with a copy of Microsoft's privacy statement. Our privacy statement is located at https://go.microsoft.com/fwlink/?LinkID=824704. You can learn more about data collection and use in the help documentation and our privacy statement. Your use of the software operates as your consent to these practices.
Legal notices
Microsoft and any contributors grant you a license to the Microsoft documentation and other content in this repository under the Creative Commons Attribution 4.0 International Public License, see the LICENSE file, and grant you a license to any code in the repository under the MIT License, see the LICENSE-CODE file.
Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries. The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks. Microsoft's general trademark guidelines can be found at http://go.microsoft.com/fwlink/?LinkID=254653.
Privacy information can be found at https://privacy.microsoft.com/
Microsoft and any contributors reserve all other rights, whether under their respective copyrights, patents, or trademarks, whether by implication, estoppel or otherwise.