This topic details how to upgrade projects that use Ignite UI™ to the current version of the Ignite UI library.
The following list presents the topics required as a prerequisite to understanding this topic.
Styling and Theming Ignite UI: This topic provides instructions on setting up your application for design time, options for using CSS in production and an overview on creating or customizing a theme.
What you need to upgrade depends on what your application uses, as outlined in the following table.
|If your application uses||Then update|
To complete the procedure, you need the following:
C:\Program Files (x86)\Infragistics\2019.2\Ignite UI\js
where ProductVersionShort stands for the release year and release number separated by a dot, e.g. 2013.2.
If you don’t have this version installed, you need to download the Ignite UI installation .zip file available from here.
By default, the installer places the new themes in:
C:\Program Files (x86)\Infragistics\2019.2\Ignite UI\css\themes. If you don’t have this version installed, you need to download the Ignite UI installation .zip file available from here.
By default, the installer places the new assemblies in:
C:\Program Files (x86)\Infragistics\2019.2\Ignite UI\MVC. If you don’t have this version installed, you need to download the Ignite UI installation .zip file available from here.
Following is a conceptual overview of the process:
To upgrade your project, following these steps.
1.Back up current scripts and themes.
Backup the jQuery UI themes. Copy the base and ig themes to the new folder. If you use a custom ThemeRoller theme instead of the ig theme or if you use minified themes, copy the files for those themes to the backup folder, too.
2. Switch to the latest version of the scripts and themes.
(These are all script files beginning with ig.)
Copy the new version of the jQuery UI theme files together with their folder structure to the themes folder of your project.
Note: Refer to your backup directory to make sure that for each jQuery UI theme that you backed up you have the corresponding new theme copied.
Note: There is breaking changes in CSS files and folder structure. More information for changes read Styling and Theming Ignite UI.
3. (Conditional) Upgrade the assemblies
If your application uses the ASP.NET MVC helpers or the Document assemblies, the assemblies for the new versions must be included in your application. Following is the list of the assemblies you need to include:
Note: The new versions of the document assemblies use the Infragistics.Web.Documents naming convention.
To upgrade the assemblies:
1. Remove the existing references to the Ignite UI assemblies.
In Visual Studio, remove the existing references for the Infragistics assemblies from your project.
2. Add and reference the new version of the Infragistics assemblies in your project.
Note: The method by which you add the assemblies to your project will vary depending on the type of deployment. In most cases, removing the old assemblies from the bin folder and adding the new assemblies to the bin folder will be adequate but the steps may differ if you are using a different deployment method, e.g. when the assemblies are in the Global Assembly Cache (GAC).
4. Verify the result.
To verify the result, run your application and test it for issues.
The following topics provide additional information related to this topic.
View on GitHub