Getting Started / Mac

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

First Steps by Installing with the NuGet Package on macOS

NuGet is a popular .NET package manager. Progress maintains the Telerik NuGet Feed for registered users and you can include the Telerik UI for .NET MAUI suite in your project as well as update to the latest available version from there.

While installing Telerik UI for .NET MAUI with NuGet works both for Windows and MacOS machines, this tutorial describes how to get up and running with the library by downloading and installing the controls 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 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.

Step 2: Download Telerik UI for .NET MAUI

Telerik UI for .NET MAUI enables you to download the suite either from the Telerik UI for .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 and .pkg automatic installation files, and the Telerik .NET MAUI NuGet Package.

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

Step 3: Add the Telerik NuGet Package Source to Visual Studio for Mac

Now, let's add the Telerik UI for .NET MAUI package through the Telerik NuGet feed. To use the available packages, you need to have an active Telerik account and to authenticate.

  1. Click on the solution folder in Visual Studio for Mac to display the context menu and choose Manage NuGet Packages.

    Telerik NuGet Package Manager context menu with the Package Manager Settings option

  2. Choose the Configure Source option from the drop-down in the lower left corner.

    Package Sources dialog with the Available package sources field

  3. On the next dialog you can see all the available sources. Choose Add to add the new server.

    Package Sources dialog with the Available package sources field

  4. In the Location field, add the Telerik server by filling in its https://nuget.telerik.com/v3/index.json URL. Click Add Source.

    Note that the https://nuget.telerik.com/v3/index.json server will be deprecated and you are recommended to switch to the v3 API, which is faster, more lightweight, and also reduces the number of requests from NuGet clients.

    Package Sources field with the checked Telerik NuGet option

The Telerik server is now ready to use. You can go to your solution and open the Solution Package Manager.

Step 4: Install the Telerik .NET MAUI NuGet Package

Now, you need to add the Telerik package to the .NET MAUI solution project that you created:

  1. Select the Telerik NuGet server as a package source and enter your credentials when prompted.
  2. Search for the Telerik.UI.for.Maui package and select it.
  3. Choose the projects which require the package.
  4. Select the desired version and click Add Package.

Manage Packages for Solutions dialog with the search field and the Telerik.UI.for.MAUI package

Next Steps

Troubleshooting

This section lists some of the common problems that are observed during NuGet installation.

Networking Problems

Another common problem is that your machine (PC or DevOps agent) is behind a proxy. To check if you're experiencing a networking issue, open the following URL in your web browser:

https://nuget.telerik.com/nuget/Search()?$filter=IsAbsoluteLatestVersion&searchTerm=%Maui%27&includePrerelease=true&$skip=0&$top=100&semVerLevel=2.0.0.

After you enter your telerik.com username and password, you should see an XML search result containing a list of all the Telerik.UI.for.Maui packages available with your license.

Unable to Load the Service Index for Source

The following error may occur if the nuget.telerik.com server is down.

Unable to load the service index for source https://nuget.telerik.com/v3/index.json

If you hit that error, make sure that the Telerik NuGet Feed is live at https://status.telerik.com/.

See Also

In this article
Related articles
Not finding the help you need?