From cd344a7d2a625f05de378f34454946fcde62c1d1 Mon Sep 17 00:00:00 2001 From: Dimo Dimov <961014+dimodi@users.noreply.github.com> Date: Thu, 10 Oct 2024 18:38:04 +0300 Subject: [PATCH] kb(common): Add KB for Version conflict detected for Telerik.Zip (#2424) --- integrations/document-processing-libraries.md | 3 +- ...l-version-conflict-detected-telerik-zip.md | 124 ++++++++++++++++++ 2 files changed, 126 insertions(+), 1 deletion(-) create mode 100644 knowledge-base/dpl-version-conflict-detected-telerik-zip.md diff --git a/integrations/document-processing-libraries.md b/integrations/document-processing-libraries.md index 8a6347a08..9c2c5d384 100644 --- a/integrations/document-processing-libraries.md +++ b/integrations/document-processing-libraries.md @@ -35,4 +35,5 @@ Telerik Document Processing Libraries' [Configuration Wizard](https://docs.teler * [Getting Started with Telerik Document Processing Libraries](https://docs.telerik.com/devtools/document-processing/getting-started/getting-started#getting-started-with-telerik-document-processing) * [Installing on Your Computer](https://docs.telerik.com/devtools/document-processing/getting-started/installation/installing-on-your-computer) * [Trial Version and Commercial License](https://docs.telerik.com/devtools/document-processing/introduction#trial-version-and-commercial-license) -* [System Requirements](https://docs.telerik.com/devtools/document-processing/getting-started/installation/system-requirements) \ No newline at end of file +* [System Requirements](https://docs.telerik.com/devtools/document-processing/getting-started/installation/system-requirements) +* [Version Conflict Detected Error for Telerik.Zip]({%slug dpl-kb-version-conflict-detected-telerik-zip%}) diff --git a/knowledge-base/dpl-version-conflict-detected-telerik-zip.md b/knowledge-base/dpl-version-conflict-detected-telerik-zip.md new file mode 100644 index 000000000..21c34ff14 --- /dev/null +++ b/knowledge-base/dpl-version-conflict-detected-telerik-zip.md @@ -0,0 +1,124 @@ +--- +title: Version Conflict Detected for Telerik.Zip +description: Learn how to fix a NuGet version conflict error that may occur when using different incompatible versions of Telerik UI for Blazor and Telerik Document Processing in the same Blazor project. +type: troubleshooting +page_title: How to Fix Version Conflict Detected Error for Telerik.Zip +slug: dpl-kb-version-conflict-detected-telerik-zip +tags: telerik, blazor, dpl, document processing +ticketid: 1666834, 1663672, 1652709, 1651020, 1649684, 1647998, 1647404, 1646717 +res_type: kb +--- + +## Environment + + + + + + + + +
ProductUI for Blazor
Telerik Document Processing
+ + +## Description + +Visual Studio and the .NET SDK throw an error if incompatible versions of Telerik UI for Blazor and Telerik Document Processing are used in the same project. + + +## Error Message + +
+ +``` +Error NU1107: Version conflict detected for Telerik.Zip. Install/reference Telerik.Zip ... directly to project ... to resolve this issue. +``` + +or + +
+ +``` +Warning NU1605: Detected package downgrade: Telerik.Zip from ... to .... Reference the package directly from the project to select a different version. +``` + + +## Cause + +Telerik UI for Blazor (the `Telerik.UI.for.Blazor` NuGet package) depends on the `Telerik.Documents.SpreadsheetStreaming` NuGet package in order to support [Grid Excel export]({%slug grid-export-excel%}). On the other hand, `Telerik.Documents.SpreadsheetStreaming` depends on `Telerik.Zip`. + +Most [Telerik Document Processing]({%slug dpl-in-blazor%}) NuGet packages depend on `Telerik.Documents.Core`, which also depends on `Telerik.Zip`. + +In other words, `Telerik.Zip` is a transitive dependency of multiple other Telerik NuGet packages. + +Telerik UI for Blazor and Telerik Document Processing use different release cycles. As a result, the latest version of Telerik UI for Blazor may not be compatible with the latest version of Telerik Document Processing. + +[Error `NU1107 Version conflict detected for Telerik.Zip`](https://learn.microsoft.com/en-us/nuget/reference/errors-and-warnings/nu1605) occurs when an older Telerik UI for Blazor version is used together with a newer Telerik Document Processing version. As a result, `Telerik.UI.for.Blazor` expects an older `Telerik.Zip` version than what the project has resolved. + +[Warning `NU1605 Detected package downgrade: Telerik.Zip`](https://learn.microsoft.com/en-us/nuget/reference/errors-and-warnings/nu1605) occurs when a newer Telerik UI for Blazor version is used together with a older Telerik Document Processing version. As a result, `Telerik.UI.for.Blazor` expects a newer `Telerik.Zip` version than what the project has resolved. + + +## Solution + +There are several ways to fix the NuGet conflict errors: + +* [Upgrade Telerik UI for Blazor]({%slug upgrade-tutorial%}), if some [newer version is available](https://www.telerik.com/support/whats-new/blazor-ui/release-history). +* Downgrade Telerik Document Processing to the older version that `Telerik.UI.for.Blazor` expects for `Telerik.Zip`. +* [Reference the newer version of `Telerik.Zip` explicitly in the project.](#reference-the-telerikzip-package-explicitly) +* [Reference the newer version of `Telerik.Documents.SpreadsheetStreaming` explicitly in the project.](#reference-the-telerikdocumentsspreadsheetstreaming-package-explicitly) + +The ultimate goal is all Telerik NuGet packages in the app to use the same version of `Telerik.Zip`. + +### Upgrade or Downgrade NuGet Package Versions + +1. Refer to the [release notes for your Telerik UI for Blazor version](https://www.telerik.com/support/whats-new/blazor-ui/release-history). +2. Check the required and compatible version of Telerik Document Processing. For example, [Telerik UI for Blazor 6.2.0 depends on Telerik Document Processing 2024.3.806](https://www.telerik.com/support/whats-new/blazor-ui/release-history/ui-for-blazor-6-2-0). +3. Upgrade Telerik UI for Blazor. Alternatively, downgrade Telerik Document Processing. + +### Reference the Telerik.Zip Package Explicitly + +Register the newer `Telerik.Zip` NuGet package version explicitly in the project, which will force Telerik UI for Blazor to use that version instead. The referenced `Telerik.Zip` version must match the version of the other Telerik Document Processing packages in the project. The resulting output in the `.csproj` file will be similar to the one below. + +>caption Project file + +
+ +````HTML + + + + + + +```` + +This approach will generate a [NuGet Warning NU1608](https://learn.microsoft.com/en-us/nuget/reference/errors-and-warnings/nu1608), but the application will be able to compile and run. + +>caption NuGet Warning NU1608 + +
+ +``` +NU1608: Detected package version outside of dependency constraint: Telerik.Documents.SpreadsheetStreaming ... requires Telerik.Zip ... but version Telerik.Zip ... was resolved. +``` + +### Reference the Telerik.Documents.SpreadsheetStreaming Package Explicitly + +Register the newer `Telerik.Documents.SpreadsheetStreaming` NuGet package version explicitly in the project, which will force Telerik UI for Blazor to use that version instead. The referenced `Telerik.Documents.SpreadsheetStreaming` version must match the version of the other Telerik Document Processing packages in the project. The resulting output in the `.csproj` file will be similar to the one below. + +>caption Project file + +
+ +````HTML + + + + + + +```` + +## See Also + +* [Telerik Document Processing Libraries Overview]({%slug dpl-in-blazor%})