Added new kb article upgrade-document-processing-libraries-separately-from-wpf

knowledge-base/upgrade-document-processing-libraries-separately-from-wpf.md

@@ -0,0 +1,48 @@
+---
+title: Upgrading Document Processing Libraries Independently from WPF Libraries
+description: Learn how to upgrade Telerik Document Processing Libraries while using an older version of the Telerik UI for WPF suite, and understand the implications.
+type: how-to
+page_title: How to Upgrade Telerik Document Processing Libraries Without Upgrading WPF Libraries
+slug: upgrade-document-processing-libraries-separately-from-wpf
+tags: document processing, libraries, upgrade, dependencies, wpf, telerik
+res_type: kb
+ticketid: 1681608
+---
+
+## Environment
+
+<table>
+<tbody>
+<tr>
+<td>Product</td>
+<td>Telerik Document Processing</td>
+</tr>
+</tbody>
+</table>
+
+## Description
+
+I need to upgrade the Telerik Document Processing Libraries to address a vulnerability in version 2024.4.1106 by moving to version 2025.1.205. However, I want to continue using version 2024.4.1111 of the WPF libraries in my projects. Is it possible to upgrade only the Document Processing Libraries without updating the WPF libraries, and what are the implications? This knowledge base article also answers the following questions:
+- Can I upgrade Telerik Document Processing Libraries separately from Telerik UI for WPF suite?
+- What are the dependencies between Telerik UI for WPF and Telerik Document Processing Libraries?
+- How to ensure application stability when upgrading Telerik Document Processing Libraries?
+
+## Solution
+
+To upgrade the Telerik Document Processing Libraries (DPL) while using an older version of the Telerik UI for WPF suite, follow these guidelines:
+
+1. **Understand Dependencies**: Certain WPF controls such as RichTextBox, PdfViewer, PivotGrid, and GridView have dependencies on the DPL for specific functionalities, like exporting data. If your application does not utilize these specific functionalities or controls, you might not need to upgrade DPL.
+
+2. **Evaluate Compatibility**: While it is technically possible to use DPL version 2025.1.205 with WPF version 2024.4.1111, Telerik does not guarantee the same level of application stability due to the potential changes in the internal API used by the WPF suite.
+
+3. **Consider Licensing Changes**: Starting from the 2025 Q1 release, all Telerik products, including DPL, introduced a dependency on the Telerik.Licensing library. Ensure to account for this change by setting up the license key as outlined in the [Setting Up Your Telerik Document Processing Libraries License Key](https://docs.telerik.com/devtools/document-processing/distribution-and-licensing/license-key).
+
+4. **Perform Extensive Testing**: Before finalizing the upgrade, thoroughly test your application with the new DPL version to identify any runtime issues that might not be apparent during development.
+
+5. **Upgrading**: If your application uses functionalities or controls dependent on DPL, consider upgrading both the DPL and WPF libraries to ensure compatibility and stability. For scenarios where upgrading the entire suite is not feasible, removing unused references to DPL might be an alternative.
+
+## See Also
+
+- [Telerik Document Processing Libraries Release Notes](https://docs.telerik.com/devtools/document-processing/release-notes/2025/release-notes-2025-1-205)
+- [Telerik.Licensing NuGet Package Information](https://docs.telerik.com/devtools/document-processing/knowledge-base/dpl-telerik-licensing-nuget-feed)
+- [Telerik UI for WPF Controls Documentation](https://docs.telerik.com/devtools/wpf/)