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 .pkg automatic installation file.

   

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. 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.

2. Use the sub-directory of the installation folder you need:

   • Binaries—Contains the Net7, Net8 and Net9 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.

   

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