Getting Started

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.

Set Up Your .NET MAUI Application

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

For .NET MAUI Apps you must have Visual Studio 2022 Preview - 17.1 Preview 1

Download Telerik UI for .NET MAUI

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

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

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

    Telerik UI for .NET MAUI

  4. As a result, the download starts automatically.

    Telerik UI for .NET MAUI

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.

    Telerik UI for .NET MAUI

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

    Telerik UI for .NET MAUI

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

    Telerik UI for .NET MAUI

Install Telerik UI for .NET MAUI

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

Installation for Windows

To install Telerik UI for .NET MAUI on Windows:

  1. Run the Telerik_UI_for_Maui_[version]_Preview.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. The installation folder provides the following subdirectories:

    • Binaries—Contains the needed assemblies for Android, iOS, MacCatalyst, and WinUI.
    • Examples—Contains the SDK application with the Telerik UI for .NET MAUI controls.
    • LicenseAgreements—Provides the product End-User License Agreement (EULA).
    • Packages—Contains the Telerik_UI_for_Maui_[version]_Preview.nupkg file.

    Telerik UI for MAUI Installation Folder

Installation for macOS

To install Telerik UI for .NET MAUI on MacOS:

  1. Run the Telerik_UI_for_Maui_[version]_Preview.pkg file, which automatically installs Telerik UI for .NET MAUI on your Mac.

  2. The installation folder provides the following subdirectories:

    • Binaries—Contains the needed dlls for Android, iOS, and MacCatalyst.
    • Examples—Contains the SDK application with the Telerik UI for .NET MAUI controls.
    • LicenseAgreements—Provides the product End-User Licensce Agreement (EULA).
    • Packages—Contains the Telerik_UI_for_Maui_[version]_Preview.nupkg file.

    Telerik UI for .NET MAUI Installation Folder

Register Required Handlers and Renderers

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

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

    using Telerik.Maui.Controls.Compatibility;
    
  2. Call the UseTelerik() method inside the Startup.cs file.

    
    public class Startup : IStartup
    {
    public void Configure(IAppHostBuilder appBuilder)
    {
        appBuilder
            .UseFormsCompatibility()
            .ConfigureFonts(fonts => {
                fonts.AddFont("ionicons.ttf", "IonIcons");
            })
            .UseTelerik()
            .UseMauiApp<App>();            
    }
    }
    

    See Also

In this article
Not finding the help you need?