Getting Started with Telerik UI for .NET MAUI

This guide provides the information you need to start using the Telerik UI for .NET MAUI suite—it includes instructions about the available download and installation approaches as well as the required handlers and renderers you have to register.

Step 1: Set Up Your .NET MAUI Application

Before you start with the installation of Telerik UI for .NET MAUI, make sure you have a running .NET MAUI application. For more information on the required steps and system requirements, refer to the Microsoft .NET MAUI official documentation.

Step 2: Download Telerik UI for .NET MAUI

Telerik UI for .NET MAUI provides the following approaches to download the library:

• Using the Telerik UI for .NET MAUI product page
• Downloading with your Telerik account

Using the Product Page

To download Telerik UI for .NET MAUI from its product page:

1. Log into your Telerik Account.

2. Go to the Telerik UI for .NET MAUI controls overview page.

3. Click the Download Telerik UI for .NET MAUI button.

   

4. As a result, the download starts automatically.

   

Using Your Telerik Account

To download Telerik UI for .NET MAUI from your Telerik account:

1. Log into your Telerik Account.

2. Click the Downloads tab.

   

3. Search for MAUI and select the Telerik UI for .NET MAUI product title.

   

4. On the next page, download the .msi and .pkg automatic installation files, and the Telerik .NET MAUI NuGet Package.

   

Step 3: Install Telerik UI for .NET MAUI

Telerik UI for .NET MAUI provides the following installation options:

• Installing on Windows
• Installing on MacOS
• Installing with NuGet

Installing on Windows

To install Telerik UI for .NET MAUI on Windows:

1. Run the Telerik_UI_for_dot_NET_Maui_[version]_[license].msi file and follow the instructions. The file automatically installs Telerik UI for .NET MAUI on your PC.

   On a 32-bit machine, the wizard will suggest to install the UI for .NET MAUI controls in C:\Program Files\Progress\. On a 64-bit machine, the wizard will suggest to install the UI for .NET MAUI controls in C:\Program Files (x86)\Progress\.

2. Use the subdirectory of the installation folder you need:

   • Binaries—Contains the Net6 and Net7 folders. Each folder contains the needed assemblies for Android, iOS, MacCatalyst, and WinUI.
   • Examples—Contains the sample applications demonstrating the Telerik UI for .NET MAUI controls. For more details, go to the Sample Applications section.
   • LicenseAgreements—Provides the product End-User License Agreement (EULA).
   • Packages—Contains the Telerik.UI.for.Maui.[version].nupkg file as well as the Document Processing NuGet packages.
   • VSExtensions—Contains the Visual Studio Extension for Visual Studio 2022.

   

Installing on macOS

To install Telerik UI for .NET MAUI on MacOS:

1. Run the Telerik_UI_for_dot_NET_Maui_[version].pkg file and follow the instructions.

   The file automatically installs Telerik UI for .NET MAUI on your Mac.

2. Use the subdirectory of the installation folder you need:

   • Binaries—Contains the Net6 and Net7 folders. Each folder contains the needed assemblies for Android, iOS, MacCatalyst, and WinUI.
   • Examples—Contains the sample applications demonstrating the Telerik UI for .NET MAUI controls. For more details, go to the Sample Applications section.
   • LicenseAgreements—Provides the product End-User License Agreement (EULA).
   • Packages—Contains the Telerik.UI.for.Maui.[version].nupkg file as well as the Document Processing NuGet packages.
   • VSExtensions—Contains the Project Wizard for Visual Studio for Mac.

   

Installing with NuGet

For the step-by-step guide on how to install Telerik UI for .NET MAUI with NuGet, refer to the article on getting up and running with the controls by using the Telerik NuGet Server and Visual Studio for Windows.

Step 4: Register Required Handlers

To visualize the Telerik UI for .NET MAUI controls, you have to register the required handlers by calling the Telerik.Maui.Controls.Compatibility.UseTelerik extension method inside the Configure method of the MauiProgram.cs file of your project.

1. Add the needed using settings inside the MauiProgram.cs file.

   using Telerik.Maui.Controls.Compatibility;
   

2. Call the UseTelerik() method inside the MauiProgram.cs file.

   public static class MauiProgram
   {
   public static MauiApp CreateMauiApp()
   {
       var builder = MauiApp.CreateBuilder();
       builder
           .UseTelerik()
           .UseMauiApp<App>()
           .ConfigureFonts(fonts =>
           {
               fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
           });
   
       return builder.Build();
   }
   }
   

See Also

• Installing Telerik UI for .NET MAUI with the Telerik NuGet Server
• Telerik UI for .NET MAUI Sample Applications