Uno.XamlMerge.Task 1.31.0-dev.59

The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org. Prefix Reserved
This is a prerelease version of Uno.XamlMerge.Task.
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package Uno.XamlMerge.Task --version 1.31.0-dev.59
NuGet\Install-Package Uno.XamlMerge.Task -Version 1.31.0-dev.59
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Uno.XamlMerge.Task" Version="1.31.0-dev.59" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Uno.XamlMerge.Task --version 1.31.0-dev.59
#r "nuget: Uno.XamlMerge.Task, 1.31.0-dev.59"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Uno.XamlMerge.Task as a Cake Addin
#addin nuget:?package=Uno.XamlMerge.Task&version=1.31.0-dev.59&prerelease

// Install Uno.XamlMerge.Task as a Cake Tool
#tool nuget:?package=Uno.XamlMerge.Task&version=1.31.0-dev.59&prerelease

Uno.XamlMerge.Task

An msbuild task which enables the merging of WinUI XAML resource dictionaries into a single flat ResourceDictionary.

This code is derived from WinUI's BatchMergeXaml class, to be reused in any WinUI and Uno Platform Controls library.

Why merge ResourceDictionary instances ?

This task is generally used to allow for separate resource dictionary authoring (which makes them easier to load and read) to avoid impacting resources lookup runtime performance. In WinUI, ResourceDictionary resolution is performed through a graph traversal of MergedDictionaries, which generally implies that a worse case resolution can require as many lookups as there are dictionaries.

To limit the impact of the traversal, this task task takes all resource dictionaries found in a specific MSBuild item group, and merges them into a single file. This file is then generally either named Themes\Generic.xaml or referenced as a merged dictionary from another Themes\Generic.xaml file.

Using the task

See our documentation for more details on how to use this task.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • .NETStandard 2.0

    • No dependencies.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on Uno.XamlMerge.Task:

Package Downloads
Nventive.View.Uno The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Nventive.View.Uno

Nventive.View.Uno.WinUI The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Nventive.View.Uno.WinUI

GitHub repositories (2)

Showing the top 2 popular GitHub repositories that depend on Uno.XamlMerge.Task:

Repository Stars
unoplatform/uno
Build Mobile, Desktop and WebAssembly apps with C# and XAML. Today. Open source and professionally supported.
unoplatform/Uno.Themes
This library is designed to help you use the Material, Fluent or Cupertino design system with the Uno Platform
Version Downloads Last updated
1.32.0-dev.61 10,849 12/5/2023
1.31.0-dev.59 87 11/8/2023
1.30.0-dev.54 58 11/8/2023
1.29.0-dev.52 58 11/8/2023
1.28.0-dev.46 61 11/8/2023
1.27.0-dev.44 94,789 7/21/2023
1.26.0-dev.40 84,224 2/17/2023
1.25.0-dev.38 141 2/17/2023
1.24.0-dev.34 113 2/15/2023
1.23.0-dev.24 167 2/8/2023
1.22.0-dev.22 1,967 1/12/2023
1.21.0-dev.21 156 12/19/2022
1.20.0-dev.20 97 12/19/2022
1.19.0-dev.19 97 12/19/2022
1.18.0-dev.18 149 12/16/2022
1.16.0-dev.16 1,098 11/23/2022
1.15.0-dev.15 94 11/23/2022
1.14.0-dev.14 96 11/22/2022
1.1.0-dev.13 26,642 5/13/2022
1.1.0-dev.12 89,870 4/13/2022
1.1.0-dev.11 117 4/13/2022
1.1.0-dev.10 134 4/12/2022
1.1.0-dev.9 125 4/11/2022
1.1.0-dev.8 201 4/8/2022
1.1.0-dev.7 116 4/8/2022
1.1.0-dev.6 127 4/7/2022
1.1.0-dev.5 121 4/7/2022
1.1.0-dev.4 124 4/7/2022
1.1.0-dev.3 238 3/8/2022
1.1.0-dev.2 3,025 2/25/2022
1.1.0-dev.1 116 2/23/2022
1.0.0 121,525 2/8/2022
0.1.0-dev.51 12,577 1/19/2022
0.1.0-dev.50 161 1/12/2022
0.1.0-dev.48 2,855 1/10/2022
0.1.0-dev.47 7,648 1/6/2022
0.1.0-dev.46 2,592 1/5/2022
0.1.0-dev.45 144 1/5/2022
0.1.0-dev.44 136 1/4/2022
0.1.0-dev.43 133 1/4/2022
0.1.0-dev.42 185 1/3/2022
0.1.0-dev.41 502 12/14/2021
0.1.0-dev.37 149 12/14/2021

#  (2023-11-08)


### Bug Fixes

* add a workaround for net461's XmlAttributeCollection.InsertAfter ([20e0cf9](https://github.com/unoplatform/uno.xamlmerge.task/commit/20e0cf93d0ffcdf2357c3a9cb43371e87de5affe))
* Adjust AdditionalFiles generation sequence ([#98](https://github.com/unoplatform/uno.xamlmerge.task/issues/98)) ([f0e11a1](https://github.com/unoplatform/uno.xamlmerge.task/commit/f0e11a1ab2d1c3537816e60037757dee483d23f3))
* Adjust assembly name rename ([#37](https://github.com/unoplatform/uno.xamlmerge.task/issues/37)) ([f70d6dd](https://github.com/unoplatform/uno.xamlmerge.task/commit/f70d6dd72ea98be335f201527f1230f1625a94a4))
* Adjust for incorrect duplicate page items ([#53](https://github.com/unoplatform/uno.xamlmerge.task/issues/53)) ([2f8b59d](https://github.com/unoplatform/uno.xamlmerge.task/commit/2f8b59df79a3b23a76127e208b524d03f6950f30))
* Allow for the same file to be present in multiple output ([#58](https://github.com/unoplatform/uno.xamlmerge.task/issues/58)) ([093fec3](https://github.com/unoplatform/uno.xamlmerge.task/commit/093fec3f7224f5eac998824834a0859df073871a))
* Always run generation on build ([#112](https://github.com/unoplatform/uno.xamlmerge.task/issues/112)) ([981a35b](https://github.com/unoplatform/uno.xamlmerge.task/commit/981a35bc3487bc9084457512cc4ed265e6e2576f))
* Avoid conflicts when a key is named like a TargetType ([#36](https://github.com/unoplatform/uno.xamlmerge.task/issues/36)) ([fc436ca](https://github.com/unoplatform/uno.xamlmerge.task/commit/fc436caebc467ab7827c69046d3aedde9a3b7aa4))
* Fix for outer builds ([be6191e](https://github.com/unoplatform/uno.xamlmerge.task/commit/be6191ebc06077e255c97988a4c76d0155450085))
* Fix XamlMerge task crash ([2cc40f4](https://github.com/unoplatform/uno.xamlmerge.task/commit/2cc40f49c354dae4be33d0252b4332f9929dec3c))
* Invalid merge inclusion ([#60](https://github.com/unoplatform/uno.xamlmerge.task/issues/60)) ([a7c211c](https://github.com/unoplatform/uno.xamlmerge.task/commit/a7c211c9c0d0ce5e8ac7ebfa72e4a321826bd083))
* Missing import for single merge file ([#54](https://github.com/unoplatform/uno.xamlmerge.task/issues/54)) ([f6c0fb0](https://github.com/unoplatform/uno.xamlmerge.task/commit/f6c0fb0e9a09a8616db6b49f811d8704e85fca86))
* Properly merge namespaces ([597372e](https://github.com/unoplatform/uno.xamlmerge.task/commit/597372e3aad24f69e1a6c0d4ed3b8da09d7eb4e9))
* **reg:** Add missing dependency on uno.sourcegenerator task ([f11018e](https://github.com/unoplatform/uno.xamlmerge.task/commit/f11018e7bd3beaf1066117c9a2d6b7a6e80b362f))
* **reg:** remove invalid debugger statement ([0546cc9](https://github.com/unoplatform/uno.xamlmerge.task/commit/0546cc9f53a8664a3969d784d2240f31d869146d))


### Features

* Add support for multiple output merged files ([#50](https://github.com/unoplatform/uno.xamlmerge.task/issues/50)) ([c646cbd](https://github.com/unoplatform/uno.xamlmerge.task/commit/c646cbd7f91e3c563b558d06f86dd1adb804c447))
* Allow for key override for non-ignored namespaces ([#105](https://github.com/unoplatform/uno.xamlmerge.task/issues/105)) ([00ded04](https://github.com/unoplatform/uno.xamlmerge.task/commit/00ded0401f135a8c0873ec9f823309e7e8414129))
* Generate HotReload-friendly merged file when HR is enabled ([333dd48](https://github.com/unoplatform/uno.xamlmerge.task/commit/333dd4899d54a7b8cb05dca264f2b5056e556039))
* Support merging #using ([5a1c3e2](https://github.com/unoplatform/uno.xamlmerge.task/commit/5a1c3e29276afa8e54064bf89dcf060124747b66))