ModernWPF 1.0.0-preview.1
1.0.0-preview.1 starts the actively maintained ModernWPF 1.x line. It is the
first forward-compatibility baseline for the CLR APIs and public resource keys
shipped by ModernWpfUI.
Highlights
- Targets
net462,net8.0-windows7.0, andnet10.0-windows7.0. - Adds
FluentControlsResourcesas the recommended resource entry.
net10.0-windows7.0uses the platform WPF Fluent theme for stock controls;
the other targets use ModernWPF's Fluent backport. - Retains
ThemeResourcesplusXamlControlsResourcesas the legacy resource
entry for applications migrating from 0.9.x. - Aligns the WinUI-derived controls, layouts, templates, automation peers, and
resource contracts with the checked-in 1.x parity baselines. - Ships portable SourceLinked PDBs in
ModernWpfUI.1.0.0-preview.1.snupkg.
Package metadata records the exact repository commit used for the build.
Framework and package changes
The package no longer contains assets for:
net45netcoreapp3.0net5.0-windows
The 0.9.x ModernWpfUI.MahApps adapter is not part of the 1.x line. Its
historical package is frozen and unsupported. MahApps applications must own
their integration locally when moving to 1.x; the core ModernWpfUI package
does not reference MahApps.
Intentional 0.9 API changes
Source and binary compatibility with 0.9.x is not promised. In particular:
- Replace
SimpleStackPanelwithStackPanelEx. - Replace
IElementFactoryShimimplementations withIElementFactory. - Replace the old WPF window-shell
TitleBarfacade and control names with
WindowTitleBarandWindowTitleBarControl. - Template-only types previously exposed from
ModernWpf.Controls.Primitivesare internal in 1.x. - WinRT projection and ABI implementation types are no longer public package
API.
See Migrating from ModernWPF 0.9.x and the
1.x public API contract for the complete boundary.
Recommended application resources
New and migrated applications should merge:
<ui:ThemeResources />
<ui:FluentControlsResources UseCompactResources="False" />The legacy entry remains available when a staged migration is preferable:
<ui:ThemeResources />
<ui:XamlControlsResources />Both entries are built and executed from the packed NuGet package on every
supported target as part of the release gate.
Preview limitations
- Packages are not Authenticode-signed for this preview. The annotated tag,
repository commit metadata, retained workflow artifact, SourceLink data, and
published SHA-256 manifest provide build provenance. - MahApps integration is excluded.
- 0.9.x binary compatibility is not provided.
- Compositor-only WinUI behavior and raw pixel parity are adapted to WPF and
remain subject to the documented manual Light, Dark, and High Contrast
visual gate. - Nullable annotations are not yet part of the public compatibility contract.