[Docs] Windows Community Toolkit documentation will need to be updated to add latest details

[agneszitte]

Windows Community Toolkit documentation will need to be updated to add latest details:

• Details about the setup with the new single project structure and legacy templates for v7 and v8
• Details about the migration from v7 to v8 for WCT
• Details about direct support for Uno Platform, simplifying the setup process starting with WCT v8
• Details about the needed update to Windows SDK 10.0.22621 and above and Microsoft.WindowsAppSDK to the latest version for WCT version 8.x
• Details about the new updated related samples

---

Hi @tomchoondal (cc @palusi, @arnold256)
We will update soon our documentation with the new changes.

But here are the details with our latest single project structure:

• For WCT (v. 7.1.2 and below):
  xmlns:controls="using:CommunityToolkit.WinUI.UI.Controls"

  In Directory.Packages.props:

   <ItemGroup Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'windows'">
     <PackageVersion Include="CommunityToolkit.WinUI.UI.Controls" Version="7.1.2" />
     <!-- Add more community toolkit references here -->
   </ItemGroup>
   <ItemGroup Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) != 'windows'">
     <PackageVersion Include="Uno.CommunityToolkit.WinUI.UI.Controls" Version="7.1.200" />
     <!-- Add more uno community toolkit references here -->
   </ItemGroup>
  

  In YourProjectName.csproj:

   <ItemGroup Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'windows'">
     <PackageReference Include="CommunityToolkit.WinUI.UI.Controls" />
     <!-- Add more community toolkit references here -->
   </ItemGroup>
   <ItemGroup Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) != 'windows'">
     <PackageReference Include="Uno.CommunityToolkit.WinUI.UI.Controls" />
     <!-- Add more uno community toolkit references here -->
   </ItemGroup>
  

• For WCT (v. 8.0 and above):
  xmlns:controls="using:CommunityToolkit.WinUI.Controls"

  • NOTE 1: The WCT 8.0 packages and above now include direct support for Uno Platform, simplifying the setup process.

  • NOTE 2: Updating to the latest WCT version requires an update to net8.0-windows10.0.22621 and Microsoft.WindowsAppSDK to the latest version (1.5.240311000).
    (Related WCT issue: Xaml Internal Error WMC9999 on when updating to v8.1-rc CommunityToolkit/Tooling-Windows-Submodule#185)

    (Example using CommunityToolkit.WinUI.Controls.Primitives here as I tested the WCT WrapPanel)
    In Directory.Packages.props:

     <ItemGroup>
        <PackageVersion Include="CommunityToolkit.WinUI.Controls.Primitives" Version="8.1.240328-rc" />
        <!-- Add more community toolkit references here -->
     </ItemGroup>
    

    In YourProjectName.csproj:

      <ItemGroup>
        <PackageReference Include="CommunityToolkit.WinUI.Controls.Primitives" />
        <!-- Add more community toolkit references here -->
      </ItemGroup>
    

I have made two sample apps to help the community on discord the other week for reference :

• Sample app using WCT (v. 7.1.2): TestWrapPanelButtons.zip
• Sample app using WCT (v. 8.1.240328-rc): TestWrapPanelButtonsWCTRC.zip

Important

Here is the Migration Guide from v7 to v8 for WCT for additional information on what changed lately between these versions.
As for example:

• For the DataGrid control you will need to use WCT version 7.1.2 as it is no longer a control available in the latest versions (v. 8.0 and above) of WCT. (related details on Discord here)
• For the Carousel control you will need to use WCT version 7.1.2 as well as it is no longer a control available in the latest versions (v. 8.0 and above) of WCT. (related details on Discord here)

Also here are the v. 8.1.240328-rc release notes

Originally posted by @agneszitte in #13090 (reply in thread)