New to Telerik UI for .NET MAUI? Start a free 30-day trial

First Steps by Installing with the MSI File

The Telerik .NET MAUI library provides an option for installing its controls by downloading and executing the MSI file, which contains the suite.

This tutorial describes how to get up and running with Telerik UI for .NET MAUI by using the automatic MSI installation approach on Windows. Here is the step by step guide you have to follow:

Step 1: Set Up Your .NET MAUI Project

Before you start with the installation of Telerik .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 enables you to download the suite either from the Telerik .NET MAUI product page or through your Telerik account. For the purposes of this tutorial, let's download the batch from your Telerik account:

  1. Log into your Telerik Account.

  2. Click the Downloads tab.

    Telerik UI for .NET MAUI Download tab in your account

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

    Telerik UI for .NET MAUI Search field in your account

  4. On the next page, download the .msi automatic installation file.

    Telerik UI for .NET MAUI available product files in your account

Step 3: Install Telerik UI for .NET MAUI

Now, you are all set to start with the installation:

  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 Net7 and Net8 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.

    Telerik .NET MAUI Installation folder with the displayed subdirectories

Step 4: Register the Required Handlers

To visualize the .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();
    }
    }
    

    Next Steps

See Also

In this article