diff --git a/distribution-and-licensing/license-key/setting-up-license-key.md b/distribution-and-licensing/license-key/setting-up-license-key.md index f38f948e..b8692af4 100644 --- a/distribution-and-licensing/license-key/setting-up-license-key.md +++ b/distribution-and-licensing/license-key/setting-up-license-key.md @@ -70,4 +70,5 @@ Whenever you purchase a new license or renew an existing one, always [download a * [Handling License Key File Name and Environment Variable Name Changes in the 2025 Q1 Release]({%slug handling-license-file-name-changes%}) * [Telerik.Licensing NuGet package is not available on the Telerik NuGet feed]({%slug dpl-telerik-licensing-nuget-feed%}) * [Diagnostic Options for Telerik Licensing]({%slug telerik-trial-version-message-diagnostic-options%}) +* [Resolving License Validation Issues in Telerik Document Processing Libraries]({%slug license-not-recognized-telerik-document-processing-libraries%}) diff --git a/knowledge-base/license-not-recognized-telerik-document-processing-libraries.md b/knowledge-base/license-not-recognized-telerik-document-processing-libraries.md new file mode 100644 index 00000000..fc36789d --- /dev/null +++ b/knowledge-base/license-not-recognized-telerik-document-processing-libraries.md @@ -0,0 +1,56 @@ +--- +title: Resolving License Validation Issues in Telerik Document Processing Libraries +description: Troubleshooting the issue where the license is not recognized during runtime in Telerik Document Processing Libraries. +type: troubleshooting +page_title: License Not Recognized in Telerik Document Processing Libraries +meta_title: License Not Recognized in Telerik Document Processing Libraries +slug: license-not-recognized-telerik-document-processing-libraries +tags: telerik, document, processing, license, validation, runtime, issues, licensing diagnostics +res_type: kb +ticketid: 1690929 +--- + +## Environment + +| Version | Product | Author | +| ---- | ---- | ---- | +| 2025.2.520| RadPdfProcessing |[Desislava Yordanova](https://www.telerik.com/blogs/author/desislava-yordanova)| + +## Description + +This article aims to address potential licensing issues while generating Excel (or PDF, DOCX, etc.) files with Telerik Document Processing Libraries during **runtime** testing. The generated file contains a "License" sheet (or a watermark) with a trial message, despite the **Build Output** window indicating a valid license. The issue arises in a multi-project (e.g. Blazor WASM) application setup, where dependencies are shared across projects. + +## Cause + +This issue generally occurs due to incomplete license validation during runtime in complex setups, particularly when using shared libraries or plugin architectures. *Even if the license is validated during build time, runtime environments may fail to recognize it due to transitive dependency limitations.* + +## Solution + +To ensure proper license validation and eliminate trial messages, follow the steps below: + +1. **License Key Placement**: Ensure the `telerik-license.txt` file is present in the root directory of all projects referencing Telerik Document Processing Libraries, including shared libraries or class libraries. + +2. **Explicit License Registration**: Add a call to `TelerikLicensing.Register()` early in your application lifecycle. For Blazor WASM applications, include this call in the `Program.cs` file. This approach validates the license explicitly. + +3. **Verify Assemblies**: Ensure **no trial** versions of Telerik assemblies are referenced in any project. Replace [trial assemblies]({%slug upgrade-trial-to-licensed-version%}) with licensed ones, if such even exist. + +4. **Enable Diagnostics**: Add the following property to your `.csproj` file to enable detailed licensing diagnostics during build and runtime: + ```xml + + diagnostic + + ``` + Review the diagnostic output for clues about license validation issues. + +5. **Direct Package References**: Add references to the Telerik Document Processing Libraries NuGet packages directly in the Blazor WASM project. This resolves transitive dependency limitations. + +6. **Avoid Environment Variables**: Use only the `telerik-license.txt` file for license delivery instead of environment variables, which can cause issues due to length limitations. + +By following these steps, runtime validation issues should resolve, and the trial message will no longer appear in generated documents. + +## See Also + +- [Telerik Document Processing Licensing Overview]({%slug introduction%}) +- [Setting Up Your Telerik Document Processing Libraries License Key]({%slug setting-up-license-key%}) +- [Using TelerikLicensing.Register Method]({%slug adding-license-key-ci-cd-services%}#using-teleriklicensingregister-method-on-aws-lambdas) +- [Diagnostic Options for Telerik Licensing]({%slug telerik-trial-version-message-diagnostic-options%})