blazor-docs/installation/automated.md

4.5 KiB

title page_title description slug previous_url tags published position
Automated Installer Automated Installer What the Automated installation package of Telerik UI for Blazor brings. installation/msi /installation/msi get,started,installation,msi,p,wizard True 3

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]({%slug installation/nuget%}). However, you can also use a wizard installer, or a [ZIP archive]({%slug installation/zip%}).

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]({%slug getting-started/what-you-need%}) so you can setup a local feed in Visual Studio. You can find them in the packages 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. @template
  • The [document processing]({%slug dpl-in-blazor%}) .nupkg files (in the dpl folder).
  • A shortcut to our online demos.
  • Our [Visual Studio extension]({%slug getting-started-vs-integration-overview%}). We also have an [extension for VS Code]({%slug getting-started-vs-code-integration-overview%}) 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:

@template

  1. Download the Automatic installation file for your operating system

Once the download completes, run the downloaded file and follow the instructions.

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

@template

Next Steps

@template

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:

    1. Open System Preferences
    2. Go to Security & Privacy and select the General tab
    3. In the bottom half of the window under Allow apps downloaded from: option select the App Store and identified developers
    4. 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 executing xattr -d com.apple.quarantine /path/to/file

  • You can, alternatively, obtain all the files you need from the [ZIP archive we provide]({%slug installation/zip%}) which does not require an installation.

See Also

  • [What You Need To Install]({%slug getting-started/what-you-need%})
  • [Get Started with Client-side Blazor]({%slug getting-started/client-side%})
  • [Get Started with Server-side Blazor]({%slug getting-started/server-side%})