67

Github [WinUI3] Windows Community Toolkit 8.0.0-preview4 for WinUI 3 Preview 4 ·...

 4 years ago
source link: https://github.com/windows-toolkit/WindowsCommunityToolkit/issues/3295
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
neoserver,ios ssh client

Windows Community Toolkit 8.0.0 Preview 4 heartpulse WinUI 3 Preview 4

Originally, at //Build, WinUI 3 Preview 1 was released to showcase improvements to WinUI 3 and the first release of the Desktop development story on .NET 5. tadatadatadaNow they've shipped Preview 4!

The Windows Community Toolkit has been working alongside the WinUI team to also make sure the Toolkit works on WinUI 3! We're happy to announce that we're also shipping a preview of the toolkit that works on top of this WinUI 3 Preview 4 the same day! tadatadatada

This pre-release showcases the majority of the toolkit working on top of WinUI 3 for Desktop developers in .NET 5! If you find any new issues specific to this preview (or do something awesome), please let us know by commenting below!

Requirements

Getting Started

  1. Open your VS 2019 Preview and Create a New Project.

  2. Pick the "Blank App, Packaged (WinUI in Desktop) C#" template.

  3. Setup your project directories and options as guided by the WinUI 3 Preview docs, we'll refer to "Project Name" generically from here on to be whatever you named your project.

  4. (Optional) You should be able to run the "Project Name (Package)" project and see the blank starting app if your WinUI 3 environment is setup correctly.

  5. Right-click your other application "Project Name" project, and select "Manage NuGet Packages..."

  6. Click the gear in the top-right of the page to configure your NuGet settings.

  7. Add a new Package source to our DevOps feed: https://pkgs.dev.azure.com/dotnet/WindowsCommunityToolkit/_packaging/WindowsCommunityToolkit-WinUI3/nuget/v3/index.json, be sure to hit the Update button after changing the textboxes, and click OK. Read more on our Preview Packages here.

  8. Select the "DevOps" package source from the drop-down menu next to the Settings icon.

  9. Click on Browse, find a Toolkit package you'd like to add like "Microsoft.Toolkit.Uwp.UI.Controls"

  10. Make sure to select the 8.0.0-preview4 version from the Version drop-down and click "Install"!

  11. Go to your MainWindow.xaml and paste in some Toolkit code, like our UniformGrid example from our Sample App:

    <controls:UniformGrid 
            FirstColumn="1"
            Orientation="Horizontal"
            Rows="0"
            Columns="0">
        <Border Background="AliceBlue" 
                Grid.Row="1" Grid.Column="1" 
                Grid.RowSpan="2" 
                Grid.ColumnSpan="2">
            <TextBlock Text="1"/>
        </Border>
        <Border Background="Cornsilk">
            <TextBlock Text="2"/>
        </Border>
        <Border Background="DarkSalmon">
            <TextBlock Text="3"/>
        </Border>
        <Border Background="Gainsboro">
            <TextBlock Text="4"/>
        </Border>
        <Border Background="LightBlue">
            <TextBlock Text="5"/>
        </Border>
        <Border Background="MediumAquamarine">
            <TextBlock Text="6"/>
        </Border>
        <Border Background="MistyRose">
            <TextBlock Text="7"/>
        </Border>
        <Border Background="LightCyan">
            <TextBlock Text="8"/>
        </Border>
        <Border Background="Salmon">
            <TextBlock Text="9"/>
        </Border>
        <Border Background="Goldenrod">
            <TextBlock Text="10"/>
        </Border>
        <Border Background="Pink">
            <TextBlock Text="11"/>
        </Border>
    </controls:UniformGrid>

Don't forget the xmlns:controls="using:Microsoft.Toolkit.Uwp.UI.Controls" in your Page tag!

(And if you replace the existing template's XAML remove the event handler in the code-behind!)

  1. Hit F5 and Voila! tadatadatada

Known Issues/Limitations

  • The Windows Community Toolkit 8.x previews are currently only geared towards .NET 5 Desktop development. The toolkit has been tested against the 'UWP' sandboxed versions of WinUI as well, but won't ship a public package until .NET 5 tooling is supported for that environment. (See tracking on dotnet and Project Reunion.)

  • Any component relying on Win2D as a dependency will not function or throw an exception. (See their WinUI tracking issue here.)

  • The new TabbedCommandBar control hasn't been updated yet.

  • ThemeListener is not working due to APIs being removed in WinUI Preview 4, see their known issue list in link below.

  • GridSplitter cursor doesn't change discussed here because of changes to CoreWindow and Cursor property internal issue.

  • Be sure to also read the WinUI 3 Preview 4 Known Issue List.


report

Recommend

About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK