Skip to content

Latest commit

 

History

History
96 lines (65 loc) · 5.76 KB

first-steps-msi-or-zip.md

File metadata and controls

96 lines (65 loc) · 5.76 KB
title page_title description slug tags published position
First Steps With MSI/ZIP
First Steps With MSI and ZIP Installation
This article describes the lifecycle of a Telerik WPF application when using MSI or ZIP installation.
msi-or-zip-setup-lifecycle
pipeline,lifecycle
true
2

First Steps With MSI or ZIP

This article describes the lifecycle of a Telerik application. This includes creating, deploying, redistributing, and upgrading an application with referenced Telerik dlls.

The topic shows what is the lifecycle when using the .msi or .zip file to get the dlls. As an alternative, you can use [NuGet packages]({%slug nuget-setup-lifecycle%}) or [Telerik UI for WPF Extension]({%slug getting-started-first-steps%}).

Creating a Project

To use the Telerik dlls, create a new WPF project using the Visual Studio project template from the File --> New --> Project menu.

{{ site.framework_name }} Create WPF Application

Set a Project name and Location for the project. For this example, we will use TelerikWPFApplication for the project's name.

{{ site.framework_name }} Setup Project Name and Location

This will create an empty WPF project where you can reference the Telerik dlls.

{{ site.framework_name }} Empty Project Visual Studio

Referencing Telerik Assemblies

[Download the .zip file]({%slug installation-installing-from-zip-wpf%}) with the Telerik assemblies in a location of your choice. Or [download the .msi]({%slug installation-installing-from-msi-wpf%}) file and install it. This tutorial will show how to reference the Telerik dlls from the default installation folder.

Use the Visual Studio's Reference Manager to browse and reference the Telerik dlls.

{{ site.framework_name }} Reference Manager {{ site.framework_name }} Reference Manager Browse Dialog {{ site.framework_name }} Added References

If you need to set a [Telerik theme]({%slug common-styling-appearance-available-themes%}) different than the default one check the [Xaml vs. NoXaml]({%slug xaml-vs-noxaml%}) and the [Setting a Theme]({%slug styling-apperance-implicit-styles-overview%}) articles.

Installing a License Key

To use the Telerik WPF product you will need to install a valid license key. Otherwise, you will see warning messages and banners related to the licensing. See how to activate a license in the [Installing License Key]({%slug installing-license-key%}) article.

Adding Telerik Controls

After you create the WPF project and reference the Telerik assemblies, add any UI and related code-behind, models, and styles. This example will show a fundamental setup, including a RadTabControl with few tabs defined in XAML.

[XAML] Example 1: Adding Telerik control in the UI

{{region msi-or-zip-setup-lifecycle-0}} telerik:RadTabControl <telerik:RadTabItem Header="Home" /> <telerik:RadTabItem Header="Insert" /> <telerik:RadTabItem Header="View" /> </telerik:RadTabControl> {{endregion}}

{{ site.framework_name }} Project with Added Tab Control

Deploying the Application

To deploy a WPF application, you can use several different approaches, like XCopy, ClickOnce, or Windows Installer deployment. Read more about this in the Deploy a WPF Application MSDN article.

Redistributing Telerik Application

Several rules should be kept in mind when redistributing an application with Telerik dlls. Read more about this in the [Redistributing Telerik Assemblies]({%slug protecting-telerik-radcontrols-assembly%}) article.

Upgrading the Project

To upgrade the project, download the new version of the .msi or the .zip file and install it accordingly. Then remove the old Telerik references from the WPF project and include the new ones. At this point, double-check if all the Telerik assemblies have the same version (for example, 2020.3.102) and if all or of the same type ([Xaml or NoXaml]({%slug xaml-vs-noxaml%})). To check this, right-click the .dll file (for example, Telerik.Windows.Controls.dll) and choose the Properties option.

{{ site.framework_name }} Telerik Assembly Properties Menu Option {{ site.framework_name }} Telerik Assembly No Xaml File Description

Delete the bin and obj folders of the projects that reference Telerik dlls in the solution and then Clean, and Rebuild them. This will ensure that no older Telerik dlls are cached and used during the compilation.

{{ site.framework_name }} Delete bin and obj Folders {{ site.framework_name }} Clean and Rebuild Solution

See Also

  • [System Requirements]({%slug installation-system-requirements-wpf%})
  • [Download Product Files]({%slug download-product-files-wpf%})
  • [Installing WPF Demos Application]({%slug installing-wpf-demos%})