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.

   

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

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.

   

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

• Available Product Files and Assemblies
• Telerik .NET MAUI Installation Approaches

See Also

• System Requirements for macOS
• Telerik Toolbox for .NET MAUI on macOS
• Telerik Project Template for VS on macOS
• Telerik .NET MAUI Product Page