Automated Wizard Installer
This article explains what the automated install wizard does for Telerik UI for Blazor components, and how to get it.
The most common way to install the Telerik UI for Blazor components is to use the Telerik NuGet feed. However, you can also use a wizard installer, or a ZIP archive.
There is an automated installer for:
- Windows (
.msi
) - MacOS (
.pkg
) - Linux (
.sh
+.tar.gz
). Pass-s <path to the archive>
when running the script. Other arguments are-d
for the location where the archive will be extracted (defaults to${HOME}/telerik-blazor"
) and-SkipNETCoreInstall
to skip the installation of .NET Core (note that the framework is required).
The automated installer provides the following:
- The necessary
.nupkg
files so you can setup a local feed in Visual Studio. You can find them in thepackages
folder under the installation folder. - An offline version of our demos that you can run and inspect in your IDE. You can find them in the
demos
folder in the installation. The project targets the latest official .NET version, and its readme file provides more details on running the project and using older versions of the framework. - The document processing
.nupkg
files (in thedpl
folder). - A shortcut to our online demos.
- Our Visual Studio extension. We also have an extension for VS Code and you can install it from the VS Code marketplace.
How to Download the Automated Installer
To download the automated msi
(for Windows) or pkg
(for Mac) installer:
Go to Downloads in your Telerik account.
On the loaded page choose from your purchased products or trial downloads Progress® Telerik® UI for Blazor, and click on it.
Download the Automatic installation file for your operating system
Once the download completes, run the downloaded file and follow the instructions.
The default installation path on Windows is
C:\Program Files (x86)\Progress\Telerik UI for Blazor <VERSION>\
. If you are not administrator of your machine, you might want to choose installation path to which you have full access (for example, the Documents or Desktop folder). Thus, you will be able to successfully run and explore the offline version of our live demos that comes with the installer.
Set Up a Local NuGet Feed in Visual Studio
To setup a local NuGet package source, so you can install the Telerik components without an active Internet connection and without setting up our private feed, do the following:
Copy all the
.nupkg
files we provide from thepackages
anddpl
folders of your Telerik UI for Blazor installation to your preferred local feed location. By default, the installation path isC:\Program Files (x86)\Progress\Telerik UI for Blazor <VERSION>
or where you unzip the ZIP installer.Open Visual Studio and go to Tools > Options.
Find the NuGet Package Manager node, expand it, and select Package Sources.
-
Click the Add (
+
) icon at the top to add the new local feed, select its name and point it to the path where you placed all the Telerik.nupkg
files.Make sure to add the packages from both the
packages
anddpl
folders to your custom feed. You can also point the package source to the Telerik installation folder to include all packages recursively.For example:
Next Steps
Once you have the Telerik NuGet source set up, follow the instructions to create a Telerik Blazor app.
Troubleshooting
Can't Install on MacOS Catalina
MacOS requires that installer packages are signed. The UI for Blazor installation .pkg
package is signed and the MacOS system should not block the installation. Nevertheless, in rare cases MacOS may still block the Telerik Installer.
There are several approaches you can try:
-
Make sure that the "identified developers" downloads are enabled:
- Open System Preferences
- Go to Security & Privacy and select the General tab
- In the bottom half of the window under Allow apps downloaded from: option select the App Store and identified developers
- Apply the option and then give the installer another try
-
Install the file manually with either of these approaches:
Right-click on the
.pkg
and select "Open". This should bring up an install dialog, but with an option to Open the file anyway.Right-click on the
.pkg
and select "Open With", and choose Installer.Or, get around Apple's security precautions by removing the quarantine Extended Attribute on the
.pkg
file by executingxattr -d com.apple.quarantine /path/to/file
You can, alternatively, obtain all the files you need from the ZIP archive we provide which does not require an installation.