зеркало из https://github.com/telerik/blazor-docs.git
kb(common): Add KB for Version conflict detected for Telerik.Zip (#2424)
This commit is contained in:
Dimo Dimov
GitHub
Родитель
2a4f44f7cd
Коммит
cd344a7d2a
|
|
@ -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)
|
||||
* [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%})
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
||||
<table>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td>Product</td>
|
||||
<td>UI for Blazor <br /> Telerik Document Processing</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
|
||||
## 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
|
||||
|
||||
<div class="skip-repl"></div>
|
||||
|
||||
```
|
||||
Error NU1107: Version conflict detected for Telerik.Zip. Install/reference Telerik.Zip ... directly to project ... to resolve this issue.
|
||||
```
|
||||
|
||||
or
|
||||
|
||||
<div class="skip-repl"></div>
|
||||
|
||||
```
|
||||
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
|
||||
|
||||
<div class="skip-repl"></div>
|
||||
|
||||
````HTML
|
||||
<ItemGroup>
|
||||
<PackageReference Include="Telerik.UI.for.Blazor" Version="AA.BB.CC" />
|
||||
<PackageReference Include="Telerik.Zip" Version="ZZ.YY.XX" />
|
||||
<PackageReference Include="Telerik.Documents.Spreadsheet" Version="ZZ.YY.XX" />
|
||||
<PackageReference Include="Telerik.Documents.Spreadsheet.FormatProviders.OpenXml" Version="ZZ.YY.XX" />
|
||||
</ItemGroup>
|
||||
````
|
||||
|
||||
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
|
||||
|
||||
<div class="skip-repl"></div>
|
||||
|
||||
```
|
||||
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
|
||||
|
||||
<div class="skip-repl"></div>
|
||||
|
||||
````HTML
|
||||
<ItemGroup>
|
||||
<PackageReference Include="Telerik.UI.for.Blazor" Version="AA.BB.CC" />
|
||||
<PackageReference Include="Telerik.Documents.SpreadsheetStreaming" Version="ZZ.YY.XX" />
|
||||
<PackageReference Include="Telerik.Documents.Spreadsheet" Version="ZZ.YY.XX" />
|
||||
<PackageReference Include="Telerik.Documents.Spreadsheet.FormatProviders.OpenXml" Version="ZZ.YY.XX" />
|
||||
</ItemGroup>
|
||||
````
|
||||
|
||||
## See Also
|
||||
|
||||
* [Telerik Document Processing Libraries Overview]({%slug dpl-in-blazor%})
|
||||
Загрузка…
Ссылка в новой задаче