MicrosoftDocs / WindowsCommunityToolkitDocs

Creative Commons Attribution 4.0 International
179 stars 156 forks source link

Getting Started - WPF coreapp is not the same as the UWP community toolkit #325

Open OzBob opened 4 years ago

OzBob commented 4 years ago

When starting a new coreapp3 WPF app, the WPF repo: https://github.com/windows-toolkit/Microsoft.Toolkit.Win32 instructs to use the Community Toolkit Docs which refer to the UWP documentation and instructs a new user to:

create a new project using the Blank App template under Visual C# -> Windows -> Universal. Important: Build 16299 or higher is supported by current version of the Toolkit.

In Solution Explorer panel, right click on your project name and select Manage NuGet Packages. Search for Microsoft.Toolkit.UWP

and when a new user does that the error is:

NU1202 Package Microsoft.Toolkit.Uwp.UI.Controls 6.0.0 is not compatible with netcoreapp3.0 (.NETCoreApp,Version=v3.0). Package Microsoft.Toolkit.Uwp.UI.Controls 6.0.0 supports: uap10.0.16299 (UAP,Version=v10.0.16299)

When the new user tries searching in nuget for just "Microsoft.Toolkit" and finds:

Microsoft.Toolkit.Win32.UI.Controls the package descriptions says:

This package is now obsolete and contains no DLLs. Please use Microsoft.Toolkit.Wpf.UI.Controls.WebView

What does WebView have to do with that package is not obvious to a new user.

Suggestion: Update https://docs.microsoft.com/en-us/windows/communitytoolkit/getting-started to include WPF Toolkit instructions.

e.g. should the new project use: Microsoft.Toolkit.Win32.UI.SDK ?

eazydripz commented 3 years ago

Thank you.