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

First Steps by Installing with the PKG File

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

This tutorial describes how to get up and running with Telerik UI for .NET MAUI by using the PKG installation approach on macOS. 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 .pkg 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 on your machine from the Apple Installer .pkg file:

  1. Go to the Telerik UI for .NET MAUI download page following the instructions in the topic on downloading the Telerik UI for .NET MAUI product files.

  2. Run the Telerik_UI_for_dot_NET_Maui_[version].pkg file and follow the instructions. As a result, the file will automatically install Telerik UI for .NET MAUI on your Mac.

    For more information about the file included in the Installation folder, go to the list of options and product files.

    Telerik UI for .NET MAUI Installation dialog on macOS with the welcome message

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();
            .ConfigureFonts(fonts =>
                fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
        return builder.Build();

    Next Steps

See Also

In this article