First Steps
This article will guide you through the basics of Telerik UI for Xamarin and how to start using the suite on Mac.
Once you have your first simple Xamarin control up and running, take a look at the Next Steps section to explore other control functionality.
For additional resources you can also review the Related Articles section on the right.
Download the Controls
When you have an active trial or developer license, you can download the following files:
- Standalone installation
- Assemblies for manual installation
- NuGet packages
- Old versions
If you are not a customer, you can download a free, fully functional trial and the same options will apply to you as well.
Make sure you have already read the System Requirements article before you proceed.
Follow the steps below in order to download the installation files:
-
Log into your Telerik account and click on the Downloads tab.
Figure 1a: Downloads tab
Select Progress Telerik UI for Xamarin product title.
-
Download the Installation .pkg and .mpack files.
Figure 3a: Download installers
-
Install Progress Telerik UI for Xamarin
Since MacOS Catalina, downloaded installers and packages are quarantined. If you try to just open the pkg file, you may see a popup preventing you from installing it. The easiest solution is to
- Right-click on the .pkg file you downloaded in Step 3
- Select "Open With"
- Select "Installer" (see Fig 4a).
Figure 4a: Open With -> Installer
For a more permanent solution, open the Mac OS Settings -> Security & Privacy settings panel and select Allow apps downloaded from App Store and Identified developers.
-
Install Visual Studio for Mac Extensions
Once you have finished the pkg installation, now it's time to install the Visual Studio Extensions with the mpack file.
Open the Visual Studio Extension Manager and select the Install form file... option. Figure 5a shows how to access the Extension Manager.
Figure 5a: Accessing Visual Studio Extensions
Once you have accessed the Extension Manager, the following dialog will appear and you should look for the Install from file option.
Figure 5b: Reaching the Extension Manager
Navigate to the ProjectTemplateXamarin.mpack file, select it and click "Open" to complete the installation.
Figure 5c: The ProjectTemplate location
If the add-in is successfully added to Visual Studio, you should see it in the IDE extensions section.
Figure 5d: Installation Successful
Restart Visual Studio for Mac to complete the installation.
Create a Project with Telerik UI for Xamarin
-
Now you can create a new project using the Telerik Project Template. Select which platform(s) your application targets and the wizard will automatically reference all required Telerik binaries and packages.
Figure 1a: Create New Project Dialog
-
Select the Telerik Forms App template which can be found in Other > Miscellaneous section.
Figure 2a: Telerik Forms App template
Next Steps
Now that you have downloaded and installed Telerik UI for Xamarin, and created your first project its time to add the Telerik UI for Xamarin control. Below you can find guidance on getting started with that: