Migration Overview: Syncfusion .NET MAUI to Syncfusion Toolkit for .NET MAUI

11 Dec 20242 minutes to read

To ensure a smooth migration from Syncfusion .NET MAUI to the Syncfusion Toolkit for .NET MAUI controls, we have designed the Toolkit components to closely resemble those in Syncfusion .NET MAUI. This approach minimizes the changes required during migration, with the primary difference being the use of toolkit-specific namespaces.
By preserving similar APIs and functionality, developers can easily update their existing projects to use the new toolkit with minimal code modifications. Refer to the table below for a detailed overview of the necessary changes:

XAML Namespaces

Controls	Syncfusion .NET MAUI Namespace	Syncfusion Toolkit for .NET MAUI Namespace	Description
SfButton	xmlns: button ="clr-namespace:Syncfusion.Maui.Buttons;assembly=Syncfusion.Maui.Buttons"	xmlns:button ="clr-namespace:Syncfusion.Maui.Toolkit.Buttons;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfButton control.
SfCalendar	xmlns: calendar ="clr-namespace:Syncfusion.Maui.Calendar;assembly=Syncfusion.Maui.Calendar"	xmlns:calendar="clr-namespace:Syncfusion.Maui.Toolkit.Calendar;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfCalendar control.
SfCarousel	xmlns: carousel ="clr-namespace:Syncfusion.Maui.Carousel;assembly=Syncfusion.Maui.Carousel"	xmlns:carousel="clr-namespace:Syncfusion.Maui.Toolkit.Carousel;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfCarousel control.
SfCartesianChart, SfCircularChart, SfFunnelChart, SfPolarChart, and SfPyramidChart	xmlns:chart="clr-namespace:Syncfusion.Maui.Charts;assembly=Syncfusion.Maui.Charts"	xmlns:chart="clr-namespace:Syncfusion.Maui.Toolkit.Charts;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfCartesianChart, SfCircularChart, SfFunnelChart, SfPolarChart, and SfPyramidChart controls.
SfChip	xmlns:chip="clr-namespace:Syncfusion.Maui.Core;assembly=Syncfusion.Maui.Core"	xmlns:chip="clr-namespace:Syncfusion.Maui.Toolkit.Chips;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfChip control.
SfEffectsView	xmlns:effectsView="clr-namespace:Syncfusion.Maui.Core;assembly=Syncfusion.Maui.Core"	xmlns:effectsView="clr-namespace:Syncfusion.Maui.Toolkit.EffectsView;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfEffectsView control.
SfNavigationDrawer	xmlns:navigationDrawer="clr-namespace:Syncfusion.Maui.NavigationDrawer;assembly=Syncfusion.Maui.NavigationDrawer"	xmlns:navigationDrawer="clr-namespace:Syncfusion.Maui.Toolkit.NavigationDrawer;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfNavigationDrawer control.
SfNumericEntry	xmlns:numericEntry ="clr-namespace:Syncfusion.Maui.Inputs;assembly=Syncfusion.Maui.Inputs"	xmlns:numericEntry="clr-namespace:Syncfusion.Maui.Toolkit.NumericEntry;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfNumericEntry control.
SfNumericUpDown	xmlns:numericUpDown ="clr-namespace:Syncfusion.Maui.Inputs;assembly=Syncfusion.Maui.Inputs"	xmlns:numericUpDown="clr-namespace:Syncfusion.Maui.Toolkit.NumericUpDown;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfNumericUpDown control.
SfPullToRefresh	xmlns:pullToRefreshControl="clr-namespace:Syncfusion.Maui.PullToRefresh;assembly=Syncfusion.Maui.PullToRefresh"	xmlns:pullToRefreshControl="clr-namespace:Syncfusion.Maui.Toolkit.PullToRefresh;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfPullToRefresh control.
SfSegmentedControl	xmlns:segmentedControl="clr-namespace:Syncfusion.Maui.Buttons;assembly=Syncfusion.Maui.Buttons"	xmlns:segmentedControl="clr-namespace:Syncfusion.Maui.Toolkit.SegmentedControl;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfSegmentedControl.
SfShimmer	xmlns:shimmer="clr-namespace:Syncfusion.Maui.Shimmer;assembly=Syncfusion.Maui.Core"	xmlns:shimmer="clr-namespace:Syncfusion.Maui.Toolkit.Shimmer;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfShimmer control.
SfTabView	xmlns:tabView="clr-namespace:Syncfusion.Maui.TabView;assembly=Syncfusion.Maui.TabView"	xmlns:tabView="clr-namespace:Syncfusion.Maui.Toolkit.TabView;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfTabView control.
SfTextInputLayout	xmlns:inputLayout="clr-namespace:Syncfusion.Maui.Core;assembly=Syncfusion.Maui.Core"	xmlns:inputLayout="clr-namespace:Syncfusion.Maui.Toolkit.TextInputLayout;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfTextInputLayout control.

C# Namespaces

Controls	Syncfusion .NET MAUI Namespace	Syncfusion Toolkit for .NET MAUI Namespace	Description
SfButton	Syncfusion.Maui.Buttons	Syncfusion.Maui.Toolkit.Buttons	Defines the namespace for SfButton control.
SfCalendar	Syncfusion.Maui.Calendar	Syncfusion.Maui.Toolkit.Calendar	Defines the namespace for SfCalendar control.
SfCarousel	Syncfusion.Maui.Carousel	Syncfusion.Maui.Toolkit.Carousel	Defines the namespace for SfCarousel control.
SfCartesianChart, SfCircularChart, SfFunnelChart, SfPolarChart, and SfPyramidChart	Syncfusion.Maui.Charts	Syncfusion.Maui.Toolkit.Charts	Defines the namespace for SfCartesianChart, SfCircularChart, SfFunnelChart, SfPolarChart, and SfPyramidChart controls.
SfChip	Syncfusion.Maui.Core	Syncfusion.Maui.Toolkit.Chip	Defines the namespace for SfChip control.
SfEffectsView	Syncfusion.Maui.Core	Syncfusion.Maui.Toolkit.EffectsView	Defines the namespace for SfEffectsView control.
SfNavigationDrawer	Syncfusion.Maui.NavigationDrawer	Syncfusion.Maui.Toolkit.NavigationDrawer	Defines the namespace for SfNavigationDrawer control.
SfNumericEntry	Syncfusion.Maui.Inputs	Syncfusion.Maui.Toolkit.NumericEntry	Defines the namespace for SfNumericEntry control.
SfNumericUpDown	Syncfusion.Maui.Inputs	Syncfusion.Maui.Toolkit.NumericUpDown	Defines the namespace for SfNumericUpDown control.
SfPullToRefresh	Syncfusion.Maui.PullToRefresh	Syncfusion.Maui.Toolkit.PullToRefresh	Defines the namespace for SfPullToRefresh control.
SfSegmentedControl	Syncfusion.Maui.Buttons	Syncfusion.Maui.Toolkit.SegmentedControl	Defines the namespace for SfSegmentedControl.
SfShimmer	Syncfusion.Maui.Shimmer	Syncfusion.Maui.Toolkit.Shimmer	Defines the namespace for SfShimmer control.
SfTabView	Syncfusion.Maui.TabView	Syncfusion.Maui.Toolkit.TabView	Defines the namespace for SfTabView control.
SfTextInputLayout	Syncfusion.Maui.Core	Syncfusion.Maui.Toolkit.TextInputLayout	Defines the namespace for SfTextInputLayout control.
Common	Syncfusion.Maui.Core.Hosting	Syncfusion.Maui.Toolkit.Hosting	Provides functionality for configure your .NET MAUI application through the AppHostBuilder.

C# Methods

Controls	Syncfusion .NET MAUI	Syncfusion Toolkit for .NET MAUI	Description
Common	ConfigureSyncfusionCore()	ConfigureSyncfusionToolkit()	Configures the implemented handlers in Syncfusion.Maui.Toolkit.