Migration to v2.0

This guide assumes the migration from version 1.6.5 to 2.0.

Main Breaking Changes

• All marked obsolete code were removed
• Drop support for .Net 4.0
• Drop support for .Net 4.5 and move up to 4.5.2
• Support .Net Core 3.0 and 3.1
• Assemblies are strong named again, but AssemblyVersion is now fixed for every major release. This means that, for example, for version 2.1 the AssemblyVersion will still be 2.0. Other versions like AssemblyFileVersion etc. won't be fixed.
• The theming got rewritten, this means that there is no longer a separation between AppTheme and Accent. These got replaced by Theme everywhere.
• Use new updated GlowWindowBehavior and BorderlessWindowBehavior from ControlzEx
• Instead of depending on System.Windows.Interactivity we now depend on the open source version Microsoft.Xaml.Behaviors.Wpf
• Use a ToolBar overflow mechanism for WindowCommands
• Use TabControlEx from ControlzEx for BaseMetroTabControl

Theming

The theming got rewritten, this means that there is no longer a separation between AppTheme and Accent. These got replaced by Theme everywhere. Instead of something like pack://application:,,,/MahApps.Metro;component/Styles/Accents/Blue.xaml and pack://application:,,,/MahApps.Metro;component/Styles/Accents/BaseLight.xaml you now have to use pack://application:,,,/MahApps.Metro;component/Styles/Themes/Light.Blue.xaml.

Old

<Application x:Class="WpfApplication.App"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             StartupUri="MainWindow.xaml">
  <Application.Resources>
    <ResourceDictionary>
      <ResourceDictionary.MergedDictionaries>
        <ResourceDictionary Source="pack://application:,,,/MahApps.Metro;component/Styles/Controls.xaml" />
        <ResourceDictionary Source="pack://application:,,,/MahApps.Metro;component/Styles/Fonts.xaml" />
        <ResourceDictionary Source="pack://application:,,,/MahApps.Metro;component/Styles/Colors.xaml" />
        <ResourceDictionary Source="pack://application:,,,/MahApps.Metro;component/Styles/Accents/Blue.xaml" />
        <ResourceDictionary Source="pack://application:,,,/MahApps.Metro;component/Styles/Accents/BaseLight.xaml" />
      </ResourceDictionary.MergedDictionaries>
    </ResourceDictionary>
  </Application.Resources>
</Application>

New

<Application x:Class="WpfApplication.App"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             StartupUri="MainWindow.xaml">
  <Application.Resources>
    <ResourceDictionary>
      <ResourceDictionary.MergedDictionaries>
        <ResourceDictionary Source="pack://application:,,,/MahApps.Metro;component/Styles/Controls.xaml" />
        <ResourceDictionary Source="pack://application:,,,/MahApps.Metro;component/Styles/Fonts.xaml" />
        <ResourceDictionary Source="pack://application:,,,/MahApps.Metro;component/Styles/Themes/Light.Blue.xaml" />
      </ResourceDictionary.MergedDictionaries>
    </ResourceDictionary>
  </Application.Resources>
</Application>

Resource Keys

The keys of various resources got rewritten. This makes it easier to find and use these resources in your applications.

Final naming convention is:

MahApps.

• and the resource type which is one of Colors., Brushes., Sizes., Font., Fonts., Storyboard., Styles., Templates.
• and the target control for Templates and Styles (e.g. Button., Slider., Window., ...)
• an optional specifier which gives more context (e.g. Slider for MahApps.Styles.Thumb which helps understanding that this thumb style is for the context of a slider)
• an optional category (e.g. Metro, Flat, Square, Win10, ...)

Renamed and new Colors

Renamed and new Brushes

Deleted Brushes

List of deleted, renamed and new fonts

List of deleted, renamed and new font sizes

List of renamed and new sizes

Styles and Templates

List of deleted, renamed and new styles

List of deleted, renamed and new control theme styles