Skip to content

Commit 02f3c8d

Browse files
committed
new KB for licensing - multi project application
1 parent b6ae79d commit 02f3c8d

File tree

2 files changed

+9
-18
lines changed

2 files changed

+9
-18
lines changed

distribution-and-licensing/license-key/setting-up-license-key.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -70,4 +70,5 @@ Whenever you purchase a new license or renew an existing one, always [download a
7070
* [Handling License Key File Name and Environment Variable Name Changes in the 2025 Q1 Release]({%slug handling-license-file-name-changes%})
7171
* [Telerik.Licensing NuGet package is not available on the Telerik NuGet feed]({%slug dpl-telerik-licensing-nuget-feed%})
7272
* [Diagnostic Options for Telerik Licensing]({%slug telerik-trial-version-message-diagnostic-options%})
73+
* [Resolving License Validation Issues in Telerik Document Processing Libraries]({%slug license-not-recognized-telerik-document-processing-libraries%})
7374

knowledge-base/license-not-recognized-telerik-document-processing-libraries.md

Lines changed: 8 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -18,11 +18,11 @@ ticketid: 1690929
1818

1919
## Description
2020

21-
This article aims to address potential licensing issues while generating Excel files with Telerik Document Processing Libraries during runtime testing. The generated file contains a "License" tab 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.
21+
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.
2222

2323
## Cause
2424

25-
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, runtime environments may fail to recognize it due to transitive dependency limitations.
25+
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.*
2626

2727
## Solution
2828

@@ -32,17 +32,7 @@ To ensure proper license validation and eliminate trial messages, follow the ste
3232

3333
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.
3434

35-
Example:
36-
```csharp
37-
using Telerik.Licensing;
38-
39-
var builder = WebAssemblyHostBuilder.CreateDefault(args);
40-
TelerikLicensing.Register();
41-
builder.RootComponents.Add<App>("#app");
42-
builder.Build().RunAsync();
43-
```
44-
45-
3. **Verify Assemblies**: Ensure no trial versions of Telerik assemblies are referenced in any project. Replace trial assemblies with licensed versions, if necessary.
35+
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.
4636

4737
4. **Enable Diagnostics**: Add the following property to your `.csproj` file to enable detailed licensing diagnostics during build and runtime:
4838
```xml
@@ -52,15 +42,15 @@ To ensure proper license validation and eliminate trial messages, follow the ste
5242
```
5343
Review the diagnostic output for clues about license validation issues.
5444

55-
5. **Direct Package References**: Add references to Telerik Document Processing Libraries and Telerik UI for Blazor NuGet packages directly in the Blazor WASM project. This resolves transitive dependency limitations.
45+
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.
5646

5747
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.
5848

5949
By following these steps, runtime validation issues should resolve, and the trial message will no longer appear in generated documents.
6050

6151
## See Also
6252

63-
- [Telerik Document Processing Licensing Overview](https://docs.telerik.com/devtools/document-processing/distribution-and-licensing/license-key)
64-
- [Using TelerikLicensing.Register Method](https://docs.telerik.com/devtools/document-processing/distribution-and-licensing/license-key/adding-license-key-ci-cd-services#using-teleriklicensingregister-method-on-aws-lambdas)
65-
- [Diagnostic Options for Telerik Licensing](https://docs.telerik.com/devtools/document-processing/knowledge-base/telerik-trial-version-message)
66-
- [Troubleshooting Telerik Document Processing Licensing Issues](https://docs.telerik.com/devtools/document-processing/distribution-and-licensing/license-key/setting-up-license-key)
53+
- [Telerik Document Processing Licensing Overview]({%slug introduction%})
54+
- [Setting Up Your Telerik Document Processing Libraries License Key]({%slug setting-up-license-key%})
55+
- [Using TelerikLicensing.Register Method]({%slug adding-license-key-ci-cd-services%}#using-teleriklicensingregister-method-on-aws-lambdas)
56+
- [Diagnostic Options for Telerik Licensing]({%slug telerik-trial-version-message-diagnostic-options%})

0 commit comments

Comments
 (0)