Error to "dotnet add package Xam.iTextSharpLGPL"

Question

Error to "dotnet add package Xam.iTextSharpLGPL"

Jonathan 170

Hi,

Can you help to the errors when running "dotnet add package Xam.iTextSharpLGPL"?

User's image

Richard Wright 0 Reputation points

2026-06-11T19:01:29.4766667+00:00

The NU1202 error occurs because the legacy Xam.iTextSharpLGPL package (v0.1.0) only supports old, deprecated Mono targets (monoandroid10, monotouch10, xamarinios10) and completely lacks a Target Framework Moniker (TFM) compatible with your modern .NET 10.0 multi-platform app (net10.0-ios, net10.0-android, etc.). Since this Xamarin-era package is unmaintained and fundamentally incompatible with the modern .NET execution runtime, you cannot install it directly. To resolve this, you should replace it with a modern, cross-platform PDF library that explicitly supports .NET Standard 2.0+ or native .NET 6/8/10, such as QuestPDF, iText.NET (the modern iText 7/8 implementation), or the open-source PdfSharpCore package.
Jonathan 170 Reputation points

2026-06-12T08:12:40.5766667+00:00

Must I file it below?
Danny Nguyen (WICLOUD CORPORATION) 7,105 Reputation points Microsoft External Staff Moderator

2026-06-12T10:25:52.16+00:00
I do not think this needs to be filed as a .NET or Visual Studio issue.

The original error is due to Xam.iTextSharpLGPL 0.1.0 not supporting the target frameworks used by your project, such as net10.0-ios, net10.0-maccatalyst, and net10.0-windows.

To resolve it, you would need to either:

Use another PDF package that supports your current target framework, or

Change your project to target a framework supported by Xam.iTextSharpLGPL, although this is usually not recommended for a modern .NET/MAUI project.

If you believe the package itself should support newer target frameworks, that would need to be raised with the package maintainer rather than filed as a Microsoft product issue.

3 answers

Your answer

Richard Wright 0 Reputation points

2026-06-11T19:01:29.4766667+00:00

The NU1202 error occurs because the legacy Xam.iTextSharpLGPL package (v0.1.0) only supports old, deprecated Mono targets (monoandroid10, monotouch10, xamarinios10) and completely lacks a Target Framework Moniker (TFM) compatible with your modern .NET 10.0 multi-platform app (net10.0-ios, net10.0-android, etc.). Since this Xamarin-era package is unmaintained and fundamentally incompatible with the modern .NET execution runtime, you cannot install it directly. To resolve this, you should replace it with a modern, cross-platform PDF library that explicitly supports .NET Standard 2.0+ or native .NET 6/8/10, such as QuestPDF, iText.NET (the modern iText 7/8 implementation), or the open-source PdfSharpCore package.
Jonathan 170 Reputation points

2026-06-12T08:12:40.5766667+00:00

Must I file it below?
Danny Nguyen (WICLOUD CORPORATION) 7,105 Reputation points Microsoft External Staff Moderator

2026-06-12T10:25:52.16+00:00

I do not think this needs to be filed as a .NET or Visual Studio issue.

The original error is due to Xam.iTextSharpLGPL 0.1.0 not supporting the target frameworks used by your project, such as net10.0-ios, net10.0-maccatalyst, and net10.0-windows.

To resolve it, you would need to either:

Use another PDF package that supports your current target framework, or

Change your project to target a framework supported by Xam.iTextSharpLGPL, although this is usually not recommended for a modern .NET/MAUI project.

If you believe the package itself should support newer target frameworks, that would need to be raised with the package maintainer rather than filed as a Microsoft product issue.

Answer 1

Danny Nguyen (WICLOUD CORPORATION) 7,105 Microsoft External Staff Moderator

Hi @Jonathan ,

The error is happening because Xam.iTextSharpLGPL 0.1.0 is an old Xamarin package and it does not appear to support your current target frameworks, such as net10.0-ios, net10.0-maccatalyst, and net10.0-windows.

Bruce's answer is correct. This package is based on an older iTextSharp version, so this is not just a dotnet add package command issue — the package itself is not compatible with the target frameworks being used.

If you still want to use an older LGPL-based iTextSharp option, you may need to look for a package that supports modern .NET targets, such as iTextSharp.LGPLv2.Core. However, please review the package license and compatibility to make sure it fits your project.

If you need newer official iText features, please also review the official iText AGPL/commercial licensing terms before using it in your application.

If you found my response helpful or informative, I would greatly appreciate it if you could follow this guidance or provide feedback.

Thank you.

Danny Nguyen (WICLOUD CORPORATION) 7,105 Reputation points Microsoft External Staff Moderator

2026-06-11T08:02:55.9833333+00:00

Hi, just checking in. Do you have any update on this post?
Jonathan 170 Reputation points

2026-06-11T08:36:52.2966667+00:00

What is the way to resolve the original issue?
Danny Nguyen (WICLOUD CORPORATION) 7,105 Reputation points Microsoft External Staff Moderator

2026-06-11T09:47:28.85+00:00
Hi @Jonathan ,

You have a few options:

Use a PDF package that supports your current target framework.

If you specifically need an older LGPL-based iTextSharp option, check whether a package such as iTextSharp.LGPLv2.Core fits your project and license requirements.

If you must use the official newer iText library, please review its AGPL/commercial licensing terms first.

If you must use Xam.iTextSharpLGPL, then the project would need to target a framework that package supports, but this is usually not recommended for a modern .NET/MAUI project.

So in short, this package is not compatible with your current target frameworks. The recommended fix is to replace it with a compatible PDF library rather than trying to force-install Xam.iTextSharpLGPL.

Answer 2

Bruce (SqlWork.com) 84,086

The licensing requirements of itext changed with version 5 from gpl to agpl. To use the free version your project must also be open source (you must publish your source code) otherwise you need to buy the commercial version.

https://itextpdf.com/how-buy

The license change led to many of open the source projects that wrap itext to abandoned. The library you are trying to use was abandoned over 10 years ago.

There is an active port of the of the old project which used the v4 source which has a more open license:

https://www.nuget.org/packages/iTextSharp.LGPLv2.Core

Jonathan 170 Reputation points

2026-06-08T03:21:36.67+00:00

What is the other way to be able to do "dotnet add package Xam.iTextSharpLGPL" now?
Bruce (SqlWork.com) 84,086 Reputation points

2026-06-12T20:17:00.2666667+00:00

Not sure your question. The Xam.iTextSharpLGP nuget package was never updated to support .net core nor Maui. You will need to pick another package that supports creating pdfs and is supported by Maui. as suggested iTextSharp.LGPLv2.Core is the closest:

dotnet add package iTextSharp.LGPLv2.Core --version 3.8.0

Answer 3

The errors occur because Xam.iTextSharpLGPL targets only old Xamarin/Mono frameworks and is not compatible with the target framework of the project (net10.0-* in the screenshot). NuGet therefore reports NU1202 “package is not compatible with…” and refuses to add it.

To resolve this, use one of these approaches:

Use a compatible target framework
- Create or retarget a project to one of the frameworks the package supports (for example monoandroid10, monotouch10, xamarinios10, or older net4x if listed in the package metadata) and reference the package only from that project.
- This is only practical if specifically building an old Xamarin app; it is not suitable for modern .NET (such as .NET 6/7/8/10).
Replace the package with a modern alternative
- For .NET (including .NET for Android/iOS/MacCatalyst), choose a PDF library that explicitly supports the project’s target framework. Install that package instead of Xam.iTextSharpLGPL.
Avoid forcing the install
- Do not try to bypass the compatibility check; the package binaries will not run correctly on net10.0-* because there is no matching runtime pack.

In summary, either change the project to an older, supported framework or, preferably, use a different PDF library that supports the current .NET target.

References:

Share via

Error to "dotnet add package Xam.iTextSharpLGPL"

3 answers

Your answer